Creazione e gestione di un servizio

Prima di creare un monitor per un progetto, è necessario creare un servizio e indicare il tipo di autenticazione richiesto per il servizio. In IBM Process Mining è possibile creare un servizio utilizzando API Rest e un server SMTP. È possibile invocare il servizio ogni volta che il monitor rileva dei dati. Ad esempio, l'API che compone il servizio può essere invocata ogni volta che il monitor rileva dei dati. I risultati creati da un monitor vengono passati come input all'API o all'SMTP.

Per ulteriori informazioni, vedi le seguenti sezioni:

Comprensione della relazione tra servizio e monitor

I dati raccolti dopo ogni esecuzione del controllo vengono impacchettati in un payload JSON e inviati all'endpoint del servizio associato definito dall'utente.

Quando crei un evento di controllo, puoi definire i parametri di query e i parametri di intestazione della richiesta nella chiamata API del servizio. In IBM Process Mining è possibile definire l'opzione Parametri corpo per garantire che il payload utilizzi un formato JSON predefinito, che include tutti i dati disponibili, oppure si può utilizzare l'opzione Corpo personalizzato per personalizzare il payload in base a un formato specifico. Per ulteriori informazioni sui vari tipi di monitor e sulle relative impostazioni, vedere Tipi di monitor.

Creazione di un servizio

Nella pagina Action Hub, è possibile creare un servizio per Rest API e un server SMTP.

Creare un servizio utilizzando un'API Rest

Per creare un servizio utilizzando l'API Rest, si può procedere come segue:

  1. Aprite un progetto e andate alla pagina Action Hub.

  2. Nella pagina Action Hub, fare clic su Crea servizio.

  3. Nella sezione Tipo di servizio della finestra di dialogo Crea un nuovo servizio, assicurarsi che sia selezionato Rest API, quindi nel campo Titolo del servizio digitare un nome per il servizio.

  4. Nel campo Descrizione , immettere una descrizione per il servizio che si sta creando.

  5. Nel campo URL digitare il sito URL al quale devono essere pubblicati i risultati. Si noti che è necessario fornire l'intero URL con http:// o https://.

  6. Impostare Consenti certificati autofirmati su True se i certificati provengono da un'origine attendibile. È possibile selezionare True o False in base all'API che si desidera creare.

  7. Impostare Condividi con altri su True per condividere il servizio con altri account nell'organizzazione. Altrimenti, impostare Condividi con altri su Falso.

  8. Nella sezione Tipo di autenticazione, fare clic su uno dei seguenti tipi:

    • Chiave API, se l'autenticazione viene eseguita in base a un valore e una chiave API.
    • Autenticazione di base, se l'autenticazione viene eseguita utilizzando una credenziale di login.
    • Nessuna autenticazione, se non è richiesta alcuna autenticazione.
  9. Per l'autenticazione con chiave API, procedere come segue:
    1. Nel campo Posizione, selezionare Intestazione o Query.
    2. Nel campo Nome chiave API, digitare il nome della chiave API.
    3. Nel campo Valore chiave API, digitare il valore della chiave API.
  10. Per l'autenticazione Basic Auth, procedere come segue:
    1. Nel campo Nome utente, digitare il nome utente.
    2. Nel campo Password, digitare la password.

  11. Fare clic su Crea.

Creare un servizio per un server SMTP

A partire dalla IBM Process Mining1.14.2, è possibile creare un servizio per un server SMTP e inviare i risultati di un evento di monitoraggio all'indirizzo e-mail definito.

Prima di creare un servizio SMTP, è necessario ottenere le seguenti informazioni:

  • Indirizzo del server SMTP a cui si desidera inviare il risultato di un evento di monitoraggio
  • Numero di porta del server SMTP

Per creare un servizio SMTP, si può procedere come segue:

  1. Aprite un progetto e andate alla pagina Action Hub.

  2. Nella pagina Action Hub, fare clic su Crea servizio.

  3. Nella sezione Tipo di servizio della finestra di dialogo Crea un nuovo servizio, fare clic su SMTP.

  4. Nel campo Titolo del servizio, digitare un nome per il servizio.

  5. Facoltativo: nel campo Descrizione, digitare una descrizione per il servizio che si desidera creare.

  6. Impostare Condividi con altri su True per condividere il servizio con altri account nell'organizzazione. Altrimenti, impostare Condividi con altri su Falso.

  7. Nel campo Server SMTP, digitare l'indirizzo del server SMTP al quale si desidera inviare i risultati di un evento di monitoraggio (ad esempio, l'indirizzo del server SMTP), smtp-mail.outlook.com ).

  8. Nel campo Porta, digitare il numero di porta del server SMTP (ad esempio, 587 ). Potrebbe essere necessario contattare il fornitore del servizio SMTP per ottenere il numero di porta.

  9. Nei campi Nome utente e Password, digitare il nome utente e la password dell'account del server.

  10. Nel campo Indirizzo e-mail, digitate il vostro indirizzo e-mail. Il campo Risposta a nell'e-mail del destinatario viene aggiornato con il valore fornito nel campo Indirizzo e-mail.

  11. Nella casella Nome visualizzato, digitare il valore che si desidera utilizzare come nome del mittente.

  12. Impostare i pulsanti Forza l'uso di una connessione sicura (TLS) e Usa TLS esplicito in base al fornitore di servizi SMTP.

  13. Fare clic su Crea.

Gestione di un servizio

La pagina Gestione servizi consente di visualizzare tutti i servizi creati per un processo e di modificare, eliminare o duplicare un servizio creato per il processo.

Per gestire un servizio, effettuare le seguenti operazioni:

  1. Nella pagina Action Hub, fare clic su Gestisci servizi.

  2. Per cercare un servizio, digitate il nome del servizio nella casella di ricerca.

  3. Per ordinare i servizi, eseguire una delle seguenti operazioni nella casella Ordina per :

    • Fare clic su Ultima modifica per ordinare i servizi in base alla modifica eseguita. L'ultimo servizio modificato viene visualizzato come primo.
    • Fare clic su In ordine alfabetico per ordinare i servizi in ordine alfabetico.
    • Fare clic su Prima più vecchia per visualizzare i servizi meno recenti creati per il processo.

  4. Per filtrare i servizi, dall'elenco a discesa Filtra per, selezionare Rest API o SMTP

  5. Per modificare un servizio, procedere come segue:
    1. Nella finestra di dialogo Gestione servizi, fare clic sull'icona tre punti corrispondente al servizio richiesto, quindi fare clic su Modifica.
    2. Nella finestra di dialogo Modifica servizio, modificare il campo richiesto, quindi fare clic su Aggiorna
  6. Per eliminare un servizio, procedere come segue:
    1. Nella finestra di dialogo Gestione servizi, fare clic sull'icona tre punti corrispondente al servizio richiesto, quindi fare clic su Elimina.
    2. Nella finestra di messaggio Elimina servizio , fare clic su Elimina.

  7. Per duplicare un servizio, fare clic sull'icona tre punti corrispondente al servizio richiesto, quindi fare clic su Duplica.