Controllo del flusso

Migliora il tuo flusso di lavoro di sviluppo con la funzionalità di analisi statica in Verifica soluzione. Questo strumento supporta le procedure consigliate in automazione robotica dei processi (RPA) e soddisfa i requisiti critici dei flussi valutando automaticamente i flussi per garantire prestazioni ottimali. L'analisi statica è disponibile nella sezione Verifica flusso della finestra di progettazione. Applica le linee guida chiave e fornisce feedback in tempo reale e ispezione precoce del codice. Si integra direttamente nel flusso di lavoro, migliora la qualità del codice e getta le basi per un'esperienza di sviluppo più efficiente e produttiva.

Gestione regole

Definire e gestire le regole tramite Il controllo della soluzione nell'interfaccia di amministrazione di Power Platform e nella configurazione di Flow Checker nel portale di Power Automate.

Gli amministratori e gli utenti con le autorizzazioni appropriate possono:

• Abilitare o disabilitare le regole.
• Configurare i livelli di gravità (errore, avviso, informazioni).
• Configurare valori personalizzati per le regole che supportano parametri, ad esempio soglie e limiti (solo Power Automate portale).
• Applicare regole a ambienti o gruppi di ambiente specifici (solo ambienti gestiti, interfaccia di amministrazione di Power Platform).

La configurazione del controllo del flusso si applica a livello di ambiente e influisce su tutti i flussi desktop all'interno dell'ambiente selezionato.

Le impostazioni di imposizione del controllo della soluzione configurate nell'interfaccia di amministrazione di Power Platform hanno la precedenza sulle impostazioni di configurazione del controllo del flusso nel portale di Power Automate. Non è possibile modificare le regole soggette a restrizioni dall'applicazione forzata di Solution checker nel portale Power Automate.

Configurazione nell'interfaccia di amministrazione

Per configurare le regole di analisi statica:

1. Andare all'interfaccia di amministrazione di Power Platform.
2. Seleziona Gestisci>Ambienti per procedere.
3. Seleziona Modifica ambienti gestiti.
4. Nella sezione Applicazione di Solution checker, configura quali regole devono essere escluse per l'ambiente selezionato.

Configurazione nel portale di Power Automate

Per configurare le regole di controllo del flusso per un ambiente:

1. Passare alla pagina Flussi desktop nel portale di Power Automate.

2. Seleziona Flow checker.

3. Nel riquadro configurazione del controllo di flusso configurare le regole desiderate. Per ogni regola, è possibile:

   • Abilitare o disabilitare la regola.
   • Selezionare un livello di gravità.
   • Specificare un valore personalizzato per le regole che supportano i parametri.

4. Seleziona Salva.

Le modifiche di configurazione vengono applicate a livello di ambiente e influiscono su tutti i flussi desktop nell'ambiente selezionato. Per i flussi desktop già aperti nella finestra di progettazione, riaprire il flusso per rendere effettive le modifiche alla configurazione.

Eseguire l'analisi statica nel portale

Per attivare manualmente l'analisi statica:

1. Vai alla pagina Soluzioni nel portale Power Automate.

2. Apri il menu di scelta rapida (⋯) accanto a una soluzione.

3. Passa il mouse su Verifica soluzione.

4. Scegli una delle opzioni seguenti:

   • Esegui: avvia l'analisi statica.
   • Visualizza risultati: apre il report di analisi più recente.
   • Scarica risultati: esporta il report per la revisione offline.

Analisi statica nella finestra di progettazione

L'analisi statica viene eseguita automaticamente, ispezionando continuamente il codice senza richiedere interventi manuali. Quando aggiungi, rimuovi o modifichi azioni nel flusso, questa funzionalità si attiva per valutare le modifiche e aggiornare l'analisi. Questo processo rende lo sviluppo efficiente e senza interruzioni. Sul lato destro della finestra di progettazione è presente un pulsante Verifica flusso dedicato. Il numero visualizzato sul pulsante indica il numero totale di violazioni del flusso desktop. Seleziona il pulsante per aprire il riquadro Verifica flusso e visualizzare informazioni dettagliate sulle regole specifiche violate.

