Создание ссылки на определенное расположение в мобильных приложениях Power BI

  • Статья

Ссылки можно использовать для прямого доступа к определенному содержимому Power BI, например определенному отчету, странице отчета, панели мониторинга, плитке и т. д.

Существует два основных сценария использования ссылок для доступа к содержимому в мобильных приложениях Power BI:

  • Чтобы открыть Power BI за пределами мобильного приложения, и приземлиться на определенном содержимом. Обычно это сценарий интеграции, в котором вы открываете мобильное приложение Power BI из другого приложения.

  • Переход в Power BI. Обычно это делается при создании пользовательской навигации в Power BI.

В этой статье рассматриваются следующие случаи:

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

  • Использование ссылок внутри Power BI для перехода к определенному содержимому Power BI.

Мобильные приложения поддерживают ссылки на отчеты, включающие параметры строки запроса. Такие ссылки открываются в мобильном приложении, предварительно отфильтрованном в соответствии с условиями, определенными в строке запроса. Дополнительные сведения о создании URL-адресов отчета с параметрами строки запроса см. в разделе "Фильтрация параметров строки запроса отчета" в URL-адресе.

Мобильные приложения также поддерживают передачу параметров в отчеты с разбивкой на страницы через URL-адреса. Дополнительные сведения см. в разделе "Передача параметра отчета" в URL-адресе отчета с разбивкой на страницы .

Если вы хотите связать с определенным элементом в Power BI за пределами мобильного приложения, существует два варианта в зависимости от того, где будет открыта ссылка:

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

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

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

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

  • Если ссылка щелкается на компьютере, откроется соответствующий элемент на веб-портале Power BI.

Ссылка должна начинаться с специального префикса, за которым следует параметры запроса:

http://app.powerbi.com/Redirect?[QUERYPARAMETERS]

Внимание

Если содержимое размещено в специальных центрах обработки данных, таких как правительство, Китай и т. д., ссылка должна начинаться с соответствующего адреса Power BI, например app.powerbigov.us или app.powerbi.cn.

Параметры запроса:

Параметр Стоимость Описание
действие (обязательное) OpenApp
Openreport
OpenDashboard
OpenTile
appId 36 символьный guid Необходимо указать, если вы хотите открыть отчет или панель мониторинга, которая является частью приложения.
Пример: appId=baf4b16d-b5bd-4360-8a3a-51d1242c09b
groupObjectId 36 символьный guid Указывает рабочую область, когда требуется открыть отчет или панель мониторинга, которая не является частью моей рабочей области.
Пример: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30e
dashboardObjectId 36 символьный guid Идентификатор объекта панели мониторинга (если действие OpenDashboard или OpenTile)
Пример: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4a
reportObjectId 36 символьный guid Идентификатор объекта отчета (если действие — OpenReport)
Пример: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cf
tileObjectId 36 символьный guid Идентификатор объекта плитки (если действие — OpenTile)
Пример: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9
reportPage Число reportSection<> Имя страницы, если вы хотите открыть определенную страницу отчета. (если действие — OpenReport)
Пример: reportPage=ReportSection6
bookmarkGuid 36 символьный guid Идентификатор закладки, если вы хотите открыть определенное представление закладки. (если действие — OpenReport)
Пример: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7f
Примечание. Значения формата BookmarkXXXXXXXXXXXXXXXXXXXXXX Не поддерживаются.
ctid 36 символьный guid Идентификатор организации элемента (соответствующий сценариям B2B. Это может быть опущено, если элемент принадлежит организации пользователя)
Пример: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681
Полноэкранный Логический Когда значение true, открывает элемент в полноэкранном режиме. Поддерживается для отчетов, оценки карта, панелей мониторинга и приложений (если целевой элемент приложения является одним из поддерживаемых элементов).
Пример: fullScreen=1

Примечание.

Закладки уровня отчета не имеют формата bookmarkGUID и в настоящее время не могут быть переданы в качестве параметра глубокой ссылки.

Примеры:

В следующих примерах заполнители для значений параметров выделены полужирным шрифтом. Чтобы получить фактические значения, перейдите к служба Power BI, откройте элемент, к которому нужно связаться, и извлеките необходимые значения из URL-адреса элемента.

  • Открытие приложения

    https://app.powerbi.com/Redirect?action=OpenApp& appId=<appid-guid>&ctid=<ctid-guid>

  • Открытие панели мониторинга, которая является частью приложения

    https://app.powerbi.com/Redirect?action=OpenDashboard& appId=<appid-guid>&dashboardObjectId=<dashboardid-guid>&ctid=<ctid-guid>

  • Открытие отчета, который является частью рабочей области, отличной от моей рабочей области

    https://app.powerbi.com/Redirect?Action=OpenReport& reportObjectId=reportid-guid>&groupObjectId=<groupobjectid-guid>&reportPage=ReportSection<num<>

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

Снимок экрана: выделенные ссылки публикации приложения Power BI.

Для отчетов и панелей мониторинга, которые не являются частью приложения, необходимо извлечь идентификаторы объектов, необходимые из URL-адреса элемента. Для этого перейдите к служба Power BI, перейдите к элементу, к которому вы хотите связаться, и найдите нужные значения в URL-адресной строке браузера.

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

  • Чтобы найти идентификатор объекта панели мониторинга 36 символов, перейдите к определенной панели мониторинга, к которой нужно связаться в служба Power BI, и найдите идентификатор объекта панели мониторинга и другие необходимые идентификаторы в указанных местах:

    https://app.powerbi.com/groups/me/dashboards/<dashboard-object-id?ctid=<org-object-id>>

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

    https://app.powerbi.com/groups/me/reports/<report-object-id ReportSection<num>?bookmarkGuid=<bookmark-id>/>

  • Чтобы связаться с элементом в рабочей области, отличной от "Моя рабочая область", необходимо извлечь идентификатор объекта группы. В этом примере показан отчет из рабочей области, отличной от моей рабочей области.

    https://app.powerbi.com/groups/<group-object-id>/reports/<report-object-id>/ReportSection<report-section-num>?ctid=<org-object-id>

