Documentazione di Oracle Cloud Infrastructure

Mapping di flusso

Gli argomenti riportati di seguito mostrano i vari tipi di eventi da cui è possibile eseguire il mapping a un flusso.

Mappare un intento a un flusso

È possibile mappare un intento a un flusso quando si crea il flusso:

  1. Nella pagina Eventi fare clic su + Aggiungi flusso.
  2. Nella finestra di dialogo Crea flusso, compilare i campi obbligatori, incluso Nome intento.

Se è già stato definito un flusso e ora è necessario mappare un intento, eseguire il mapping dell'intento:

  1. Nella pagina Flussi, nella lista dei flussi, selezionare Flusso principale.
  2. Fare clic su Questa è un'immagine dell'icona Aggiungi. nella sezione Eventi intento.
    Immagine dell'intestazione della sezione Eventi intenti.

  3. Nella finestra di dialogo Crea gestore eventi intento selezionare il nome dell'intento e il flusso mappato, quindi fare clic su Crea.
    Segue la descrizione di df-create-intent-event-handler-dialog.png
    Descrizione dell'immagine df-create-intent-event-handler-dialog.png

    .

Mappa un evento integrato a un flusso

  1. Selezionare Flusso principale.
  2. Fare clic su Questa è un'immagine dell'icona Aggiungi. nella sezione Eventi built-in.
    Immagine dell'intestazione Eventi integrati.

  3. Nella finestra di dialogo Crea handler di eventi incorporato, selezionare il tipo di evento dal flusso mappato e fare clic su Crea.
    Segue la descrizione dell'immagine df-2-0-built-events-mapping-dialog.png
    Descrizione dell'illustrazione df-2-0-built-events-mapping-dialog.png

Mappa un evento di transizione a un flusso

  1. Selezionare il flusso a cui mappare l'evento.
  2. Selezionare la scheda Configurazione.
  3. Espandere la sezione Mappature eventi.
  4. Nel campo della transizione che si desidera mappare, selezionare uno stato.

Richiama un flusso da un altro flusso

Per richiamare un flusso da un altro flusso, utilizzare i componenti Richiama flusso e Fine flusso. Funzionamento:

  • Il flusso padre chiama il flusso figlio da uno stato di flusso di richiamo. Questo stato viene utilizzato per passare e ricevere valori dal flusso figlio.
  • Lo stato del flusso finale del flusso figlio riporta i relativi parametri di output al flusso padre e può anche attivare un'azione eseguita dal flusso padre dopo la fine del flusso figlio.

    Se il flusso figlio si dirama e ha più stati di flusso finale, ognuno può restituire la propria azione al flusso padre e il flusso padre può utilizzare queste azioni per determinare la diramazione da seguire.

    Le transizioni azione consentono di di diramare il flusso padre in base ai risultati del flusso figlio. Ad esempio, se si dispone di un flusso figlio che dovrebbe cercare un account, potrebbe passare un'azione per il successo e un'azione per il fallimento.

  • Al termine del flusso figlio, il flusso padre riprende.

Ad esempio, un flusso Aggiorna conto in uno skill finanziario sarebbe il flusso padre che può completare la richiesta di aggiornamento dell'utente solo chiamando un flusso figlio, Recupera conto. Il risultato, o parametro di output previsto dal flusso padre dopo l'esecuzione del flusso figlio, è l'account utente. In questo caso, il conto è il parametro di output inviato allo stato del flusso di richiamo dallo stato del flusso finale del flusso figlio.

Per collegare i flussi:
  1. Creare i parametri di input e output per il flusso figlio.
  2. Nel flusso padre o chiamante, fare clic sull'icona Aggiungi stato nel punto in cui si desidera chiamare il flusso figlio e selezionare il componente Controllo flusso > Richiama flusso. quindi fare clic su Inserisci.
  3. Aprire la finestra di ispezione delle proprietà per lo stato del flusso di richiamo appena aggiunto.
  4. Nella pagina Generale, immettere un nome e una descrizione.
  5. Nella pagina Componente, selezionare il flusso figlio dall'elenco a discesa Flusso.
  6. Se il flusso padre deve passare i parametri al flusso figlio, fare clic su Aggiungi, quindi selezionare il parametro di input appartenente al flusso figlio e immettere un valore predefinito. quindi fare clic su Salva. Ripetere questa operazione per ogni parametro di input.
  7. Se il flusso padre prevede un risultato dal flusso figlio, fare clic su Aggiungi per selezionare il parametro di output appartenente al flusso figlio, quindi assegnare un nome alla variabile del flusso (padre) corrente che viene impostata sul valore del parametro di output.
  8. Aprire la pagina Transizioni per impostare lo stato successivo e, se necessario, aggiungere transizioni di azione quali l'annullamento o l'errore.
  9. Se nel flusso padre sono state configurate transizioni di azioni, configurare gli stati di fine flusso nel flusso figlio per attivare tali azioni. È possibile eseguire queste operazioni nella pagina Componente di ogni strumento di ispezione delle proprietà del flusso finale.
  10. Se è necessario restituire un parametro al flusso padre, fare clic su Aggiungi, quindi immettere il nome che corrisponde al nome del parametro nello stato del flusso di richiamo del flusso padre. Immettere quindi un valore di output del parametro e fare clic su Salva.

