Die Include/Must_Include-Variable spezifiziert eine Datei, die in das Skript mit einbezogen und als Skript-Code evaluiert werden sollte. Sie wird nicht zum Hinzufügen von Daten verwendet. Sie können Teile Ihres Script-Codes in einer separaten Textdatei speichern und in verschiedenen Apps verwenden. Dies ist eine benutzerdefinierte Variable.
Syntax:
$(Include=filename)
$(Must_Include=filename)
Es gibt zwei Versionen der Variable:
- Include generiert keinen Fehler, wenn die Datei nicht gefunden werden kann. Sie schlägt im Hintergrund fehl.
- Must_Include generiert einen Fehler, wenn die Datei nicht gefunden werden kann.
Wenn Sie keinen Pfad angeben, wird der Dateiname auf das Arbeitsverzeichnis der Qlik Sense-App bezogen. Sie können auch einen absoluten Dateipfad oder einen Pfad zu einer lib://-Ordnerverbindung angeben. Setzen Sie kein Leerzeichen vor oder nach dem Gleichheitszeichen.
Beispiele:
$(Include=abc.txt);
$(Must_Include=lib://DataFiles/abc.txt);
Einschränkungen
Eingeschränkte gegenseitige Kompatibilität zwischen UTF-8-codierten Dateien unter Windows und unter Linux.
Es ist optional, UTF-8 mit BOM (Byte Order Mark) zu verwenden. BOM kann die Nutzung von UTF-8 in Software beeinträchtigen, die keine Nicht-ASCII-Bytes am Beginn einer Datei erwartet, aber den Textstream ansonsten handhaben könnte.
Windows-Systeme verwenden BOM in UTF-8, um zu identifizieren, dass eine Datei UTF-8-codiert ist, trotz des Umstands, dass keine Zweideutigkeit im Byte-Speicher vorhanden ist.
Unix/Linux nutzen UTF-8 für Unicode, aber nicht BOM, da dies die Syntax für Befehlsdateien beeinflusst.
Dies hat verschiedene Auswirkungen für Qlik Sense.
In Windows wird jede Datei, die mit einem UTF-8 BOM beginnt, als UTF-8-Skriptdatei betrachtet. Andernfalls wird ANSI-Codierung vorausgesetzt.
In Linux ist die 8-Bit-Codeseite des Systemstandards UTF-8. Daher funktioniert UTF-8 auch ohne BOM.
Infolgedessen kann keine Übertragbarkeit garantiert werden. Es ist nicht immer möglich, eine Datei unter Windows zu erstellen, die von Linux interpretiert werden kann, und umgekehrt. Aufgrund der unterschiedlichen Handhabung von BOM besteht keine gegenseitige Kompatibilität zwischen den beiden Systemen hinsichtlich UTF-8-codierter Dateien.
Weitere Informationen finden Sie unter Byte Order Mark.
Einfügen von QVS-Code aus Bereichen in Qlik Cloud Analytics
In Qlik Cloud Analytics können Sie beim Laden von Daten aus einer Datendatei innerhalb eines Ladeskripts einen LOAD-Befehl verwenden oder QVS-Code einfügen. In beiden Fällen können im Skript hierarchische Bereichsordnerstrukturen referenziert werden. Folgen Sie den Regeln für gültige Bereichsordnerpfade. Zusätzlich müssen die Datei und alle referenzierten Ordner bereits an dem angegebenen Speicherort vorhanden sein. Andernfalls schlägt der Ladevorgang fehl.
Beispiel: Referenzieren einer QVS-Datei im Pfad der obersten Ebene eines Bereichs
In diesem Beispiel wird die Datei test.qvs im Ladeskript referenziert. Die Datei befindet sich in dem Bereich TeamSharedSpace. Die Datei befindet sich nicht innerhalb eines bestimmten Ordners, sondern im Pfad der obersten Ebene im Bereich.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)Beispiel: Referenzieren der Datei QVS in einem bestimmten Ordnerpfad innerhalb eines Bereichs
In diesem Beispiel wird die Datei test.qvs im Ladeskript referenziert. Die Datei befindet sich im Ordner SalesData innerhalb des Bereichs TeamSharedSpace.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)Weitere Informationen zum Referenzieren der Bereichsordnerstruktur in Ladeskripten finden Sie unter Referenzieren der Ordnerstruktur im Bereich bei der Entwicklung von Apps und Skripten.