Создание пакетов содержимого шаблонов в Power BIAuthor template content packs in Power BI

При создании пакета содержимого шаблонов используются Power BI Desktop и PowerBI.com. Пакет содержимого включает четыре компонента:Authoring a template content pack uses the Power BI Desktop and PowerBI.com. There are four components to your content pack:

Каждый из этих элементов может быть вам знаком как существующая функция Power BI.You may be familiar with each piece as existing Power BI features. При создании пакета содержимого необходимо учитывать дополнительные параметры по каждому аспекту. Дополнительные сведения см. в следующем разделе.When building a content pack, there are additional things to consider for each aspect, see each section below for more details.

ЗапросыQueries

В пакетах содержимого шаблонов запросы, созданные в Power BI Desktop, используются для подключения к источникам данных и импорта данных.For template content packs, queries developed in the Power BI Desktop are used to connect to your data source and import data. Эти запросы необходимы для получения согласованных схем и позволяют обновлять данные по расписанию (прямые запросы не поддерживаются).These queries are required to return a consistent schema and are supported for Scheduled Data refresh (direct query is not supported).

Каждый пакет содержимого шаблона поддерживает только один источник данных, поэтому будьте внимательны при составлении запросов.Template content packs only support one data source per content pack so define your queries carefully. Один источник данных — это источник, для которого требуется единая процедура аутентификации.A single data source is defined as a source that requires the same authentication. Вы можете создавать несколько вызовов API в разных запросах, если все эти вызовы обращаются к одной и той же конечной точке API и проходят аутентификацию одного типа.You can make multiple API calls in different queries if all the calls are to the same API endpoint and use the same authentication. Пакеты содержимого Power BI не поддерживают несколько источников, которые проходят аутентификацию разных типов.Power BI content packs do not support multiple sources that require different authentications.

Подключение к APIConnect to your API

Чтобы приступить к созданию запросов, нужно подключиться к API из Power BI Desktop.To get started, you will need to connect to your API from Power BI Desktop to start building your queries.

Для подключения к API можно использовать стандартные соединители данных, доступные в Power BI Desktop.You can use the Data Connectors that are available out of the box in Power BI Desktop to connect to your API. Вы можете использовать соединитель веб-данных ("Получить данные" -> "Интернет"), чтобы подключиться к REST API, или соединитель OData ("Получить данные" -> "Канал OData"), чтобы подключиться к каналу OData.You can use the Web Data Connector (Get Data -> Web) to connect to your Rest API or the OData connector (Get Data -> OData feed) to connect to your OData feed. Обратите внимание, что эти соединители будут работать по умолчанию, только если API поддерживает обычную аутентификацию.Please note that these connectors will work out of the box only if your API supports Basic Authentication.

Примечание

Если API использует другие типы аутентификации (например, с использованием OAuth 2.0 или ключа веб-API), вам нужно разработать собственный соединитель данных, чтобы разрешить Power BI Desktop подключиться к API, пройдя аутентификацию.If your API uses any other authentication types, like OAuth 2.0 or Web API Key, then you will need to develop your own Data Connector to allow Power BI Desktop to successfully connects and authenticates to your API. Дополнительные сведения о том, как разработать собственный соединитель данных для пакета содержимого, см. здесь.For details on how to develop your own Data Connector for your Content Pack, check the Data Connectors documentation here.

Зависимость от источникаConsider the source

Запросы определяют, какие данные будут включены в модель данных.The queries define the data that will be included in the data model. В зависимости от размера вашей системы такие запросы также должны включать фильтры, гарантирующие, что ваши клиенты будут работать с контролируемым размером, соответствующим вашему бизнес-сценарию.Depending on the size of your system, these queries should also include filters to ensure your customers are dealing with a manageable size that fits your business scenario.

Пакеты содержимого Power BI могут параллельно выполнять сразу несколько запросов для нескольких пользователей.Power BI content packs can execute multiple queries in parallel and for multiple users concurrently. Заранее продумайте стратегию регулирования и согласования и спросите нас, как сделать ваш пакет содержимого устойчивым к сбоям.Plan ahead your throttling and concurrency strategy and ask us how to make your content pack fault tolerant.

Применение схемыSchema enforcement

