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.
Składnia:
$(Include=filename)
$(Must_Include=filename)
Istnieją dwie wersje zmiennej:
- Include nie generuje błędu, jeśli nie można znaleźć pliku; nie pojawia się żadna informacja o niepowodzeniu.
- Must_Include generuje błąd, jeśli nie można znaleźć pliku.
Jeśli ścieżka nie zostanie określona, nazwa pliku będzie określana względem katalogu roboczego aplikacji Qlik Sense. Można również określić bezwzględną ścieżkę do pliku albo ścieżkę do połączenia do folderu lib://. Nie umieszczaj znaku spacji przed znakiem równości ani po nim.
Przykłady:
$(Include=abc.txt);
$(Must_Include=lib://DataFiles/abc.txt);
Ograniczenia
Ograniczona kompatybilność między systemami w przypadku plików zakodowanych w UTF-8 w systemie Windows i Linux.
Używanie kodowania UTF-8 z BOM (Byte Order Mark) jest opcjonalne. BOM może kolidować podczas używania UTF-8 w oprogramowaniu, które nie oczekuje bajtów innych niż ASCII na początku pliku, ale mogłoby obsłużyć strumień tekstowy bez BOM.
Systemy Windows używają BOM w UTF-8 do identyfikacji, że plik jest zakodowany w UTF-8, pomimo tego, że kolejność bajtów jest jednoznaczna.
Systemy Unix i Linux używają UTF-8 do Unicode, ale nie używają BOM, ponieważ koliduje to ze składnią plików poleceń.
Ma to pewne konsekwencje dla Qlik Sense.
W systemie Windows każdy plik rozpoczynający się od BOM kodowania UTF-8 jest uważany za plik skryptu w formacie UTF-8. W przeciwnym razie zakłada się kodowanie ANSI.
W systemie Linux domyślną systemową 8-bitową stroną kodową jest UTF-8. Dlatego UTF-8 działa, chociaż nie zawiera BOM.
W rezultacie nie można zagwarantować przenośności. Nie zawsze jest możliwe utworzenie w systemie Windows pliku, który można zinterpretować w systemie Linux i odwrotnie. Nie ma wzajemnej kompatybilności między tymi dwoma systemami w zakresie plików zakodowanych w UTF-8 ze względu na różną obsługę BOM.
Więcej informacji można znaleźć w artykule BOM (informatyka)
Wstawianie kodu QVS z przestrzeni w Analityka Qlik Cloud
W Analityka Qlik Cloud podczas ładowania danych z pliku danych w skrypcie ładowania można użyć instrukcji LOAD lub wstawić kod QVS. W obu przypadkach hierarchiczne struktury folderów przestrzeni można przywoływać w instrukcji skryptu. Przestrzegaj zasad używania prawidłowych ścieżek folderów przestrzeni. Ponadto plik oraz wszystkie foldery, do których się odwołuje, muszą już istnieć w określonej lokalizacji. W przeciwnym razie przeładowanie nie powiedzie się.
Przykład: Odwołanie do pliku QVS na ścieżce najwyższego poziomu w przestrzeni
W tym przykładzie plik test.qvs jest przywoływany w skrypcie ładowania. Plik znajduje się w przestrzeni TeamSharedSpace. Plik nie znajduje się w żadnym konkretnym folderze, tylko na ścieżce najwyższego poziomu w przestrzeni.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)Przykład: Odwołanie do pliku QVS w konkretnej ścieżce folderów w przestrzeni
W tym przykładzie plik test.qvs jest przywoływany w skrypcie ładowania. Plik znajduje się w folderze SalesData w przestrzeni TeamSharedSpace.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)Więcej informacji na temat odwoływania się do struktury folderów w przestrzeni w skryptach ładowania zawiera temat Odwoływanie się do struktury folderów w rozwoju aplikacji i skryptów.