Widget de linha do tempo

Finalidade

O widget Timeline é um widget interativo que exibe eventos registrados de uma tabela Tulip. Ele mostra o registro mais recente no topo, permitindo que você esteja sempre atualizado.

Configuração

Campos obrigatórios:- ID de agregação (agregação da tabela Tulip)- Chave de API (texto)- Segredo (texto)- URL da conta (texto)

Campo opcional:- White text (yes/no) - Altere para "yes" para mudar a cor da fonte para branco. O padrão é "não".

Para configurar esse widget, você precisa fornecer uma chave de API, um segredo e um URL (que se parece com your-account.tulip.co). Se não souber o que é uma chave de API, consulte a próxima seção.Como alternativa, você pode configurar o widget no editor de aplicativos (antes de executar o aplicativo) inserindo informações diretamente nas propriedades do widget.Depois de fornecer as informações necessárias, atualize o widget. Nesse momento, se você tiver algum evento na tabela, ele deverá ser exibido no widget.O widget usa uma agregação. Por meio da agregação, o widget é preenchido com as informações dos eventos. Sem essa agregação, o widget precisaria ser atualizado após cada inserção na tabela para mantê-lo atualizado.

Como criar um token de API

Para acessar a tabela de eventos, você deve ter um token de API com permissão tables: read. Verifique se você tem um token navegando até a seção de configurações da sua instância e depois até "API tokens". Se houver um espaço de trabalho configurado, ele poderá estar em Configurações do espaço de trabalho. Clique em "Edit" (Editar) e verifique se a opção tables: read está marcada em scopes (escopos). Se estiver marcado, está tudo pronto; caso contrário, ajuste os escopos ou crie um novo token. Se não houver tokens, crie um clicando no botão "Create API token". Atribua o nome que preferir e, em seguida, selecione os escopos, garantindo que tables: read esteja marcado e quaisquer outros escopos que você considere adequados. De preferência, atribua o mínimo de privilégio necessário, mas, se não tiver certeza, marque todas as opções. Ao clicar em "Create" (Criar), aparecerá uma janela instruindo-o a salvar a chave secreta. Siga essa orientação porque, se você a perder e precisar regenerar o segredo, todos os locais em que o segredo anterior for usado precisarão ser atualizados para o novo segredo.

Como funciona

O widget é atualizado automaticamente quando um novo registro é adicionado à tabela. Ele mostra os últimos eventos na parte superior. Você pode alterar a fonte se estiver usando o widget em um fundo mais escuro.

A tabela é chamada Timeline events (Eventos da linha do tempo ) e tem as seguintes colunas:- ID (texto) - ID exclusivo para os eventos, deve ser criado automaticamente, não se destina a ser exibido, mas é necessário- Título (texto) - título do evento, deve ser conciso, pois é exibido em tamanho maior- Descrição (texto) - se o título não for descritivo o suficiente, mais detalhes podem ser adicionados, que são exibidos sob o título- Tipo (texto) - pode ser um dos seguintes ou deixado em branco: success, error, warning, message, andon, pause, start, stop, msteams - há também um ícone padrão se o tipo não for fornecido ou não for nenhum dos mencionados anteriormente - eles são tratados de forma insensível no widget- Date Created (metadados, oculto) - cada registro em uma tabela Tulip tem metadados (Date created e Date updated) que não podem ser modificados, mas podem ser usados em consultas