Табличные отчеты в управляемых пространствах
Можно создавать табличные отчеты для приложений, требующих строгого управления данными. Используя те же принципы, что при разработке моделей данных приложения для применения в управляемых пространствах, можно подготовить приложение для работы со встроенными функциями отчетности. Это обеспечивается с помощью синтаксиса с учетом пространства в скрипте загрузки.
При разработке приложения для публикации в управляемом пространстве учитывайте следующее:
Шаблон можно разработать до или после публикации приложения. Если шаблон создается до публикации, измените подключенное приложение после публикации.
Список рассылки необходимо добавить в приложение до публикации. В процессе разработки он может содержать фиктивные источники данных вместо фактических. Скрипт загрузки ссылается на источники из списка рассылки, поэтому его необходимо составить в процессе подготовки к публикации, используя синтаксис с учетом пространства. Этот синтаксис автоматически используется по умолчанию, если в качестве исходного файла загружается список рассылки.
После публикации ресурсы отчетности (шаблон, фильтры и задачи отчета) можно повторно создавать по необходимости в зависимости сценария применения отчетности для опубликованного приложения. Следует добавить реальные источники данных, используемые в списке рассылки, в управляемое пространство.
Существующие конфигурации табличного отчета
Если конфигурация отчета и список рассылки созданы до 26 марта 2024 года, необходимо ознакомиться с изменениями в процессе загрузки файлов для списков рассылки.
Для приложений, созданных до 26 марта 2024 года, исходный файл списка рассылки, загруженный в раздел Отчетность, автоматически переименовывался и добавлялся в пространство. Затем ссылка на этот переименованный файл автоматически добавлялась в скрипт загрузки. Теперь загруженный исходный файл не переименовывается при добавлении в пространство.
Чтобы продолжить пользоваться существующими конфигурациями отчетов при публикации этих приложений, следуйте инструкциям в соответствующем разделе ниже (в зависимости от источников списка рассылки). В качестве альтернативы, можно повторно создать конфигурацию отчета с нуля, следуя инструкциям ниже на этой странице.
Если загружен исходный файл
Откройте Редактор загрузки данных и просмотрите ссылки на имена файлов в разделе скрипта Список рассылки. Внесите изменения в синтаксис, чтобы использовались ссылки с учетом пространства, указывающие на текущее пространство, а не на какое-то конкретное пространство. Например, ссылка на файл может выглядеть так:
FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"
Измените ее следующим образом:
FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"
Как видите, имя файла содержит идентификатор исходного приложения. Если требуется запустить именно этот скрипт при публикации приложения, добавьте фактический файл списка рассылки в управляемое пространство, указав точно такое же имя.
В качестве альтернативы, можно переименовать исходный файл в пространстве разработки, обновить скрипт загрузки, а затем выполнить публикацию. В завершение, добавьте фактический файл списка рассылки с обновленным именем.
Если в скрипт вручную добавлены удаленные источники
Если же скрипт загрузки настроен вручную с целью использования других источников данных для списка рассылки, просто необходимо внести изменения в скрипт загрузки, указав относительные ссылки с учетом пространства на источники данных (если это еще не сделано).
Для получения дополнительной информации и конкретных примеров см. раздел Источники данных для приложений в управляемых пространствах.
Рабочий процесс
Следуйте приведенной ниже процедуре при работе с табличными отчетами в управляемом пространстве.
Разработка приложения
В пространстве разработки (личном или общем) как обычно создайте приложение, предназначенное для публикации в управляемом пространстве.
Разработка шаблонов и фильтров
Если требуется, можно создать шаблон отчета и фильтры до публикации приложения. Это может быть полезным в качестве подготовительного этапа разработки приложения, но шаблоны и фильтры, добавленные в исходное приложение, не сохраняются в опубликованном экземпляре.
Если шаблон создан до публикации и его требуется использовать для опубликованного приложения, измените подключенное приложение Qlik Sense для шаблона. Это действие можно выполнить в надстройке. Альтернативный вариант ― выполнить это действие в приложении Qlik Sense при загрузке шаблона в опубликованное приложение. См. раздел Изменение подключенного приложения Qlik Sense.
Подготовка ссылки на список рассылки
Когда список рассылки добавляется в приложение, изменяется его скрипт загрузки. Скрипт загрузки приложения недоступен в опубликованном приложении. По этой причине список рассылки необходимо добавлять в приложение до публикации.
На этом этапе список рассылки нужен в качестве местозаполнителя для фактического файла или других источников, которые будут использоваться для списка рассылки в управляемом пространстве.
Процедура немного отличается в зависимости от того, является список рассылки исходным файлом или удаленным источником данных, добавленным в скрипт вручную. Однако в основе процедуры лежат одни и те же принципы. Для получения полных инструкций по использованию синтаксиса с учетом пространства в скрипте загрузки см. раздел Источники данных для приложений в управляемых пространствах.
Вариант 1. Прямая загрузка исходного файла
Следуйте обычной процедуре для загрузки исходного файла в качестве списка рассылки. Добавление списка рассылки путем загрузки исходного файла.
Вместо добавления финализированных данных получателя можно вставить любые местозаполнители. Здесь важно загрузить файл, который затем автоматически добавляется в пространство разработки, а ссылка на него добавляется в скрипт.
Проверьте, что раздел Distribution List в скрипте загрузки содержит ссылку на файл с учетом пространства, и не ссылается напрямую на конкретное пространство. Это выполнятся автоматически при загрузке исходного файла в качестве списка рассылки в раздел Отчетность приложения. Это должно выглядеть следующим образом:
FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"
Это пример ссылки с учетом пространства, которая указывает на текущее пространство, где находится приложение. Дополнительное двоеточие перед DataFiles формирует необходимую относительную ссылку.
Позже, при публикации приложения в управляемом пространстве, загрузите фактический файл списка рассылки в это управляемое пространство. Фактический список рассылки должен иметь то же имя файла, которое указано в скрипте.
Вариант 2. Добавление ссылок на источники данных в скрипт вручную
Следуйте обычной процедуре, чтобы вручную подключиться к удаленным источникам списка рассылки в скрипте. Определение списка рассылки вручную в скрипте загрузки.
В процессе написания скрипта для подключения к требуемым источникам данных для списка рассылки, при необходимости можно использовать фиктивные ссылки на файлы и подключения. В скрипте источники данных просто должны иметь те же имена, которые у них будут в управляемом пространстве, а для ссылок на эти источники необходимо использовать относительный синтаксис с учетом пространства.
Публикация приложения
После подготовки скрипта загрузки и списка рассылки приложение готово к публикации в управляемом пространстве. Для получения дополнительной информации о публикации приложений см. Публикация приложений.
Изменение подключенного приложения Qlik Sense
Если шаблон отчета создан до публикации приложения, его необходимо обновить, указав ссылку на правильный идентификатор приложения. Опубликованный экземпляр приложения и исходное приложение имеют разные идентификаторы.
Этот процесс может быть завершен в надстройке Qlik для Microsoft Excel, или в Qlik Sense при загрузке шаблона. Прежде чем начинать, можно создать отдельную копию шаблона, присвоив ей имя, отличное от имени шаблона исходного приложения.
Для получения полных инструкций см.:
Из надстройки Qlik для Microsoft Excel: Изменение подключенного приложения Qlik Sense
Из Qlik Sense: Изменение подключенного приложения Qlik Sense
Всегда есть возможность разрабатывать и обновлять свои шаблоны в управляемом пространстве напрямую.
Добавление фактических источников списка рассылки
В управляемом пространстве создайте необходимые файлы и подключения для загрузки списка рассылки, указанного в скрипте загрузки. Это действие можно выполнить в любое время.
Источники данных, предоставляющие список рассылки, должны содержать те же имена параметров (имена подключений, файлов и полей), что источники списка рассылки в скрипте загрузки исходного приложения.
После добавления подключенных источников в пространство можно будет перезагрузить приложение.
Создание новых ресурсов отчетности
Теперь можно добавить в приложение ресурсы отчетности. К ним относятся шаблон, фильтры и задачи отчета.
Разрешения
Работать с табличными отчетами для приложения могут пользователи, которым назначены следующие роли в управляемом пространстве:
Владелец
Может управлять
Может выполнять задачи оператора (только для Право пользователя «Профессионал» или Full User)
Для получения дополнительной информации см. раздел Управление разрешениями в управляемых пространствах.
Ограничения
Табличные отчеты недоступны для приложений, публикуемых или распространяемых из Client-Managed Qlik Sense (включая многооблачные развертывания) в Qlik Cloud. Чтобы использовать табличные отчеты с этими приложениями, перенесите приложение в Qlik Cloud с помощью инструментов миграции (см. раздел Настройка инструментов миграции Qlik Cloud), или вручную экспортируйте приложение и повторно загрузите его в Qlik Cloud.
Для получения дополнительной информации см. раздел Табличная отчетность при работе с экспортированными или перенесенными приложениями.