Убедитесь, что ваши запросы устойчивы к изменениям в системе, так как изменения в схеме в момент обновления могут нарушить модель.Ensure your queries are resilient to changes in your system, changes in schema on refresh can break the model. Если в ответ на некоторые запросы источник может выдавать пустой результат или сообщать об отсутствии схемы, можно настроить возврат пустой таблицы или сообщений об ошибках, которые будут понятны пользователю.If the source could return null/missing schema result for some queries, consider returning an empty table or throw a custom error messages that is meaningful to your user.

ПараметрыParameters

Параметры в Power BI Desktop позволяют пользователям указывать входные значения для настройки извлекаемых данных.Parameters in Power BI Desktop allow your users to provide input values that customize the data retrieved by the user. Заранее продумайте параметры, чтобы избежать дополнительной работы после создания подробных запросов или отчетов.Think of the parameters upfront to avoid rework after investing time to build detailed queries or reports.

Примечание

Пакеты содержимого шаблонов сейчас поддерживают только текстовые параметры.Template content packs only support text parameters currently. В процессе разработки можно использовать другие типы параметров, но при тестировании все указанные пользователями значения будут буквенными.Other parameter types can be used during development but during the testing portion all values provided by the users will be literal.

Дополнительные рекомендации по запросамAdditional query tips

  • Убедитесь, что все столбцы набраны правильно.Ensure all columns are typed appropriately
  • Столбцы имеют информативные имена (см. "Вопросы и ответы").Columns have informative names (see Q&A)
  • Для совместно используемой логики можно применять функции и запросы.For shared logic, consider using functions or queries
  • Служба пока не поддерживается уровнями конфиденциальности. Если вы получили запрос об уровнях конфиденциальности, перепишите запрос таким образом, чтобы он задействовал относительные пути.Privacy levels are not currently supported in the service - if you get a prompt about privacy levels, you may need to re-write the query to use relative paths

Модель данныхData Model

Четко определенная модель данных позволит вашим клиентам легко и интуитивно понятно взаимодействовать с пакетом содержимого.A well-defined data model will ensure your customers can easily and intuitively interact with the content pack. Создайте модель данных в Power BI Desktop.Create the data model in the Power BI Desktop.

Примечание

Основное моделирование (типизация, имена столбцов) должно осуществляться преимущественно с использованием запросов.Much of the basic modelling (typing, column names) should be done in the queries.

Вопросы и ответыQ&A

От моделирования также зависит, насколько хорошие результаты предоставит функция вопросов и ответов вашим клиентам.The modelling will also affect how well Q&A can provide results for your customers. Добавьте синонимы к часто используемым столбцам и следите за тем, чтобы столбцы были правильно указаны в запросах.Ensure you add synonyms to commonly used columns and that your columns are properly named in the queries.

Дополнительные рекомендации по модели данныхAdditional data model tips

  • Ко всем столбцам значений применено форматирование.All value columns have formatting applied >[!NOTE] >В запросе должны применяться типы.Types should be applied in the query.
  • Ко всем мерам применено форматирование.All measures have formatting applied
  • Выбрано формирование сводных данных по умолчанию,Default Summarization is set. в частности "Не суммировать", если применимо (например, для уникальных значений).Especially "Do Not Summarize", when applicable (for unique values for example)
  • Задана категория данных, если применимо.Data Category has been set, when applicable
  • Отношения заданы, если это необходимо.Relationships are set, as necessary

ОтчетыReports

Страницы отчета позволяют получить более глубокий анализ данных, включенных в пакет содержимого.The report pages offer additional insight into the data included in your content pack. Используйте их для получения ответов на основные вопросы, для решения которых был создан пакет содержимого.Use the pages of the reports to answer the key business questions your content pack is trying to address. Отчеты создаются с помощью Power BI Desktop.Create the report using the Power BI Desktop.

Примечание

В пакет содержимого можно включить только один отчет. Обращаться к конкретным разделам сценария можно при помощи разных страниц.Only one report may be included in a content pack, take advantage of the different pages to call out particular sections of your scenario.

