Создание ссылки на определенное расположение в мобильных приложениях 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=00001111-aaaa-2222-bbbb-333cccc4444 |
| groupObjectId | 36 символьный guid | Указывает рабочую область, когда требуется открыть отчет или панель мониторинга, которая не является частью моей рабочей области. Пример: groupObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb |
| dashboardObjectId | 36 символьный guid | Идентификатор объекта панели мониторинга (если действие OpenDashboard или OpenTile) Пример: dashboardObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb |
| reportObjectId | 36 символьный guid | Идентификатор объекта отчета (если действие — OpenReport) Пример: reportObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb |
| tileObjectId | 36 символьный guid | Идентификатор объекта плитки (если действие — OpenTile) Пример: tileObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb |
| reportPage | строка | Имя страницы, если вы хотите открыть определенную страницу отчета. (если действие — OpenReport) Пример: reportPage=ReportSection6 |
| bookmarkGuid | 36 символьный guid | Идентификатор закладки, если вы хотите открыть определенное представление закладки. (если действие — OpenReport) Пример: bookmarkGuid=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Примечание. Значения формата BookmarkXXXXXXXXXXXXXXXXXXXXXX Не поддерживаются. |
| ctid | 36 символьный guid | Идентификатор организации элемента (соответствующий сценариям B2B. Это может быть опущено, если элемент принадлежит организации пользователя) Пример: aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb |
| fullScreen | Логический | Когда значение 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=<&groupObjectId=>&reportPage=ReportSectionnum<>
Как получить правильный формат ссылки
Ссылки на приложения и элементы в приложениях
Для приложений, а также для отчетов и панелей мониторинга, которые являются частью приложения, самый простой способ получить ссылку — перейти в рабочую область приложения и выбрать "Обновить приложение". Откроется интерфейс публикации приложения. Откройте вкладку разрешений и разверните раздел ссылок, чтобы просмотреть ссылки на приложение и все его содержимое. Эти ссылки можно использовать за пределами Power BI для доступа к приложению и его содержимому напрямую.
Ссылки на элементы, не имеющиеся в приложении
Для отчетов и панелей мониторинга, которые не являются частью приложения, необходимо извлечь идентификаторы объектов, необходимые из URL-адреса элемента. Для этого перейдите к служба Power BI, перейдите к элементу, к которому вы хотите связаться, и найдите нужные значения в URL-адресной строке браузера.
В примерах показано, где можно найти идентификаторы, необходимые в URL-адресах элементов, к которым вы хотите связаться.
Чтобы найти идентификатор объекта панели мониторинга 36 символов, перейдите к определенной панели мониторинга, к которой нужно связаться в служба Power BI, и найдите идентификатор объекта панели мониторинга и другие необходимые идентификаторы в указанных местах:
https://app.powerbi.com/groups/me/dashboards/ <
Чтобы найти идентификатор объекта отчета с 36 символами, перейдите к определенному отчету, к которому нужно связаться в служба Power BI, и найдите необходимые идентификаторы, как показано ниже. В этом примере содержится ссылка на определенную страницу отчета и определенную закладку.
https://app.powerbi.com/groups/me/reports/ >
Чтобы связаться с элементом в рабочей области, отличной от "Моя рабочая область", необходимо извлечь идентификатор объекта группы. В этом примере показан отчет из рабочей области, отличной от моей рабочей области.
https://app.powerbi.com/groups/ <group-object-id>/reports/</?ctid=<org-object-id>
Создайте ссылку, которая открывается только на устройстве с установленным мобильным приложением Power BI
Формат ссылки, описанный в этом разделе, ссылается на определенное расположение мобильных приложений 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/ <aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb>
Если панель мониторинга отсутствует в моей рабочей области, необходимо также добавить идентификатор объекта группы либо до, либо после идентификатора панели мониторинга. Показанная глубокая ссылка содержит параметр идентификатора объекта группы, добавленный после идентификатора объекта панели мониторинга:
mspbi://app/OpenDashboard?DashboardObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb&GroupObjectId=cccccccc-2222-3333-4444-dddddddddddd
Обратите внимание на амперсанд (> между двумя параметрами).
Открытие определенной плитки в фокусе
Эта ссылка открывает определенную плитку в режиме фокусировки в мобильном приложении Power BI:
mspbi://app/OpenTile?DashboardObjectId=>
Чтобы найти идентификаторы 36-символьной панели мониторинга и объектов плиток, перейдите к определенной панели мониторинга в служба Power BI и откройте плитку в режиме фокусировки. В этом примере выделены идентификаторы панели мониторинга и плиток.
https://app.powerbi.com/groups/me/dashboards/ aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/tiles/cccccccc-2222-3333-4444-dddddddddddd/infocus
Чтобы открыть эту плитку непосредственно, ссылка будет:
mspbi://app/OpenTile?DashboardObjectId=aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb&TileObjectId=cccccccc-2222-3333-4444-dddddddddddd
Обратите внимание на амперсанд (> между двумя параметрами).
Если панель мониторинга отсутствует в моей рабочей области, добавьте параметр 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/ dddddddd-3333-4444-5555-eeeeeeeeeeee
Если отчет отсутствует в моей рабочей области, необходимо также добавить &GroupObjectId=<36-character-group-id> либо до, либо после идентификатора отчета. Например, в этом случае глубокая ссылка будет:
mspbi://app/OpenReport?ReportObjectId=dddddddd-3333-4444-5555-eeeeeeeeeeee&GroupObjectId=ffffffff-5555-6666-7777-aaaaaaaaaaaa
Обратите внимание на амперсанд (> между двумя параметрами).
Открытие определенной страницы отчета
Эта ссылка открывает определенную страницу отчета в мобильном приложении Power BI:
mspbi://app/OpenReport?ReportObjectId=<>&reportPage=ReportSectionnumber<>
Страница отчета называется ReportSection, за которой следует число. Чтобы найти необходимые значения, откройте отчет в служба Power BI, перейдите на определенную страницу отчета и извлеките нужные значения из URL-адреса. Например, выделенные разделы этого URL-адреса представляют значения, которые необходимо открыть на определенной странице отчета:
https://app.powerbi.com/groups/me/reports/ dddddddd-3333-4444-5555-eeeeeeeeeeee/ReportSection11
Добавление контекста (необязательно)
Вы также можете добавить контекст в строку. Затем, если вам нужно связаться с нами, мы можем использовать этот контекст для фильтрации данных, чтобы найти, что относится к вашему приложению. Чтобы добавить контекст, добавьте параметр context=<app-name> в ссылку:
Например, в следующем примере показана ссылка, содержащая параметр контекста:
mspbi://app/OpenReport?ReportObjectId=dddddddd-3333-4444-5555-eeeeeeeeeeee&GroupObjectId=eeeeeeee-4444-5555-6666-ffffffffffff&context=SlackDeepLink
Использование ссылок внутри Power BI
В мобильных приложениях Power BI ссылки внутри Power BI работают так же, как они работают в служба Power BI.
Если вы хотите добавить ссылку на отчет, указывающий на другой элемент Power BI, можно просто скопировать URL-адрес этого элемента из адресной строки браузера. Дополнительные сведения см. в статье "Добавление гиперссылки в текстовое поле в отчете".
Рекомендации и ограничения
Глубокие ссылки на отчеты с параметром bookmarkGuid поддерживаются в мобильных приложениях только в том случае, если значение параметра bookmarkGuid имеет стандартный формат GUID 36 символов. Ссылки, в которых значение параметра bookmarkGuid имеет формат BookmarkXXXXXXXXXXXXXXXXXXXXXXXXX.
Связанный контент
Ваши отзывы помогут нам решить, что реализовать в будущем, поэтому не забудьте проголосовать за другие функции, которые вы хотите увидеть в мобильных приложениях Power BI.
- Что такое мобильные приложения Power BI?
- Следите за @MSPowerBI twitter
- Присоединение к беседе на Сообщество Power BI
- Что такое Power BI?