Informazioni di riferimento sul codice di errore del flusso cloud

Usare questo articolo per risolvere gli errori più comuni nei flussi cloud Power Automate. Ogni voce spiega cosa significa l'errore, perché accade e come risolverlo.

Errori in fase di progettazione

Questi errori si verificano quando si salva, convalida o si pubblica un flusso.

ModelloNonValido

Significato: la definizione del flusso contiene un errore di sintassi in una configurazione di espressione o azione.

Cause comuni:

• Parentesi o virgolette non corrispondenti in un'espressione
• Riferimento a un output dell'azione che non esiste (digitazione nel nome dell'azione)
• Uso di una funzione con il numero errato di argomenti (ad esempio, createArray() senza argomenti)
• Digitare una mancata corrispondenza in un'espressione costante (ad esempio, int('abc') o div(100, 0)): il motore convalida questi elementi in fase di salvataggio
• Copiare espressioni incollate dalla documentazione che include caratteri Unicode invisibili

Come correggere:

1. Aprire l'azione evidenziata in rosso nella finestra di progettazione.
2. Controllare l'espressione nella barra della formula. Cercare caratteri o non corrispondenti().'
3. Verificare che i nomi delle azioni nelle espressioni corrispondano esattamente (con distinzione tra maiuscole e minuscole): outputs('Get_item') non outputs('Get Item').
4. Se l'espressione è corretta, eliminarla e riscrivarla manualmente per rimuovere i caratteri nascosti.

Informazioni correlate: ExpressionEvaluationFailed, FlowCheckerError

FlowCheckerError

Significato: il controllo del flusso ha rilevato uno o più problemi di convalida che impediscono il salvataggio.

Cause comuni:

• Un campo obbligatorio è vuoto in una o più azioni
• Una connessione non è selezionata per un'azione del connettore
• Un'espressione fa riferimento a un valore di contenuto dinamico da un ramo parallelo (non è garantito che esista)
• Gli input dei trigger sono incompleti

Come correggere:

1. Selezionare il banner di errore nella parte superiore della finestra di progettazione per visualizzare l'elenco completo dei problemi.
2. Selezionare ogni errore per passare all'azione interessata.
3. Compilare i campi obbligatori, correggere le espressioni interrotte e selezionare le connessioni.
4. Salva di nuovo. Il controllo viene eseguito automaticamente al salvataggio.

Informazioni correlate: InvalidTemplate, MissingRequiredProperty

DuplicateActionName

Significato: due o più azioni nel flusso hanno lo stesso nome interno.

Cause comuni:

• Copia incollando un'azione senza rinominarla
• Importazione di una definizione del flusso modificata manualmente con chiavi duplicate
• Ridenominazione di un'azione in un nome già usato da un'altra azione nello stesso ambito

Come correggere:

