Табличные отчеты в управляемых пространствах

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

При разработке приложения для публикации в управляемом пространстве учитывайте следующее:

• Шаблон можно разработать до или после публикации приложения. Если шаблон создается до публикации, используйте надстройку для изменения идентификатора подключенного приложения после публикации.

• Список рассылки необходимо добавить в приложение до публикации. В процессе разработки он может содержать фиктивные источники данных вместо фактических. Скрипт загрузки ссылается на источники из списка рассылки, поэтому его необходимо составить в процессе подготовки к публикации, используя синтаксис с учетом пространства. Этот синтаксис автоматически используется по умолчанию, если в качестве исходного файла загружается список рассылки.

• После публикации ресурсы отчетности (шаблон, фильтры и задачи отчета) можно повторно создавать по необходимости в зависимости сценария применения отчетности для опубликованного приложения. Следует добавить реальные источники данных, используемые в списке рассылки, в управляемое пространство.

Существующие конфигурации табличного отчета

Если конфигурация отчета и список рассылки созданы до 26 марта 2024 года, необходимо ознакомиться с изменениями в процессе загрузки файлов для списков рассылки.

Для приложений, созданных до 26 марта 2024 года, исходный файл списка рассылки, загруженный в раздел Отчетность, автоматически переименовывался и добавлялся в пространство. Затем ссылка на этот переименованный файл автоматически добавлялась в скрипт загрузки. Теперь загруженный исходный файл не переименовывается при добавлении в пространство.

Чтобы продолжить пользоваться существующими конфигурациями отчетов при публикации этих приложений, следуйте инструкциям в соответствующем разделе ниже (в зависимости от источников списка рассылки). В качестве альтернативы, можно повторно создать конфигурацию отчета с нуля, следуя инструкциям ниже на этой странице.

Если загружен исходный файл

Откройте Редактор загрузки данных и просмотрите ссылки на имена файлов в разделе скрипта Список рассылки. Внесите изменения в синтаксис, чтобы использовались ссылки с учетом пространства, указывающие на текущее пространство, а не на какое-то конкретное пространство. Например, ссылка на файл может выглядеть так:

FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"

Измените ее следующим образом:

FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"

Как видите, имя файла содержит идентификатор исходного приложения. Если требуется запустить именно этот скрипт при публикации приложения, добавьте фактический файл списка рассылки в управляемое пространство, указав точно такое же имя.

В качестве альтернативы, можно переименовать исходный файл в пространстве разработки, обновить скрипт загрузки, а затем выполнить публикацию. В завершение, добавьте фактический файл списка рассылки с обновленным именем.

Если в скрипт вручную добавлены удаленные источники

Если же скрипт загрузки настроен вручную с целью использования других источников данных для списка рассылки, просто необходимо внести изменения в скрипт загрузки, указав относительные ссылки с учетом пространства на источники данных (если это еще не сделано).

Для получения дополнительной информации и конкретных примеров см. раздел Источники данных для приложений в управляемых пространствах.

Рабочий процесс

Следуйте приведенной ниже процедуре при работе с табличными отчетами в управляемом пространстве.

Разработка приложения

В пространстве разработки (личном или общем) как обычно создайте приложение, предназначенное для публикации в управляемом пространстве.

Разработка шаблонов и фильтров

Если требуется, можно создать шаблон отчета и фильтры до публикации приложения. Это может быть полезным в качестве подготовительного этапа разработки приложения, но шаблоны и фильтры, добавленные в исходное приложение, не сохраняются в опубликованном экземпляре.

Если шаблон создан до публикации и его требуется использовать для опубликованного приложения, используйте функцию Изменить подключение шаблона в надстройке, чтобы изменить идентификатор подключенного приложения. См. раздел Изменение подключения шаблона.

Подготовка ссылки на список рассылки

Когда список рассылки добавляется в приложение, изменяется его скрипт загрузки. Скрипт загрузки приложения недоступен в опубликованном приложении. По этой причине список рассылки необходимо добавлять в приложение до публикации.

На этом этапе список рассылки нужен в качестве местозаполнителя для фактического файла или других источников, которые будут использоваться для списка рассылки в управляемом пространстве.

Процедура немного отличается в зависимости от того, является список рассылки исходным файлом или удаленным источником данных, добавленным в скрипт вручную. Однако в основе процедуры лежат одни и те же принципы. Для получения полных инструкций по использованию синтаксиса с учетом пространства в скрипте загрузки см. раздел Источники данных для приложений в управляемых пространствах.

Вариант 1. Прямая загрузка исходного файла

Следуйте обычной процедуре для загрузки исходного файла в качестве списка рассылки. Добавление списка рассылки путем загрузки исходного файла.

Вместо добавления финализированных данных получателя можно вставить любые местозаполнители. Здесь важно загрузить файл, который затем автоматически добавляется в пространство разработки, а ссылка на него добавляется в скрипт.

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

FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"

Это пример ссылки с учетом пространства, которая указывает на текущее пространство, где находится приложение. Дополнительное двоеточие перед DataFiles формирует необходимую относительную ссылку.

Позже, при публикации приложения в управляемом пространстве, загрузите фактический файл списка рассылки в это управляемое пространство. Фактический список рассылки должен иметь то же имя файла, которое указано в скрипте.

Вариант 2. Добавление ссылок на источники данных в скрипт вручную

Следуйте обычной процедуре, чтобы вручную подключиться к удаленным источникам списка рассылки в скрипте. Определение списка рассылки вручную в скрипте загрузки.

В процессе написания скрипта для подключения к требуемым источникам данных для списка рассылки, при необходимости можно использовать фиктивные ссылки на файлы и подключения. В скрипте источники данных просто должны иметь те же имена, которые у них будут в управляемом пространстве, а для ссылок на эти источники необходимо использовать относительный синтаксис с учетом пространства.

Публикация приложения

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

Изменение подключения шаблона

Если шаблон отчета создан до публикации приложения, его необходимо обновить, указав ссылку на правильный идентификатор приложения. Опубликованный экземпляр приложения и исходное приложение имеют разные идентификаторы.

Эта процедура выполняется в надстройке Qlik для Microsoft Excel. Прежде чем начинать, можно создать отдельную копию шаблона, присвоив ей имя, отличное от имени шаблона исходного приложения.

Для получения полных инструкций см. раздел Изменение подключенного приложения Qlik Sense.

Если же приложение было опубликовано до создания шаблона, теперь можно создать новый шаблон и подключить его к приложению в управляемом пространстве.

Добавление фактических источников списка рассылки

В управляемом пространстве создайте необходимые файлы и подключения для загрузки списка рассылки, указанного в скрипте загрузки. Это действие можно выполнить в любое время.

Источники данных, предоставляющие список рассылки, должны содержать те же имена параметров (имена подключений, файлов и полей), что источники списка рассылки в скрипте загрузки исходного приложения.

После добавления подключенных источников в пространство можно будет перезагрузить приложение.

Создание новых ресурсов отчетности

Теперь можно добавить в приложение ресурсы отчетности. К ним относятся шаблон, фильтры и задачи отчета.

Разрешения

Работать с табличными отчетами для приложения могут пользователи, которым назначены следующие роли в управляемом пространстве:

• Владелец

• Может управлять

• Может выполнять задачи оператора (только для Право пользователя «Профессионал» или Full User)

Для получения дополнительной информации см. раздел Управление разрешениями в управляемых пространствах.

Ограничения