Utilizzare il simulatore di playbook

Il simulatore di playbook fornisce un approccio semplificato per sviluppare playbook con tempi e sforzi ridotti.

Il simulatore di playbook offre diverse funzionalità chiave, che ti consentono di:

• Lavora in un ambiente di pre-produzione, che ti consente di testare le azioni e osservare i risultati senza influire sui dati di produzione attivi (soprattutto quando il playbook è disattivato).
• Facilita il test di ogni singolo passaggio o blocco del playbook per verificare che il flusso di lavoro funzioni come previsto.
• Testa tutti i possibili rami di condizioni all'interno del playbook, confermando una copertura completa e un comportamento prevedibile.

Utilizzare il simulatore di playbook con il playbook

Quando lavori con i playbook, che tu ne stia utilizzando uno esistente o ne stia creando uno nuovo, inizia sempre attivando il simulatore del playbook. Nella parte superiore viene visualizzato un indicatore verde che conferma l'attivazione.

Se utilizzi il simulatore di playbook su un playbook attivo, questo influisce su tutti gli avvisi in arrivo che attivano il playbook. Questo perché il salvataggio di un playbook con dati simulati applica questi dati alle richieste attive in produzione, il che può potenzialmente influire sui risultati reali.

1. Passa il puntatore sopra un avviso di richiesta, fai clic su more_vert Opzioni avviso e seleziona Importa avviso come scenario di test. Questa azione crea uno scenario di test per l'esecuzione del playbook simulato. Le entità modificate negli scenari di test non hanno alcuna influenza sulle entità nei casi normali.
2. Sposta il puntatore verso la parte inferiore della pagina Playbook e seleziona uno scenario di test. Assicurati che lo scenario di test selezionato corrisponda al playbook che intendi eseguire. Per confermare, fai clic su Entità e verifica che il playbook sia in grado di elaborare le entità presenti in questo scenario di test.
3. Fai clic su Esegui. Il simulatore elabora i passaggi, esegue le azioni definite e fornisce i risultati.

Interpretare i risultati del simulatore per ogni passaggio

Dopo aver fatto clic su Esegui, la prima riga della console viene visualizzata come se fosse un playbook live. Ogni passaggio simulato presenta opzioni, in genere tra cui Dati scenario, Visualizza risultati e Blocca risultati (o Inserisci risultati). I passaggi manuali richiedono un pulsante per inserire i parametri, fornire le risposte ed eseguire il passaggio.

Dati richiesta

L'icona Dati della richiesta apre una finestra di dialogo per visualizzare le informazioni della richiesta in quella fase specifica, dopo il completamento dell'azione corrente. Questa finestra di dialogo viene aggiornata dinamicamente con i risultati del passaggio corrente. Se un'azione ha aggiunto un arricchimento alla richiesta, lo vedrai qui. Poiché mostra lo stato della richiesta dopo l'esecuzione di un passaggio, i dati variano per ogni passaggio nella console di simulazione. L'ispezione dei dati del caso nei diversi passaggi ti aiuta a comprendere le modifiche applicate al caso durante l'esecuzione del playbook. Le varie schede della finestra di dialogo forniscono ulteriori dettagli.

Visualizza risultati

L'opzione Visualizza risultati mostra i risultati dell'azione specifica del passaggio corrente. Le informazioni presentate sono simili a una panoramica o a una bacheca dei casi e includono anche i dettagli di eventuali arricchimenti.

Puoi accedere a questi tipi di informazioni:

• La scheda principale mostra il messaggio di output, le tabelle, i link e gli allegati.
• La scheda Dettagli tecnici fornisce il risultato dell'azione e il risultato JSON (se presente).

Come per le altre opzioni, puoi fare clic sui dati per un'analisi più approfondita. Nella pagina Visualizza risultati, puoi anche fare clic su Imposta risultato JSON. Questa funzionalità consente di sostituire l'esempio JSON dell'azione corrente. Puoi modificare questo esempio JSON direttamente dall'ambiente di sviluppo integrato (IDE) e poi utilizzarlo nel generatore di espressioni per estrarre dati specifici dal risultato JSON.

Fissa risultati

L'opzione Blocca risultati è disponibile quando un passaggio viene eseguito correttamente. Si tratta di una funzionalità molto utile che ti consente di considerare il risultato di un'azione come fisso.

Fissare i risultati può farti risparmiare tempo perché:

• Eliminando la necessità di attendere i risultati di servizi di terze parti.
• Riduzione del numero di query effettuate a questi servizi, il che contribuisce a conservare le credenziali.

In sostanza, quando esegui nuovamente il playbook, qualsiasi passaggio con risultati bloccati viene "ignorato": il relativo codice non viene eseguito di nuovo e i risultati bloccati vengono utilizzati così come sono. Puoi anche modificare questo risultato inserendo dati simulati. Quando attivi l'opzione Blocca risultati, l'azione entra in modalità di simulazione e la rappresentazione visiva del passaggio in genere cambia da uno sfondo blu a uno grigio, indicando chiaramente che la modalità Simula è attiva per quel passaggio.

