O evento mais novo aparece grande com seu nível, fonte e idade, enquanto eventos anteriores seguem em uma lista e o rodapé conta eventos e erros na janela, para que os acontecimentos mais recentes sejam lidos claramente de longe. Preenche a tela, fica no meio, se encaixa em um canto, roda como uma linha ou como uma faixa ao longo de uma borda, com eventos anteriores como lista, trilho ou células compactas. Você define o nome do registro, a janela para as contagens, o nível mais baixo mostrado, se o cartão fica ou sai quando está silencioso e quanto tempo um evento conta como recente.
Cartão ao vivo
Categoria: Operações. Tags: Notícias e anúncios, Números e métricas, Escritórios e locais de trabalho.
Layouts
Este cartão principal se encaixa em qualquer layout: tela cheia, centro, largo, canto, chip, faixa ou qualquer retângulo livre.
Layouts: cheio, centro, largo, canto, chip, faixa. Formas: paisagem, retrato, quadrado, faixa.
Layouts, temas e publicação de cartões. Veja os cartões.
Dados e privacidade
Este cartão usa suas propriedades configuradas e dados ao vivo do cartão.
Propriedades
Para tema, fundo, destaque e posição, veja Propriedades comuns.
Defina as propriedades estáticas nos params do cartão ao criá-lo. O documento de dados dele contém apenas propriedades dinâmicas. Linhas aninhadas descrevem o conteúdo da propriedade pai.
Propriedades estáticas
| Nome | Tipo | Padrão | Valores e limites | Descrição |
|---|---|---|---|---|
title | string | "Activity" | maxLength: 30 | A sobrancelha: o nome do log. |
windowMinutes | integer | 60 | mínimo: 1; máximo: 10080 | A janela que contabiliza eventos e erros. |
minLevel | string | "info" | "info", "success", "warning", "error" | O nível mais baixo mostrado; níveis inferiores são descartados do registro e suas contagens. error são apenas erros. |
presence | string | "always" | "always", "recent" | recent mostra o cartão apenas enquanto o evento mais recente tiver menos de recentMinutes de idade; um registro silencioso sai. |
recentMinutes | integer | 10 | mínimo: 1; máximo: 1440 | Quanto tempo um evento mantém o cartão presente com presence: recent. |
backgroundColor | string, nulo | null | padrão: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | Substitui o fundo e a placa do cartão por uma cor plana ordenada por CSS. #RRGGBBAA fornece opacidade. background none tem precedência. |
textColor | string, nulo | null | padrão: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | Substitui as cores do texto principal e secundário. As cores de destaque e status semântico mantêm seus papéis. |
Propriedades dinâmicas
| Nome | Tipo | Padrão | Valores e limites | Descrição |
|---|---|---|---|---|
events | array | [] | maxItems: 100 | |
events[].id | string | "" | maxLength: 40 | Chaveia a linha, para que um evento já exibido não seja animado novamente. |
events[].at | string | "" | maxLength: 40 | Instante ISO 8601 em que o evento ocorreu; ordena o registro e determina a idade. |
events[].source | string | "" | maxLength: 30 | De onde veio: um serviço, um agente ou uma pessoa. |
events[].title | string | minLength: 1; maxLength: 120; Obrigatório | ||
events[].detail | string | "" | maxLength: 160 | |
events[].level | string | "" | "", "info", "success", "warning", "error" | Vazio conta como informação. |
Exemplo de tela
Salve as propriedades estáticas como params.json e crie o cartão. O resultado traz o id crd_ dele.
{
"theme": "neomustard"
}
screenrig card create --type activity-feed --major 1 --file params.json
Adicione este item aos primitives de uma página da playlist, com esse id no lugar do id do exemplo. Publique a playlist e atribua uma tela.
{
"id": "activity-feed",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}
Escrever dados ao vivo
Escreva o documento no cartão depois de criá-lo e depois substitua-o para atualizar a tela sem republicar. O cartão verifica cada gravação contra suas propriedades dinâmicas e recusa um documento que ele rejeita. Use o mesmo projeto da playlist.
Salve o documento como card-data.json. O CLI lê o documento em si, sem invólucro:
{
"events": []
}
screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json
Ou chame a API diretamente. A API envolve o mesmo documento em um campo document. Um token de agente já nomeia seu projeto, então nenhum cabeçalho de projeto é enviado; se você enviar ScreenRig-Project, ele deve corresponder ao projeto do token. Forneça sua autorização de API pelo ambiente; veja Autenticação da API.
curl --request PUT "https://api.screenrig.ai/api/cards/crd_01EXAMPLECARD000000000/data" \
--header "Authorization: Bearer $SCREENRIG_TOKEN" \
--header "Content-Type: application/json" \
--data '{"document":{"events":[]}}'