--- title: "Widget Cronologia" slug: "timeline-widget" updated: 2026-10-22T17:17:29Z published: 2026-10-22T17:17:29Z canonical: "support.tulip.co/timeline-widget" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Widget Cronologia :::(Info)To download, visit: [Library](https://library.tulip.co/apps/timeline-widget). ::: ## Scopo Il widget Timeline è un widget interattivo che visualizza gli eventi registrati da una tabella Tulip. Mostra il record più recente in cima, consentendoti di essere sempre aggiornato. ![image](https://tulip.widen.net/content/w9asw7xkxy/web/Timelinewidget.gif?animate=true&u=hhrpm9) ## Configurazione Campi obbligatori:- ID aggregazione (aggregazione della tabella Tulip)- Chiave API (testo)- Segreto (testo)- URL dell’account (testo) Campo facoltativo: - Testo bianco (sì/no) - Impostare su "sì" per cambiare il colore del carattere in bianco. L'impostazione predefinita è "no". Per configurare questo widget, devi fornire una chiave API, un segreto e un URL (del tipo `your-account.tulip.co`). Se non sai cos’è una chiave API, consulta la sezione successiva.In alternativa, puoi configurare il widget all’interno dell’editor dell’app (prima di eseguire l’app) inserendo le informazioni direttamente nelle proprietà del widget.Una volta fornite le informazioni necessarie, aggiorna il widget. A questo punto, se nella tabella sono presenti eventi, questi dovrebbero essere visualizzati nel widget. Il widget utilizza un’aggregazione. Grazie all’aggregazione, il widget viene popolato con le informazioni relative agli eventi. Senza questa aggregazione, il widget dovrebbe essere aggiornato dopo ogni inserimento nella tabella per mantenerlo aggiornato. ### Come creare un account di servizio Feature rename Prior to r383, Service Accounts were called "API Tokens". Per accedere alla tabella degli eventi, è necessario disporre di un account di servizio con l’autorizzazione " `tabelle: lettura` ". Verifica di averne uno accedendo alla sezione delle impostazioni della tua istanza e poi a "Tulip API". Se è stato configurato uno spazio di lavoro, questa opzione potrebbe trovarsi nelle impostazioni dello spazio di lavoro.Se si dispone già di un account di servizio, questo sarà elencato in quella posizione. Fare clic su “Modifica” e assicurarsi che l’opzione `“tabelle: lettura”` sia selezionata nella sezione “Ambiti”. Se è selezionata, è tutto a posto; in caso contrario, modificare gli ambiti o creare un nuovo account di servizio.Se non sono presenti account di servizio, creane uno cliccando sul pulsante "Crea account di servizio". Assegna il nome che preferisci, quindi seleziona gli ambiti, assicurandoti che " `tabelle: lettura` " sia selezionato e qualsiasi altro ambito che ritieni opportuno. Preferibilmente, assegna il minimo di privilegi necessario; tuttavia, in caso di dubbio, puoi selezionare tutte le opzioni.Dopo aver cliccato su “Crea”, apparirà una finestra che ti chiederà di salvare la chiave segreta. Segui queste istruzioni perché, se la perdi e devi rigenerare la chiave segreta, tutte le posizioni in cui viene utilizzata la chiave precedente dovranno essere aggiornate con la nuova chiave. ## Come funziona Il widget si aggiorna automaticamente quando viene aggiunto un nuovo record alla tabella. Mostra gli eventi più recenti in cima. È possibile modificare il carattere se si utilizza il widget su uno sfondo più scuro. La tabella si chiama `"Eventi della cronologia` " e presenta le seguenti colonne:- ID (testo) - ID univoco per gli eventi; dovrebbe essere generato automaticamente; non è destinato alla visualizzazione ma è necessario- Titolo (testo) - titolo dell’evento; dovrebbe essere conciso poiché viene visualizzato in caratteri più grandi- Descrizione (testo) - se il titolo non è abbastanza descrittivo, è possibile 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, avvio, arresto, msteams` - è presente anche un’icona predefinita se il tipo non viene specificato o non corrisponde a nessuno di quelli menzionati in precedenza - nel widget vengono gestiti senza distinzione tra maiuscole e minuscole- Data di creazione (metadati, nascosta) - ogni record in un « Tulip table » (elenco di attività) possiede metadati (Data di creazione e Data di aggiornamento) che non possono essere modificati ma possono essere utilizzati nelle query