Auslöser erstellen

Auslöser in WebSphere Automation erstellen

Verwenden Sie die Swagger-Benutzerschnittstelle für die REST-API WebSphere Automation , um eine neue Aktion zu erstellen. Die Aktionsressource ist Teil der Self-Secure-API, die in der Swagger-Benutzerschnittstelle unter https://<cpd-route>/websphereauto/secvul/apis/openapi/ui/verfügbar sind. Weitere Informationen zum Auffinden der REST-API finden Sie <cpd-route>unter Anzeigen der REST-API.

Führen Sie auf der Seite der Swagger-Benutzerschnittstelle für die selbstsichere API die folgenden Schritte aus, um einen Auslöser zu erstellen:

1. Klicken Sie auf Veröffentlichen/Auslöser , um einen Auslöser zu erstellen.

   Der Abschnitt wird erweitert und zeigt die Registerkarte Parameter , einen Beispielanforderungshauptteil mit Schema und Antworten an.

2. Klicken Sie auf Schema , um das Triggerschema anzuzeigen.

   Stellen Sie sicher, dass Sie mit dem Schema und den zulässigen Werten für jeden Parameter vertraut sind.

3. Klicken Sie auf Ausprobieren.

   Der Bereich für den Anforderungshauptteil kann jetzt bearbeitet werden.

4. Ändern Sie den Anforderungshauptteil, indem Sie die Werte in Anführungszeichen nach dem Doppelpunkt für die Parameter ändern, die Sie ändern möchten.

   Weitere Informationen zu den Trigger-Ressourcenparametern finden Sie unter Trigger-Ressource.

   Sie können JSONata -Ausdrücke verwenden, um bedingte Verarbeitung bereitzustellen oder Werte aus der Ressourcenbenachrichtigung an die Aktion zu übergeben. Weitere Informationen finden Sie unter Erstellen eines Ressourcen-Triggers und Überprüfen von JSONata-Ausdrücken.

5. Klicken Sie auf Ausführen.
6. Überprüfen Sie den Antwortcode.

   Wenn Ihr Auslöser gültig ist, ist der Antwortcode 201 für eine erfolgreiche Operation. Ihr Auslöser ist aktiv und kann die Aktion mit der angegebenen actionId aufrufen, wenn die definierten Kriterien erfüllt sind.

JSONata-Ausdrücke überprüfen

Wenn Sie Daten aus der Ressourcenbenachrichtigung über den Trigger an die Aktion übergeben oder wenn Sie eine bedingte Verarbeitung verwenden, die auf den Daten in der Ressourcenbenachrichtigung basiert, können Sie Ihre JSONata-Ausdrücke mit dem JSONata Exerciser unter https://try.jsonata.org/ überprüfen.

1. Kopieren Sie den vollständigen JSON-Code für die Ressourcenbenachrichtigung, auf der Ihr Auslöser basiert, und fügen Sie ihn in die JSON-Anzeige ein.

   Beispiele finden Sie unter Trigger-Ressource.

2. Erstellen Sie einen JSONata-Ausdruck in der JSONata-Anzeige.

   Der folgende JSONata-Ausdruck wertet beispielsweise ein Ereignis create vulnerability aus, um festzustellen, ob mindestens ein CVEs in der Schwachstelle einen Schweregrad größer als 9 aufweist (auf der CVSS-Skala von 0 bis 10).

   $count(vulnerability.cves[cvssBaseScore > 9 ]) > 0

   Ein weiteres Beispiel ist der folgende JSONata-Ausdruck

   $vulnerability.cves

   kann Daten übergeben, die wie das folgende Code-Snippet aussehen:

   {
           "id": " CVE-2021-44228 ",
           "description": "Lorem ipsum dolor sit amet ...",
           "cvssBaseScore": 10
         }
   

3. Die dritte Anzeige wird automatisch mit dem Ergebnis des Ausdrucks aktualisiert.

   Wenn Sie den JSONata-Ausdruck als conditionverwenden möchten, muss der Ausdruck ein boolescher Wert sein (d. h. mit einem Ergebnis vontrueoderfalse). Eine Bedingung muss ausgewertet werden alstruefür den Auslöser zum Aufrufen der Aktion.

   Wenn Sie Daten aus der Ressourcenbenachrichtigung an die Aktion übergeben, müssen Sie sicherstellen, dass der Ausdruck syntaktisch korrekt ist und die gewünschten Werte übergeben.