1. Cercare nel flusso azioni con nomi identici (controllare anche all'interno Apply to Each e Scope ai contenitori).
2. Rinominare uno dei duplicati. Selezionare il menu ... nell'azione, quindi selezionare Rinomina.
3. Aggiornare tutte le espressioni che fanno riferimento all'azione rinominata: outputs('Old_Name') a outputs('New_Name').

Informazioni correlate: InvalidTemplate

MissingRequiredProperty

Significato: un campo di input obbligatorio per un'azione o un trigger è vuoto.

Cause comuni:

• Aggiunta di un'azione del connettore ma non completamento della configurazione
• Il token di contenuto dinamico risolto in vuoto è stato usato in un campo obbligatorio
• Flusso importato da una soluzione in cui le variabili di ambiente non sono impostate

Come correggere:

1. Aprire l'azione contrassegnata con l'errore.
2. Cercare i campi contrassegnati con un asterisco rosso (*) vuoto.
3. Compilare il valore richiesto, con testo statico o un token di contenuto dinamico.
4. Per i flussi di soluzione, verificare che tutte le variabili di ambiente abbiano valori nell'ambiente di destinazione.

Informazioni correlate: FlowCheckerError

Errori di espressione di runtime

Questi errori si verificano quando viene eseguito un flusso e non è possibile valutare un'espressione.

ExpressionEvaluationFailed

Cosa significa:

Un'espressione non è riuscita a valutare in fase di esecuzione perché i dati effettivi non corrispondono a quanto previsto dall'espressione. Questo errore si verifica solo quando l'espressione usa valori dinamici (variabili, corpo del trigger, output delle azioni) che non possono essere controllati in fase di salvataggio.

Cause comuni:

• Chiamata int() su una variabile che contiene una stringa non numerica in fase di esecuzione
• Accesso a una proprietà su un oggetto Null (outputs('Get_item')?['body/title'] quando Get_item restituito nulla)
• Formato data non corrispondente in formatDateTime() o parseDateTime() quando il formato proviene da una variabile
• Divisione per zero quando il divisore è un valore dinamico che accade a 0

Come correggere:

1. Aprire l'esecuzione non riuscita e selezionare l'azione non riuscita per visualizzare l'espressione e i valori di input.
2. Eseguire il wrapping di espressioni rischiose con controlli Null: if(empty(triggerBody()?['value']), 'default', triggerBody()?['value']).
3. Usare coalesce() per fornire valori di fallback: coalesce(outputs('Get_item')?['body/title'], 'Untitled').
4. Convalidare i tipi di dati prima della conversione: if(isInt(variables('input')), int(variables('input')), 0).

Informazioni correlate: InvalidTemplate, ContentConversionFailed

ContentConversionFailed

Significato: il flusso non è riuscito a convertire i dati da un tipo a un altro tra le azioni.

Cause comuni:

• Passaggio di una stringa in cui è previsto un numero intero o un valore booleano
• Invio di una matrice a un'azione che prevede un singolo oggetto
• Stringa di data in un formato imprevisto (ad esempio, DD/MM/YYYY quando MM/DD/YYYY è previsto)
• Contenuto binario (file) passato a un input di testo

Come correggere:

1. Controllare gli input dell'azione non riuscita nella cronologia di esecuzione. Confrontare il tipo di valore effettivo con quello previsto dall'azione.
2. Usare funzioni di conversione esplicite: int(), float()string(), , bool(), json().
3. Per le date, usare parseDateTime() con impostazioni locali esplicite o formatDateTime() per normalizzare prima di passare.
4. Per le matrici, usare first() per estrarre un singolo elemento se l'azione downstream prevede un solo valore.

Informazioni correlate: ExpressionEvaluationFailed

Errori di connessione e autenticazione

Questi errori si verificano quando il flusso non può eseguire l'autenticazione a un servizio connesso.

InvalidConnection

Significato: un riferimento di connessione nel flusso punta a una connessione interrotta, eliminata o scaduta.

Cause comuni:

• L'utente che ha creato la connessione ha modificato la password o ha reimpostato l'autenticazione a più fattori
• La connessione è stata eliminata dalla pagina Connessioni
• Un amministratore ha rimosso la connessione tramite l'interfaccia di amministrazione di Power Platform
• Il flusso è stato importato in un ambiente in cui la connessione non esiste

Come correggere:

1. Aprire il flusso in modalità di modifica. Le azioni con connessioni interrotte mostrano un'icona di avviso.
2. Selezionare l'azione e selezionare Cambia connessione o Aggiungi nuova connessione.
3. Accedere con le credenziali appropriate per creare una nuova connessione.
4. Salvare e testare il flusso.

Informazioni correlate: ConnectionNotConfigured, ConnectionAuthorizationFailed

ConnectionNotConfigured

Cosa significa: un'azione richiede una connessione ma non è stata selezionata alcuna connessione.

Cause comuni:

• Il flusso è stato importato da una soluzione e i riferimenti alla connessione non sono stati mappati
• È stata aggiunta una nuova azione, ma il passaggio di connessione è stato ignorato
• Il riferimento alla connessione punta a una variabile di ambiente senza alcun valore

Come correggere:

1. Aprire il flusso in modalità di modifica e trovare l'azione con l'avviso di connessione.
2. Selezionare una connessione esistente dall'elenco a discesa oppure crearne una nuova.
3. Per i flussi di soluzioni, passare a Soluzioni Riferimenti> allaconnessione della soluzione>predefinita.
4. Impostare la connessione per ogni riferimento.

Informazioni correlate: InvalidConnection

Non autorizzato (401)

Significato: l'API ha rifiutato la richiesta perché il token di autenticazione non è valido o è scaduto.

Cause comuni:

• Token OAuth scaduto e la connessione non è riuscita ad aggiornare automaticamente
• L'account dell'utente è stato disabilitato o la password è stata modificata
• Segreto dell'entità servizio o certificato scaduto
• I criteri di accesso condizionale hanno bloccato l'accesso (area geografica, conformità del dispositivo)

Come correggere:

1. Passare a Power Automate>Connections e trovare la connessione usata dall'azione non riuscita.
2. Se la connessione visualizza un avviso, selezionare Correggi connessione e ripetere l'autenticazione.
3. Per le connessioni all'entità servizio, ruotare il segreto in Microsoft Entra ID e aggiornare la connessione.
4. Controllare Microsoft Entra ID log di accesso per i blocchi di accesso condizionale: Azure portale>Microsoft Entra ID> Log di accesso filtrare in base al nome dell'app.

Informazioni correlate: Accesso negato (403),ConnectionAuthorizationFailed

Non consentito (403)

Significato: l'utente autenticato o l'app non dispone dell'autorizzazione per eseguire l'operazione richiesta.

Cause comuni:

• Un criterio DLP (Prevenzione della perdita dei dati) blocca l'azione del connettore o del connettore in questo ambiente
• L'utente non dispone delle autorizzazioni per la risorsa di destinazione( ad esempio, nessun accesso in scrittura a un SharePoint list)
• Un amministratore ha limitato il connettore tramite le impostazioni a livello di tenant
• Il connettore richiede una licenza Premium e l'utente è in un piano di inizializzazione

Come correggere:

1. Controllare i criteri di prevenzione della perdita dei dati: Criteridati dell'interfaccia > di amministrazione di Power Platform. Cercare i criteri che bloccano il connettore nel gruppo dell'ambiente.
2. Verificare che l'utente della connessione disponga delle autorizzazioni appropriate per il servizio di destinazione (SharePoint autorizzazioni del sito, ruoli di sicurezza dataverse e simili).
3. Se si tratta di un problema del connettore Premium, verificare che il proprietario o il chiamante del flusso disponga di una licenza Power Automate Premium.
4. Contattare l'amministratore se è necessario modificare un criterio di prevenzione della perdita dei dati.

Informazioni correlate: Non autorizzato (401), DirectApiAuthorizationRequired

ConnectionAuthorizationFailed

Significato: la connessione esiste ma le credenziali archiviate non sono più valide.

Cause comuni:

• La password dell'utente è stata modificata o il metodo MFA è stato reimpostato
• Token di aggiornamento OAuth scaduto (comune con le connessioni inutilizzate per più di 90 giorni)
• Consenso dell'amministratore revocato per l'app in Microsoft Entra ID
• Connessione condivisa non condivisa dal proprietario

Come correggere:

1. Aprire Power Automate>Connections.
2. Trovare la connessione interessata.
3. Selezionare la connessione e quindi correggere la connessione per ripetere l'autenticazione.
4. Se si usa una connessione condivisa, chiedere al proprietario della connessione di ricondividerla.
5. Per gli account di servizio, impostare un promemoria del calendario per ruotare le credenziali prima della scadenza.

Informazioni correlate: InvalidConnection, Non autorizzato (401)

Errori del connettore e dell'API

Questi errori provengono dal servizio downstream che il flusso sta chiamando.

ActionFailed

Significato: un'azione ha restituito uno stato di errore. Si tratta di un wrapper generico. I dettagli effettivi dell'errore si trovano nel corpo dell'output dell'azione.

Cause comuni:

• L'API downstream ha restituito un errore 4xx o 5xx
• Un flusso figlio (chiamato tramite "Esegui un flusso figlio") non è riuscito
• Un connettore personalizzato ha restituito un formato di risposta imprevisto
• Le impostazioni configure-run-after dell'azione hanno causato l'esecuzione dopo un errore precedente

Come correggere:

1. Aprire l'esecuzione non riuscita e selezionare l'azione non riuscita.
2. Espandere Output per visualizzare il messaggio di errore e il codice di stato effettivi dall'API.
3. Risolvere il problema sottostante in base all'errore specifico dell'API (esaminare le voci 400, 401, 403 e 404 in questo riferimento).
4. Se l'azione deve essere eseguita anche quando le azioni precedenti hanno esito negativo, selezionare Configura esecuzione dopo le impostazioni.

Informazioni correlate: BadRequest (400), NotFound (404)

BadRequest (400)

Significato: l'API del connettore ha rifiutato la richiesta perché i dati di input non sono validi o non validi.

Cause comuni:

• Invio di un campo con tipo di dati errato (stringa anziché numero o viceversa)
• Campi obbligatori mancanti nel corpo della richiesta
• Caratteri non validi nei nomi di file o nei titoli degli elementi di elenco
• Superamento di un limite di lunghezza del campo (ad esempio, SharePoint testo a riga singola = 255 caratteri)

Come correggere:

1. Aprire l'azione non riuscita nella cronologia di esecuzione ed esaminare la sezione Input per visualizzare esattamente ciò che è stato inviato.
2. Confrontare gli input con lo schema previsto dell'API (vedere la documentazione del connettore).
3. Purificare l'input dell'utente con replace() per rimuovere caratteri non validi prima di passare all'azione.
4. Utilizzare substring() o take() per troncare i valori lunghi alla lunghezza massima del campo.

Informazioni correlate: ActionFailed, ContentConversionFailed

NotFound (404)

Cosa significa: la risorsa a cui l'azione sta tentando di accedere non esiste.

Cause comuni:

• Un SharePoint list, una raccolta o un sito è stato rinominato o eliminato
• È stata rimossa una cartella Outlook o un canale di Teams
• Il flusso fa riferimento a un ID hardcoded per una risorsa che non esiste più
• La tabella o la riga di Dataverse è stata eliminata da un altro processo

Come correggere:

1. Verificare che la risorsa esista ancora nel servizio di destinazione.
2. Se è stato rinominato, aggiornare l'azione in modo da usare il nuovo nome o l'ID.
3. Sostituire gli ID hardcoded con ricerche dinamiche dove possibile (ad esempio, "Recupera elementi" con un filtro anziché "Recupera elemento" con un ID statico).
4. Aggiungere la gestione degli errori: configurare l'azione successiva su Esegui dopo>l'errore e gestire correttamente la versione 404.

Informazioni correlate: ActionFailed

Errori di attivazione

Questi errori si riferiscono ai trigger di flusso che non vengono attivati o non hanno esito negativo.

TriggerConditionNotMet

Significato: il trigger ha valutato la condizione e ha determinato che l'evento non deve avviare un'esecuzione del flusso.

Cause comuni:

• Un'espressione di condizione trigger restituisce sempre false (errore logico)
• La condizione del trigger fa riferimento a un campo che non esiste nel payload del trigger
• L'evento si è verificato ma i dati non corrispondono al filtro (ad esempio, "Quando viene creato un elemento" con una condizione in Stato, ma Lo stato è vuoto)

Come correggere:

1. Passare alle impostazioni del trigger ed esaminare l'espressione della condizione del trigger.
2. Testare la condizione su un payload di evento noto. Usare Visualizza codice nel trigger per visualizzare lo schema non elaborato.
3. Rimuovere temporaneamente la condizione, attivare il flusso manualmente ed esaminare l'output del trigger per verificare i nomi e i valori dei campi.
4. Correggere l'espressione e riabilitare la condizione.

Informazioni correlate: ExpressionEvaluationFailed

Errori di timeout e limitazione

Questi errori si verificano quando il flusso o un'azione supera i limiti di tempo o frequenza.

ActionTimedOut

Significato: una singola azione ha superato il timeout configurato ed è stata annullata.

Cause comuni:

• Azione HTTP che chiama un'API esterna lenta con timeout predefinito di 100 secondi
• "Attendere un'approvazione" con una scadenza che ha superato
• Caricamento o download di file di grandi dimensioni tramite una connessione lenta
• Query dataverse che restituisce troppe righe senza impaginazione

Come correggere:

1. Aprire le impostazioni dell'azione e aumentare il valore di timeout (durata ISO 8601, PT5M ad esempio, per 5 minuti).
2. Per le azioni HTTP, verificare se l'API esterna ha un modello di operazione a esecuzione prolungata (polling con ripetizione dei tentativi).
3. Per Dataverse aggiungere $filter e $top ridurre il set di risultati.
4. Per le approvazioni, impostare una scadenza ragionevole e aggiungere un ramo di timeout per gestire le risposte non.

Informazioni correlate: OperationTimedOut

OperationTimedOut

Significato: un'operazione a esecuzione prolungata (attesa webhook, approvazione, polling HTTP) ha superato il tempo di attesa massimo.

Cause comuni:

• Azione webhook HTTP in attesa di un callback che non è mai venuto
• Azione di approvazione senza scadenza, raggiungendo il limite di esecuzione del flusso di 30 giorni
• Azione "Ritardo fino a" impostata su una data oltre il limite di durata di esecuzione di 30 giorni
• Il servizio esterno è inattivo e non ha mai inviato la risposta prevista

Come correggere:

1. Impostare sempre timeout espliciti nelle azioni webhook e approvazione.
2. Per le azioni webhook HTTP, implementare un ramo di timeout con Configura esecuzione dopo>il timeout.
3. Suddividere le attese lunghe in segmenti più brevi usando un ciclo con controlli giornalieri.
4. Per il limite di esecuzione di 30 giorni, riprogettare i processi a esecuzione prolungata per usare un modello di "inoltro": terminare l'esecuzione corrente e avviarne uno nuovo con lo stato passato tramite Dataverse o un file.

Informazioni correlate: ActionTimedOut

WorkflowRunActionRepetitionQuotaExceeded

Significato: un ciclo Apply to Each ha superato il numero massimo di iterazioni (valore predefinito: 100.000 per Premium, 5.000 per i profili di prestazioni).

Cause comuni:

• Elaborazione di una tabella di SharePoint list o Dataverse di grandi dimensioni senza filtrare prima
• Cicli annidati Apply to Each che moltiplicano i conteggi delle iterazioni (100 x 100 = 10.000)
• Azione Get items che restituisce tutte le righe anziché un subset filtrato

Come correggere:

1. Aggiungere filtri all'azione origine dati per ridurre il numero di elementi prima del ciclo.
2. Usare OData $filter e $top nelle azioni Recupera elementi anziché filtrare all'interno del ciclo.
3. Per set di dati di grandi dimensioni, eseguire in batch il lavoro su più esecuzioni del flusso usando token di paginazione o intervalli di date.
4. Prendere in considerazione l'uso Select di Filter array azioni o Apply to Each anziché quando è sufficiente trasformare o filtrare i dati.

Informazioni correlate: FlowRunQuotaExceeded

FlowRunQuotaExceeded

Significato: il flusso o il tenant ha superato il limite di esecuzione giornaliera delle azioni.

Cause comuni:

• Licenza con seeding/gratuito: 6.000 azioni al giorno per utente
• Licenza Premium: 40.000 azioni al giorno per utente
• Licenza del processo: 250.000 azioni al giorno per flusso
• Un flusso con un numero elevato di cicli che utilizza migliaia di azioni per esecuzione

Come correggere:

1. Controllare l'utilizzo corrente nell'interfaccia di amministrazione di Power Platform>Analytics>Power Automate.
2. Ottimizzare i flussi per usare un minor numero di azioni: sostituire Apply to Each con Select/Filter,batch operations, reduce polling frequency.
3. Aggiornare il livello di licenza se il carico di lavoro richiede legittimamente più capacità.
4. Distribuire i carichi di lavoro tra più flussi o pianificare l'esecuzione di volumi elevati durante le ore di minore attività.

Informazioni correlate: WorkflowRunActionRepetitionQuotaExceeded, DirectApiAuthorizationRequired

Errori di licenza

DirectApiAuthorizationRequired

Cosa significa: il flusso usa un connettore Premium, ma il chiamante non ha una licenza Premium.

Cause comuni:

• Un flusso con connettori Premium (HTTP, SQL Server, Dataverse, connettori personalizzati) viene eseguito da un utente in una licenza di Microsoft 365 con seeding
• Il proprietario del flusso ha premium, ma l'utente che attiva l'utente non (la licenza del chiamante è importante, non il proprietario)
• Il proprietario di un flusso pianificato ha perso la licenza Premium
• Un flusso nel contesto è stato disassociato dall'app Power, rendendolo out-of-context

Come correggere:

1. Identificare il connettore che richiede Premium. Il messaggio di errore lo denomina in genere.
2. Assegnare una licenza Power Automate Premium all'utente che attiva o esegue il flusso.
3. Per i flussi pianificati o automatizzati, assicurarsi che il proprietario del flusso disponga di una licenza Premium.
4. Valutare se una licenza di processo (per flusso) è più conveniente per i flussi condivisi con volumi elevati.

Informazioni correlate: Accesso negato (403),FlowRunQuotaExceeded

Tabella di riferimento rapido

Informazioni correlate

• Manuale delle espressioni per i workflow cloud
• Correggere gli errori di connessione nei flussi cloud
• Risolvere gli errori del flusso nel cloud
• Power Automate limiti e configurazione
• Guida alle licenze Power Automate

Nota: l'autore ha creato questo articolo con assistenza per l'intelligenza artificiale. Altre informazioni