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 可能会干扰 UTF-8 在软件中的使用,该软件不希望在文件的开头使用非 ASCII 字节,但可以处理文本流。
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。这就是为什么 UTF-8 可以工作的原因,尽管它不包含 BOM。
因此,无法保证便携性。在 Windows 上创建一个可以被 Linux 解释的文件并非总是可能,反之亦然。由于对 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)
有关在加载脚本中引用空间文件夹结构的详细信息,请参阅在应用程序和脚本开发中引用空间文件夹结构。