# Lista de ocorrências

> O cartão Ocorrências de um painel de unidade, os episódios de ocorrência ativos e recentes da unidade.

A **Lista de ocorrências** mostra os episódios de ocorrência ativos e recentes de uma unidade
(veja [Ocorrências](process-occurrences) para o que é uma ocorrência). Ela é uma leitura, não uma
superfície de comando: nada nela escreve.

Ela é o cartão Ocorrências 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 lista desenha no máximo cinco episódios, os ativos primeiro
e os mais recentes depois, então o teto descarta os mais antigos do que sobra.

## O que uma linha mostra {#what-a-row-shows}

Cada linha de episódio carrega:

- o nome da ocorrência e a palavra de estado dela,
- o relógio **Ativa**, há quanto tempo a condição está (ou esteve) em vigor,
- quando o episódio chegou a perder o sinal, um relógio separado de **Perda de sinal** (ou
  **Sinal indisponível** enquanto o sinal ainda está fora),
- a mensagem do episódio, quando ele tem uma, com o texto inteiro na dica da linha.

Enquanto um episódio está ativo, uma faixa na borda inicial da linha e a palavra de estado dela
tomam o tom da severidade da ocorrência, o mesmo tom que o ponto dela tem na linha do tempo de
[Ocorrências](events-occurrences) de Eventos: crítico para Crítica, cautela para Alerta, neutro
para Informação. Um episódio normalizado é desenhado sem tom, qualquer que seja a severidade dele.

Os dois relógios são deliberadamente separados: um sinal indisponível nunca faz uma ocorrência
ativa parecer normalizada.

## Estados e atualização {#states-and-refresh}

O cabeçalho diz o que a lista está lendo, e no painel de unidade ele é o próprio cabeçalho do
cartão: `Ocorrências` durante uma execução, `Ocorrências · 2 ativas` enquanto há episódios
ativos, `Ocorrências · fora de execução` enquanto a unidade não tem execução (a lista então lê os
episódios surgidos fora de uma), e `Ocorrências · indisponível` onde o leitor de episódios não
está rodando. A lista se atualiza a cada dois segundos, aproximadamente. Uma atualização que
falha mantém as linhas anteriores e marca o cabeçalho com `· desatualizado` enquanto a nova
tentativa automática está pendente, em vez de limpar uma lista que o operador pode estar lendo.