Verifica flusso (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

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.

Importante

• Questa è una funzionalità di anteprima.
• Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono soggette a condizioni per l'utilizzo supplementari e sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso iniziale e fornire feedback.

Gestione regole

Le regole vengono definite e gestite tramite Verifica soluzione nell'interfaccia di amministrazione di Power Platform. Gli amministratori possono:

• Abilitare o disabilitare le regole.
• Configurare i livelli di gravità (errore, avviso, informazioni).
• Applicare regole ad ambienti o gruppi di ambienti specifici (solo ambienti gestiti).

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 Verifica soluzione, configura quali regole devono essere escluse per l'ambiente selezionato.

Nota

• Se l'ambiente fa parte di un gruppo di ambienti con una configurazione definita, le impostazioni della regola vengono ereditate e non possono essere modificate singolarmente. Scopri di più sulla Verifica soluzione in Verifica soluzione e sull'Applicazione della Verifica soluzione negli ambienti gestiti.
• Gli amministratori Power Platform devono assegnare il seguente privilegio a tutti i ruoli che richiedono l'accesso alla funzionalità: prvReadmsdyn_analysisoverride (il nome descrittivo è "Sostituzione analisi (lettura)").

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 puntatore del 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.

Nota

L'analisi statica viene eseguita per tutti i flussi desktop inclusi in una soluzione. Identifica quale flusso desktop attiva una specifica violazione della regola controllando la colonna Nome oggetto nei risultati. Questa colonna mostra il nome del flusso desktop corrispondente.

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.

Ogni analisi genera un punteggio percentuale che mostra la percentuale 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.

Ogni violazione visualizza un riquadro con i dettagli, tra cui la natura dell'errore, le correzioni consigliate e un collegamento alla documentazione. Utilizza il dispositivo di scorrimento nell'intestazione della regola per spostarti tra le occorrenze della stessa violazione. Queste linee guida consentono agli sviluppatori di risolvere i problemi in modo rapido ed efficace.

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.

Gestione 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: prestazioni
• 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 della variabile superata

• Gravità: avviso
• Tipo: manutenibilità
• Dettagli errore: nome della variabile supera il limite di 25 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 25 caratteri.
• Correzione suggerita: rinomina le variabili che superano il limite di caratteri specificato per assicurarti che i relativi nomi abbiano una lunghezza inferiore a 25 caratteri.

Valori predefiniti 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 errore su blocco vuota

• Gravità predefinita: avviso
• Tipo: manutenibilità
• Dettagli errore: l'azione "errore su blocco" è vuota e non gestisce errori.
• Descrizione: questa regola controlla se le azioni "Errore su blocco" nel flusso sono configurate correttamente per gestire gli errori, assicurandosi che vengano generati e gestiti come previsto.
• Correzione suggerita: per gestire i potenziali errori, configura le azioni Errore su blocco nel flusso.

Clausole 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: esegui il refactoring del flusso per ridurre l'annidamento delle istruzioni if a non più di cinque livelli.

Azione if incompleta

• Gravità: avviso
• Tipo: manutenibilità
• 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: prestazioni
• 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 sicurezza per interrompere il ciclo se l'esecuzione è più lunga del previsto. Ad esempio, impostare un numero massimo di iterazioni o includere un timeout.

Uso improprio azioni di attesa

• Gravità: avviso
• Tipo: prestazioni
• Dettagli errore: è stato rilevato un uso improprio delle azioni di attesa, con più di 10 azioni di attesa che causano potenziali colli di bottiglia.
• Descrizione: questa regola verifica se il flusso contiene un numero eccessivo di azioni di attesa, più di 10, per 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.

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