Creación de un vínculo a una ubicación específica en las aplicaciones móviles de Power BI

Puede usar vínculos para acceder directamente a contenido de Power BI específico, como un informe específico, una página del informe, un panel, un icono, etc.

Existen dos escenarios principales para usar vínculos para acceder al contenido en las aplicaciones móviles de Power BI:

  • Para abrir Power BI desde fuera de la aplicación móvil y aterrizar en contenido específico. Normalmente se trata de un escenario de integración en el que se abre la aplicación móvil de Power BI desde otra aplicación.

  • Para navegar dentro de Power BI. Esto suele ocurrir cuando se quiere crear una navegación personalizada en Power BI.

En este artículo se tratan los casos siguientes:

  • Uso de vínculos para abrir contenido de Power BI específico desde fuera de la aplicación móvil. Se describen dos formatos de vínculo. Uno utiliza un método de redireccionamiento y se puede usar independientemente de dónde se abra Power BI. El otro se abre directamente en la aplicación móvil de Power BI y solo funcionará en dispositivos móviles que tengan instalada la aplicación móvil.

  • Uso de vínculos dentro de Power BI para navegar a contenido de Power BI específico.

Las aplicaciones móviles admiten vínculos de informe que incluyen parámetros de cadena de consulta. Estos vínculos se abren en la aplicación móvil filtrados previamente según las condiciones definidas en la cadena de consulta. Para más información sobre cómo crear direcciones URL de informe con parámetros de cadena de consulta, consulte Filtrar parámetros de cadena de consulta de informe en la dirección URL.

Las aplicaciones móviles también admiten el paso de parámetros a informes paginados mediante direcciones URL. Para más información, consulte Pasar un parámetro de informe en una URL para un informe paginado en Power BI.

Si desea vincular a un elemento específico de Power BI desde fuera de la aplicación móvil, hay dos opciones, dependiendo de dónde se vaya a abrir el vínculo:

  • Si desea que el vínculo se abra correctamente, independientemente de si se hace clic en él en el explorador de un equipo o en un dispositivo móvil, puede crear un vínculo que garantice que se abrirá correctamente, con independencia de dónde se haga clic. Este vínculo tiene una sintaxis de redireccionamiento especial para habilitar este comportamiento inteligente.

  • Si sabe que el vínculo se va a abrir solo en un dispositivo móvil que tiene instalada la aplicación móvil de Power BI, puede evitar la sobrecarga de redireccionamiento del método anterior y usar otra sintaxis de vínculo que abra el vínculo directamente en la aplicación móvil de Power BI en el dispositivo móvil. Sin embargo, es importante tener en cuenta que, aunque este vínculo evita la sobrecarga de redireccionamiento del primer método, no funcionará si se abre en cualquier lugar que no sea un dispositivo móvil que tenga instalada la aplicación móvil de Power BI.

El formato de vínculo descrito en esta sección usa el redireccionamiento para asegurarse de que el vínculo funciona independientemente de dónde se haga clic en él.

  • Si se hace clic en el vínculo en un dispositivo móvil, se asegura de que el dispositivo use la aplicación móvil de Power BI para abrir el vínculo. Si la aplicación móvil no está instalada en el dispositivo, sugiere al usuario que vaya a la tienda para obtenerla.

  • Si se hace clic en el vínculo en un equipo, se abrirá el elemento correspondiente en el portal web de Power BI.

El vínculo debe comenzar con un prefijo especial, seguido de los parámetros de la consulta:

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

Importante

Si el contenido está hospedado en un centro de datos especial como Government, China, etc., el vínculo debe comenzar con la dirección de Power BI adecuada, como app.powerbigov.us o app.powerbi.cn.

Los parámetros de consulta son los siguientes:

