# Linha do tempo de comentários

> O cartão Comentários de um painel de unidade, os comentários do operador na execução ativa da unidade, com a conduta de acrescentar, reescrever e excluir.

A **Linha do tempo de comentários** mostra os comentários do operador na execução ativa de uma
unidade, do mais antigo para o mais novo, cada um com o carimbo de tempo dele e a fase em que
ele foi gravado, mais uma caixa de acréscimo no pé (veja [Execuções e comentários](process-runs)
para o que um comentário registra). Um comentário faz parte do registro da execução e pode sair
da estação de novo num relatório, então a linha do tempo também carrega os dois gestos que
mantêm esse registro honesto: reescrever uma linha onde ela está, e removê-la.

Ela é o cartão Comentários do [painel de unidade](view-unit-panels), não um componente: o painel
a desenha para a própria unidade onde quer que os [Painéis](process-panels) do modelo mantenham
esse cartão ligado. Ela nunca é colocada numa tela, e a paleta Adicionar do dashboard não a
oferece. Não há nada a configurar: a unidade é o vínculo inteiro, e o painel a fornece.

## O que o cabeçalho diz {#what-the-header-says}

O cabeçalho declara o que a linha do tempo está lendo, e no painel de unidade ele é o próprio
cabeçalho do cartão: `Comentários · <nome da execução>` durante uma execução ativa,
`Comentários · sem execução ativa` enquanto a unidade está ociosa (a lista está então vazia), e
`Comentários (indisponível)` onde o serviço do Process não está rodando. As notas de
pós-execução são acrescentadas pelos [Históricos](histories), não por esta linha do tempo.

A lista se atualiza a partir do arquivo da execução com um freio (a cada três segundos,
aproximadamente, e na hora quando a execução muda). Um gesto que o operador tem aberto, uma
reescrita em curso, uma remoção armada, segura a atualização, para que a linha não seja
reescrita sob a mão dele; uma troca de execução não é segurada, porque a execução a que aqueles
gestos pertenciam já foi.

## Acrescentar um comentário {#adding-a-comment}

Digite na caixa de acréscimo e pressione **Adicionar**. O botão só fica habilitado enquanto há
uma execução ativa, o operador tem permissão e o rascunho não está em branco. O comentário é
gravado sob o operador autenticado (ou sob a estação quando ninguém está autenticado), porque
uma nota também é evidência. Uma falha aparece na linha de resposta da própria linha do tempo.

## Reescrever um comentário {#rewriting-a-comment}

**Editar** abre a linha no lugar, sobre o texto como foi gravado. **Salvar** (ou Enter)
confirma; **Cancelar** (ou Escape) deixa o registro como estava. Um texto em branco ou sem
mudança deixa o registro em paz; uma reescrita de verdade carimba a edição e a persiste. É a
mesma confirmação que a grade dos Históricos aplica aos comentários de pós-execução.

## Excluir um comentário {#deleting-a-comment}

Remover exige dois toques, os dois na própria linha, porque um painel de operação não tem uma
segunda superfície em que abrir um diálogo, e um comentário removido não volta:

1. **Excluir** arma a linha. Nada sai do arquivo da execução ainda; a linha pergunta
   `Excluir este comentário? Isso não pode ser desfeito.`
2. O **Excluir** de confirmação ao lado dessa pergunta remove o comentário. **Cancelar** o
   mantém.

Armar uma linha desarma qualquer outro gesto aberto: uma linha que pede para ser removida não
está também sendo reescrita.

## Permissão {#permission}

Os três gestos exigem a permissão **Executar procedimentos**, na página do Process e na página
View do mesmo jeito, reconferida no instante da escrita, nunca só quando o painel foi desenhado.
Enquanto o operador não pode escrever, a linha do tempo continua legível, a caixa de acréscimo e
os gestos ficam desabilitados, e a dica de cada controle desabilitado carrega a razão.