Widżet osi czasu

Cel

Widżet Oś czasu jest interaktywnym widżetem, który wyświetla zarejestrowane zdarzenia z tabeli Tulip. Pokazuje najnowszy rekord na górze, dzięki czemu zawsze jesteś na bieżąco.

Konfiguracja

Wymagane pola:- Identyfikator agregacji (agregacja tabeli Tulip)- Klucz API (tekst)- Sekret (tekst)- Adres URL konta (tekst)

Pole opcjonalne:- Biały tekst (tak/nie) - Przełącz na "tak", aby zmienić kolor czcionki na biały. Domyślnie działa jako "nie".

Aby skonfigurować ten widżet, musisz podać klucz API, sekret i adres URL (który wygląda jak your-account.tulip.co). Jeśli nie wiesz, co to jest klucz API, zapoznaj się z następną sekcją. Alternatywnie możesz skonfigurować widżet w edytorze aplikacji (przed uruchomieniem aplikacji), wprowadzając informacje bezpośrednio we właściwościach widżetu. Po podaniu niezbędnych informacji odśwież widżet. W tym momencie, jeśli masz jakieś zdarzenia w tabeli, powinny one być wyświetlane w widżecie. Widżet używa agregacji. Dzięki agregacji widżet jest wypełniany informacjami o zdarzeniach. Bez tej agregacji widżet musiałby być odświeżany po każdym wstawieniu do tabeli, aby był aktualny.

Jak utworzyć token API

Aby uzyskać dostęp do tabeli zdarzeń, musisz mieć token API z uprawnieniem tables: read. Sprawdź, czy go posiadasz, przechodząc do sekcji ustawień swojej instancji, a następnie do sekcji "Tokeny API". Jeśli skonfigurowano obszar roboczy, może on znajdować się w ustawieniach obszaru roboczego. Jeśli posiadasz już token, będzie on wymieniony w tej lokalizacji. Kliknij "Edytuj" i upewnij się, że opcja tables: read jest zaznaczona w obszarze scopes. Jeśli jest zaznaczone, wszystko jest gotowe; jeśli nie, dostosuj zakresy lub utwórz nowy token. Jeśli nie ma żadnych tokenów, utwórz je, klikając przycisk "Utwórz token API". Przypisz dowolną nazwę, a następnie wybierz zakresy, upewniając się, że tabele: odczyt są zaznaczone i inne zakresy według własnego uznania. Najlepiej jest przypisać najmniejszą niezbędną ilość uprawnień, ale jeśli nie masz pewności, możesz zaznaczyć wszystkie opcje. Po kliknięciu przycisku "Utwórz" pojawi się okno z instrukcją zapisania tajnego klucza. Należy tego przestrzegać, ponieważ w przypadku jego utraty i konieczności ponownego utworzenia sekretu, wszystkie lokalizacje, w których używany jest poprzedni sekret, będą wymagały aktualizacji do nowego sekretu.

Jak to działa

Widżet aktualizuje się automatycznie po dodaniu nowego rekordu do tabeli. Pokazuje ostatnie wydarzenia na górze. Możesz zmienić czcionkę, jeśli używasz widżetu na ciemniejszym tle.

Tabela nazywa się Wydarzenia na osi czasu i ma następujące kolumny:- ID (tekst) - unikalny identyfikator wydarzenia, powinien być tworzony automatycznie, nie powinien być wyświetlany, ale jest niezbędny- Tytuł (tekst) - tytuł wydarzenia, powinien być zwięzły, ponieważ jest wyświetlany w większym rozmiarze- Opis (tekst) - jeśli tytuł nie jest wystarczająco opisowy, można dodać więcej szczegółów, które są wyświetlane pod tytułem- Typ (tekst) - może być jednym z poniższych lub pozostawiony pusty: sukces, błąd, ostrzeżenie, komunikat, andon, pauza, start, stop, msteams - istnieje również domyślna ikona, jeśli typ nie został podany lub nie jest żadnym z wcześniej wymienionych - są one obsługiwane w widgecie bez względu na wielkość liter- Data utworzenia (metadane, ukryte) - każdy rekord w tabeli Tulip ma metadane (Data utworzenia i Data aktualizacji), których nie można modyfikować, ale można ich używać w zapytaniach.