Переменная 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.
Для получения дополнительной информации см. раздел Метка порядка байтов
Вставка кода QVS из пространств в Аналитика Qlik Cloud
В Аналитика Qlik Cloud при загрузке данных из файла данных в рамках скрипта загрузки можно использовать оператор LOAD или вставить код QVS. В обоих случаях иерархические структуры папок могут быть упомянуты в операторе скрипта. Придерживайтесь правил по правильному указанию путей к папкам пространства. Кроме того, файл и все упоминаемые папки должны уже существовать в указанном местоположении. В противном случае перезагрузка завершится ошибкой.
Пример: Ссылка на файл QVS в пути верхнего уровня пространства
В этом примере в скрипте загрузки есть ссылка на файл test.qvs. Файл расположен в пространстве TeamSharedSpace. Файл не находится в определенной папке, а расположен в пути верхнего уровня в пространстве.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)Пример: Ссылка на файл QVS в определенном пути к папке в пределах пространства
В этом примере в скрипте загрузки есть ссылка на файл test.qvs. Файл расположен в папке SalesData в пространстве TeamSharedSpace.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)Для получения дополнительной информации о том, как ссылаться на структуру папок пространства в скриптах загрузки, см. раздел Ссылка на структуру папок в пространстве при разработке приложений и скриптов.