Variabeln Include/Must_Include specificerar ett skript som innehåller text som ska inkluderas i skriptet och utvärderas som skriptkod. Den används inte för att lägga till data. Du kan spara delar av skriptkoden i en separat textfil och återanvända den i flera appar. Detta är en användardefinierad variabel.
Syntax:
$(Include=filename)
$(Include=script ID)
$(Must_Include=filename)
$(Must_Include=script ID)
Det finns två versioner av variabeln:
- Include genererar inte ett fel om skriptet inte kan hittas och du meddelas inte.
- Must_Include genererar ett fel om skriptet inte kan hittas.
Om du arbetar med filer och om du inte anger en sökväg blir filnamnet relativt till Qlik Sense-appens arbetskatalog. Du kan också ange en absolut sökväg till filen, eller en sökväg till lib://-katalogens anslutning. Det får inte finnas något blanksteg före eller efter likhetstecknet. Om du arbetar med andra skript, kan du ange skriptet genom att följa script:// med skript-ID:t.
Exempel:
$(Include=abc.txt);
$(Include=script://a01b2c34-5de6-789f-g0hi-1j2k3l45m6n7);
$(Must_Include=lib://DataFiles/abc.txt);
Behörigheter för att infoga skript
Flera skriptformat kan infogas i dina skript. QVF- och QVS-format rekommenderas och erbjuder ett grafiskt användargränssnitt för att automatiskt generera Include satsens syntax.
Beroende på formatet på skriptet du infogar, krävs olika behörighetsnivåer för skriptet som du infogar. Dessa behörigheter kan krävas för att använda det grafiska gränssnittet för skriptinfogning, omladdning av skript, eller båda.
| Format för infogat skript | Obligatorisk roll i utrymme som innehåller det infogade skriptet |
|---|---|
| QVF (fristående skripttillgång) |
|
| QVS eller annat textformat |
|
Begränsningar
Begränsad kompatibilitet mellan Windows och Linux för UTF-8-kodade filer.
Det är valfritt att använda UTF-8 med BOM (Byte Order Mark). BOM kan störa användningen av UTF-8 i program som inte förväntar sig icke-ASCII-byte i början av en fil, men som annars skulle kunna hantera textströmmen.
Windows-system använder BOM i UTF-8 för att identifiera att en fil är UTF-8-kodad, trots att det inte råder någon tveksamhet om hur lagring i byte ska ske.
Unix/Linux använder UTF-8 för Unicode men använder inte BOM, eftersom detta stör syntaxen i kommandofiler.
Detta medför vissa konsekvenser för Qlik Sense.
I Windows identifieras alla filer som börjar med en UTF-8 BOM som en UTF-8-skriptfil. Annars antas att ANSI-kodning används.
I Linux är UTF-8 systemets standardkodsida för 8 bitar. Därför fungerar UTF-8 fastän den inte innehåller någon BOM.
Portabilitet kan därför inte garanteras. En fil som skapas i Windows kan inte alltid tolkas av Linux och vice versa. För UTF-8-kodade filer finns ingen tvärkompatibilitet mellan systemen eftersom de hanterar BOM på olika sätt.
Mer information finns i Byte order mark.
Infoga QVS-kod från utrymmen i Qlik Cloud Analytics
I Qlik Cloud Analytics kan du använda en LOAD-sats eller infoga QVS-kod när du laddar data från en datafil i ett laddningsskript. I båda fallen kan hierarkiska mappstrukturer för utrymmen refereras i skriptsatsen. Följ reglerna för giltiga mappsökvägar i utrymmet. Filen och alla refererade mappar måste redan finnas på den angivna platsen. I annat fall misslyckas inläsningen.
Exempel: Referenser till QVS-fil på översta sökvägen i ett utrymme
I detta exempel refereras filen test.qvs i laddningsskriptet. Filen är placerad i utrymmet TeamSharedSpace. Filen är inte placerad i någon specifik mapp, utan finns i stället i den översta sökvägen i utrymmet.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)Exempel: Referens till QVS-fil i en specifik mappsökväg inom ett utrymme
I detta exempel refereras filen test.qvs i laddningsskriptet. Filen är placerad i mappen SalesData inom utrymmet TeamSharedSpace.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)Se Referera till utrymmets mappstruktur vid utveckling av appar och skript för mer information om hänvisning till mappstrukturen i utrymmen i laddskript.