Дополнительные рекомендации по отчетамAdditional report tips

  • Для перекрестной фильтрации используйте больше одного визуального элемента на страницу отчета.Use more than one visual per page for cross-filtering
  • Тщательно выравнивайте визуальные элементы (избегайте наложения).Align the visuals carefully (no overlapping)
  • Выбирайте для макета режим "4:3" или "16:9".Page is set to "4:3" or "16:9" mode for layout
  • Все представленные агрегаты должны иметь смысл (средние, уникальные значения).All of the aggregations presented make numeric sense (averages, unique values)
  • Фрагментирование должно давать адекватные результаты.Slicing produces rational results
  • Как минимум в верхней части отчета должен присутствовать логотип.Logo is present on at least the top report
  • По возможности элементы должны быть представлены в цветах клиента.Elements are in the client's color scheme to the extent possible

Панель мониторингаDashboard

Основным инструментом взаимодействия с пакетом содержимого для ваших клиентов служит панель мониторинга.The dashboard is the main point of interaction with your content pack for your customers. Она должна содержать обзор содержимого пакета, особенно меры, играющие важную роль в вашем бизнес-сценарии.It should include an overview of the content included, especially the important metrics for your business scenario.

Чтобы создать панель мониторинга для пакета содержимого шаблонов, просто отправьте PBIX-файл через меню "Получить данные" > "Файлы" или опубликуйте его непосредственно из Power BI Desktop.To create a dashboard for your template content pack, simply upload your PBIX through Get Data > Files or publish directly from the Power BI Desktop.

Примечание

Сейчас пакеты содержимого шаблонов должны включать один отчет и один набор данных.Template content packs currently require a single report and dataset per content pack. Не закрепляйте на панели мониторинга, используемой в пакете содержимого, содержимое из нескольких отчетов или наборов данных.Do not pin content from multiple reports/datasets onto the dashboard used in the content pack.

Дополнительные рекомендации по панелям мониторингаAdditional dashboard tips

  • Закрепляя плитки на панели мониторинга, придерживайтесь одной общей темы.Maintain the same theme when pinning so that the tiles on your dashboard are consistent
  • Прикрепите к теме логотип, чтобы клиенты знали, откуда пакет.Pin a logo to the theme so consumers know where the pack is from
  • Рекомендуется использовать макет шириной в 5–6 элементов, подходящий для большинства разрешений экранов.Suggested layout to work with most screen resolutions is 5-6 small tiles wide
  • Все плитки на панели мониторинга должны иметь соответствующие заголовки и подписи.All dashboard tiles should have appropriate titles/subtitles
  • Плитки различных сценариев на панели мониторинга можно сгруппировать (вертикально или горизонтально).Consider groupings in the dashboard for different scenarios, either vertically or horizontally

Обзор ограниченийSummary of restrictions

Как указано в предыдущих разделах, в настоящее время пакеты содержимого шаблона имеют следующие ограничения:As listed in the above sections, currently the template content packs have a set of restrictions:

ПоддерживаютсяSupported Не поддерживаетсяNot Supported
Наборы данных, встроенные в PBI DesktopDatasets built in PBI Desktop Наборы данных из других пакетов содержимого или такие входные данные, как файлы ExcelDatasets from other content packs or inputs such as Excel files
Источник данных, поддерживаемый для обновления данных в облаке по расписаниюData source supported for cloud Scheduled Data refresh Прямой запрос и локальное подключениеDirect query or on-prem connecitivty is not supported
Запросы, возвращающие согласованную схему или соответствующие ошибкиQueries returning consistent schema or errors where appropriate Динамические или пользовательские схемыDynamic or custom schemas
Один источник данных на набор данныхOne data source per dataset Несколько источников данных, включая гибридные приложения и URL-адреса, определяемые как множественные источники данныхMultiple data sources such as mashups or URLs that are detected as mutliple data sources
Параметры текстового типаParameters of type text Другие типы параметров (например, дата) или "Список разрешенных значений"Other parameter types (such as date) or "list allowed of values"
Одна панель мониторинга, отчет и набор данныхOne dashboard, report and dataset Несколько панелей мониторинга, отчетов и наборов данныхMultiple dashboards, reports or datasets

Дальнейшие действияNext step

Проверка и отправка содержимого пакетаContent Pack Testing and Submission