Include
Include/Must_Include 變數會指定包含應該納入指令碼並且評估為指令碼之文字的檔案。這不是用來新增資料。您可以將指令碼的各部分儲存在獨立文字檔中,並在數個應用程式中重複使用。 這是使用者定義的變數。
語法:
$(Include=filename)
$(Must_Include=filename)
存在兩個版本的變數:
- Include 在找不到檔案時不會產生錯誤,而是將自動失敗。
- Must_Include 在找不到檔案時產生錯誤。
如果您未指定路徑,而檔案名稱將與 Qlik Sense 應用程式工作目錄相關。您也可以指定一個絕對檔案路徑,或指向 lib:// 資料夾連線的路徑。請勿在等號之前或之後放置空格字元。
範例:
$(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 編碼檔案沒有交叉相容性。
如需詳細資訊,請參閱位元組順序標記
在 Qlik Cloud 分析 中從空間插入 QVS 程式碼
在 Qlik Cloud 分析 中,在載入指令碼內從資料檔案載入資料時,可以使用 LOAD 陳述式或插入 QVS 程式碼。在這兩種情況下,都可以在指令碼陳述式中參考階層空間資料夾結構。按照有效空間資料夾路徑的規則。此外,該檔案和所有參考的資料夾需要已存在於指定位置。否則,載入會失敗。
範例: 參考空間上層路徑的 QVS 檔案
在此範例中,載入指令碼中參考了檔案 test.qvs。該檔案位於空間 TeamSharedSpace 中。該檔案沒有位於任何特定資料夾中,而是位於空間中的上層路徑。
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)
範例: 參考空間內特定資料夾路徑中的 QVS 檔案
在此範例中,載入指令碼中參考了檔案 test.qvs。該檔案位於空間 TeamSharedSpace 內的資料夾 SalesData 中。
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)
如需更多關於在載入指令碼中參考空間資料夾結構的資訊,請參閱 在應用程式和指令碼開發中參考空間資料夾結構。