Include

Zmienna Include/Must_Include określa skrypt, 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)

$(Include=script ID)

$(Must_Include=filename)

$(Must_Include=script ID)

Istnieją dwie wersje zmiennej:

• Include nie generuje błędu, jeśli nie można znaleźć skryptu; nie pojawia się żadna informacja o niepowodzeniu.
• Must_Include generuje błąd, jeśli nie można znaleźć skryptu.

Jeśli podczas pracy z plikami ś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. W przypadku pracy z innymi skryptami można określić skrypt, dodając identyfikator skryptu do script://.

Przykłady:  

$(Include=abc.txt);

$(Include=script://a01b2c34-5de6-789f-g0hi-1j2k3l45m6n7);

$(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ę.

$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)

$(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.