Include
Variabeln Include/Must_Include specificerar en fil 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)
$(Must_Include=filename)
Det finns två versioner av variabeln:
- Include genererar inte ett del om det inte går att hitta filen, den misslyckas i tysthet.
- Must_Include genererar ett fel om det inte går att hitta filen.
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.
Exempel:
$(Include=abc.txt);
$(Must_Include=lib://DataFiles/abc.txt);
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-analys
I Qlik Cloud-analys 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.