Inserisci risultati

L'opzione Inserisci risultati diventa disponibile se un passaggio non è riuscito. Questa funzionalità ti consente di inserire manualmente i dati di simulazione. La volta successiva che esegui questo passaggio specifico, restituisce come risultato i dati che hai fornito manualmente.

Una volta selezionata questa opzione, la modalità Simula viene attivata automaticamente. La rappresentazione visiva del passaggio cambia da uno sfondo blu a uno grigio, indicando chiaramente che la modalità Simula è attiva. Il campo Risultato script è obbligatorio per tutti i passaggi quando è attiva la modalità Simula.

Inserire dati simulati

Per inserire dati simulati, puoi considerare alcuni casi d'uso:

• Creazione e test del playbook in movimento: puoi eseguire un passaggio, visualizzare i risultati e capire immediatamente come utilizzare questi dati più avanti nel playbook.
• Risparmiare tempo dopo l'esecuzione: potresti voler bloccare i risultati del passaggio. In questo modo risparmierai tempo impedendo l'esecuzione ripetuta del passaggio sulle API di terze parti durante i test successivi.
• Test di diversi scenari: puoi modificare i risultati dei passaggi per testare il playbook in varie condizioni. Impostando dati di simulazione diversi, puoi influenzare le condizioni e le azioni successive che si basano sui risultati precedenti. Ad esempio, se il tuo playbook ha una condizione che si ramifica in due o più percorsi, puoi sperimentare con i dati di simulazione per "forzare" il playbook a seguire un ramo specifico.

Inserisci dati di simulazione

Puoi inserire dati di simulazione (fittizi) nel playbook in due modi principali: tramite la finestra di dialogo di configurazione del passaggio del playbook o utilizzando Blocca risultati (o Inserisci risultati) dopo l'esecuzione di un simulatore.

Utilizzare la finestra di dialogo di configurazione del passaggio del playbook

1. Fai clic sulla finestra di dialogo di configurazione del passaggio all'interno del playbook.
2. Attiva l'opzione Modalità di simulazione. La rappresentazione visiva dell'azione diventa grigia, a indicare che è in modalità di simulazione.
3. Nella sezione Risultati dell'azione, puoi inserire i dati di simulazione (mock). È incluso quanto segue:
• Risultato dello script: fornisci un risultato simulato per le azioni basate su script.
• Risultato JSON: inserisci i dati JSON, eventualmente estraendo dati specifici dal codice JSON. Puoi anche caricare un output di esempio facendo clic su Carica esempio. In questo modo viene caricato il risultato JSON previsto dell'azione, il che è particolarmente utile se:
• La simulazione non è ancora stata eseguita e l'output è vuoto.
• La simulazione non è riuscita e non vengono visualizzati risultati.
• Vuoi sostituire i risultati esistenti (ottenuti da precedenti blocchi o inserimenti) con il campione.
• Arricchimenti: puoi utilizzare gli arricchimenti delle esecuzioni di simulazione precedenti o creare chiavi di arricchimento personalizzate.

Utilizzare i risultati dopo l'esecuzione di una simulazione

Fissa risultati

Se un passaggio viene eseguito correttamente, puoi fare clic su Blocca risultati accanto all'azione. Dopo si verifica quanto segue:

• Il passaggio si apre automaticamente in modalità Simula.
.
• I risultati dell'ultima esecuzione della simulazione riuscita sono bloccati nel passaggio. Puoi utilizzare questi risultati o modificarli.
• Puoi modificare il risultato JSON utilizzando l'editor JSON o fare clic su Carica esempio per eseguire l'override.
• Puoi utilizzare gli arricchimenti delle esecuzioni di simulazione precedenti o creare chiavi di arricchimento personalizzate.

Inserisci risultati

Se un passaggio non è riuscito, puoi fare clic su Inserisci risultati accanto all'azione. Dopo si verifica quanto segue:

1. Questi dati verranno restituiti ogni volta che viene eseguito il passaggio.

Disattivare il simulatore di playbook

Quando disattivi il simulatore di playbook, la console in basso viene nascosta e qualsiasi passaggio in modalità di simulazione torna alla normale modalità "live". L'eccezione sono i blocchi del playbook: devi disattivare il simulatore di blocchi per chiudere la modalità di simulazione. I dati di simulazione (fittizi) inseriti vengono salvati per essere utilizzati la prossima volta che attivi il simulatore.

Utilizzare i blocchi del playbook

Puoi anche utilizzare il simulatore del playbook per creare e testare un nuovo blocco del playbook. Quando un blocco è in modalità simulazione, anche tutti i playbook principali che lo utilizzano utilizzano i dati simulati del blocco.