Richiama un'altra competenza da un flusso

Per richiamare un altro skill da un flusso, utilizzare i componenti Richiama skill e Termina flusso. Funzionamento:

  • L'abilità che si sta chiamando deve trovarsi nello stesso assistente digitale dell'abilità da cui si sta chiamando.
  • Lo skill che si sta chiamando deve avere un flusso designato come pubblico.
  • Il flusso chiamante utilizza uno stato Richiama skill per specificare una versione di uno skill e un flusso di destinazione in tale skill. Usa questo stato per passare i valori e ricevere i valori dallo skill chiamato.
  • Lo stato del flusso finale del flusso di destinazione riporta i relativi parametri di output al flusso chiamante e può anche attivare un'azione eseguita dal flusso chiamante al termine del flusso di destinazione.

    Se il flusso di destinazione si dirama e ha più stati di flusso finale, ognuno può restituire la propria azione al flusso chiamante e il flusso chiamante può utilizzare queste azioni per determinare quale ramo seguire.

    Le transizioni azione consentono di di diramare il flusso chiamante in base ai risultati del flusso di destinazione. Ad esempio, se si dispone di un flusso di destinazione che dovrebbe cercare un account, potrebbe passare un'azione per il successo e un'azione per l'errore.)

  • Al termine del flusso di destinazione, il flusso di chiamata dall'abilità chiamante riprende.

Ad esempio, un flusso Aggiorna conto in uno skill finanziario sarebbe il flusso chiamante che può completare solo la richiesta di aggiornamento dell'utente chiamando un flusso di destinazione, Recupera conto. Il risultato, o parametro di output previsto dal flusso chiamante dopo l'esecuzione del flusso di destinazione, è l'account utente. In questo caso, il conto è il parametro di output inviato allo stato di capacità di richiamo dallo stato di flusso finale del flusso di destinazione.

Per collegare i flussi:
  1. Creare i parametri di input e output per il flusso di destinazione.
  2. Nel flusso di destinazione selezionare la scheda Configurazione, espandere la sezione Generale e attivare lo switch Pubblico.
    Questo è uno screenshot di una parte della pagina Configurazione che mostra il campo Richiedi autorizzazione e lo switch Pubblico.

  3. Nel flusso chiamante, fare clic sull'icona Aggiungi stato nel punto in cui si desidera chiamare il flusso di destinazione e selezionare il componente Controllo flusso > Richiama competenza. quindi fare clic su Inserisci.
  4. Aprire la finestra di ispezione delle proprietà per lo stato dello skill di richiamo appena aggiunto.
  5. Nella pagina Generale, immettere un nome e una descrizione.
  6. Nella pagina Componente, selezionare lo skill dall'elenco a discesa Competenza.
  7. Selezionare una versione dall'elenco a discesa Versione skill.
    Nota

    Questo valore si applica solo se lo skill a cui viene fatto riferimento è uno skill autonomo. Se lo skill di destinazione si trova nello stesso assistente digitale dello skill chiamante, in fase di esecuzione viene utilizzata la versione dello skill presente nell'assistente digitale e il valore di questo campo viene ignorato.
  8. Nell'elenco a discesa Nome flusso selezionare uno dei flussi pubblici appartenenti allo skill selezionato.
  9. Se il flusso chiamante deve passare i parametri al flusso di destinazione, fare clic su Aggiungi, quindi selezionare il parametro di input appartenente al flusso di destinazione e immettere un valore predefinito. quindi fare clic su Salva. Ripetere questa operazione per ogni parametro di input.
  10. Se il flusso chiamante prevede un risultato dal flusso di destinazione, fare clic su Aggiungi per selezionare il parametro di output appartenente al flusso di destinazione, quindi assegnare un nome alla variabile del flusso chiamante che viene impostata sul valore del parametro di output.
    Nota

    Se il flusso di destinazione non è ancora disponibile, è possibile specificare che il flusso utilizza dati mock per i parametri di output in modo da poter continuare a sviluppare e testare il flusso in attesa che il flusso di destinazione diventi disponibile. A tale scopo, impostare la proprietà Usa motivo su True e immettere i parametri e i valori di output nel campo Parametri di output di spostamento. Immettere ogni parametro in una riga separata nel form 
    ParamName: ParamValue
  11. Aprire la pagina Transizioni per impostare lo stato successivo e, se necessario, aggiungere transizioni di azione quali l'annullamento o l'errore.
  12. Se nel flusso chiamante sono state configurate transizioni di azioni, configurare gli stati di fine flusso nel flusso di destinazione per attivare tali azioni. È possibile eseguire queste operazioni nella pagina Componente di ogni strumento di ispezione delle proprietà del flusso finale.
  13. Se è necessario passare di nuovo un parametro al flusso chiamante, fare clic su Aggiungi, quindi immettere il nome che corrisponde al nome del parametro nello stato della competenza di richiamo del flusso chiamante. Immettere quindi un valore di output del parametro e fare clic su Salva.