Service erstellen und verwalten

Bevor Sie einen Monitor für ein Projekt erstellen, müssen Sie einen Dienst erstellen und die Art der für den Dienst erforderlichen Authentifizierung angeben. Unter IBM Process Mining können Sie einen Dienst mit Rest API und einem SMTP-Server erstellen. Sie können den Dienst immer dann aufrufen, wenn der Monitor Daten erkennt. So kann beispielsweise die API, aus der der Dienst besteht, immer dann aufgerufen werden, wenn der Monitor Daten erkennt. Die von einem Monitor erzeugten Ergebnisse werden als Eingaben an die API oder SMTP weitergeleitet.

Weitere Informationen finden Sie in den folgenden Abschnitten:

Verstehen der Beziehung zwischen Service und Überwachung

Die nach jeder Überwachungsausführung erfassten Daten werden in JSON-Nutzdaten gepackt und an den zugehörigen Serviceendpunkt gesendet, der vom Benutzer definiert wird.

Wenn Sie ein Überwachungsereignis erstellen, können Sie Abfrageparameter und Anforderungsheaderparameter im Service-API-Aufruf definieren. Unter IBM Process Mining können Sie die Option Body-Parameter definieren, um sicherzustellen, dass die Nutzlast ein vordefiniertes JSON-Format verwendet, das alle verfügbaren Daten enthält, oder Sie können die Option Benutzerdefinierter Body verwenden, um die Nutzlast an ein bestimmtes Format anzupassen. Weitere Informationen zu den verschiedenen Monitortypen und deren Einstellungen finden Sie unter Monitortypen.

Service erstellen

Auf der Seite Action Hub können Sie einen Dienst für die Rest-API und einen SMTP-Server erstellen.

Erstellen eines Dienstes mit einer Rest-API

Mit den folgenden Schritten können Sie einen Dienst mit Rest-API erstellen:

  1. Öffnen Sie ein Projekt und gehen Sie dann auf die Seite Action Hub.

  2. Klicken Sie auf der Seite Action Hub auf Service erstellen.

  3. Vergewissern Sie sich, dass im Abschnitt Diensttyp des Dialogfelds Neuen Dienst erstellen die Option Rest API ausgewählt ist, und geben Sie dann im Feld Diensttitel einen Namen für den Dienst ein.

  4. Geben Sie im Feld Beschreibung eine Beschreibung für den Service ein, den Sie erstellen.

  5. In das Feld URL geben Sie die URL ein, auf der die Ergebnisse veröffentlicht werden sollen. Beachten Sie, dass Sie die vollständige URL mit http:// oder https:// angeben müssen.

  6. Setzen Sie Selbst signierte Zertifikate zulassen auf True , wenn die Zertifikate aus einer vertrauenswürdigen Quelle stammen. Je nach der API, die Sie erstellen möchten, können Sie zwischen True und False wechseln.

  7. Setzen Sie Mit anderen teilen auf True , um den Service mit anderen Konten in der Organisation gemeinsam zu nutzen. Andernfalls setzen Sie Freigeben für andere auf Falsch.

  8. Klicken Sie im Abschnitt Authentifizierungstyp auf einen der folgenden Typen:

    • API-Schlüssel, wenn die Authentifizierung auf der Basis eines API-Schlüssels und -Werts ausgeführt wird.
    • Basisauthentifizierung, wenn die Authentifizierung mit einem Anmeldeberechtigungsnachweis erfolgt.
    • Keine Authentifizierung, wenn keine Authentifizierung erforderlich ist.
  9. Führen Sie für die API-Schlüsselauthentifizierung die folgenden Schritte aus:
    1. Wählen Sie im Feld Position die Option Kopfzeile oder Abfrage.
    2. Geben Sie in das Feld API-Schlüsselname den Namen für den API-Schlüssel ein.
    3. Geben Sie in das Feld API-Schlüsselwert den Wert für den API-Schlüssel ein.
  10. Führen Sie für die Basic Auth-Authentifizierung die folgenden Schritte aus:
    1. Geben Sie in das Feld Benutzername den Benutzernamen ein.
    2. Geben Sie in das Feld Passwort das Passwort ein.

  11. Klicken Sie auf Erstellen.

Erstellen eines Dienstes für einen SMTP-Server

Ab der IBM Process Mining release 1.14.2 können Sie einen Dienst für einen SMTP-Server erstellen und die Ergebnisse eines Monitor-Ereignisses an die definierte E-Mail-Adresse senden.