Ogni analisi genera un punteggio percentuale che mostra la proporzione di regole seguite con successo. Un punteggio più alto significa meno violazioni e una migliore qualità del codice.

Questo punteggio viene ricalcolato ogni volta che viene apportata una modifica al flusso, fornendo un feedback immediato e promuovendo buone pratiche di sviluppo.

In caso di violazione delle regole, il report di analisi statica mostra un riepilogo chiaro. Elenca i nomi delle regole e il numero di azioni o variabili nel flusso che violano ciascuna regola. La selezione di una regola evidenzia l'azione corrispondente e fornisce una spiegazione dettagliata dell'errore. Per le violazioni relative alle variabili, il sistema passa al riquadro delle variabili, semplificando le correzioni. Il riquadro Verifica flusso include funzionalità di ricerca e consente di filtrare per flusso secondario, in modo da trovare rapidamente problemi specifici.

Ogni violazione visualizza un riquadro con i dettagli, tra cui la natura dell'errore, le correzioni consigliate e un collegare alla documentazione. Usa il cursore nell'intestazione della regola per passare da un'occorrenza all'altra della stessa violazione. Queste linee guida consentono agli sviluppatori di risolvere i problemi in modo rapido ed efficace. Le violazioni di errore del controllo del flusso mostrano un indicatore in linea e una finestra popup con ulteriori dettagli. Anche gli avvisi vengono visualizzati direttamente nell'area di lavoro del designer, proprio come gli errori. Il progettatore mostra gli stati diagnostici, ad esempio avvisi ed errori, nelle schede dei sottoflussi e include un pulsante che consente di passare direttamente al componente che richiede attenzione.

Legenda

1. Occorrenze della violazione della regola specifica
2. Passa all'azione che viola la regola
3. Collegamento alla documentazione

Regole di analisi statica

Le regole di analisi statica sono linee guida predefinite che aiutano a garantire la sicurezza, la gestibilità e le prestazioni dei flussi. Ogni regola prende di mira aspetti specifici della progettazione del flusso, come la sicurezza, le prestazioni e la gestibilità, e fornisce commenti utili per migliorare la qualità del flusso. Di seguito è riportato un elenco delle regole, delle relative descrizioni e delle correzioni suggerite.

Sicurezza password non sicura

• Gravità: Avviso
• Tipo: Sicurezza
• Dettagli errore: le password vengono gestite in modo non sicuro nel flusso.
• Descrizione: questa regola verifica se le password sono gestite in modo non sicuro all'interno di un flusso desktop per garantire che non vengano esposte o gestite in modo errato durante l'esecuzione.
• Correzione suggerita: assicurati che tutti gli input relativi alle password siano gestiti in modo appropriato usando le funzionalità di password di Power Automate per desktop. Utilizza l'opzione "Inserimento diretto di testo crittografato" per la massima sicurezza grazie alla crittografia basata su computer. Per i flussi usati su computer diversi, scegli "Input password come variabile" e contrassegna la variabile corrispondente come sensibile per migliorare la sicurezza. Inoltre, usa funzionalità di gestione delle credenziali sicure come l'azione "Ottieni credenziali", che si integra con le credenziali CyberArk.

Ricorsività tra due flussi secondari

• Gravità: Avviso
• Tipo: Progettazione
• Dettagli errore: sono state rilevate chiamate ricorsive tra flussi secondari che possono causare un ciclo infinito.
• Descrizione: questa regola verifica la presenza di chiamate ricorsive tra due o più flussi secondari, garantendo che il flusso non si traduca in un ciclo infinito.
• Correzione suggerita: elimina le chiamate ricorsive tra i flussi secondari.

Lunghezza massima della variabile superata