Parámetro valor Descripción
action (obligatorio) OpenApp
OpenReport
OpenDashboard
OpenTile
appId GUID de 36 caracteres Debe especificarse si quiere abrir un informe o un panel que forme parte de una aplicación.
Ejemplo: appId=baf4b16d-b5bd-4360-8a3a-51d11242c09b
groupObjectId GUID de 36 caracteres Especifica el área de trabajo si quiere abrir un informe o un panel que no forma parte de Mi área de trabajo.
Ejemplo: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30e
dashboardObjectId GUID de 36 caracteres Identificador de objeto de panel (si action es OpenDashboard u OpenTile).
Ejemplo: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4a
reportObjectId GUID de 36 caracteres Identificador de objeto de informe (si action es OpenReport).
Ejemplo: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cf
tileObjectId GUID de 36 caracteres Identificador de objeto de icono (si action es OpenTile).
Ejemplo: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9
reportPage ReportSection<num> Nombre de la página si desea abrir una página específica del informe (si action es OpenReport).
Ejemplo: reportPage=ReportSection6
bookmarkGuid GUID de 36 caracteres Identificador de marcador, si desea abrir una vista con marcadores específica (si action es OpenReport).
Ejemplo: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7f
Nota: No se admiten los valores del formato BookmarkXXXXXXXXXXXXXXXXXXX.
ctid GUID de 36 caracteres Identificador de organización del elemento (relevante para escenarios B2B. Esto se puede omitir si el elemento pertenece a la organización del usuario).
Ejemplo: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681 .

Nota

Los marcadores de nivel de informe no tienen un formato bookmarkGUID y actualmente no se pueden pasar como parámetros de un vínculo profundo.

Ejemplos:

En los ejemplos siguientes, los marcadores de posición para los valores de parámetro se resaltan en negrita. Para obtener los valores reales, vaya al servicio Power BI, abra el elemento al que desea vincular y extraiga los valores que necesita de la dirección URL del elemento.

  • Abrir una aplicación

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

  • Abrir un panel que forma parte de una aplicación

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

  • Abrir un informe que forma parte de un área de trabajo distinta de Mi área de trabajo

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

En el caso de aplicaciones, informes y paneles que forman parte de una aplicación, la forma más sencilla de obtener el vínculo es ir al área de trabajo de la aplicación y seleccionar Actualizar aplicación. Se abrirá la experiencia "Publicar aplicación". Abra la pestaña de permisos y expanda la sección de vínculos para ver los vínculos a la aplicación y todo su contenido. Puede usar estos vínculos desde fuera de Power BI para acceder directamente a la aplicación y su contenido.

Screenshot of Power BI publish app links highlighted.

En el caso de los informes y paneles que no forman parte de una aplicación, es necesario extraer los identificadores de objetos necesarios de la dirección URL del elemento. Para ello, vaya al servicio Power BI, navegue hasta el elemento al que desea vincular y busque los valores que necesita en la dirección URL que aparece en la barra de direcciones del explorador.

Los ejemplos muestran dónde puede buscar los identificadores que necesita en las direcciones URL de los elementos a los que desea vincular.

  • Para buscar un identificador de objeto de panel de 36 caracteres, vaya al panel específico al que desea vincular en el servicio Power BI y busque el identificador de objeto del panel y cualquier otro identificador necesario en los lugares indicados a continuación:

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

  • Para buscar un identificador de objeto de informe de 36 caracteres, desplácese hasta el informe específico al que desea vincular en el servicio Power BI y busque los identificadores necesarios como se muestra a continuación. Este ejemplo contiene una referencia a una página de informe específica y a un marcador específico.

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

  • Para vincular a un elemento en un área de trabajo distinta de Mi área de trabajo, debe extraer el identificador del objeto de grupo. En este ejemplo se muestra un informe de un área de trabajo distinta de Mi área de trabajo.

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

El formato de vínculo descrito en esta sección se vincula a una ubicación específica dentro de las aplicaciones móviles de Power BI en todas las plataformas móviles: iOS, dispositivos Android y Windows. Este formato de vínculo abre directamente la ubicación, sin ninguno de los redireccionamientos implicados en el método descrito en la sección anterior. Este formato solo se puede abrir en dispositivos móviles que tengan instalada la aplicación móvil de Power BI.