Формат ссылки, описанный в этом разделе, ссылается на определенное расположение мобильных приложений Power BI на всех мобильных платформах: iOS, устройства Android и Windows. Этот формат ссылки открывает расположение непосредственно без перенаправления, связанного с методом, описанным в предыдущем разделе. Этот формат можно открыть только на мобильных устройствах с установленным мобильным приложением Power BI.

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

  • Открытие мобильного приложения Power BI

    Используйте эту ссылку, чтобы открыть мобильное приложение Power BI на любом устройстве:

    mspbi://app/

  • Открытие определенной панели мониторинга

    Эта ссылка открывает мобильное приложение Power BI для определенной панели мониторинга:

    mspbi://app/OpenDashboard?DashboardObjectId=<36-character-dashboard-id>

    Чтобы получить идентификатор объекта панели мониторинга 36 символов, перейдите к определенной панели мониторинга в служба Power BI и извлеките ее из URL-адреса. Например, идентификатор объекта панели мониторинга выделен в следующем URL-адресе из служба Power BI:

    https://app.powerbi.com/groups/me/dashboards/<61b7e871-cb98-48ed-bddc-6572c921e270>

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

    mspbi://app/OpenDashboard?DashboardObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248

    Обратите внимание на амперсанд (> между двумя параметрами).

  • Открытие определенной плитки в фокусе

    Эта ссылка открывает определенную плитку в режиме фокусировки в мобильном приложении Power BI:

    mspbi://app/OpenTile?DashboardObjectId=<36-character-dashboard-id&TileObjectId=<36-character-tile-id>>

    Чтобы найти идентификаторы 36-символьной панели мониторинга и объектов плиток, перейдите к определенной панели мониторинга в служба Power BI и откройте плитку в режиме фокусировки. В этом примере выделены идентификаторы панели мониторинга и плиток.

    https://app.powerbi.com/groups/me/dashboards/3784f99f-b460-4d5e-b86c-b6d8f7ec54b7/tiles/565f9740-5131-4648-87f2-f79c4cf9c5f5/infocus

    Чтобы открыть эту плитку непосредственно, ссылка будет:

    mspbi://app/OpenTile?DashboardObjectId=3784f99f-b460-4d5e-b86c-b6d8f7ec54b7&TileObjectId=565f9740-5131-4648-87f2-f79c4cf9c5f5

    Обратите внимание на амперсанд (> между двумя параметрами).

    Если панель мониторинга отсутствует в моей рабочей области, добавьте параметр GroupObjectId, например &GroupObjectId=<36-character-group-id>

  • Открытие определенного отчета

    Эта ссылка открывает определенный отчет в мобильном приложении Power BI:

    mspbi://app/OpenReport?ReportObjectId=<36-character-report-id>

    Чтобы найти идентификатор объекта отчета с 36 символами, перейдите к конкретному отчету в служба Power BI. Следующий URL-адрес из служба Power BI иллюстрирует идентификатор отчета, который необходимо извлечь.

    https://app.powerbi.com/groups/me/reports/df9f0e94-31df-450b-b97f-4461a7e4d300

    Если отчет отсутствует в моей рабочей области, необходимо также добавить &GroupObjectId=<36-character-group-id> либо до, либо после идентификатора отчета. Например, в этом случае глубокая ссылка будет:

    mspbi://app/OpenReport?ReportObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248

    Обратите внимание на амперсанд (> между двумя параметрами).

  • Открытие определенной страницы отчета

    Эта ссылка открывает определенную страницу отчета в мобильном приложении Power BI:

    mspbi://app/OpenReport?ReportObjectId=36-character-report-id>&reportPage=ReportSection<number<>

    Страница отчета называется ReportSection, за которой следует число. Чтобы найти необходимые значения, откройте отчет в служба Power BI, перейдите на определенную страницу отчета и извлеките нужные значения из URL-адреса. Например, выделенные разделы этого URL-адреса представляют значения, которые необходимо открыть на определенной странице отчета:

    https://app.powerbi.com/groups/me/reports/df9f0e94-31df-450b-b97f-4461a7e4d300/ReportSection11

  • Открыть в полноэкранном режиме (только для устройств Windows)

    Для устройств Windows можно также добавить параметр openFullScreen , чтобы открыть определенный отчет в полноэкранном режиме. В следующем примере откроется страница отчета в полноэкранном режиме:

    mspbi://app/OpenReport?ReportObjectId=500217de-50f0-4af1-b345-b81027224033&openFullScreen=true

  • Добавление контекста (необязательно)

    Вы также можете добавить контекст в строку. Затем, если вам нужно связаться с нами, мы можем использовать этот контекст для фильтрации данных, чтобы найти, что относится к вашему приложению. Чтобы добавить контекст, добавьте параметр context=<app-name> в ссылку:

    Например, в следующем примере показана ссылка, содержащая параметр контекста:

    mspbi://app/OpenReport?ReportObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248&context=SlackDeepLinkLink

В мобильных приложениях Power BI ссылки внутри Power BI работают так же, как они работают в служба Power BI.

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

Рекомендации и ограничения

Глубокие ссылки на отчеты с параметром bookmarkGuid поддерживаются в мобильных приложениях только в том случае, если значение параметра bookmarkGuid имеет стандартный формат GUID 36 символов. Ссылки, в которых значение параметра bookmarkGuid имеет формат BookmarkXXXXXXXXXXXXXXXXXXXXXXXXX.

Связанный контент

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