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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Опубликовать приложение

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

Изменить подключенное Qlik Sense приложение

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

Этот процесс может быть автоматически завершен в надстройке Qlik Sense при загрузке шаблона. Для форматов шаблонов на основе Microsoft Office — Excel, PowerPoint или Word — это также можно сделать в соответствующей надстройке. Прежде чем начать, вы можете создать отдельную копию шаблона, чтобы отличить ее от шаблона для исходного приложения.

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

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

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

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

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

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

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

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

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

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

Разрешения

Для работы с отчетностью в приложении для приложений в управляемых пространствах вам необходимо:

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

• Одна из следующих ролей в управляемом пространстве:

  • Владелец

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

  • Может эксплуатировать

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

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

Ограничения