Отчетность в приложении в управляемых пространствах

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

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

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

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

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

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

Если конфигурация отчета и список рассылки созданы до 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 Sense при загрузке шаблона. Для шаблона отчета Excel это также можно сделать в надстройке Qlik для Microsoft Excel. Прежде чем начинать, можно создать отдельную копию шаблона, присвоив ей имя, отличное от имени шаблона исходного приложения.

Для получения полных инструкций см.:

• Из Qlik Sense: Изменение подключенного приложения Qlik Sense

• Из надстройки Qlik для Microsoft Excel: Изменение подключенного приложения Qlik Sense

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

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

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

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

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

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

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

Разрешения

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

• Владелец

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

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

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

Ограничения