:::(Info)To download, visit: Library.
:::
Cel
Widżet „Oś czasu” to interaktywny widżet wyświetlający zarejestrowane zdarzenia z tabeli Tulip. Najnowszy wpis jest wyświetlany na górze, dzięki czemu zawsze masz aktualne informacje.
Konfiguracja
Pola wymagane:- Identyfikator agregacji (agregacja tabeli Tulip)- Klucz API (tekst)- Tajny klucz (tekst)- Adres URL konta (tekst)
Pole opcjonalne: - Biały tekst (tak/nie) - Ustaw opcję na „tak”, aby zmienić kolor czcionki na biały. Domyślnie ustawione jest „nie”.
Aby skonfigurować ten widget, musisz podać klucz API, sekret oraz adres URL (który wygląda jak twoje-konto.tulip.co). Jeśli nie wiesz, czym 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 w właściwościach widżetu.Po podaniu niezbędnych informacji odśwież widżet. W tym momencie, jeśli w tabeli znajdują się jakieś zdarzenia, powinny one zostać wyświetlone w widżecie.Widżet wykorzystuje agregację. 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 dodaniu danych do tabeli, aby był aktualny.
Jak utworzyć konto usługowe
Prior to r383, Service Accounts were called "API Tokens".
Aby uzyskać dostęp do tabeli zdarzeń, musisz posiadać konto serwisowe z uprawnieniem „tables: read ”. Sprawdź, czy je posiadasz, przechodząc do sekcji ustawień swojej instancji, a następnie do „Tulip API”. Jeśli skonfigurowano obszar roboczy, może on znajdować się w ustawieniach obszaru roboczego.Jeśli posiadasz już konto usługowe, będzie ono widoczne w tym miejscu. Kliknij „Edytuj” i upewnij się, że w sekcji zakresów uprawnień zaznaczona jest opcja „tabele: odczyt ”. Jeśli jest zaznaczona, wszystko jest gotowe; jeśli nie, dostosuj zakresy uprawnień lub utwórz nowe konto usługowe.Jeśli nie ma żadnych kont serwisowych, utwórz je, klikając przycisk „Utwórz konto serwisowe”. Nadaj mu dowolną nazwę, a następnie wybierz zakresy uprawnień, upewniając się, że opcja „tables: read” jest zaznaczona oraz dodaj inne zakresy według własnego uznania. Najlepiej przyznać minimalny niezbędny zakres uprawnień, ale w razie wątpliwości możesz zaznaczyć wszystkie opcje.Po kliknięciu „Utwórz” pojawi się okno z instrukcją zapisania klucza tajnego. Postępuj zgodnie z tą instrukcją, ponieważ w przypadku utraty klucza i konieczności jego ponownego wygenerowania wszystkie miejsca, w których używano poprzedniego klucza, będą wymagały aktualizacji do nowego klucza.
Jak to działa
Widżet aktualizuje się automatycznie po dodaniu nowego rekordu do tabeli. Najnowsze zdarzenia są wyświetlane na górze. Jeśli korzystasz z widżetu na ciemniejszym tle, możesz zmienić czcionkę.
Tabela nosi nazwę „Zdarzenia na osi czasu” i zawiera następujące kolumny:- ID (tekst) - unikalny identyfikator zdarzeń, powinien być tworzony automatycznie; nie jest przeznaczony do wyświetlania, ale jest niezbędny- Tytuł (tekst) - tytuł zdarzenia; powinien być zwięzły, ponieważ jest wyświetlany większą czcionką- 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 to być jedna z poniższych opcji lub pole pozostawione puste: 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 wyżej wymienionych – w widżecie są one traktowane bez rozróżniania wielkości liter – Data utworzenia (metadane, ukryte) - każdy rekord w tabeli „ Tulip table ” posiada metadane (data utworzenia i data aktualizacji), których nie można modyfikować, ale które można wykorzystać w zapytaniach