Include

Include/Must_Include変数は、スクリプトにインクルードしてスクリプト コードとして評価する必要があるテキストが格納されたスクリプトを指定します。 データの追加には使用されません。スクリプト コードの一部を別のテキスト ファイルに保存して、複数のアプリで再利用することができます。 これはユーザー定義変数です。

構文:

$(Include=filename)

$(Include=script ID)

$(Must_Include=filename)

$(Must_Include=script ID)

この変数には、次の 2 つのバージョンがあります。

• Include は、スクリプトが見つからなくてもエラーを生成せず、サイレントに失敗します。
• Must_Include は、スクリプトが見つからない場合にエラーを生成します。

ファイルを操作する場合、パスを指定しないと、ファイル名は Qlik Sense アプリの作業ディレクトリを基準とした相対的な名前になります。絶対ファイル パス、または lib:// フォルダー接続へのパスも指定できます。等号の前後にスペース文字を入れないでください。他のスクリプトを使用する場合は、script:// の後にスクリプト ID を指定してスクリプトを指定できます。

$(Include=abc.txt);

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

$(Must_Include=lib://DataFiles/abc.txt);  

制限事項

Linux と比べて Windows では、UTF-8 エンコード ファイルの相互互換性が限定されます。

UTF-8 と BOM (バイト オーダー マーク) の併用はオプションです。ファイルの始めに ASCII 以外のバイトを想定していないソフトウェア内で BOM と UTF-8 を使用すると干渉する場合がありますが、それ以外ではテキスト ストリームを処理できます。

• Windows システムでは、バイト ストレージでのあいまいさがないにもかかわらず、UTF-8 内で BOM を使用してファイルが UTF-8 でエンコードされていることを識別します。

• Unix/Linux では Unicode に UTF-8 を使用しますが、コマンド ファイルの構文と干渉するため BOM は使用しません。

このため、Qlik Sense にいくつかの影響が生じます。

• Windows では、UTF-8 BOM で始まるファイルはいずれも UTF-8 スクリプト ファイルと見なされます。それ以外では、ANSI エンコードと見なされます。

• Linux では、システムの既定 8 ビット コード ページが UTF-8 です。BOM が含まれていなくても UTF-8 が機能するのはこのためです。

この結果、移植性を保証することができません。Linux で解読できるファイルを Windows で作成 (あるいはその逆) できるとは限りません。BOM の処理方法が異なるため、これら 2 つのシステム間には、UTF-8 エンコードのファイルに関する相互互換性がありません。

詳細については、「バイト オーダー マーク」をご覧ください。

Qlik Cloud Analytics のスペースから QVS コードを挿入する

Qlik Cloud Analytics では、ロード スクリプト内でデータ ファイルからデータをロードするときに、LOAD ステートメントを使用したり、QVS コードを挿入したりできます。どちらの場合も、階層的なスペース フォルダー構造をスクリプト ステートメントで参照できます。有効なスペース フォルダー パスのルールに従ってください。さらに、ファイルと参照されるすべてのフォルダーが、指定された場所に既に存在している必要があります。存在していない場合、リロードは失敗します。

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

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

ロード スクリプトでスペース フォルダー構造を参照する方法の詳細については、「アプリおよびスクリプト開発におけるスペース フォルダー構造の参照」を参照してください。