Funkcja Top() oblicza wartość wyrażenia w pierwszym (najwyższym) wierszu segmentu kolumny w tabeli. Wiersz wybierany do obliczeń zależy od wartości opcjonalnego parametru offset — domyślnie jest to wiersz najwyższy. W przypadku wykresów niebędących tabelami wynik funkcji Top() jest obliczany na pierwszym wierszu bieżącej kolumny w tabeli prostej odpowiadającej wykresowi.
Składnia:
Top([TOTAL] expr [ , offset [,count ]])
Typ zwracanych danych: dual
Argumenty:
| Argument | Opis |
|---|---|
| expr | Wyrażenie lub pole zawierające mierzone dane. |
| offset |
Określenie wartości offsetn większej niż 1 umożliwia przeniesienie oceny wyrażenia w dół o n wierszy poniżej najwyższego wiersza. Określenie ujemnej wartości argumentu offset sprawia, że funkcja Top działa tak samo jak funkcja Bottom z odpowiednią dodatnią wartością argumentu offset. |
| count | Jeśli trzeci parametr count będzie większy od 1, funkcja zwróci zakres wartości count, po jednej dla każdego z count ostatnich wierszy bieżącego segmentu kolumny. W tej postaci funkcja może być używana jako argument dla specjalnych funkcji zakresu. Funkcje zakresu |
| TOTAL |
Jeśli tabela jest jednowymiarowa lub jako argument zostanie podany kwalifikator TOTAL, bieżący segment kolumny jest zawsze równy całej kolumnie. |
Ograniczenia:
-
Wywołania rekurencyjne będą zwracać NULL.
-
Sortowanie według wartości Y w wykresach albo sortowanie według kolumn wyrażeń w tabelach jest niedozwolone, jeśli w dowolnym z wyrażeń wykresu używana jest ta funkcja wykresu. W takiej sytuacji te opcje sortowania są automatycznie wyłączone. Gdy użyjesz tej funkcji wykresu w wizualizacji lub tabeli, sortowanie wizualizacji powróci do posortowanych danych wejściowych tej funkcji.
Przykłady i wyniki:
Przykład: 1
Na zrzucie ekranu w tym przykładzie widoczne jest, że stosowna wizualizacja tabeli została utworzona na podstawie wymiaru Customer oraz miar Sum(Sales) i Top(Sum(Sales)).
Kolumna Top(Sum(Sales)) zwraca wartość 587 dla wszystkich wierszy, ponieważ jest to wartość najwyższego wiersza: Astrida.
W tabeli tej przedstawione są również bardziej złożone miary: jedna utworzona na podstawie wyrażenia Sum(Sales)+Top(Sum(Sales)) i jedna zatytułowana Top offset 3, utworzona na podstawie wyrażenia Sum(Sales)+Top(Sum(Sales), 3) z argumentem offset o wartości 3. W efekcie jej działania wartość Sum(Sales) dla bieżącego wiersza jest dodawana do wartości z trzeciego wiersza liczonego od najwyższego wiersza (wartość z wiersza bieżącego plus wartość dla klienta Canutility).
Przykład: 2
Na zrzutach ekranu tabel przedstawionych w tym przykładzie do wizualizacji zostały dodane kolejne wymiary: Month i Product. W przypadku wykresów wielowymiarowych wyniki wyrażeń zawierających funkcje Above, Below, Top i Bottom są zależne od kolejności sortowania wymiarów kolumn przez Qlik Sense. Qlik Sense oblicza wartości funkcji na podstawie segmentów kolumny uzyskanych z wymiaru sortowanego jako ostatni. Kolejność sortowania kolumn określa się w panelu właściwości w sekcji Sortowanie i może ona być inna od kolejności wyświetlania kolumn w tabeli.
Więcej informacji na ten temat zawiera przykład 2 w funkcji Above.
|
Przykład: 3 |
Wynik | ||
|---|---|---|---|
|
Funkcję Top można stosować jako źródło danych wejściowych dla funkcji zakresu. Na przykład: RangeAvg (Top(Sum(Sales),1,3)). |
W funkcji Top() argument offset ma wartość 1, a argument count ma wartość 3. Funkcja ta znajduje wyniki wyrażenia Sum(Sales) w trzech wierszach począwszy od wiersza pod najwyższym wierszem w segmencie kolumny (ponieważ offset=1), oraz i w dwóch wierszach pod nim (o ile jest tam wiersz). Wspomniane trzy wartości są stosowane jako dane wejściowe dla funkcji RangeAvg(), która znajduje średnią wartości w określonym szeregu liczbowym. Tabela z kolumną Customer jako wymiarem zwraca następujące wyniki dla wyrażenia RangeAvg(). |
||
|