Перейти к основному содержимому

Include

НА ЭТОЙ СТРАНИЦЕ

Include

Переменная Include/Must_Include указывает файл, содержащий текст, который необходимо включить в скрипт и который рассматривается в качестве кода скрипта. Она не используется для добавления данных. Можно сохранять часть кода скрипта в отдельный текстовый файл и использовать его в разных приложениях. Эта переменная определяется пользователем.

Примечание: Эта переменная поддерживает только подключения к данным в папке в стандартном режиме.

Синтаксис:

$(Include=filename)

$(Must_Include=filename)

Существует две версии переменной.

  • Переменная Include не создает ошибку, если не удалось найти файл, и сообщение об ошибке не отображается.
  • Переменная Must_Include создает ошибку, если не удалось найти файл.

Если не указать путь, имя файла будет отнесено к рабочему каталогу приложения Qlik Sense. Можно также указать абсолютный путь файла или путь к подключению к папке lib://. Перед знаком равенства или после него не следует ставить пробел.

Примечание: Конструкция set Include =filename не применяется.

Примеры:  

$(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.

Для получения дополнительной информации см. Метка порядка байтов