# Include

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

Примечание к информацииВ Qlik Sense и Qlik Sense Desktop эта переменная поддерживает только ссылки на подключения к данным папок. Ссылки на файлы в облачных хранилищах поставщиков не поддерживаются.

Синтаксис:

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

Для получения дополнительной информации см. [Метка порядка байтов](https://en.wikipedia.org/wiki/Byte_order_mark)