> For the complete documentation index, see [llms.txt](https://docs.powerembedded.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerembedded.com/power-embedded-documentacao/documentacao-tecnica/instalacao-do-power-embedded/tutorial-de-instalacao/tutorial-de-instalacao-portal-de-administracao-do-power-bi.md).

# Tutorial de Instalação: Portal de Administração do Power BI

Nesta etapa, serão habilitadas as permissões necessárias para que o Power Embedded possa utilizar as APIs do Power BI/Fabric e consultar informações do ambiente.

**Pré-requisito:** esta etapa deve ser realizada por um usuário com permissão de administrador do Power BI.

Acesse o **Portal de Administração do Power BI** e abra **Configurações do locatário**.

1. No campo "**filtrar por palavra chave**", localizado no canto superior a direita, pesquise por **API**.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2F71kiF83nSrEOwhhmPhEw%2Fimage.png?alt=media&amp;token=6d8e0f12-2812-44be-998b-07387f75f199" alt=""><figcaption></figcaption></figure>

2. **Configurações do Desenvolvedor:**  Habilite a configuração **"Os principais serviços podem chamar as APIs públicas do Fabirc"** \
   Em "Aplicar a", selecione "Grupos de segurança específicos" e selecione o grupo de segurança criado anteriormente , neste tutorial, **PowerEmbedded-Group.** Clique em Aplicar.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FLmeDfoe8jFA2RPmPCueF%2Fimage.png?alt=media&amp;token=5858bb21-c092-45a5-970e-a021d2e4cffb" alt=""><figcaption></figcaption></figure>

3. Ainda com a palavra chave API filtrada, desça o cursor até " Configurações da API de Administração". Nesse menu será necessário habilitar as 4 opções para o **grupo de segurança especifico** Power Embedded-Group.

* As entidades de serviço podem acessar as APIs de administrador somente leitura;
* Entidades de serviço podem acessar APIs de administrador usadas para atualizações;
* Aprimorar as respostas das APIs de administração com metadados detalhados;
* Aprimorar as respostas das APIs de administração com expressoes DAX e mashup.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FXQEbgJMuhbA1NJKpNXar%2Fimage.png?alt=media&amp;token=3b3897a2-6b23-46a4-9497-a2ede17cb39d" alt=""><figcaption></figcaption></figure>

> **Importante:** algumas configurações do Portal de Administração podem ficar disponíveis somente após a aplicação ou atualização de uma configuração anterior. Caso uma opção não apareça imediatamente, atualize a página e verifique novamente.

4. Ainda na categoria **“Configurações do desenvolvedor”**, ou pesquise a palavra chave  “**inserir**” na barra de busca, marque a opção **“Inserir conteúdo em aplicativos”** e adicione o grupo de segurança "PowerEmbedded-Group" e clique na opção “**Aplicar”**.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FUrVEj6TcgVl5GcEABhHD%2Fimage.png?alt=media&amp;token=9ee00086-53cb-42e0-8c27-00c3e2c45525" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="message" %}
Caso essa configuração já esteja ativada e permitida para toda a organização, que é o padrão do Power BI, pode deixar assim, caso o cliente concorde. Alterar isso pode causar problemas em outros processos, caso estejam utilizando algo que necessite dessa permissão.
{% endhint %}

5. Na seção **“Configurações de integração”**, faça o mesmo processo para a configuração **“Permitir pontos de extremidade XMLA e analisar no Excel com modelos semânticos locais”**, que serve para permitir a listagem das roles de RLS de forma automática.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FH3LCxmYJS1Yir4OTlRN6%2Fimage.png?alt=media&amp;token=f2843541-9554-4484-be18-c93c482b298f" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="message" %}
Caso essa configuração já esteja ativada e permitida para toda a organização, que é o padrão do Power BI, pode deixar assim, caso o cliente concorde. Alterar isso pode causar problemas em outros processos, caso estejam utilizando algo que necessite dessa permissão.
{% endhint %}

6. E por ultimo,pesquise agora pela palavra **"Exportar"** na barra de pesquisa de palavra chave. Localize a seção **"Configurações de compartilhamento e de Exportação"**

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FsrxtUM8JUi2WNV5RTD5o%2Fimage.png?alt=media&amp;token=f31b2914-4c21-4680-8c53-c94b65bee64c" alt=""><figcaption></figcaption></figure>

Observe também se as configurações abaixo do Power BI está permitindo as exportações abaixo:

* Exportar para Excel (Usado pelo menu "Exportar dados" no visual)
* Exportar para .csv (Usado pelo menu "Exportar dados" no visual)
* Exportar relatório como apresentações em Power Point ou documentos PDF (Botão Exportar)
* Exportar os relatórios como arquivos de imagem (Botão Exportar)

{% hint style="info" icon="message" %}
Caso essa configuração já esteja ativada e permitida para toda a organização, que é o padrão do Power BI, pode deixar assim, caso o cliente concorde. Alterar isso pode causar problemas em outros processos, caso estejam utilizando algo que necessite dessa permissão.
{% endhint %}

### Ativar a Trial do Fabric

O **Trial do Microsoft Fabric** permite utilizar temporariamente uma capacidade do Fabric para realizar testes e configurar o ambiente antes da contratação de uma capacidade dedicada.

#### 1. Ativar o Trial do Fabric

Para iniciar o período de avaliação, acesse o **Power BI** e clique na sua foto de perfil, localizada no canto superior direito.

Em seguida, selecione **Iniciar avaliação do Fabric**, caso essa opção esteja disponível para o seu usuário.

Ao iniciar a avaliação, selecione a **Avaliação da região de capacidade** na qual o Trial será criado.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2Fd1JycnSpNzIQSKzjrBZ3%2Fimage.png?alt=media&amp;token=6e7ecff8-3ccc-48d5-9911-b854147ff272" alt=""><figcaption></figcaption></figure>

> **⚠️ Atenção à região da capacidade**
>
> A região escolhida durante a ativação do Trial deve ser definida com atenção, pois a migração posterior para outra região pode apresentar limitações.
>
> **Exemplo:** se o Trial for criado na região **Brazil South** e, posteriormente, a organização contratar uma capacidade dedicada na região **East US**, a alteração da região poderá gerar complicações na associação dos recursos.
>
> Antes de iniciar o Trial, confirme qual região deverá ser utilizada no ambiente definitivo

#### Importante: Disponibilidade do Trial

A Microsoft atualizou a política de disponibilização do **Trial do Microsoft Fabric**, e a opção **Iniciar avaliação do Fabric** pode não estar disponível para todos os usuários ou organizações.

Caso a opção não esteja disponível para o usuário que está realizando a instalação, recomendamos verificar se **outro usuário da organização possui a disponibilidade para iniciar o Trial**.

Se nenhum usuário da organização tiver essa opção disponível, recomendamos utilizar uma **capacidade dedicada do Microsoft Fabric** para realizar os testes. Nesse cenário, a **F2** é a menor capacidade dedicada do Fabric e pode ser utilizada para a etapa de avaliação.

### Associar os workspaces à capacidade do Fabric

Após ativar o Trial, é necessário associar os **workspaces** que serão utilizados pelo Power Embedded à capacidade do Fabric.

No menu lateral do **Power BI**, acesse **Workspaces** e selecione o workspace que será configurado.

Em seguida:

1. Acesse **Configurações do workspace**.
2. Na seção **Tipo de workspace**, clique em **Editar**.
3. Selecione **Avaliação Fabric**.
4. Em **Detalhes**, selecione o recurso de computação correspondente à avaliação criada anteriormente.
5. Salve a configuração.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2Fat4aEk0561j8FgpejIEp%2Fimage.png?alt=media&amp;token=0c5a42d3-68a1-4c1b-b4e0-80748cae8661" alt=""><figcaption></figcaption></figure>

\
Após essa configuração, o workspace estará associado à capacidade do Fabric.

{% hint style="info" icon="message" %}
**Importante:** se houver outros workspaces que serão utilizados no Power Embedded, esse procedimento deverá ser realizado individualmente em cada um deles.
{% endhint %}

### Adicionar o Service Principal ao workspace

Além de associar o workspace à capacidade, é necessário conceder ao **Service Principal do Power Embedded** acesso ao workspace.

Nas configurações do workspace, acesse **Gerenciar acesso**.

Clique em **Adicionar pessoas ou grupos** e pesquise pelo Service Principal criado anteriormente. Neste tutorial, utilizaremos **POWEREMBEDDED-APP**.

Selecione o aplicativo e atribua a função de **Administrador** no workspace.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FVeX1drMthWxVv3caogmr%2Fimage.png?alt=media&amp;token=33ae8299-be11-4cd2-9738-8308f85f25e7" alt=""><figcaption></figcaption></figure>

{% hint style="info" icon="message" %}
**Importante:** esse procedimento deve ser realizado em **todos os workspaces que serão disponibilizados no Power Embedded**.
{% endhint %}