Bevor Sie einen SMTP-Dienst erstellen, müssen Sie die folgenden Informationen einholen:

  • SMTP-Serveradresse, an die Sie das Ergebnis eines Überwachungsereignisses senden möchten
  • Portnummer des SMTP-Servers

Sie können die folgenden Schritte verwenden, um einen SMTP-Dienst zu erstellen:

  1. Öffnen Sie ein Projekt und gehen Sie dann auf die Seite Action Hub.

  2. Klicken Sie auf der Seite Action Hub auf Service erstellen.

  3. Klicken Sie im Abschnitt Diensttyp des Dialogfelds Neuen Dienst erstellen auf SMTP.

  4. Geben Sie in das Feld Diensttitel einen Namen für den Dienst ein.

  5. Optional: Geben Sie in das Feld Beschreibung eine Beschreibung für den Dienst ein, den Sie erstellen möchten.

  6. Setzen Sie Mit anderen teilen auf True , um den Service mit anderen Konten in der Organisation gemeinsam zu nutzen. Andernfalls setzen Sie Mit anderen teilen auf Falsch.

  7. Geben Sie in das Feld SMTP-Server die Adresse des SMTP-Servers ein, an den Sie die Ergebnisse eines Überwachungsereignisses senden möchten (z. B., smtp-mail.outlook.com ).

  8. Geben Sie in das Feld Port die Portnummer des SMTP-Servers ein (z. B. 587 ). Möglicherweise müssen Sie sich an den SMTP-Dienstanbieter wenden, um die Portnummer zu erfahren.

  9. Geben Sie in die Felder Benutzername und Passwort den Benutzernamen und das Passwort des Serverkontos ein.

  10. Geben Sie in das Feld E-Mail-Adresse Ihre E-Mail-Adresse ein. Das Antwort-an-Feld in der E-Mail des Empfängers wird mit dem im Feld E-Mail-Adresse angegebenen Wert aktualisiert.

  11. Geben Sie in das Feld Anzeigename den Wert ein, den Sie als Namen des Absenders verwenden möchten.

  12. Stellen Sie die Schaltflächen Verwendung einer sicheren Verbindung (TLS) erzwingen und Explizites TLS verwenden auf der Grundlage des SMTP-Dienstanbieters ein.

  13. Klicken Sie auf Erstellen.

Service verwalten

Auf der Seite Dienste verwalten können Sie alle für einen Prozess erstellten Dienste anzeigen und einen für den Prozess erstellten Dienst bearbeiten, löschen oder duplizieren.

Führen Sie die folgenden Schritte aus, um einen Service zu verwalten:

  1. Klicken Sie auf der Seite Action Hub auf Dienste verwalten.

  2. Um nach einem Dienst zu suchen, geben Sie den Namen des Dienstes in das Suchfeld ein.

  3. Um die Dienste zu sortieren, führen Sie einen der folgenden Schritte im Feld Sortieren nach aus:

    • Klicken Sie auf Letzte Änderung , um die Services nach der vorgenommenen Änderung zu sortieren. Der zuletzt geänderte Service wird als erster angezeigt.
    • Klicken Sie auf Alphabetisch , um die Services in alphabetischer Reihenfolge zu sortieren.
    • Klicken Sie auf Älteste zuerst , um die ältesten Services anzuzeigen, die für den Prozess erstellt wurden.

  4. Um die Dienste zu filtern, wählen Sie in der Dropdown-Liste Filtern nach die Option Rest API oder SMTP

  5. Um einen Dienst zu bearbeiten, gehen Sie wie folgt vor:
    1. Klicken Sie im Dialogfeld Dienste verwalten auf das Symbol Drei Punkte , das dem gewünschten Dienst entspricht, und dann auf Bearbeiten.
    2. Bearbeiten Sie im Dialogfeld Dienst bearbeiten das erforderliche Feld und klicken Sie dann auf Aktualisieren
  6. Um einen Dienst zu löschen, gehen Sie wie folgt vor:
    1. Klicken Sie im Dialogfeld Dienst verwalten auf das Symbol Drei Punkte , das dem gewünschten Dienst entspricht, und dann auf Löschen.
    2. Klicken Sie im Nachrichtenfenster Service löschen auf Löschen.

  7. Um einen Dienst zu duplizieren, klicken Sie auf das Symbol Drei Punkte , das dem gewünschten Dienst entspricht, und dann auf Duplizieren.