Переменная Include/Must_Include указывает файл, содержащий текст, который необходимо включить в скрипт и который рассматривается в качестве кода скрипта. Она не используется для добавления данных. Можно сохранять часть кода скрипта в отдельный текстовый файл и использовать его в разных приложениях. Эта переменная определяется пользователем.
Синтаксис:
$(Include=filename)
$(Must_Include=filename)
Существует две версии переменной.
- Переменная Include не создает ошибку, если не удалось найти файл, и сообщение об ошибке не отображается.
- Переменная Must_Include создает ошибку, если не удалось найти файл.
Если не указать путь, имя файла будет отнесено к рабочему каталогу приложения Qlik Sense. Можно также указать абсолютный путь файла или путь к подключению к папке lib://. Перед знаком равенства или после него не следует ставить пробел.
Примеры:
$(Include=abc.txt);
$(Must_Include=lib://DataFiles/abc.txt);
Ограничения
Ограниченная перекрестная совместимость между файлами в кодировке UTF-8 под Windows и Linux.
Необязательно использовать UTF-8 с BOM (Byte Order Mark, метка порядка байтов). BOM может мешать использованию UTF-8 в программах, которые не ожидают не-ASCII байтов в начале файла, но которые в противном случае могли бы обрабатывать текстовый поток.
-
Системы Windows используют BOM в кодировке UTF-8, чтобы определить, что файл в кодировке UTF-8, хотя в байтовом хранилище нет неоднозначности.
-
Unix/Linux используют UTF-8 для Unicode, но не используют BOM, так как это мешает синтаксису командных файлов.
Это имеет некоторые последствия для Qlik Sense.
-
В Windows любой файл, начинающийся с BOM UTF-8, считается файлом скрипта UTF-8. В противном случае предполагается кодировка ANSI.
-
В Linux 8-битная системная кодовая страница по умолчанию — UTF-8. Поэтому UTF-8 работает, хотя и не содержит BOM.
В результате переносимость не может быть гарантирована. Не всегда возможно создать файл под Windows, который может быть интерпретирован под Linux, и наоборот. Между двумя системами нет перекрестной совместимости по отношению к файлам в кодировке UTF-8 из-за различной работы с BOM.
Для получения дополнительной информации см. Метка порядка байтов