Создание приложения-шаблона в Power BI

В этой статье содержатся пошаговые инструкции по созданию приложения шаблона Power BI. Приложения шаблонов Power BI позволяют партнерам Power BI создавать приложения Power BI без написания кода и развертывать их в любом клиенте Power BI.

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

Администраторы Power BI управляют и управляют тем, кто в своей организации может создавать приложения-шаблоны и устанавливать их. Авторизованные пользователи могут установить свое приложение-шаблон, изменить его и распространить его пользователям Power BI в своих организациях.

Необходимые компоненты

Ниже приведены требования к созданию приложения-шаблона:

Создание рабочей области шаблона

Чтобы создать приложение-шаблон, которое можно распространить в другие клиенты Power BI, необходимо создать его в рабочей области.

  1. В служба Power BI создайте рабочую область, как описано в статье "Создание рабочей области в Power BI". В разделе "Дополнительно" выберите "Разработка приложения-шаблона".

    Screenshot that shows Develop a template app.

    Важно!

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

  2. После создания рабочей области нажмите кнопку "Сохранить".

Примечание.

Для повышения уровня приложений шаблонов требуются разрешения администратора Power BI.

Добавление содержимого в рабочую область приложения-шаблона

Как и в обычной рабочей области Power BI, следующим шагом является добавление содержимого в рабочую область. Если вы используете параметры в Power Query, убедитесь, что они имеют хорошо определенные типы, например Text. Типы Any и Binary не поддерживаются.

Рекомендации по созданию отчетов и панелей мониторинга для приложения-шаблона см. в Советы для разработки приложений шаблонов в Power BI.

Определение свойств приложения-шаблона

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

  1. В рабочей области приложения-шаблона выберите "Создать приложение".

    Screenshot that shows Create app.

    Затем введите дополнительные параметры для приложения-шаблона на шести вкладках.

  2. На вкладке фирменной символики заполните следующие поля:

    • Название приложения
    • Description
    • Сайт поддержки. Ссылка на поддержку отображается в разделе сведений о приложении после повторного распространения приложения-шаблона в качестве организационного приложения.
    • Логотип приложения. Логотип имеет ограничение размера файла 45 КБ, должно иметь пропорции 1:1 и должно находиться в формате .png, .jpg или .jpeg файла.
    • Цвет темы приложения

    Screenshot that shows the Branding tab.

  3. На вкладке "Навигация" можно включить построитель навигации для определения области навигации приложения.

    Screenshot that shows the Navigation tab.

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

  4. На вкладке "Элемент управления" задайте ограничения и ограничения пользователей приложения для содержимого приложения. Этот элемент управления можно использовать для защиты интеллектуальной собственности в приложении.

    Screenshot that shows the Control tab.

    Примечание.

    Если вы хотите защитить данные, отключите параметр "Скачать отчет в файл ", а затем настройте остальные два варианта в нужное значение.

    Зачем?

    Элементы управления представления, редактирования и экспорта на этой вкладке применяются только к служба Power BI. Скачав PBIX-файл , он больше не находится в службе. Он помещает копию данных, незащищенную, в расположении, выбранном пользователем. После этого у вас больше нет контроля над тем, что пользователь может сделать с ним.

    Если вы хотите ограничить доступ к запросам и мерам, позволяя пользователям добавлять собственные источники данных, рассмотрите возможность проверка только экспорт или внешнее подключение к параметрам данных. Это позволяет пользователям добавлять собственные источники данных, не изменяя семантику модели. Дополнительные сведения см. в статье "Использование составных моделей в Power BI Desktop".

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

    Screenshot that shows the Parameters tab.

    Каждый параметр имеет имя, которое поступает из запроса, и поле "Значение ". Во время установки существует три варианта получения значения параметра:

    • Пользователю, который устанавливает приложение, можно ввести значение.

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

      Screenshot of a parameter value required from the user.

    • Вы можете указать предварительно заполненное значение, которое пользователь, который устанавливает приложение, не может измениться.

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

      Чтобы настроить параметр таким образом, введите значение в текстовое поле "Значение ", а затем выберите значок блокировки, чтобы значение не было изменено. В следующем примере показан этот параметр:

      Screenshot of an absolute parameter value.

    • Вы можете указать значение по умолчанию, которое пользователь может изменить во время установки.

      Чтобы настроить параметр таким образом, введите требуемое значение по умолчанию в текстовом поле "Значение " и оставьте значок блокировки разблокирован, как показано в следующем примере:

      Screenshot of a changeable default parameter value.

    На этой вкладке также можно указать ссылку на документацию по приложению.

  6. На вкладке "Проверка подлинности" выберите используемый метод проверки подлинности . Доступные параметры зависят от используемых типов источников данных.

    Screenshot that shows the Authentication tab.

    Уровень конфиденциальности настраивается автоматически:

    • Один источник данных автоматически настраивается как частный.
    • Многоанонимный источник данных автоматически настраивается как общедоступный.
  7. На этапе тестирования на вкладке Access выберите, кто другой в вашей организации может установить и протестировать приложение. Вы вернеесь и измените эти параметры позже. Параметр не влияет на доступ к приложению распределенного шаблона.

    Screenshot of the Access tab.

  8. Выберите Создать приложение.

    Появится сообщение о готовности тестового приложения с ссылкой на копирование и предоставление общего доступа к тестировщикам приложений.

    Screenshot of the message that the test app is ready.

    Вы также выполнили первый шаг следующего процесса управления выпусками.

