Compartilhar via

Solucionar problemas de adição de uma fonte de dados (versão prévia)

Este artigo apresenta etapas da solução de problemas para quando o comando pac code add-data-source da PAC CLI (Power Apps Command Line Interface) falhar.

Sintomas

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

Sintoma Mensagem de exemplo
Falha na busca Fetch Failed (nenhuma pilha adicional)
Tempo limite/erros de rede ETIMEDOUT, ENOTFOUND, ECONNRESET
Incompatibilidade de ambiente Fonte de dados não encontrada/esquema inesperado

Pré-requisitos

  1. Verifique se você tem a CLI mais recente do Power Platform instalada. Atualize-o se você não tiver certeza.
  2. Verifique se você está autenticado no ambiente correto. Use comandos pac auth create e pac auth list.
  3. Verifique se a rede permite chamadas HTTPS de saída para os endpoints do Power Platform.

Etapas para solucionar problemas

Para diagnosticar a causa raiz, siga estas etapas:

Etapa 1: Validar a configuração

Abra power.config.json o arquivo e confirme:

  • environmentId corresponde ao ambiente que você pretende atingir.
  • region é definido como prod, a menos que você esteja direcionando intencionalmente outra região. Adicione caso não encontrado.

Etapa 2: Verificação do contexto do ambiente

Execute o comando pac env who.

Compare o Environment ID na saída com o valor environmentId em power.config.json.

Saída de exemplo (anotada):

Connected as user@domain.com
Organization Information
  Org ID:                     00aa00aa-bb11-cc22-dd33-44ee44ee44ee
  Unique Name:                unq2889ab2be728ef118406000d3a33f
  Friendly Name:              User Name
  Org URL:                    https://myorg.crm.dynamics.com/
  User Email:                 user@domain.com
  User ID:                    aaaaaaaa-bbbb-cccc-1111-222222222222
  Environment ID:             aaaabbbb-0000-cccc-1111-dddd2222eeee  <-- Ensure this matches

Trecho de exemplo correspondente power.config.json :

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

Etapa 3: executar novamente o comando

Reexecute o comando pac code add-data-source. Por exemplo:

pac code add-data-source -a dataverse -t account

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

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

Se ainda estiver falhando:

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 do PAC.
  2. Navegue diretamente até a fonte de dados que você está tentando adicionar. Por exemplo, o site do SharePoint ou a URL do ambiente do Dataverse.
  3. Entre com as mesmas credenciais usadas para autenticar com o comando pac CLI pac auth create
  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, vá para Analisar o tráfego de rede.

Analisar o tráfego de rede

Essa é a maneira mais eficaz de ver os dados brutos de comunicação de rede entre a CLI do PAC e o ponto de extremidade da fonte de dados.

  1. Baixe e instale o Fiddler Classic. O Fiddler é uma ferramenta para monitorar o tráfego de rede.

  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 pac code add-data-source.

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

  5. Analise as informações de 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/Redefinir contexto de autenticação

Se uma incompatibilidade for detectada, você deverá limpar ou redefinir o contexto de autenticação usando os comandos da CLI pac a seguir.

pac auth list
pac auth select --index <n>
pac env who

Se estiver incorreto, autentique novamente:

pac auth create --environment <yourEnvironmentId>

Dados de escalonamento

Antes de entrar em contato com o suporte técnico para registrar um problema, colete os dados a seguir.

Forneça:

  • Versão da CLI. Use o comando pac --version
  • Sistema operacional e shell (Windows cmd/PowerShell/WSL)
  • O comando completo usado
  • Trecho de saída da depuração limpo
  • power.config.json depois de editar informações confidenciais
  • Last updated on