Budowanie stron i kafelków

Appka to stos stron, a każda strona to siatka kafelków — ten sam model kafelków, którego używają dashboardy. Jeśli budowałeś już dashboard w Saiku, poczujesz się identycznie; jedyną nową warstwą są strony Appki i nawigacja wokół nich.

Strony

Każda Appka startuje z jedną stroną. W trybie edycji:

• Dodaj stronę z menu nawigacji (szyna albo góra) — + obok listy stron.
• Zmień nazwę strony w miejscu; nazwa to to, co widać w nawigacji.
• Przełączaj strony, klikając je w nawigacji. Każda strona pamięta własny stan filtrów, gdy się między nimi poruszasz.

Ułóż strony tak, by pasowały do historii, którą chcesz opowiedzieć — najpierw strona przeglądowa, potem strony szczegółowe.

Wskazówka

Strona może otwierać się pasem tytułowym — dużym nagłówkiem, wyciszonym podtytułem i wyrównaną do prawej linią meta (np. Portland #14 · Today / Regional manager view / Thu · Week 41). Nagłówek, podtytuł, meta i ikonę per strona ustawisz w zakładce Pages inspektora designu.

Dodawanie kafelków

Na stronie w trybie edycji kliknij + Dodaj kafelek, by otworzyć menu kafelków. Wbudowane typy kafelków to:

Kafelek	Co pokazuje
Wykres	Szesnaście typów wykresów — słupkowy / liniowy / warstwowy / kołowy / pierścieniowy / wodospad / treemap / sunburst / heatmapa / radar / punktowy / bąbelkowy / mapa. Zobacz Kafelek Wykres
Tabela	Rekordy komórek miar z nagłówkami wierszy
KPI	Pojedyncza miara jako duża liczba, z opcjonalnym porównaniem i sparkline
Tekst / notatka	Adnotacja w Markdownie — bez danych
Obraz	Logo, diagram albo zrzut ekranu z URL-a lub wgrania

Wybierz typ, a kafelek spadnie na siatkę. Rozmieszczanie i rozmiar działają jak w dashboardzie — przeciągnij, by przesunąć, przeciągnij uchwyt, by zmienić rozmiar.

Notatka

Menu kafelków listuje też własne renderery (ECharts option, Graph, Ranked list) i wszelkie zainstalowane przez administratora pluginy, każdy jako osobną pozycję. Mają własne strony: Własne kafelki i Pluginy.

Filtrów nie ma w tym menu — dodaje się je w panelu Filtry strony, nad siatką.

Wiązanie kafelka z danymi

Dodanie kafelka wybiera jego typ; edytor kafelka ⚙ to miejsce, gdzie dajesz mu dane. Otwórz go przyciskiem edycji kafelka. Zależnie od typu kafelka konfigurujesz:

• Kostkę i zapytanie — dla kafelków wykresu, tabeli i KPI wybierz połączenie / kostkę i zbuduj zapytanie (miary, wymiary na wierszach albo kolumnach, slicery). Zobacz Skąd bierze się zapytanie kafelka niżej.
• Typ wykresu, a za przyciskiem Opcje wykresu drugi edytor z podwójnymi osiami, typami serii combo, liniami trendu, sortowaniem / Top N, formatowaniem liczb, liniami i pasmami referencyjnymi. Kafelek wykresu potrafi też wykrywać anomalie, rzutować prognozę i emitować filtr krzyżowy, gdy w nim zaznaczysz. Wszystko to ma własną stronę: Kafelek Wykres.
• Miarę i porównanie — dla KPI, która miara jest dużą liczbą i (opcjonalnie) do czego się ją porównuje. Użyj wzorca formatu $cN dla waluty kompaktowej ($48.2K). Zobacz Porównania KPI niżej.
• Treść — ciało Markdown dla kafelka tekstowego albo URL / wgranie dla kafelka obrazu (te dwa nie potrzebują zapytania).
• Formatowanie warunkowe — kafelki tabeli obsługują reguły per kolumna: kolor tła, paski danych, kolor czcionki albo ikonę (↑ ↓ →), przypięte do progów względnych (percentyl) albo bezwzględnych. Tabela może też dodać końcową kolumnę sparkline, rysującą mini wykres na wiersz z wartości miar tego wiersza — sensowne, gdy te kolumny tworzą serię (dajmy na to miesiące), mniej przy niepowiązanych miarach.
• Format liczb (per kolumna) — kafelki tabeli przyjmują wzorzec wyświetlania per kolumna, dopasowywany po caption nagłówka, tym samym słownikiem, co kafelki KPI i listy rankingowej: $cN waluta kompaktowa, $N waluta zwykła, N% procent, samo N cyfry po przecinku. Warto ustawić przy każdej mierze całkowitej, której format w kostce niesie miejsce dziesiętne — inaczej liczba sztuk wyrenderuje się jako 10759.0. Kolumny, które pominiesz, zachowują formatowanie kostki.
• Auto-odświeżanie — każdy kafelek związany z zapytaniem może się przeliczać co 1, 5, 15, 30 albo 60 minut, respektując aktywne filtry i pauzując, gdy karta przeglądarki jest ukryta.

Dla własnych kafelków ECharts option edytor dokłada opcje wyświetlania: żywy przełącznik Trend / Breakdown (zamiana serii między linią a słupkami na tych samych danych), uwydatnij ostatni punkt (akcentowy znacznik „bieżącego okresu”) oraz format osi wartości. Zobacz Własne kafelki.

Kafelki tekstu i obrazu to te dwa, które nie niosą zapytania; cała reszta wiąże się z kostką.

Skąd bierze się zapytanie kafelka

Są dwa sposoby dania kafelkowi zapytania i siedzą w różnych miejscach edytora ⚙.

Zbuduj je tutaj. Kliknij Edytuj zapytanie wizualnie, a pełny kreator zapytań Saiku otworzy się wewnątrz edytora kafelka: drzewo kostki po lewej, strefy upuszczania Miary / Kolumny / Wiersze / Filtr i żywa siatka wyników pod spodem. Wykonuje się w trakcie budowania, więc widzisz prawdziwe liczby, zanim zatwierdzisz kafelek. Zastosuj zatwierdza zapytanie; zapisanie kafelka je utrwala. To zwykła droga — najpierw wybierz kostkę, inaczej przycisk zostaje nieaktywny.

Albo wskaż coś istniejącego, pod Źródłem zapytania:

• Zapisane zapytanie — wybierz istniejący plik .saiku, a kafelek renderuje się z niego na żywo. Serwer ładuje zapisane zapytanie, scala wszelkie mające zastosowanie filtry dashboardu i przelicza je przy każdym odświeżeniu — jedno zapisane zapytanie może więc podpierać kafelki w kilku Appkach i wszystkie pójdą za nim, gdy je zmienisz.
• JSON inline — zobacz niżej.

JSON inline przyjmuje wprost ciało AiQueryRequest. Sięgnij po niego, gdy chcesz kształt zapytania, którego kreator nie oferuje — konkretną hierarchię, gdy dwie dzielą nazwę poziomu, dajmy na to — albo gdy kopiujesz zapytanie między kafelkami.

Wskazówka

W kreatorze wizualnym dwuklik na mierze albo poziomie dodaje ją — znacznie szybciej niż przeciąganie. Poziomy lądują na Wierszach; by wsadzić jeden na Kolumny (czego potrzebuje heatmapa, bo chce po poziomie na każdej osi), albo przeciągnij go tam, albo dodaj i wybierz Przenieś do Kolumn z menu chipa.

Hierarchia nie może być na osi i w filtrach

Połóż Time / Time / Month na Wierszach, a potem spróbuj filtrować po Time / Time / Year, a zapytanie zostanie odrzucone:

Hierarchy ‘Time’ is already on the rows/columns axis. Mondrian rejects the same hierarchy on two independent axes. Either move the filter members onto the axis selection’s members[], or filter on a different hierarchy/dimension.

To reguła leżącego pod spodem silnika OLAP, a nie ograniczenie Saiku. Aby zawęzić oś do części hierarchii, wymień memberów na samej osi zamiast filtrować osobno — w JSON-ie inline to tablica members[] na wierszu:

"rows": [{
  "dimension": "Time", "hierarchy": "Time", "level": "Month",
  "members": ["[Time].[Time].[1998].[Q1].[January]", "…"]
}]

Ta sama technika jest wyjściem awaryjnym, gdy memberzy poziomu wracają w kolejności, której nie chcesz: wypisanie ich wprost ustala sekwencję, bo Sortuj kategorie w kafelku wykresu porządkuje po wartości miary, a nie po kategorii. Referencyjna Appka FoodMart Ops używa dokładnie tego, by przypiąć swój wykres trendu do ośmiu nazwanych tygodni.

Porównania KPI

Wyróżnik delty w KPI — to „+6.7% vs last month” pod liczbą — jest wyprowadzony z własnego poziomu czasu kafelka, więc zawsze opisuje porównanie, które kafelek naprawdę wykonał. Odpytaj w ziarnie miesięcznym, a powie „vs last month”; w tygodniowym — „vs last week”.

Najpierw ustaw poziom czasu

Ten poziom czasu to coś, co Ty wybierasz, a nie coś, co kafelek wnioskuje — i dopóki go nie ustawisz, porównanie nie ma się do czego odnieść.

Blisko dołu edytora KPI, pod Poziom czasu (do porównania + sparkline), wybierz Wymiar, Hierarchię i Poziom (np. Time / Time / Month). Wtedy:

• porównanie ma poprzedni okres, wobec którego mierzy, oraz
• pole wyboru Sparkline staje się dostępne — nanosi miarę wzdłuż tego poziomu.

Uwaga

To krok najczęściej pomijany. Wybierasz miarę, ustawiasz Porównanie na Poprzedni okres i pozornie nic się nie dzieje — bo kafelek jeszcze nie wie, czym dla tej kostki jest „okres”. Zjedź niżej i wypełnij trzy selektory poziomu czasu.

Możesz nadpisać sformułowanie polem Etykieta delty, gdy kostka ma własne słownictwo („vs last trading day”), ale domyślne nie może już kłócić się z danymi.

Niepełne końcowe okresy

Najnowszy kubełek szeregu czasowego często dopiero się zapełnia — bieżący tydzień albo miesiąc — albo jest granicą danych, gdzie ostatni okres trzyma parę dni. Zmierzony wobec całego poprzedniego okresu daje liczbę opisującą kalendarz, a nie biznes: −84%, które znaczy, że nic się nie zmieniło poza datą.

Ustaw Niepełne końcowe okresy, by powiedzieć kafelkowi, ile najnowszych okresów jest wciąż częściowych. Te okresy:

• zachowują swoje prawdziwe wartości — nic nie jest ukrywane, a sparkline nadal nanosi każdy punkt
• są opisane „Week 52 · partial” pod liczbą
• nie mają wobec siebie pokazanego procentu, bo nie ma uczciwego do pokazania

Notatka

Kafelek nie wypracuje tego sam — wyniki zapytań nie niosą dat do porównania z zegarem, a zgadywanie z wartości ukryłoby prawdziwe załamanie. To więc Twoja deklaracja, a bezpieczny kierunek jest wbudowany: ustawienie jej źle kosztuje Cię porównanie, zamiast je wymyślić.

Zapisywanie

Zapisz Appkę z edytora. Utrwala się jako dokument .saikuapp w repozytorium, w katalogu wybranym przy tworzeniu. Otwórz ją ponownie kiedykolwiek z listy Appek albo osadź na innej stronie — zobacz Osadzanie Appki.

Powiązane

• Przegląd App Buildera — czym jest Appka i czym różni się od dashboardu.
• Własne kafelki — deklaratywne renderery ECharts i grafu poza wbudowaną piątką.
• Analyze — buduj i zapisuj zapytania, które Twoje kafelki ponownie wykorzystują.