• Severità: Avviso
• Tipo: manutenibilità
• Dettagli errore: nome della variabile supera il limite di 40 caratteri.
• Descrizione: questa regola verifica se il nome di ogni variabile definita nel flusso ha una lunghezza superiore a un numero di caratteri specificato. Il limite predefinito è di 40 caratteri.
• Correzione suggerita: rinomina le variabili che superano il limite di caratteri specificato per assicurarti che i relativi nomi abbiano una lunghezza inferiore a 40 caratteri.

Valori predefiniti delle variabili di input

• Gravità: Avviso
• Tipo: manutenibilità
• Dettagli errore: le variabili di input/output non utilizzano valori predefiniti.
• Descrizione: questa regola verifica se le variabili di input/output utilizzano valori predefiniti, assicurando che siano configurate correttamente per il flusso.
• Correzione suggerita: assegna valori predefiniti a tutte le variabili di input e output nel flusso.

Soglia per numero di variabili di input e output

• Gravità: Avviso
• Tipo: manutenibilità
• Dettagli errore: le variabili di input/output totali superano il limite di 25 variabili.
• Descrizione: questa regola verifica se il numero totale di variabili di input/output nel flusso supera una soglia specificata. Il limite è di 25 variabili.
• Correzione suggerita: assicurati che il numero di variabili di input e output nel flusso non superi 25.

Azione in caso di errore per blocco vuoto

• Gravità predefinita: Avviso
• Tipo: Progettazione
• Dettagli dell'errore: l'azione "In caso di errore del blocco" è vuota e non gestisce gli errori.
• Descrizione: Questa regola verifica se le azioni "In caso di errore del blocco" nel tuo flusso sono configurate correttamente per gestire gli errori, garantendo che gli errori vengano generati e gestiti come previsto.
• Correzione consigliata: Per gestire i possibili errori, configura le azioni In caso di errore nel blocco nel flusso.

Istruzioni if annidate

• Gravità: Avviso
• Tipo: manutenibilità
• Dettagli errore: le clausole if annidate superano i cinque livelli.
• Descrizione: questa regola verifica se sono presenti istruzioni if annidate con più di cinque livelli, assicurando che il flusso rimanga gestibile e leggibile.
• Correzione suggerita: ristruttura il flusso per ridurre le istruzioni if annidate a non più di cinque livelli.

Incompleto se

• Gravità: Avviso
• Tipo: Progettazione
• Dettagli errore: è stata rilevata un'azione If incompleta, priva di contenuto o contenente solo azioni nel ramo Else.
• Descrizione: questa regola rileva azioni If prive di contenuto o contenenti solo azioni nel ramo Else, assicurando un'efficace implementazione delle istruzioni condizionali.
• Correzione suggerita: esamina il flusso e rivedi ogni condizione "If" per assicurarti che includa azioni significative nei rami "If", "Else if" ed "Else".

Ciclo infinito

• Gravità: Avviso
• Tipo: Progettazione
• Dettagli errore: è stato rilevato un ciclo infinito nel flusso che potrebbe causarne l'esecuzione a tempo indefinito.
• Descrizione: questa regola verifica se nel flusso sono presenti cicli infiniti, in modo da identificare ed evitare scenari in cui il flusso potrebbe essere eseguito indefinitamente.
• Correzione suggerita: assicurati che ogni ciclo abbia una condizione di terminazione chiaramente definita e realizzabile. La condizione può essere basata su un contatore, su un valore specifico o sul completamento di un'attività. Aggiungi controlli o condizioni di arresto di sicurezza per interrompere il ciclo se continua più a lungo del previsto. Ad esempio, impostare un numero massimo di iterazioni o includere un timeout.

Uso improprio delle azioni di attesa

