跳到主要內容 跳至補充內容

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 (獨立指令碼資產)
  • 共用空間:可以編輯可以編輯應用程式中的資料可以管理擁有者

  • 受管理空間:可以操作可以管理擁有者

QVS 或其他文字格式
  • 共用空間:可以取用資料可以編輯可以編輯應用程式中的資料可以管理擁有者

  • 受管理空間:可以取用資料可以操作可以管理擁有者

限制

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)

如需更多關於在載入指令碼中參考空間資料夾結構的資訊,請參閱 在應用程式和指令碼開發中參考空間資料夾結構

此頁面是否對您有幫助?

若您發現此頁面或其內容有任何問題——錯字、遺漏步驟或技術錯誤——請告知我們!