Creazione e configurazione di un Undercover Agent per un evento messaggio

Per creare e configurare un Undercover Agent per un evento messaggio, effettuare le seguenti operazioni:

1. Aprire il designer.
2. Per avviare il Nuovo Undercover Agent, fare clic sull'icona più (+) accanto a Eventi e selezionare Undercover Agent. Viene visualizzata la procedura guidata Nuovo Undercover Agent .
3. Nella finestra Nuovo Undercover Agent, inserire le seguenti informazioni:
   • Nome: immettere un nome per il nuovo Undercover Agent.
   • Tipo di pianificazione: selezionare Su evento dall'elenco a discesa.
   • Fare clic su Fine.
4. Nella sezione Comune, è possibile immettere una descrizione dell'Undercover Agent nella casella di testo Documentazione .
5. Nella sezione Scheduler, è possibile vedere il tipo di pianificazione per l'Undercover Agent corrente nel campo Tipo di pianificazione .
6. Oltre all'area Indicatore evento , accettare il Messaggiodell'indicatore evento predefinito. Se lo si desidera, è possibile fare clic su Seleziona e selezionare Contenuto. (La selezione Contenuto viene utilizzata per gestire gli eventi di contenuto che hanno origine dai server ECM. La selezione Messaggio viene utilizzata per gestire gli eventi del messaggio che hanno origine da definizioni di processi di business, listener JMS o servizi web creati dall'utente.)
7. In Dettagli, fare clic sull'elenco a discesa accanto a Nome coda per selezionare la coda desiderata dalle seguenti opzioni:

   Tabella 1. Opzioni di coda disponibili

   Opzione	Descrizione
   Coda asincrona	Consente ai lavori del Gestore eventi di essere eseguiti contemporaneamente.
   SYNC_QUEUE_1	Forza il completamento di un lavoro e l'avvio del lavoro successivo anche se l'attività precedente ha esito negativo. Per default, sono disponibili tre code sincrone.
   SYNC_QUEUE_2	Forza il completamento di un lavoro e l'avvio del lavoro successivo anche se l'attività precedente ha esito negativo. Per default, sono disponibili tre code sincrone.
   SYNC_QUEUE_3	Forza il completamento di un lavoro e l'avvio del lavoro successivo anche se l'attività precedente ha esito negativo. Per default, sono disponibili tre code sincrone.

   Nota: . Quando si installa ed esegue il processo su un server del flusso di lavoro in un ambiente di test o di produzione, la coda selezionata deve esistere in tale ambiente affinché l'Undercover Agent possa essere eseguito.
8. accanto a Implementazione, accettare la selezione predefinita Variabile o selezionare Servizio. Utilizzare un'implementazione variabile per passare gli eventi direttamente dall'Undercover Agent al processo. Per confronto, utilizzare un'implementazione del servizio per elaborare informazioni sugli eventi aggiungendo decisioni o logica di business.
9. Se si seleziona Variabile, il tipo di variabile predefinito NameValuePair è già selezionato. Tuttavia, è possibile fare clic su Seleziona per scegliere un tipo di variabile esistente diverso oppure fare clic su Nuovo per creare il tipo di variabile.
10. Se si è selezionato Servizio, il servizio allegato predefinito Evento BPD predefinito è già selezionato. Tuttavia, è possibile fare clic su Seleziona per scegliere un servizio esistente diverso oppure è possibile fare clic su Nuovo per creare un servizio.
11. Verificare che la casella di spunta Abilitata sia selezionata.
    Nota: se questa casella di spunta non è selezionata, il Gestore eventi non esegue l'Undercover Agent quando il messaggio viene ricevuto o inviato. (Il controllo Gestore eventi potrebbe mostrare che il Gestore eventi ha eseguito l'Undercover Agent, ma se questa casella di spunta non è selezionata, l'esecuzione non si verifica.)
12. Nella sezione Associazione parametri, selezionare la casella di spunta Utilizza valore predefinito se si desidera utilizzare il valore predefinito della variabile di input nel servizio collegato. Se la variabile di input del servizio collegato non ha un valore predefinito, questa casella di spunta è disabilitata.

    Immettere un valore nella casella di testo se si desidera associare un valore costante alla variabile di input del servizio collegato. Ad esempio, è possibile utilizzare una costante per scopi di test.

    Nella maggior parte dei casi, i valori richiesti sono inclusi nell'evento del messaggio in entrata e non è richiesta alcuna azione.

13. Nella sezione Evento, viene fornito un ID predefinito univoco nel campo Messaggio evento . Questo ID rappresenta il messaggio evento per l'elaborazione.

    Se si sta inviando un messaggio al gestore eventi da un sistema esterno, l'ID in questo campo è il nome evento che è necessario includere nel messaggio XML.

    Se si utilizza un servizio Web per abilitare un'applicazione esterna da richiamare nell' automazione del flusso di lavoro, non modificare questo ID. Il prodotto utilizza senza soluzione di continuità questo ID se si crea un'integrazione in entrata.

14. Aprire il processo che include l'evento messaggio a cui si desidera collegare l'Undercover Agent. Ad esempio, se si desidera che un particolare processo venga avviato quando un nuovo record cliente viene creato in un sistema esterno, è possibile associare l'evento di inizio nel processo con un Undercover Agent che gestisce tale evento in entrata.
    Nota: assicurarsi che il mittente e il destinatario di un messaggio utilizzino entrambi lo stesso Undercover Agent. Ad esempio, se il mittente di un messaggio è un evento di fine messaggio in un altro processo, selezionare lo stesso Undercover Agent sia per l'evento di inizio ricezione che per l'evento di fine messaggio di invio nell'altro processo.

    Suggerimento: se si utilizzano occasionalmente i messaggi in entrata, considerare l'utilizzo di eventi di sottoscrizione durevoli. Le sottoscrizioni durevoli sono sottoscrizioni Java™ Message Service (JMS) che persistono e memorizzano i messaggi sottoscritti anche quando il client non è connesso. I messaggi durevoli si accumulano, anche se si seleziona la casella di spunta per renderli utilizzabili. Utilizzare periodicamente il metodo DELETE /std/bpm/durable_messages in Operational Rest API per eliminare gli eventi di sottoscrizione durevoli.
15. Fare clic sull'evento messaggio nel processo per selezionarlo.
16. Fare clic sull'opzione della scheda Generale nelle proprietà.
17. Nella sezione Proprietà evento, fare clic su Seleziona accanto a UCA messaggio allegato e selezionare l'Undercover Agent creato nei passi precedenti.
18. Fare clic su Salva o Termina modifica.
    Per informazioni dettagliate sulla dichiarazione di variabili per i servizi umani lato client, vedere Dichiarazione di variabili
19. Nell'editor Undercover Agent, è possibile fare clic su Esegui ora se si desidera verificare e monitorare Undercover Agent.