• Gravità: Avviso
• Tipologia: Performance
• Dettagli dell'errore: è stato rilevato un uso improprio delle azioni di attesa, con più di 10 azioni di attesa che possono creare colli di bottiglia.
• Descrizione: Questa regola verifica se il flusso contiene un numero eccessivo di azioni di attesa, ovvero più di 10, per contribuire a identificare e ridurre al minimo i potenziali colli di bottiglia causati da ritardi prolungati.
• Correzione suggerita: esamina il flusso per identificare tutte le azioni di attesa e verifica se sono essenziali per la logica del flusso. Elimina le attese inutili o combinale ove possibile.

Tempo di attesa molto elevato

• Gravità: Avviso
• Tipo: prestazioni
• Dettagli errore: è stato rilevato un tempo di attesa molto elevato, di durata superiore al limite di 600 secondi consentito per le azioni di attesa hardcoded.
• Descrizione: questa regola verifica se le azioni di attesa hardcoded nel flusso superano un intervallo di tempo specificato, con il limite impostato su 600 secondi.
• Correzione suggerita: esamina il flusso per trovare le azioni di attesa che superano il limite di 600 secondi. Controlla se questi lunghi tempi di attesa sono necessari e regolane la durata in base al tempo più breve necessario per il corretto funzionamento del flusso. Se è necessaria un'attesa prolungata, suddividila in intervalli più brevi e aggiungi controlli o condizioni tra di essi. Quando possibile, sostituisci le azioni di attesa prolungata con trigger basati su eventi.

Azioni non raggiunte

• Gravità: Avviso
• Tipo: manutenibilità
• Dettagli dell'errore: una o più azioni nel flusso non sono raggiungibili e non verranno eseguite in nessuna circostanza.
• Descrizione: questa regola verifica la presenza di azioni nel flusso che sono logicamente irraggiungibili. Le azioni non raggiungibili possono derivare da diramazioni errate, condizioni posizionate in modo errato o segmenti disconnessi e potrebbero indicare difetti nella logica o nella struttura del flusso.
• Soluzione consigliata: esamina il flusso per trovare le azioni che non sono connesse a un percorso di esecuzione. Assicurati che ogni azione sia raggiungibile tramite un ramo logico o un ciclo valido. Rimuovi o sposta le azioni non raggiungibili per mantenere il flusso pulito ed efficiente.

Flusso secondario non necessario

• Gravità: avviso
• Tipo: manutenibilità
• Dettagli errore: la regola ha rilevato un flusso secondario che non contiene azioni, solo azioni disabilitate o include troppe azioni per giustificarne la separazione. Tali flussi secondari potrebbero non contribuire significativamente all'esecuzione del flusso e possono ridurre la chiarezza.
• Descrizione: questa regola controlla la presenza di flussi secondari vuoti o eccessivamente minimi, che in genere contengono meno di 5 azioni. Anche se i sottoflow sono utili per la modularità e il riutilizzo, quelli che non dispongono di contenuti o astrazioni significativi possono indicare lo sviluppo incompleto, la frammentazione non necessaria o la configurazione errata. Questi modelli possono causare confusione e ostacolare la manutenibilità.
• Correzione suggerita: esaminare il sottoflow identificato per determinare se serve uno scopo chiaro e prezioso. In caso contrario, provare a rimuoverlo o a unirlo in un blocco di logica correlato. Se il sottoflow è destinato a un uso futuro, aggiungere un'azione placeholder per chiarirne il ruolo e prevenire interpretazioni errate.

Limitazioni note

• Disponibile solo in Ambienti gestiti.
• La personalizzazione delle regole si limita all'abilitazione o alla disabilitazione delle regole e alla configurazione della gravità.

Problemi noti

• L'eliminazione delle azioni copiate dopo aver visualizzato il dettaglio di una violazione di una regola può generare errori non gestiti.
• L'uso di una variabile password non riservata nelle azioni seguenti causa l'esito negativo dell'analisi statica durante la valutazione delle regole.
  • Visualizza finestra di dialogo di input
  • Visualizza finestra di dialogo di selezione cartella
  • Visualizza modulo personalizzato