Тестирование пакетов содержимого шаблонов для Power BITesting template content packs for Power BI

Существует несколько способов протестировать пакет содержимого перед его отправкой для публикации.There are multiple ways to test your content pack before submitting it for publishing.

Примечание

Если ваш пакет содержимого использует разработанный вами соединитель данных, вы не сможете проверить обновление данных или пакета содержимого шаблона, как описано ниже.If your content pack uses a custom Data Connector that you developed, you will not be able to test the data refresh or the template content pack as described below. В таком случае переходите к этапу отправки своего пакета содержимого. Его проверит для вас команда специалистов по Power BI.If that is the case, please proceed to submit your content pack and the Power BI team will work with you on testing your content pack.

Тестирование обновления данных по расписаниюTesting Scheduled Data Refresh

Пакеты содержимого шаблона используют обновление на сайте PowerBI.com для создания экземпляра пакета содержимого с данными клиента при подключении.Template content packs leverage Refresh in PowerBI.com to instantiate a content pack with the customer's data when they connect. Прежде чем пакет содержимого станет общедоступным, можно проверить этот поток с помощью созданного файла Desktop.Prior to the content pack being publicly available, you can test this flow with the Desktop file you've created.

После отправки файла выберите "..." рядом с набором данных и затем "Запланировать обновление".After uploading the file, select the "…" next to the dataset and select Schedule Refresh. Настройте учетные данные для источника.Configure credentials for the source. Убедитесь, что обновление набора данных выполнено успешно, попробуйте использовать элементы "Обновить сейчас" и "Запланированные обновления".Make sure that your dataset refreshes successfully, try both "Refresh Now" and "Scheduled Refresh". Если при обновлении возникают сбои, просмотрите сообщение об ошибке, а также поверьте запросы и конечную систему.If your refresh hits any failures, check the error message and validate your queries and your end system.

Дополнительные советы по обновлениюAdditional refresh tips

  • При попытке запланировать обновление должен обнаруживаться только один источник данных.Only one data source should be detected when you try to schedule refresh
  • Тестовое подключение должно демонстрировать, что пользователь сможет загрузить пакет содержимого.Test connection should indicate that your user will be able to load the content pack. Если это не так, включите в запросы обработку дополнительных типов ошибок.If that's not the case, ensure your queries handle the additional error cases.
  • Обновление должно завершаться в разумные сроки, рекомендуемая длительность около 5 минут.Refresh should complete in a reasonable time, ~5mins is suggested

настройки

Тестирование шаблоновTesting Templates

Пакет содержимого шаблона аналогичен существующим решениям за исключением того, что он не включает фактические данные в набор данных.A template content pack is similar to existing solutions except that it does not include the actual data in the dataset. Вместо этого, когда пользователь применяет шаблон или создает его экземпляр, ему выводится запрос на ввод параметров и учетных данных для подключения.Instead, when a user consumes or instantiates a template, they are prompted for parameters and credentials in order to connect. После подключения они видят собственные данные на панели мониторинга, в отчетах и наборах данных.Once connected, they'll see their own data in the dashboard, report and datasets.

После создания экземпляра пакета содержимого пользователь получает доступ к настройкам наборов данных, в частности к графику обновления. Никакие настройки RLS в наборе данных не публикуются вместе с пакетом содержимого.After a user instantiates the content pack they have access to the dataset settings including scheduled refresh, any RLS settings on the dataset are not published with the content pack.

Примечание

Пакеты содержимого шаблонов могут содержать только одну панель мониторинга, один отчет и один набор данных.Template content packs can only include 1 dashboard, 1 report and 1 dataset. Ознакомьтесь со списком ограничений на странице создания.Please see the list of restrictions in the authoring page.

Чтобы иметь возможность создавать шаблоны в своем клиенте, попросите администратора Power BI активировать для вас показанную ниже функцию.To enable template creation for your tenant, please work with your Power BI admin to enable the feature switch below.

переключатель функции

Если эта функция включена, в нижней части окна Создание пакета содержимого отображается флажок, который позволяет опубликовать шаблон пакета содержимого в вашей организации.Once enabled, you'll see a checkbox at the bottom of "Create content pack", allowing you to publish a template content pack to your organization.

флажок

ИменованиеNaming

Рекомендуется назначить панели мониторинга, отчету и набору данных согласованные имена в рамках пакета содержимого.We suggest naming your dashboard, report and dataset consistently across your content pack. Эти имена жестко запрограммированы и будут одинаковыми для всех пользователей, поэтому можно указать имя продукта или сценария, чтобы клиентам было проще найти его.These names are hardcoded and will be the same for all users, so using your product/scenario name can make it easier for your customers to locate.

Дополнительные советы по шаблонуAdditional template tips

  • Убедитесь, что параметры, указанные в запросах, имеют значение для конечных пользователей.Ensure the parameters you specified in the queries are meaningful to your end users
  • Определите, как долго конечный пользователь будет ожидать завершения запланированного обновления.Consider how long your end user will be waiting for scheduled refresh to complete

создание

ОтправкаSubmission

Процесс отправки с помощью Microsoft AppSource позволяет опубликовать пакет содержимого шаблона в коллекции пакетов содержимого служб в PowerBI.com, а также включить ваш пакет содержимого список в список Microsoft AppSource.The submission process through Microsoft AppSource will allow you to publish your template content pack in the service content packs gallery in PowerBI.com as well as list your content pack in Microsoft AppSource.

Перед отправкойBefore submission

  • Просмотрите советы по разработке для каждого из артефактов в пакете содержимого.Review the authoring tips for each of the artifacts within the content pack
  • Выполните тестирование и подключение, используя разные учетные записи и данные.Test and connect with various accounts and data conditions. (Пропустите этот шаг, если вы разработали собственный соединитель данных.)(Skip this step if you developed your own custom Data Connector)
  • Тщательно проверьте все визуальные элементы на наличие ошибок.Review all visuals, look carefully for misspelled items
  • Убедитесь, что пакет содержимого правильно реагирует на вопросы и ответы. Мы рекомендуем провести тестирование для всей модели данных, используя не меньше 30 разных вопросов.Ensure the content pack responds well to Q&A, we suggest testing at least 30 varied questions across the data model. (Пропустите этот шаг, если вы разработали собственный соединитель данных.)(Skip this step if you developed your own custom Data Connector)

ОтправкаSubmission

Когда все будет готово к отправке, перейдите на страницу отправки приложений на AppSource и отправьте нужные сведения.Once ready to submit, visit the Apps submission page on AppSource and submit your information. Обязательно выберите в списке доступных продуктов Power BI.Please make sure to select Power BI from the available list of products

Команда специалистов по Power BI рассмотрит заявку и свяжется с вами. Это необходимо для подтверждения того, что все артефакты соответствуют требованиям.The Power BI team will review your submission and will reach out to you to ensure all the artifacts meets the submission requirements. Помимо всестороннего анализа мы также проверим качество панели мониторинга и отчетов, чтобы убедиться, что они соответствуют описанному в приложении бизнес-сценарию.In addition to being complete, we'll also validate the quality of the dashboard and reports provided ensuring they meet the business scenario described in the application.

ОбновленияUpdates

Обновление пакета содержимого происходит аналогично исходной подаче заявки.Updating your content pack follows a similar flow to the original submission.