Zwykłe instrukcje skryptu
Zwykłe instrukcje służą zazwyczaj do wykonywania operacji na danych. Każda taka instrukcja może obejmować w skrypcie dowolną liczbę wierszy i musi zawsze być zakończona średnikiem, czyli znakiem „;”.
Słowa kluczowe w skrypcie mogą być podawane z użyciem dowolnych kombinacji małych i wielkich liter. Wielkość liter jest natomiast uwzględniana w nazwach pól i zmiennych używanych w instrukcjach.
Przy każdej funkcji znajduje się pole rozwijane umożliwiające wyświetlenie składni i krótkiego opisu funkcji. Kliknij nazwę funkcji w opisie składni, aby uzyskać więcej informacji.
Instrukcja alias służy do ustawienia aliasu, który będzie używany jako nazwa pola we wszystkich wystąpieniach tego pola w skrypcie.
Alias fieldname as aliasname {,fieldname as aliasname}
Ta instrukcja zwraca niepowtarzalną wartość całkowitą dla każdej odrębnie przetwarzanej wartości w polu napotkanej podczas wykonywania skryptu.
Autonumber *fieldlist
[Using namespace] ]
Instrukcja binary służy do ładowania danych z innego dokumentu QlikView, w tym danych z instrukcji Section Access.
Binary [[path] filename]
Udostępnia sposób wyświetlania komentarzy do tabeli (metadanych) z baz danych lub arkuszy kalkulacyjnych.
comment-table tablelist using mapname
comment-table tablename with comment
Instrukcja CONNECT służy do określania dostępu aplikacji QlikView do ogólnej bazy danych przy użyciu interfejsu OLE DB/ODBC. W przypadku ODBC źródło danych najpierw należy określić za pomocą narzędzia administracyjnego ODBC.
Instrukcja Directory określa, w którym katalogu należy szukać plików danych w kolejnych instrukcjach LOAD, do momentu wydania nowej instrukcji Directory.
Directory [path]
Instrukcja Disconnect przerywa bieżące połączenieODBC/OLE DB/Niestandardowe. Ta instrukcja jest opcjonalna.
W dowolnym momencie podczas wykonywania skryptu można usunąć z modelu danych, a zarazem z pamięci, pola aplikacji Qlik Sense, korzystając w tym celu z instrukcji drop field. Właściwość „distinct” tabeli jest usuwana po instrukcji drop field.
drop-field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
W dowolnym momencie podczas wykonywania skryptu można usunąć z modelu danych, a zarazem z pamięci, wewnętrzne tabele aplikacji QlikView, korzystając w tym celu z instrukcji drop table.
drop-table tablename [, tablename2 ...]
drop tables[ tablename [, tablename2 ...]
Instrukcja Execute służy do uruchamiania innych programów w czasie, gdy aplikacja QlikView ładuje dane. Na przykład w celu wykonania niezbędnych przekształceń.
Execute commandline
Instrukcja force wymusza w aplikacji QlikView interpretację wartości pól kolejnych instrukcji LOAD i SELECT jako pisanych tylko wielkimi literami, tylko małymi literami, jak nazwy własne lub tak, jak są wyświetlane (mieszane). Ta instrukcja umożliwia powiązanie wartości pól z tabeli utworzonych zgodnie z różnymi konwencjami.
Force ( capitalization | case upper | case lower | case mixed )
Instrukcja LOAD ładuje pola z pliku, z danych zdefiniowanych w skrypcie, z wcześniej załadowanej tabeli, ze strony internetowej, z wyniku późniejszej instrukcji SELECT lub przez automatyczne wygenerowanie danych.
Load [ distinct ] *fieldlist
[( from file [ format-spec ] |
from_field fieldassource [format-spec]
inline data [ format-spec ] |
resident table-label |
autogenerate size )]
[ where criterion | while criterion ]
[ group_by groupbyfieldlist ]
[order_by orderbyfieldlist ]
Instrukcja let, uzupełniająca instrukcję set, służy do określania zmiennych skryptu. W odróżnieniu od instrukcji set instrukcja let powoduje obliczenie wartości wyrażenia po prawej stronie operatora „=” przed przypisaniem jej do zmiennej.
Let variablename=expression
Instrukcja Loosen Table umożliwia jawne deklarowanie wewnętrznych tabel danych QlikView jako luźno powiązanych na etapie wykonywania skryptu. Jeśli w skrypcie występuje jakakolwiek instrukcja Loosen Table, aplikacja QlikView zignoruje wszelkie ustawienia tabel luźno powiązanych obowiązujące przed wykonaniem skryptu.
loosen-table tablename [ , tablename2 ...]
Loosen Tables tablename [ , tablename2 ...]
Instrukcja map ... using służy do mapowania określonej wartości pola lub wyrażenia na wartości we wskazanej tabeli mapowania. Tabelę mapowania tworzy się instrukcją Mapping.
Map *fieldlist Using mapname
Instrukcja NullAsNull wyłącza konwersję wartości NULL na wartości ciągów znaków ustawione wcześniej przez instrukcję NullAsValue.
NullAsNull *fieldlist
Instrukcja NullAsValue określa, dla których pól wartość NULL powinna być przekształcona w wartość.
NullAsValue *fieldlist
Instrukcja Qualify służy do przełączania kwalifikacji nazw pól, na przykład aby nazwy te przyjmowały jako prefiks nazwę tabeli.
Qualify *fieldlist
Instrukcja rem służy do wstawiania komentarzy do skryptu lub tymczasowego dezaktywowania instrukcji w skrypcie bez usuwania ich.
Rem string
Ta funkcja skryptu zmienia nazwy istniejących pól aplikacji QlikView po ich załadowaniu.
rename-field (using mapname | oldname to newname{ , oldname to newname })
Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Ta funkcja skryptu zmienia nazwy istniejących tabel wewnętrznych aplikacji QlikView po ich załadowaniu.
rename-table (using mapname | oldname to newname{ , oldname to newname })
Rename Tables (using mapname | oldname to newname{ , oldname to newname })
Instrukcja section pozwala określić, czy następujące po niej instrukcje LOAD i SELECT mają być traktowane jako dane czy jako definicje praw dostępu.
Section (access | application)
Pola są wybierane ze źródła danych ODBC lub dostawcy OLE DB z użyciem standardowych instrukcji SELECT języka SQL. Akceptacja instrukcji SELECT zależy jednak od używanego sterownika ODBC lub dostawcy OLE DB.
Select [all | distinct | distinctrow | top n [percent] ] *fieldlist
From tablelist
[Where criterion ]
[Group by fieldlist [having criterion ] ]
[Order by fieldlist [asc | desc] ]
[ (Inner | Left | Right | Full)Join tablename on fieldref = fieldref ]
Instrukcja set jest używana do określania zmiennych skryptu. Mogą one służyć do zastępowania ciągów znaków, ścieżek, dysków itp.
Set variablename=string
Instrukcja sleep wstrzymuje wykonanie skryptu przez określony czas.
Sleep n
Instrukcja SQL umożliwia wysłanie dowolnego polecenia SQL przez połączenie ODBC lub OLE DB.
SQL sql_command
Instrukcja sqlcolumns zwraca zestaw pól opisujących kolumny źródła danych ODBC lub OLE DB, do którego utworzono połączenie connect.
Instrukcja sqltables zwraca zestaw pól opisujących tabele źródła danych ODBC lub OLE DB, do którego utworzono połączenie connect.
Instrukcja sqltypes zwraca zestaw pól opisujących typy źródła danych ODBC lub OLE DB, do którego utworzono połączenie connect.
Ciąg danych używany na potrzeby reprezentacji zestawu wszystkich danych pola w bazie danych można ustawić przy użyciu instrukcji star. Wpływa on na następne instrukcje LOAD i SELECT.
Star is [ string ]
Ta funkcja skryptu tworzy plik QVD lub CSV.
Store [ *fieldlist from] table into filename [ format-spec ];
Ta funkcja skryptu jest metodą przypisywania znaczników do pól. W przypadku próby oznaczenia nazwy pola niewystępującej w dokumencie oznaczanie zostanie zignorowane. W przypadku znalezienia niezgodnych wystąpień pola lub znacznika używana jest ostatnia wartość.
Tag fields fieldlist using mapname
Tag field fieldname with tagname
Instrukcja trace zapisuje ciąg znaków w oknie Postęp wykonania skryptu oraz w pliku dziennika skryptu (jeśli jest używany). Może być bardzo przydatna do celów debugowania. Komunikat taki można dostosować przy użyciu rozszerzeń „$” zmiennych obliczanych przed instrukcją trace.
Trace string
Instrukcja Unmap powoduje dezaktywację mapowania wartości pola określonej w poprzedniej instrukcji Map … Using dla kolejno ładowanych pól.
Unmap *fieldlist
Instrukcja Unqualify służy do wyłączania kwalifikowania nazw pól, które zostało wcześniej włączone przy użyciu instrukcji Qualify.
Unqualify *fieldlist
Udostępnia metodę usuwania znaczników z pól. W przypadku próby usunięcia znacznika nazwy pola niewystępującej w dokumencie usuwanie znacznika zostanie zignorowane. Jeśli zostaną znalezione wystąpienia nazwy pola lub znacznika, które powodują konflikt, użyta zostaje ostatnia wartość.
Untag fields fieldlist using mapname
Untag field fieldname with tagname