Modyfikacje skryptu ładowania
Qlik Cloud nie obsługuje ścieżek systemu plików Windows w funkcjach, instrukcjach i zmiennych. Zamiast tego używane są połączenia bibliotek, które są ciągami połączeń z plikami danych i skryptów, na przykład lib://DataFiles/myData.txt.
Ograniczenia
Niektórych instrukcji, zmiennych i funkcji stosowanych w QlikView i Qlik Sense zarządzanym przez klienta (w trybie standardowym lub starszej wersji) nie można używać w Qlik Cloud lub mają one ograniczenia. Ograniczenia te są zwykle nakładane na instrukcje, zmienne i funkcje powiązane ze ścieżkami systemu plików Windows.
Użycie nieobsługiwanej instrukcji w skrypcie ładowania danych spowoduje błąd przy wykonywaniu skryptu ładowania. Komunikaty o błędach można znaleźć w pliku dziennika skryptu. Użycie nieobsługiwanej zmiennej lub funkcji nie jest sygnalizowane żadnym komunikatem o błędzie ani wpisem w pliku dziennika. Funkcja zwróci jedynie wartość NULL.
Podczas edytowania skryptu ładowania danych nie są wyświetlane żadne informacje o użyciu nieobsługiwanej zmiennej, instrukcji lub funkcji.
Stosowalność zmiennych, instrukcji i funkcji w Qlik Cloud
Jeśli planujesz ponowne używanie skryptów ładowania danych z QlikView lub Qlik Sense zarządzanego przez klienta w Qlik Cloud, zapoznaj się z poniższymi tabelami, aby sprawdzić, które zmienne, instrukcje i funkcje są obsługiwane oraz jakie są ich wymagania.
Zmienne systemowe
Zmienna | Zastosowanie | Definicja |
---|---|---|
Floppy |
Nieobsługiwane |
Zwraca literę napędu pierwszego znalezionego napędu dyskietek (zwykle jest to a:). |
CD |
Nieobsługiwane |
Zwraca literę napędu pierwszego znalezionego napędu CD-ROM. Jeśli żaden napęd CD-ROM nie zostanie znaleziony, wówczas zostanie zwrócona litera c:. |
QvPath |
Nieobsługiwane |
Zwraca ciąg przeglądania ścieżki pliku wykonywalnego Qlik Sense. |
QvRoot |
Nieobsługiwane |
Zwraca katalog główny pliku wykonywalnego programu Qlik Sense. |
QvWorkPath |
Nieobsługiwane |
Zwraca ciąg znaków przeglądania do bieżącej aplikacji Qlik Sense. |
QvWorkRoot |
Nieobsługiwane |
Zwraca katalog główny bieżącej aplikacji Qlik Sense. |
WinPath |
Nieobsługiwane |
Zwraca ciąg znaków przeglądania do systemu Windows. |
WinRoot |
Nieobsługiwane |
Zwraca katalog główny systemu Windows. |
$(include=...) | Obsługiwane dane wejściowe: Ścieżka używająca połączenia z biblioteką | Zmienna Include/Must_Include określa plik, który zawiera tekst, jaki powinien zostać umieszczony w skrypcie i oceniony jako kod skryptu. Nie służy do dodawania danych. Można przechowywać części kodu skryptu w oddzielnym pliku tekstowym i używać ich wielokrotnie w wielu aplikacjach. Jest to zmienna definiowana przez użytkownika. |
Zwykłe instrukcje skryptu
Instrukcja | Zastosowanie | Definicja |
---|---|---|
Binary | Obsługiwane dane wejściowe: Ścieżka używająca połączenia z biblioteką | Instrukcja binary służy do ładowania danych z innej aplikacji. |
Connect | Nieobsługiwane | Instrukcja CONNECT służy do określania dostępu aplikacji Qlik Sense 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. |
Directory | Obsługiwane dane wejściowe: Ścieżka używająca połączenia z biblioteką | Instrukcja Directory określa, w którym katalogu należy szukać plików danych w kolejnych instrukcjach LOAD, do momentu wydania nowej instrukcji Directory. |
Execute | Nieobsługiwane | Instrukcja Execute służy do uruchamiania innych programów w czasie, gdy aplikacja Qlik Sense ładuje dane. Na przykład w celu wykonania niezbędnych przekształceń. |
LOAD from ... | Obsługiwane dane wejściowe: Ścieżka używająca połączenia z biblioteką | 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. |
Store into ... | Obsługiwane dane wejściowe: Ścieżka używająca połączenia z biblioteką | Instrukcja Store tworzy plik QVD, Parquet, CSV lub TXT. |
Instrukcje sterowania skryptem
Instrukcja | Obsługiwane dane wejściowe | Zwracane dane wyjściowe | Definicja |
---|---|---|---|
For each... filelist mask/dirlist mask |
połączenie z biblioteką |
połączenie z biblioteką |
Konstrukcja filelist mask tworzy rozdzieloną przecinkami listę wszystkich plików w bieżącym katalogu zgodnych z filelist mask. Konstrukcja dirlist mask tworzy rozdzieloną przecinkami listę wszystkich katalogów w bieżącym katalogu zgodnych z maską nazwy katalogu. |
Funkcje pliku
Funkcja | Obsługiwane dane wejściowe | Zwracane dane wyjściowe | Definicja |
---|---|---|---|
Attribute() | połączenie z biblioteką | Zwraca wartość metaznaczników różnych plików multimedialnych w postaci tekstu. | |
ConnectString() | Nazwa połączenia biblioteki | Zwraca aktywne parametry połączenia dla połączeń ODBC lub OLE DB. | |
FileDir() |
|
połączenie z biblioteką | Funkcja FileDir zwraca ciąg znaków zawierający ścieżkę do katalogu aktualnie odczytywanego pliku tabeli. |
FilePath() |
|
połączenie z biblioteką | Funkcja FilePath zwraca ciąg znaków zawierający pełną ścieżkę do aktualnie odczytywanego pliku tabeli. |
FileSize() |
połączenie z biblioteką |
Funkcja FileSize zwraca liczbę całkowitą zawierającą rozmiar (w bajtach) pliku filename albo, jeśli nie określono parametru filename, aktualnie odczytywanego pliku tabeli. | |
FileTime() |
połączenie z biblioteką |
Funkcja FileTime zwraca znacznik czasu w formacie UTC ostatniej modyfikacji określonego pliku. Jeżeli nie określono pliku, funkcja zwróci znacznik czasu w formacie UTC ostatniej modyfikacji aktualnie odczytywanego pliku tabeli. | |
GetFolderPath() |
Nieobsługiwane |
Zwracane dane wyjściowe: Ścieżka bezwzględna |
Funkcja GetFolderPath zwraca wartość funkcji Microsoft Windows SHGetFolderPath. Ta funkcja przyjmuje na wejściu nazwę folderu Microsoft Windows i zwraca pełną ścieżkę do tego folderu. |
QvdCreateTime() | połączenie z biblioteką | Ta funkcja skryptu zwraca znacznik czasu z nagłówkiem XML z ewentualnego pliku QVD. W przeciwnym wypadku zwraca wartość NULL. W znaczniku czasu jest określany czas UTC. | |
QvdFieldName() | połączenie z biblioteką | Funkcja skryptu zwraca nazwę numeru pola (fieldno) w pliku QVD. Jeśli nie istnieje, zwracana jest wartość NULL. | |
QvdNoOfFields() | połączenie z biblioteką | Ta funkcja skryptu zwraca liczbę pól w pliku QVD. | |
QvdNoOfRecords() | połączenie z biblioteką | Ta funkcja skryptu zwraca liczbę rekordów aktualnie istniejących w pliku QVD. | |
QvdTableName() | połączenie z biblioteką | Ta funkcja skryptu zwraca nazwę tabeli zapisaną w pliku QVD. |
Funkcje systemowe
Funkcja | Zastosowanie | Definicja |
---|---|---|
DocumentPath() |
Nieobsługiwane |
Ta funkcja zwraca ciąg znaków zawierający pełną ścieżkę do bieżącej aplikacji Qlik Sense. |
GetRegistryString()
|
Nieobsługiwane |
Zwraca wartość nazwanego klucza rejestru o podanej ścieżce rejestru. Funkcji tej można używać zarówno w wykresach, jak i w skryptach. |