Управление выпуском приложения-шаблона

Перед общедоступным выпуском приложения-шаблона необходимо убедиться, что оно готово. В области управления выпусками Power BI можно следовать и проверять полный путь выпуска приложения. Вы также можете активировать переход с этапа на этап. Распространенные этапы:

  • Создайте тестовое приложение только для тестирования в организации.
  • Повышение уровня тестового пакета до предварительной стадии и тестирования за пределами вашей организации.
  • Повышение уровня предварительной версии пакета до рабочей версии в Рабочей среде.
  • Удалите любой пакет или начните с предыдущего этапа.

URL-адрес не изменяется при перемещении между этапами выпуска. Повышение не влияет на сам URL-адрес.

Чтобы пройти этапы выпуска, выполните следующие действия.

  1. В рабочей области шаблона выберите "Управление выпусками".

    Screenshot that shows Release Management in the template workspace.

  2. Если вы выполнили действия, описанные в этой статье, чтобы создать тестовое приложение, точка рядом с тестированием уже будет заполнена. Нажмите кнопку "Получить ссылку".

    Если приложение еще не создано, нажмите кнопку "Создать приложение ", чтобы запустить процесс создания приложения шаблона.

    Screenshot of the Release Management pane with Get link highlighted.

  3. Чтобы проверить работу установки приложения, скопируйте ссылку в окне и вставьте ее в новое окно браузера.

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

  4. В диалоговом окне выберите "Установить".

  5. После успешной установки выберите приложение в списке приложений , чтобы открыть его.

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

  7. Когда вы будете готовы повысить уровень приложения до предварительной среды для тестирования за пределами клиента, вернитесь в область "Управление выпусками " и выберите "Повысить уровень приложения".

    Screenshot of the Release Management pane with Promote app highlighted.

    Примечание.

    При продвижении приложения оно становится общедоступным за пределами вашей организации.

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

  8. В диалоговом окне выберите "Повысить".

  9. Скопируйте новый URL-адрес, чтобы предоставить общий доступ за пределами клиента для тестирования. Эта ссылка также является той, которую вы отправляете, чтобы начать процесс распространения приложения в AppSource, создав новое предложение Центра партнеров.

    Отправьте только предварительные ссылки в Центр партнеров. После утверждения приложения вы получите уведомление о том, что оно опубликовано в AppSource, вы можете повысить уровень пакета до рабочей среды в Power BI.

  10. Когда приложение готово к рабочей среде или совместному использованию с помощью AppSource, вернитесь в область "Управление выпусками" и выберите "Повысить уровень приложения " рядом с предварительной средой.

  11. Выберите "Продвинуть".

    Теперь ваше приложение находится в рабочей среде и готово к распространению.

    Screenshot of the Release Management pane with the app in production.

Чтобы сделать приложение широко доступным для пользователей Power BI во всем мире, отправьте его в AppSource. Дополнительные сведения см. в предложении "Создание приложения Power BI".

Автоматизация конфигурации параметров во время установки

Если вы являетесь независимым поставщиком программного обеспечения и распространяете приложение шаблона через веб-службу, вы можете создать автоматизацию, которая настраивает параметры приложения шаблона автоматически при установке приложения в Power BI. Автоматическая настройка упрощает работу клиентов и повышает вероятность успешной установки, так как клиентам не нужно предоставлять сведения, которые они могут не знать. Дополнительные сведения см. в статье "Автоматическая настройка установки приложения шаблона".