# Include

Include/Must\_Include 變數會指定包含應該納入指令碼並且評估為指令碼之文字的檔案。這不是用來新增資料。您可以將指令碼的各部分儲存在獨立文字檔中，並在數個應用程式中重複使用。 這是使用者定義的變數。

資訊備註在 Qlik Sense 和 Qlik Sense Desktop 中，此變數僅支援對資料夾資料連線的參考。不支援參考基於雲端的儲存提供者中的檔案。

語法：

$(Include=filename)

$(Must\_Include=filename)

存在兩個版本的變數：

* Include 在找不到檔案時不會產生錯誤，而是將自動失敗。
* Must\_Include 在找不到檔案時產生錯誤。

如果您未指定路徑，而檔案名稱將與 Qlik Sense 應用程式工作目錄相關。您也可以指定一個絕對檔案路徑，或指向 lib:// 資料夾連線的路徑。請勿在等號之前或之後放置空格字元。

資訊備註建構 set Include =filename 不適用。

範例：

$(Include=abc.txt);

$(Must\_Include=lib://DataFiles/abc.txt);

## 限制

### Windows 與 Linux 之下的 UTF-8 編碼檔案之間的交叉相容性有限。

可以選擇使用 UTF-8 與 BOM (位元組順序標記)。BOM 會在啟動檔案時影響沒有預期非 ASCII 位元組的軟體中 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 的處理方式不同，兩個系統之間對於 UTF-8 編碼檔案沒有交叉相容性。

如需詳細資訊，請參閱[位元組順序標記](https://en.wikipedia.org/wiki/Byte_order_mark)