:::(Info)To download, visit: Library.
:::
Zweck
Das Timeline-Widget ist ein interaktives Widget, das protokollierte Ereignisse aus einer Tulip-Tabelle anzeigt. Es zeigt den neuesten Datensatz ganz oben an, sodass Sie stets auf dem neuesten Stand sind.
Einrichtung
Pflichtfelder:- Aggregations-ID (Tulip-Tabellenaggregation)- API-Schlüssel (Text)- Geheimschlüssel (Text)- Konto-URL (Text)
Optionales Feld:- Weißer Text (ja/nein) - Schalten Sie auf „ja“, um die Schriftfarbe auf Weiß zu ändern. Die Standardeinstellung ist „nein“.
Um dieses Widget einzurichten, musst du einen API-Schlüssel, ein Geheimnis und eine URL (die wie „dein-Konto.tulip.co“ aussieht) angeben. Wenn Sie nicht wissen, was ein API-Schlüssel ist, lesen Sie den nächsten Abschnitt.Alternativ können Sie das Widget im App-Editor (vor dem Ausführen der App) einrichten, indem Sie die Informationen direkt in die Eigenschaften des Widgets eingeben.Sobald Sie die erforderlichen Informationen angegeben haben, aktualisieren Sie das Widget. Wenn sich zu diesem Zeitpunkt Ereignisse in der Tabelle befinden, sollten diese im Widget angezeigt werden.Das Widget verwendet eine Aggregation. Durch die Aggregation wird das Widget mit den Informationen zu den Ereignissen gefüllt. Ohne diese Aggregation müsste das Widget nach jedem Eintrag in die Tabelle aktualisiert werden, um auf dem neuesten Stand zu bleiben.
So erstellen Sie ein Dienstkonto
Prior to r383, Service Accounts were called "API Tokens".
Um auf die Ereignistabelle zugreifen zu können, benötigen Sie ein Dienstkonto mit der Berechtigung „Tabellen: Lesen “. Überprüfen Sie, ob Sie über ein solches Konto verfügen, indem Sie im Einstellungsbereich Ihrer Instanz zu „Tulip API“ navigieren. Falls ein Arbeitsbereich eingerichtet ist, finden Sie diese Option möglicherweise unter den Arbeitsbereichseinstellungen.Wenn Sie bereits über ein Dienstkonto verfügen, wird es an dieser Stelle aufgeführt. Klicken Sie auf „Bearbeiten“ und stellen Sie sicher, dass unter „Bereiche“ die Option „Tabellen: Lesen“ aktiviert ist. Ist dies der Fall, sind Sie startklar; andernfalls passen Sie entweder die Bereiche an oder erstellen Sie ein neues Dienstkonto.Falls keine Dienstkonten vorhanden sind, erstellen Sie eines, indem Sie auf die Schaltfläche „Dienstkonto erstellen“ klicken. Geben Sie einen beliebigen Namen ein und wählen Sie dann die Berechtigungsbereiche aus. Stellen Sie sicher, dass „Tabellen: Lesen“ aktiviert ist und fügen Sie weitere Berechtigungsbereiche nach Bedarf hinzu. Weisen Sie vorzugsweise nur die unbedingt erforderlichen Berechtigungen zu; im Zweifelsfall können Sie jedoch alle Optionen aktivieren.Wenn Sie auf „Erstellen“ klicken, erscheint ein Fenster mit der Aufforderung, den geheimen Schlüssel zu speichern. Befolgen Sie diese Anweisung, denn wenn Sie ihn verlieren und den geheimen Schlüssel neu generieren müssen, müssen alle Stellen, an denen der vorherige geheime Schlüssel verwendet wird, auf den neuen geheimen Schlüssel aktualisiert werden.
So funktioniert es
Das Widget wird automatisch aktualisiert, wenn ein neuer Datensatz zur Tabelle hinzugefügt wird. Die letzten Ereignisse werden ganz oben angezeigt. Sie können die Schriftart ändern, wenn Sie das Widget auf einem dunkleren Hintergrund verwenden.
Die Tabelle heißt „Timeline-Ereignisse“ und enthält die folgenden Spalten:– ID (Text) – eindeutige ID für die Ereignisse; sollte automatisch generiert werden; nicht zur Anzeige vorgesehen, aber erforderlich– Titel (Text) – Titel des Ereignisses; sollte prägnant sein, da er größer angezeigt wird– Beschreibung (Text) – Wenn der Titel nicht aussagekräftig genug ist, können weitere Details hinzugefügt werden, die unter dem Titel angezeigt werden – Typ (Text) – Kann einer der folgenden Werte sein oder leer gelassen werden: Erfolg, Fehler, Warnung, Meldung, Andon, Pause, Start, Stopp, MSTeams – Es gibt außerdem ein Standardsymbol, wenn der Typ nicht angegeben ist oder keiner der zuvor genannten ist – Im Widget wird bei der Verarbeitung nicht zwischen Groß- und Kleinschreibung unterschieden – Erstellungsdatum (Metadaten, ausgeblendet) - Jeder Datensatz in einem „ Tulip table “ verfügt über Metadaten (Erstellungsdatum und Aktualisierungsdatum), die nicht geändert, aber in Abfragen verwendet werden können