Solucionar problemas de adição de uma fonte de dados

Solucione problemas ao adicionar uma fonte de dados quando o comando da CLI pa app add data-source do Power Apps falhar. Siga estas etapas para identificar problemas de configuração, autenticação ou rede e adicionar a fonte de dados com êxito.

Sintomas

As falhas geralmente acontecem porque algo em seu computador ou rede está bloqueando a conexão ou interrompendo a autenticação.

Pré-requisitos

1. Verifique se você tem a CLI de Power Apps mais recente instalada. Atualize-o se você não tiver certeza.

2. Use pa auth login para entrar e pa auth status verificar a conta ativa:

   pa auth login
   pa auth status
   

3. Verifique se sua rede permite chamadas HTTPS de saída para os endpoints do Power Platform.

Etapas para solucionar problemas de erros de fonte de dados

Para diagnosticar a causa raiz, siga estas etapas.

Etapa 1: Validar a configuração

Abra o power.config.json arquivo e confirme:

• environmentId corresponde ao ambiente que você deseja ter como destino.
• region é definido como prod, a menos que você queira direcionar para outra região. Adicione-o se ele estiver ausente.

Etapa 2: Verificação do contexto do ambiente

Use pa auth status para confirmar se a conta correta está ativa:

pa auth status

Compare o environmentId em power.config.json com a ID do ambiente mostrada na URL do ambiente do Power Apps.

Exemplo de trecho de power.config.json:

{
  "environmentId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "region": "prod"
}

Etapa 3: executar novamente o comando

Execute pa app add data-source novamente. Por exemplo:

pa app add data-source --connector dataverse --table account

Procure códigos de status HTTP ou mensagens de erro na saída.

Etapa 4: Validação de rede e segurança

Se o comando ainda falhar:

• Confirme se nenhum proxy corporativo ou firewall bloqueia processos da CLI ou outro tráfego nonbrowser.
• Aprove os pontos de extremidade necessários do Power Platform. Consulte os requisitos de conectividade do Power Platform.

Verificar a conectividade do navegador

Esta etapa ajuda a confirmar que sua conta de usuário tem as permissões corretas e que a fonte de dados pode ser acessada no computador.

1. Abra um navegador da Web no mesmo computador em que você está usando a CLI Power Apps.
2. Vá diretamente para a fonte de dados que você está tentando adicionar, como o site SharePoint ou a URL do ambiente do Dataverse.
3. Entre com a mesma conta mostrada por pa auth status.
4. Se você não conseguir acessar o recurso, um problema de permissões com sua conta de usuário será a causa raiz provável.
5. Se você puder acessá-lo, continue a analisar o tráfego de rede.

Analisar o tráfego de rede

Use uma ferramenta de monitoramento de rede para inspecionar a comunicação entre a CLI do Power Apps e o endpoint da fonte de dados.

1. Baixe e instale o Fiddler Classic.

2. Inicie o Fiddler e verifique se ele está capturando o tráfego. Vá até Arquivo>Capturar Tráfego.

3. Em um prompt de comando, execute o comando que está falhando pa app add data-source.

4. Na lista de sessões do Fiddler, procure solicitações feitas para o ponto de extremidade da fonte de dados, como yourorg.crm.dynamics.com or yourtenant.sharepoint.com.

5. Analise a resposta:

   • Um 200 código de status indica êxito.
   • Um 401 código de status (não autorizado) ou 403 (proibido) aponta para um problema de autenticação ou permissão.
   • Outros códigos de erro ou uma completa falta de resposta podem indicar que um firewall ou proxy está bloqueando a solicitação.

Etapa 5: Limpar ou redefinir o contexto de autenticação

Se a conta errada estiver ativa, use pa auth switch:

pa auth switch

Se a conta não estiver listada, use pa auth login:

pa auth login

Para limpar todas as informações de autenticação salvas e entrar novamente, use pa auth logout e depois use pa auth login:

pa auth logout
pa auth login

Dados de escalonamento

Antes de entrar em contato com o suporte técnico para registrar um problema, forneça:

• Versão da CLI de origem em pa --version
• Sistema operacional e shell, como Prompt de Comando do Windows, PowerShell ou WSL
• O comando completo usado
• Saída de depuração sanitizada
• power.config.json depois de redigir valores confidenciais