# Include

Include/Must\_Include 変数は、スクリプトに含められ、スクリプト コードとして評価されるテキストを含むファイルを指定します。データの追加には使用されません。スクリプト コードの一部を別のテキスト ファイルに保存して、複数のアプリケーションで再利用できます。 これはユーザー定義変数です。

情報メモQlik Sense および Qlik Sense Desktop では、この変数はフォルダー データ接続への参照のみをサポートしています。クラウドベースのストレージ プロバイダー内のファイルへの参照はサポートされていません。

構文:

$(Include=filename)

$(Must\_Include=filename)

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

* Include は、ファイルが見つからない場合にエラーを生成しません。失敗した場合、何もしません。
* Must\_Include は、ファイルが見つからない場合にエラーを生成します。

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

情報メモ構文 set Include =filename は適用できません。

$(Include=abc.txt);

$(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 エンコードのファイルに関する相互互換性がありません。

詳細については、「[バイト オーダー マーク](https://en.wikipedia.org/wiki/Byte_order_mark)」をご覧ください。