Los vínculos de este formato pueden apuntar directamente a paneles, iconos e informes. El destino del vínculo profundo determina su formato. Siga estos pasos para crear vínculos profundos a ubicaciones diferentes.

  • Abrir la aplicación móvil de Power BI

    Use este vínculo para abrir la aplicación móvil de Power BI en cualquier dispositivo:

    mspbi://app/

  • Abrir en un panel específico

    Este vínculo abre la aplicación móvil de Power BI en un panel específico:

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

    Para obtener el identificador de objeto de panel de 36 caracteres, vaya al panel específico del servicio Power BI y extráigalo de la dirección URL. Por ejemplo, el identificador de objeto de panel se resalta en la siguiente dirección URL del servicio Power BI:

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

    Si el panel no está en Mi área de trabajo, debe agregar también el identificador de objeto de grupo, ya sea antes o después del identificador del panel. El vínculo profundo que se muestra tiene el parámetro de identificador de objeto de grupo agregado después del identificador de objeto de panel:

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

    Observe la Y comercial (&) entre los dos parámetros.

  • Abrir en un icono concreto en modo de enfoque

    Este vínculo abre un icono específico en modo de enfoque en la aplicación móvil de Power BI:

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

    Para buscar el identificador de objeto y de icono de panel de 36 caracteres, vaya al panel específico en el servicio Power BI y abra el icono en modo de enfoque. En el ejemplo, se resaltan los identificadores de icono y panel.

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

    Para abrir directamente este icono, el vínculo sería:

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

    Observe la Y comercial (&) entre los dos parámetros.

    Si el panel no está en Mi área de trabajo, agregue el parámetro GroupObjectId; por ejemplo, &GroupObjectId=<36-character-group-id>

  • Abrir en un informe específico

    Este vínculo abre un informe específico en la aplicación móvil de Power BI:

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

    Para buscar el identificador del objeto de informe de 36 caracteres, vaya al informe específico en el servicio Power BI. La siguiente dirección URL del servicio Power BI ilustra el identificador de informe que necesita extraer.

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

    Si el informe no está en Mi área de trabajo, necesita agregar también &GroupObjectId=<36-character-group-id>, ya sea antes o después del identificador de informe. Por ejemplo, en este caso, el vínculo profundo sería:

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

    Observe la Y comercial (&) entre los dos parámetros.

  • Abrir una página de informe específica

    Este vínculo abre una página específica del informe en la aplicación móvil de Power BI:

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

    La página del informe se denomina ReportSection y va seguida de un número. De nuevo, para buscar los valores que necesita, abra el informe en el servicio Power BI, vaya a la página específica del informe y extraiga los valores que necesita de la dirección URL. Por ejemplo, las secciones resaltadas de esta dirección URL representan los valores que necesitaría abrir en una página específica del informe:

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

  • Abrir en modo de pantalla completa (solo para dispositivos Windows)

    Si se trata de dispositivos Windows, también puede agregar el parámetro openFullScreen para abrir un informe específico en modo de pantalla completa. En el ejemplo siguiente, se abre una página de informe en modo de pantalla completa:

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

  • Agregar contexto (opcional)

    También puede agregar contexto a la cadena. Si más adelante necesita ponerse en contacto con nosotros, podemos usar ese contexto para filtrar los datos, a fin de encontrar lo que es relevante para la aplicación. Para agregar contexto, agregue el parámetro context=<app-name> al vínculo:

    Por ejemplo, en el ejemplo siguiente, se muestra un vínculo que incluye un parámetro de contexto:

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

En las aplicaciones móviles de Power BI, los vínculos dentro de Power BI funcionan tal cual lo hacen en el servicio Power BI.

Si quiere agregar un vínculo al informe que apunte a otro elemento de Power BI, solo tiene que copiar la dirección URL de ese elemento desde la barra de direcciones del explorador. Para más información, consulte Agregar un hipervínculo a un cuadro de texto en un informe.

Consideraciones y limitaciones

Los vínculos profundos a informes con un parámetro bookmarkGuid solo se admiten en las aplicaciones móviles cuando el valor del parámetro bookmarkGuid tiene el formato GUID estándar de 36 caracteres. No se admiten vínculos en los que el valor del parámetro bookmarkGuid tiene el formato BookmarkXXXXXXXXXXXXXXXXXXXXXX.

Sus comentarios nos ayudan a decidir qué implementaremos en el futuro; no olvide votar por otras características que le gustaría ver en aplicaciones móviles de Power BI.