Funkcje systemowe
Funkcje systemowe udostępniają funkcje dotyczące dostępu do właściwości systemu, urządzenia i dokumentu QlikView.
Przy każdej funkcji znajduje się pole rozwijane umożliwiające wyświetlenie składni i krótkiego opisu funkcji. W przypadku niektórych funkcji można uzyskać dodatkowe informacje, klikając nazwę funkcji w opisie składni.
Ta funkcja zwraca ciąg znaków zawierający właściwość autora bieżącego dokumentu. Może być stosowana zarówno w skrypcie ładowania, jak i wyrażeniu wykresu.
Author( )
Ta funkcja zwraca ciąg znaków agenta użytkownika dotyczący przeglądarki klienta. Może być stosowana zarówno w skrypcie ładowania, jak i wyrażeniu wykresu.
Przykład:
Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114 Safari/537.36
ClientPlatform( )
Ta funkcja zwraca ciąg znaków zawierający nazwę komputera, jaką zwraca system operacyjny. Może być stosowana zarówno w skrypcie ładowania, jak i wyrażeniu wykresu.
ComputerName( )
Ta funkcja skryptu zwraca nazwę kulturową stosowanej leksykografii z uwzględnieniem znaków diakrytycznych. Jeśli nie ustawiono zmiennej CollationLocale, zwracane są rzeczywiste ustawienia regionalne komputera użytkownika.
GetCollationLocale( )
Ta funkcja zwraca wartość nazwanej właściwości rozszerzonej w obiekcie arkusza z danym ID obiektu. Jeśli nie podano objectid, użyty będzie obiekt arkusza zawierający wyrażenie. Właściwość rozszerzona jest zdefiniowana dla obiektu rozszerzenia w jego pliku definicji.
GetExtendedProperty(name[, objectid])
Funckja GetObjectField() zwraca nazwę wymiaru. Index jest opcjonalną liczbą całkowitą oznaczającą wymiar, który powinien zostać zwrócony.
GetObjectField([index])
Ta funkcja zwraca wartość klucza w rejestrze Windows. Może być stosowana zarówno w skrypcie ładowania, jak i wyrażeniu wykresu.
GetRegistryString(path, key)
Ta funkcja może być używana tylko w skrypcie i otwiera pole wprowadzania, które zachęca użytkownika do wprowadzenia wartości podczas wykonywania skryptu. Parametry cue i caption są używane odpowiednio jako tekst komunikatu i tekst nagłówka. Funkcja zwraca wprowadzoną wartość.
Funkcja pola wprowadzania zwraca wartość NULL, jeśli okno dialogowe zostanie anulowane, zamknięte bądź w przypadku, gdy wyświetlenie okna dialogowego jest niemożliwe.
Przykład:
Load
Input('Enter value', 'Input box') as v,
Recno () as r
autogenerate 3;
Input(str cue [, str caption])
Ta funkcja może być używana tylko w skrypcie i otwiera okno komunikatu podczas wykonywania skryptu. Parametry msg i caption są używane odpowiednio jako tekst komunikatu i tekst nagłówka. Parametr mb_buttons definiuje przyciski, jakie będą widoczne w oknie komunikatu, odpowiednio do następujących wartości:
0 lub 'OK' dla pojedynczego przycisku OK,
1 lub 'OKCANCEL' dla dwóch przycisków, OK i Cancel,
2 lub 'ABORTRETRYIGNORE' dla trzech przycisków, Abort, Retry i Ignore,
3 lub 'YESNOCANCEL' dla trzech przycisków, Yes, No i Cancel,
4 lub 'YESNO' dla dwóch przycisków, Yes i No,
5 lub 'RETRYCANCEL' dla dwóch przycisków, Retry i Cancel.
Parametr mb_icons definiuje ikonę, jaka będzie widoczna w oknie komunikatu, odpowiednio do następujących wartości:
0 lub pusty ciąg dla braku ikony,
16 lub 'ICONHAND' dla ikony ze znakiem X, która jest używana w przypadku błędów krytycznych,
32 lub 'ICONQUESTION' dla ikony ze znakiem zapytania,
48 lub 'ICONEXCLAMATION' dla ikony ze znakiem wykrzyknika, która jest używana w przypadku błędów nieistotnych, przestróg i ostrzeżeń
64 lub 'ICONASTERISK' dla ikony ze znakiem i, która jest używana w przypadku komunikatów informacyjnych.
Parametr mb_defbutton definiuje przycisk, który będzie aktywny w momencie wyświetlenia okna komunikatu, odpowiednio do następujących wartości:
0 lub 'DEFBUTTON1', jeśli aktywny powinien być pierwszy przycisk,
256 lub 'DEFBUTTON2', jeśli aktywny powinien być drugi przycisk,
512 lub 'DEFBUTTON3', jeśli aktywny powinien być trzeci przycisk,
768 lub 'DEFBUTTON4', jeśli aktywny powinien być czwarty przycisk.
Ta funkcja zwraca liczbę całkowitą określającą, który przycisk nacisnął użytkownik, odpowiednio do następujących wartości:
1 dla OK,
2 dla Cancel,
3 dla Abort,
4 dla Retry,
5 dla Ignore,
6 dla Yes,
7 dla No
Parametry 3, 4 i 5 zostaną dodane wewnętrznie, dlatego użycie wartości liczbowych innych niż określone powyżej może pojawić się nieoczekiwana kombinacja ikon i przycisków.
Funkcja okna komunikatu zwraca wartość NULL, jeśli wyświetlenie okna dialogowego jest niemożliwe.
Przykład:
Load
MsgBox('Message 2', 'msgbox', 'OKCANCEL', 'ICONASTERISK') as x, 2 as r
autogenerate 1;
MsgBox(str msg [, str caption [, mb_buttons [, mb_icons[, mb_defbutton]]]] )
Ta funkcja zwraca ciąg znaków zawierający nazwę bieżącego użytkownika, jaką zwraca system operacyjny. Może być stosowana zarówno w skrypcie ładowania, jak i wyrażeniu wykresu.
OSUser( )
Ta funkcja zwraca pełne oznaczenie wersji i numer kompilacji aplikacji QlikView jako ciąg znaków.
Zwraca ciąg znaków zawierający nazwę bieżącego użytkownika QlikView, jaką wprowadzono w dostępie do sekcji.
QVuser( )
Ta funkcja zwraca znacznik czasu odnoszący się do zakończenia ostatniego ładowania danych. Może być stosowana zarówno w skrypcie ładowania, jak i wyrażeniu wykresu.
ReloadTime( )
Ta funkcja wykresu zwraca nazwę stanu obiektu, w którym jest używana. Programista QlikView może używać tej funkcji w celu uzyskania efektu dynamicznego tekstu i kolorów w przypadku zmiany stanu obiektu. Należy zwrócić uwagę na to, że ta funkcja działa tylko względem obiektów. Nie może być używana w wyrażeniu wykresu w celu określenia stanu, do którego odwołuje się wyrażenie.