Ler en inglés

Compartir por


Instrucións: Activar a seguranza a nivel de fila en Power BI en Power Pages

Do mesmo xeito que Power Pages é a ferramenta preferida para estender rapidamente o seu despregamento de Microsoft Dataverse ao público en forma de sitio web, Power BI é a ferramenta preferida para renderizar visualizacións elegantes baseadas en datos. A beleza do Power Platform está na súa capacidade de mesturar ambos á perfección. No pasado, para renderizar un informe de Power BI nunha páxina web, os administradores tiñan que publicar o informe na web e incorporalo nun iFrame. Aínda que se aplicasen permisos de páxinas para bloquear a páxina co informe, se unha persoa tivese a ligazón usada para incorporar o informe, calquera seguiría sendo capaz de acceder ao informe fóra do sitio web.

O propósito de publicar na web é permitir que calquera persoa na web consuma os datos e mesmo volva compartir o informe.

Aviso

Cando usa Publicar na web, calquera persoa en Internet pode ver o informe ou elemento visual publicado. A visualización non require autenticación. Inclúe a visualización de datos a nivel de detalle que agregan os seus informes. Antes de publicar un informe, asegúrese está ben para vostede compartir os datos e as visualizacións publicamente. Non publique información confidencial ou de propiedade exclusiva. Se ten dúbidas, consulte as políticas da súa organización antes de publicar.

Con Power BI Embedded, pódense servir contextualmente compoñentes de Power BI aos usuarios, pasar filtros automáticos mediante un parámetro de filtro e habilitar as capacidades de seguranza a nivel de fila para permitir que unha organización asegure realmente os datos visibles para os usuarios e só mostren o que están destinados a ver.

Nota

Só se admite a seguranza a nivel de fila para Power BI Embedded.

Requisitos previos

Escenario

Traballa nun estudo de fitness en grupo e utiliza Dataverse para controlar as clases de fitness en grupo e a súa asistencia. Os instrutores de fitness do grupo non residen no seu arrendatario, xa que cada un é tratado como un contratista. Estes instrutores de fitness en grupo utilizarán o seu sitio web para iniciar sesión e ver un historial das súas clases impartidas, a súa próxima programación e as taxas de asistentes. Non obstante, só deberían poder ver as clases que eles mesmos impartiron, e non as de todos.

Os instrutores están representados por rexistros de Contacto en Dataverse. Ao acceder ao sitio web de Power Pages, fano como o seu rexistro de Contacto . Os datos que necesitan ver no sitio web proceden da nosa táboa personalizada de Clases. A táboa Clases ten unha relación N*:1 cun contacto, xa que o formulario de clases ten un campo de busca chamado Instrutor, que é para a táboa de contactos.

Un rexistro dunha clase en Dataverse.

Para que a seguridade do nivel de fila funcione para os usuarios de Power Pages (Contactos), debe existir esa relación directa entre o Contacto e a táboa contra a que está a informar. A continuación móstrase un exemplo de modelo de datos deste escenario:

Relación de contacto coa táboa de clases.

Configurar un informe ou un panel de Power BI

  1. Abra o seu informe ou panel de Power BI en Power BI Desktop.

    Informe de Power BI do instrutor.

  2. Debemos cambiar a relación entre Contacto e a nosa táboa (Clases neste escenario) para utilizar o filtrado bidireccional. Para facelo, seleccione o separador Modelo no extremo esquerdo.

    Opción de modelo en Power BI.

  3. Seleccione a liña que vincula a súa táboa de contacto coa táboa que contén os datos do informe; no caso de exemplo, esta é vbd_class xa que estamos informando das clases.

  4. Na ventá Editar relación, hai dúas listas de selección. Na parte superior, escolla a táboa sobre a que está a informar (vbd_class) e seleccione a columna que teña o identificador único do rexistro.

  5. Na lista inferior, seleccione a táboa contacto e a columna Contacto .

  6. A cardinalidade indica Moitos a un (*:1). Cambie a dirección do filtro cruzado a Ambas.

    Edición de enlace entre táboas.

  7. Seleccione Aceptar.

  8. Mentres implementamos a seguranza a nivel de fila (RLS), debemos crear o noso rol. Na fita Inicio superior, seleccione Xestionar roles.

  9. En Roles, seleccione Crear. Poña un nome ao rol. O escenario de mostra utilizado pagesuser.

  10. Na columna Táboas, seleccione contacto.

  11. Encha a caixa de texto á dereita coa expresión DAX:

    [User Name] = username()

    Nota

    O campo [Username] reside na táboa de contactos e non é un nome de usuario real. Isto fai referencia á táboa adx_externalidentity utilizada por Power Pages. Esta ten o GUID que se envía a Power BI na función username().

    Xestionar roles en Power BI.

  12. Seleccione Gardar e, a seguir, garde o seu ficheiro.

  13. Na fita Inicio, seleccione Publicar.

  14. Selecciona unha área de traballo da organización da que es propietario e que utilizará a integración de Power Pages. Elixa Seleccionar.

