Problemi con l'errore di avvio dello strumento di verifica del portale

In questo articolo verranno illustrati i risultati della diagnostica di Verifica portale relativi a problemi di avvio e come risolvere problemi o errori comuni.

Il portale non viene caricato e l'errore del server verrà visualizzato

Questo problema può essere causato da diversi motivi, ad esempio quando un portale non è in grado di connettersi all'ambiente Dataverse sottostante, l'ambiente Dataverse non esiste o il suo URL è cambiato, o quando una richiesta all'ambiente Dataverse è scaduta. Quando esegui lo strumento Verifica portale, cercherà di determinare il motivo esatto e ti indirizzerà alla mitigazione corretta.

Di seguito viene riportato un elenco delle cause comuni per questo errore e le corrispondenti procedure di mitigazione.

L'URL dell'ambiente Microsoft Dataverse connesso è cambiato

Ciò avviene quando l'URL dell'ambiente Dataverse viene cambiato da un utente dopo il provisioning di un portale. Per risolvere il problema, aggiorna l'URL di Dynamics 365:

1. Apri l'interfaccia di amministrazione dei portali Power Apps.
2. Vai a Azioni del portale > Aggiorna URL Dynamics 365.

Dopo che l'azione è stata completata, l'URL dell'ambiente Dataverse verrà aggiornato e il portale inizierà a funzionare.

L'ambiente Microsoft Dataverse connesso al portale è in modalità di amministrazione.

Questo problema si verifica quando la modalità di amministrazione viene attivata per l'ambiente Dataverse a seguito del passaggio dalla modalità di produzione a quella sandbox oppure manualmente da un amministratore dell'organizzazione.

Se questa è la causa, puoi disabilitare la modalità di amministrazione eseguendo i passaggi elencati qui. Dopo la disabilitazione della modalità di amministrazione, il portale funzionerà correttamente.

La connessione di autenticazione tra l'ambiente Dataverse e il portale è interrotta.

Questo problema si verifica quando la connessione di autenticazione tra l'organizzazione Dynamics 365 e il portale viene interrotta in quanto l'ambiente Dataverse è stato ripristinato da un backup o è stata eliminata e ricreata a partire da un backup. Per risolvere il problema:

1. Apri l'interfaccia di amministrazione dei portali Power Apps.
2. Nella scheda Dettagli portali, seleziona Inattivo nell'elenco Stato portale.
3. Seleziona Aggiorna.
4. Seleziona Attivo nell'elenco Stato portale.
5. Seleziona Aggiorna.

Una volta completati questi passaggi, il portale si riavvia e può ora effettuare una connessione di autenticazione.

In particolari situazioni, soprattutto se l'ID organizzazione è cambiato dopo l'operazione di ripristino (o se è stato eseguito nuovamente il provisioning dell'organizzazione), questa procedura di mitigazione non funzionerà. In tali situazioni, puoi reimpostare il portale ed eseguirne un nuovo provisioning nella stessa istanza. Per informazioni su come reimpostare un portale, vedi Reimpostare un portale.

Timeout della richiesta all'ambiente Microsoft Dataverse

Questo problema può verificarsi se la richiesta API al tuo ambiente Dataverse è in timeout. Questo problema dovrebbe mitigarsi automaticamente una volta che la richiesta API inizia a funzionare. Puoi anche provare a riavviare il portale:

1. Apri l'interfaccia di amministrazione dei portali Power Apps.
2. Passa ad Azioni portali > Riavvia.

Se il riavvio del portale non riesce e il problema persiste per un lungo periodo di tempo, contatta il supporto tecnico Microsoft.

Impossibile trovare il binding del sito Web

Questo problema si verifica quando i record di binding di sito Web per il portale vengono eliminati dall'ambiente Dataverse sottostante e il portale non può creare automaticamente il binding. Per risolvere il problema:

1. Apri l'app Gestione del portale.
2. Vai a Portali > Binding sito Web.
3. Elimina tutti i record di binding di sito Web che puntano al portale. Il campo Nome sito consente di identificare i record di binding di sito Web del portale.
4. Riavvia il portale.

Dopo aver completato questi passaggi, il portale viene riavviato e ricreerà automaticamente il record di binding di sito Web.

Tuttavia, vi sono casi in cui il portale non potrà ricreare tale record quando il GUID del record del sito Web disponibile nell'istanza è diverso da quello creato durante l'installazione predefinita del portale. In questo caso, esegui questa procedura:

1. Elimina tutti i record di binding di sito Web pertinenti al portale.

2. Crea un record di binding di sito Web manualmente con i valori seguenti:

   • Nome: può essere una qualsiasi stringa.
   • Sito Web: seleziona il record del sito Web di cui intendi eseguire il rendering nel portale.
   • Sitename: digita il nome host del portale, ad esempio (URL del portale senza https:// all'inizio). Se il portale utilizza un nome di dominio personalizzato, utilizza questo nome.
   • Lascia vuoti tutti gli altri campi.

3. Dopo che il record di binding di sito Web è stato ricreato, riavvia il portale dall'Interfaccia di amministrazione dei portali Power Apps.

Si è verificato un errore imprevisto durante il tentativo di connessione all'ambiente Microsoft Dataverse

Questa situazione può essere dovuta a un problema imprevisto. Per risolvere il problema, puoi provare a reimpostare il portale o a rieseguirne il provisioning. Per informazioni su come reimpostare un portale, vedi Reimpostare un portale.

Se né la reimpostazione né un nuovo provisioning del portale risolvono il problema, contatta il supporto Microsoft per assistenza.

Vedi anche

Esegui verifica portale