Widget della linea temporale

Scopo

Il widget Timeline è un widget interattivo che visualizza gli eventi registrati da una tabella Tulip. Mostra il record più recente in alto, consentendo di essere sempre aggiornati.

Impostazione

Campi obbligatori:- ID di aggregazione (aggregazione della tabella Tulip)- Chiave API (testo)- Segreto (testo)- URL dell'account (testo)

Campo opzionale:- Testo bianco (sì/no) - Selezionare "sì" per cambiare il colore del carattere in bianco. Il valore predefinito è "no".

Per impostare questo widget, è necessario fornire una chiave API, un segreto e un URL (che assomiglia a your-account.tulip.co). Se non si sa cos'è una chiave API, consultare la sezione successiva. In alternativa, è possibile impostare il widget nell'editor dell'applicazione (prima di eseguire l'applicazione), inserendo le informazioni direttamente nelle proprietà del widget. A questo punto, se sono presenti eventi nella tabella, dovrebbero essere visualizzati nel widget. Il widget utilizza un'aggregazione. Attraverso l'aggregazione, il widget viene popolato con le informazioni sugli eventi. Senza questa aggregazione, il widget dovrebbe essere rinfrescato dopo ogni inserimento nella tabella per mantenerlo aggiornato.

Come creare un token API

Per accedere alla tabella degli eventi, è necessario disporre di un token API con il permesso tables: read. Per verificarne la disponibilità, accedere alla sezione impostazioni della propria istanza e quindi a "Token API". Se è stato impostato uno spazio di lavoro, questo si trova sotto le impostazioni dello spazio di lavoro. Se si possiede già un token, sarà elencato in quella posizione. Fare clic su "Modifica" e assicurarsi che la voce tables: read sia selezionata sotto scope. Se è selezionata, è tutto pronto; in caso contrario, è necessario modificare gli ambiti o creare un nuovo token. Se non sono presenti token, crearne uno facendo clic sul pulsante "Crea token API". Assegnare il nome che si preferisce e poi selezionare gli ambiti, assicurandosi che sia selezionata la voce tables: read (tabelle: lettura) e tutti gli altri ambiti che si ritengono opportuni. Preferibilmente, assegnare la quantità minima di privilegi necessari, anche se, in caso di incertezza, è possibile selezionare tutte le opzioni. Dopo aver fatto clic su "Crea", apparirà una finestra che indica di salvare la chiave segreta. Attenetevi a questa indicazione, perché se la perdete e dovete rigenerare il segreto, tutte le postazioni in cui viene utilizzato il segreto precedente dovranno essere aggiornate con il nuovo segreto.

Come funziona

Il widget si aggiorna automaticamente quando viene aggiunto un nuovo record alla tabella. Mostra gli ultimi eventi in cima. È possibile cambiare il carattere se si utilizza il widget su uno sfondo più scuro.

La tabella si chiama Timeline eventi e ha le seguenti colonne: - ID (testo) - ID univoco per gli eventi, che dovrebbe essere creato automaticamente, non destinato a essere visualizzato ma necessario - Titolo (testo) - titolo dell'evento, che dovrebbe essere conciso poiché viene visualizzato più grande - Descrizione (testo) - se il titolo non è abbastanza descrittivo, si possono aggiungere ulteriori dettagli che vengono visualizzati sotto il titolo - Tipo (testo) - può essere uno dei seguenti o lasciato vuoto: successo, errore, avviso, messaggio, andon, pausa, start, stop, msteams - c'è anche un'icona predefinita se il tipo non è dato o non è nessuno dei precedenti - sono gestiti in modo insensibile nel widget- Data di creazione (metadati, nascosti) - ogni record in una tabella Tulip ha dei metadati (Data di creazione e Data di aggiornamento) che non possono essere modificati, ma possono essere usati nelle query