Configurar integración de Power BI

Consulte Configurar integración de Power BI para habilitar o seu sitio web para a integración de Power BI.

Incorporar informe de Power BI

  1. Navegue a Power Pages. Busque o sitio web de Power Pages no que vai integrar o informe e despois seleccione Editar para abrir o estudio de deseño de Power Pages.

  2. Desde a área de traballo Páxinas, seleccione a páxina web na que quere integrar o informe.

  3. Engada unha sección ao corpo da páxina web.

  4. Escolla a icona Power BI cando se lle solicite que escolla o compoñente que está a engadir na sección.

    Engada unha sección a unha páxina web.

  5. Cando o compoñente encha a sección, seleccione na esquina superior esquerda; Editar Power BI.

  6. Seleccione Tipo de proceso. As opcións son:

    1. Inserir para os teus clientes: permíteche compartir Power BI con usuarios externos sen unha Power BI licenza ou unha Microsoft Entra identidade.

    2. Inserir para a túa organización: esta utiliza Microsoft Entra autenticación para compartir o informe de Power BI para que os usuarios internos poidan ver isto.

    3. Publicar na web: Isto permite a calquera persoa compartir o informe e os datos en Internet.

    Advertencia

    Asegúrese de que non sexa información confidencial.

    Información adicional: Publicar na web

    Escolla Incorporado para os seus clientes.

  7. Seleccione a súa área de traballo que contén o informe ou panel, especifique o tipo como Informe ou Panel e, a seguir, escolla o informe ou panel no último menú despregable. Se se trata dun informe, debe especificar a páxina que está a inserir.

    Seleccione informe.

  8. Para ver o código que integrou o informe ou o panel, seleccione Editar código na esquina superior dereita do estudio.

    Edite o código.

  9. Cando se lle pida, seleccione Abrir Visual Studio Code. Á esquerda, baixo PowerPages (área de traballo) o nome do sitio web de Power Pages ten un menú despregable na páxina web. Nesa sección ve un ficheiro .css, un ficheiro .js e a copia HTML. Asegúrese de estar no ficheiro de copia HTML.

    VS Code.

  10. Seleccione CTRL + F e busque {% para que poidamos identificar rapidamente o código que contén a referencia ao noso panel de control ou informe de Power BI. {% indica a apertura dunha etiqueta, que crea lóxica para a linguaxe Líquido. Liquid é a nosa ponte entre Dataverse e co que interactúan os usuarios no sitio web. Cando usamos o editor de estudio para incorporar compoñentes, créase automaticamente un fragmento de código de Liquid no código fonte da páxina web. Máis información sobre a etiqueta liquid Power BI pódese atopar aquí: Etiquetas Liquid de Dataverse e Engadir informe de Power BI.

  11. A liña completa de código liquid que ves asemellarase:

    {% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection" %}
    
  12. Peche o separador Visual Studio Code para a web.

  13. No estudio de deseño de Power Pages, seleccione o compoñemte Power BI Embedded e escolla Editar Power BI.

  14. Desprácese cara abaixo para alternar Aplicar roles a verdadeiro/si.

  15. Na caixa de texto Roles, escriba o nome do rol que creou en Power BI Desktop.

    Engada roles ao compoñente de Power BI.

  16. Para ver os cambios que isto fixo no código que integrou o informe ou o panel, seleccione de novo Editar código na esquina superior dereita do estudio.

  17. A liña completa de código liquid que ves asemellarase agora:

    {% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection" roles:"pagesuser" %}
    
  18. Peche o separador de Visual Studio Code para volver ao estudio de deseño.

  19. Para previsualizar o informe ou panel integrado resultante no seu explorador seleccione Sincronizar na esquina superior dereita e, a seguir, seleccione Previsualizar > Desktop.

  20. Para probar o informe, sen que ningún usuario inicie sesión, pode ver que se aplicou o RLS, xa que non hai rexistros devoltos navegando ao sitio web de Power Pages:

    Informe en branco.

    Neste informe hai datos subxacentes, xa que cando ve isto desde Power BI Desktop sen o RLS aplicado, pode ver que hai varios rexistros en xeral, pero están relacionados cun rexistro de contacto.

  21. Para probar isto aínda máis, se iniciamos sesión no sitio web cun usuario que ten un contacto correspondente que teña datos relacionados, só poderá ver os rexistros relacionados co usuario asinado na páxina web:

    Informe da clase na páxina web.

Resumo

Incorporou un informe ou panel de Power BI que utiliza seguranza a nivel de fila no seu sitio web de Power Pages.

O panel de filtros aparece de maneira predefinida. Ocultar o panel de filtros require JavaScript. Os pasos para facelo están documentados aquí: Engadir un informe ou panel de Power BI a unha páxina web dun portal.