# Include

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

語法：

$(Include=filename)

$(Include=script ID)

$(Must\_Include=filename)

$(Must\_Include=script ID)

存在兩個版本的變數：

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

如果使用檔案，如果您未指定路徑，檔案名稱將與 Qlik Sense 應用程式工作目錄相關。您也可以指定一個絕對檔案路徑，或指向 lib:// 資料夾連線的路徑。請勿在等號之前或之後放置空格字元。如果使用其他指令碼，您可以透過追蹤 script:// 並加上指令碼 ID 來指定指令碼。

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

範例：

$(Include=abc.txt);

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

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

## 插入指令碼的權限

多種指令碼格式可以插入到您的指令碼中。建議使用 QVF 和 QVS 格式，它們提供圖形使用者介面來自動產生Include陳述式語法。

根據您要插入的指令碼格式，您需要不同的權限等級來插入該指令碼。這些權限可能用於指令碼插入的圖形介面、重新載入指令碼，或兩者皆是。

插入的指令碼的空間權限

| 插入的指令碼的格式 | 包含插入的指令碼的空間中的必要角色 |
| --- | --- |
| QVF (獨立指令碼資產) | <ul><li><p>共用空間：<span>可以編輯</span>、<span>可以編輯應用程式中的資料</span>、<span>可以管理</span>或<span>擁有者</span></p></li><li><p>受管理空間：<span>可以操作</span>、<span>可以管理</span>或<span>擁有者</span></p></li></ul> |
| QVS 或其他文字格式 | <ul><li><p>共用空間：<span>可以取用資料</span>、<span>可以編輯</span>、<span>可以編輯應用程式中的資料</span>、<span>可以管理</span>或<span>擁有者</span></p></li><li><p>受管理空間：<span>可以取用資料</span>、<span>可以操作</span>、<span>可以管理</span>或<span>擁有者</span></p></li></ul> |

## 限制

### 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)

## 在 Qlik Cloud 分析 中從空間插入 QVS 程式碼

在 Qlik Cloud 分析 中，在載入指令碼內從資料檔案載入資料時，可以使用 LOAD 陳述式或插入 QVS 程式碼。在這兩種情況下，都可以在指令碼陳述式中參考階層空間資料夾結構。按照[有效空間資料夾路徑](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/manage-data-files-spaces.htm#PathRules)的規則。此外，該檔案和所有參考的資料夾需要已存在於指定位置。否則，載入會失敗。

範例： 參考空間上層路徑的 QVS 檔案

在此範例中，載入指令碼中參考了檔案 test.qvs。該檔案位於空間 TeamSharedSpace 中。該檔案沒有位於任何特定資料夾中，而是位於空間中的上層路徑。

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

範例： 參考空間內特定資料夾路徑中的 QVS 檔案

在此範例中，載入指令碼中參考了檔案 test.qvs。該檔案位於空間 TeamSharedSpace 內的資料夾 SalesData 中。

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

如需更多關於在載入指令碼中參考空間資料夾結構的資訊，請參閱 [在應用程式和指令碼開發中參考空間資料夾結構](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Spaces/manage-data-files-spaces.htm#FolderStructureRefExamples)。