Problemas de inicialização do Verificador do Portal

Neste artigo, você saberá mais sobre os resultados de diagnóstico do Verificador de Portal e como resolver problemas de inicialização e questões ou problemas comuns.

O portal não é carregado e exibe "Erro do servidor"

Esse problema tem várias causas diferentes, como quando um portal não consegue se conectar ao ambiente subjacente do Dataverse, o ambiente do Dataverse não existe, a URL mudou ou uma solicitação para o ambiente do Dataverse expirou. Quando você executa a ferramenta Portal Checker, ela tenta determinar o motivo exato e indicar a mitigação correta.

Veja abaixo uma lista de causas comuns deste erro e as etapas de mitigação correspondentes.

A URL do ambiente do Microsoft Dataverse conectado mudou

Isso ocorre quando a URL do ambiente do Dataverse é alterada por um usuário após o provisionamento de um portal na organização. Para corrigir esse problema, atualize a URL do Dynamics 365:

1. Abra o Centro de administração de portais do Power Apps.
2. Vá para Ações do Portal > Atualizar URL do Dynamics 365.

Assim que essa ação for concluída com sucesso, a URL do ambiente do Dataverse será atualizada e o portal começará a funcionar.

Um ambiente do Microsoft Dataverse conectado ao seu portal está no modo de administração.

Esse problema ocorre quando o ambiente do Dataverse é colocado no modo de administração ou durante a alteração do organização do modo de produção para o modo de área restrita, ou manualmente por um administrador da organização.

Se esta foi a causa, você pode desabilitar o modo de administração seguindo as etapas listadas aqui. Depois que o modo de administração é desabilitado, o portal deve funcionar.

A conexão de autenticação entre o ambiente do Dataverse e o portal foi interrompida

Esse problema ocorre quando a conexão de autenticação entre a organização do Dynamics 365 e o portal é interrompida porque o ambiente do Dataverse foi restaurado de um backup ou foi excluído e recriado de um backup. Para corrigir esse problema:

1. Abra o Centro de administração de portais do Power Apps.
2. Na guia Detalhes do Portal, selecione Desativado na lista Estado do Portal .
3. Selecione Atualizar.
4. Selecione Ativo na lista Estado do Portal.
5. Selecione Atualizar.

Quando essas etapas forem concluídas, o portal será reiniciado e será possível fazer uma conexão de autenticação.

Em certas situações, principalmente se a ID da organização tiver sido alterada depois da operação de restauração (ou se você provisionou a organização novamente), essas etapas de solução funcionarão. Nessas situações, você pode redefinir e reprovisionar o portal para a instância. Para obter informações sobre como redefinir um portal, consulte Redefinir um portal.

A solicitação para o ambiente do Microsoft Dataverse atingiu o tempo limite

Esse problema poderá ocorrer se a solicitação da API para o ambiente do Dataverse expirar. Esse problema deve ser mitigado automaticamente assim que a solicitação da API começar a funcionar. Você também pode tentar reiniciar o portal:

1. Abra o Centro de administração de portais do Power Apps.
2. Vá para Ações do Portal > Reiniciar.

Se reiniciar o portal não funcionar e o problema persistir por um longo período, fale com o Suporte da Microsoft para obter ajuda.

Associação do site não encontrada

Esse problema ocorre quando registros de associação do site para o portal são excluídos do ambiente do Dataverse subjacente e o portal não consegue criar a associação automaticamente. Para corrigir esse problema:

1. Abra o aplicativo de gerenciamento de portal.
2. Vá para Portais > Vinculações de site.
3. Excluir todos os registros de associação do site que estão apontando para o seu portal. O campo Sitename ajuda a identificar os registros de associação do site para seu portal.
4. Reiniciar o portal.

Ao concluir essas etapas, seu portal reiniciará e deverá recriar registros da associação de site automaticamente.

Existem situações em que o portal não conseguirá recriar o registro de associação do site automaticamente, como quando a GUID de registros de site disponível em sua instância for diferente da criada durante a instalação padrão do seu portal. Nesta situação, faça o seguinte:

1. Excluir todos os registros de associação do site relacionados ao seu portal.

2. Crie um registro da associação de site manualmente com os seguintes valores:

   • Nome: pode ser qualquer cadeia de caracteres.
   • Site: selecione o registro do site a ser renderizado no seu portal.
   • Sitename: digite o nome do host do seu portal (URL do portal sem https:// no início). Se seu portal estiver usando um nome de domínio personalizado, use esse nome aqui.
   • Deixe todos os outros campos em branco.

3. Depois que o registro de site de associação for recriado, reinicie o centro de administração de portais do Power Apps.

Ocorreu um erro inesperado ao tentar estabelecer conexão com seu ambiente do Microsoft Dataverse

Essa situação poderá ocorrer devido a um erro inesperado. Para atenuar essa situação, tente redefinir ou reprovisionar o portal. Para obter informações sobre como redefinir um portal, consulte Redefinir um portal.

Se a redefinição do portal ou o reprovisionamento não resolverem o problema, fale com o Suporte da Microsoft para obter ajuda.

Confira também

Executar Verificador do Portal

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).