Analyseregeln erstellen
- Aktualisiert31. Juli 2025
- 6 Minuten Lesedauer
- Zurich
- "Orchestration"
Füllen Sie in einer benutzerdefinierten Aktivität definierte Ausgabevariablen mit Payload-Daten aus, die von einem Eingabetest auf einem externen Host oder Endpunkt zurückgegeben werden.
Vorbereitungen
Warum und wann dieser Vorgang ausgeführt wird
Prozedur
-
Ziehen Sie eine Ausgabevariable aus dem Datenstruktur-Generator in das Feld Variablenname im Abschnitt Analyseregeln.
Abbildung : 1. Variablen zu Analyseregeln zuordnen 
Das Formular „Analyseregeln“ wird für die ausgewählte Variable angezeigt. Standardmäßig ist der Analysetyp auf Direkt festgelegt, wodurch die Variable ohne Analyse des Inhalts mit allen Daten des ausgewählten Payloads gefüllt wird. Jede Vorlage verfügt über eine bestimmte Standard-Analysequelle.
-
Füllen Sie das Formular aus, indem Sie die Felder in der Tabelle verwenden.
In diesem Beispiel ist der Analysetyp XML ausgewählt, mit dem Sie bestimmte Parameter aus dem zu analysierenden Payload auswählen können.
Tabelle : 1. Felder für die Analyseregeln Feld Beschreibung Quelle wird analysiert Quelle der vom Zielhost oder Endpunkt zurückgegebenen Daten. Jede Vorlage öffnet ein bestimmtes Standard-Payload. Die verfügbaren Optionen hängen von der für die Aktivität ausgewählten Ausführungsvorlage ab. Sie können auch lokale Variablen als Analysequelle verwenden, wenn zuvor eine Analyseregel definiert wurde. Eine Liste der verfügbaren Payloads für jede Vorlage finden Sie unter Analysequellen des Aktivitätendesigners. Ausdruck Ausdruck, der zum Extrahieren bestimmter Daten aus der ausgewählten Analysequelle verwendet wird. Dieser Ausdruck wird aus anklickbaren Daten im Beispiel-Payload erstellt und in dem Format angezeigt, das im Feld Typ wird analysiert ausgewählt wurde. Beim Testen kann der Ausdruck mehrere Ergebnisse zurückgeben. Stellen Sie fest, welche Auswahl zuverlässige oder vorhersagbare Ergebnisse liefert, bevor Sie den Ausdruck auswählen. Hinweis: Das System kann keine anklickbaren RegEx-Ausdrücke aus Beispieldaten generieren. Sie müssen alle regulären Ausdrücke manuell schreiben.Variablenname Geänderter Variablenname, wie er im endgültigen Ausgabeausdruck verwendet wird. Das System fügt das Präfix activityOutput oder activityLocal für die von Ihnen angegebene Variable hinzu. Typ wird analysiert Die Sprache, in der das Payload des Zielhosts abgefragt wird. Die Auswahlmöglichkeiten sind: - Direkt: Ordnet zum gesamten Inhalt des im Feld Quelle wird analysiert ausgewählten Payload ohne Analyse zu. Dies ist der Standardanalysetyp.
- XML: XPath-Abfrage zum Auswählen von Knoten aus einem XML-Payload
- JSON: JSONPath-Abfrage zum Auswählen von Teilen eines JSON-Payload
- Regulärer Ausdruck: Analysemethode, die mit einem regulären Ausdruck Daten aus einem Payload extrahiert. Der Analysetyp „Regulärer Ausdruck“ unterstützt keine mehrzeiligen Analysen und unterscheidet nicht zwischen Groß- und Kleinschreibung.
Kurzbeschreibung Kurze Beschreibung dieser Analyseregel Beispiel-Payloaddaten Beispieldaten aus der Quelle, die die angeforderten Daten enthält. Dieses Feld ist nicht für den Analysetyp Direkt verfügbar. Nach dem Klicken auf Musterdaten analysieren können die Daten in diesem Feld nicht bearbeitet werden, sie können aber zum Erstellen von Ausdrücken angeklickt werden. Klicken Sie auf Musterdaten bearbeiten, um das Feld wieder bearbeitbar zu machen. Ergebnis wird analysiert Zeigt die Daten an, die der ausgewählte Ausdruck von der Quelle zurückgibt. Dieses Feld ist nicht für den Analysetyp Direkt verfügbar.
Analysequellen des Aktivitätendesigners
In dieser Tabelle sind die Analysequellen aufgelistet, die für jede Ausführungsvorlage verfügbar sind.
| Vorlage | Quelle |
|---|---|
| SOAP-Webservice |
|
| JDBC |
|
| JavaScript-Probe |
|
| PowerShell |
|
| REST-Webservice |
|
| SFTP |
|
| Probe |
|
| SSH |
|
| JMS |
|
Beispiel für Analyseregeln des Aktivitätendesigners
In diesem Beispiel ist die Analyseregel so konfiguriert, dass sie die Variable activityOutput.ipv4 mit dem Wert für die IP-Adresse eines Domänenservers unter Verwendung von PowerShell ausfüllt.
Vorbereitungen
Warum und wann dieser Vorgang ausgeführt wird
Um die Beispieldaten zu generieren, muss der Administrator den Befehl auf dem Host ausführen und beim Erstellen der Analyseregel die zurückgegebenen Daten in das Feld Beispiel-Payloaddaten einfügen. Der Administrator kann dann einen Ausdruck erstellen, der IP-Adressen aus diesem Beispiel in zwei Formaten zurückgibt: ipv4 und ipv6. In diesem Beispiel erzeugt das System zwei Ausdrücke, die für die Analyseregel verwendet werden.
Prozedur
-
Klicken Sie auf die Registerkarte Eingaben, und notieren Sie sich den Befehl.
Abbildung : 2. PowerShell-Eingabebefehl für Analyseregel 
-
Wählen Sie den Analysetyp für die Quelle aus.
Im folgenden Beispiel wählen Sie aus XML .
-
Klicken Sie auf Musterdaten analysieren.
Das System zeigt die XML im richtigen Format an, und sie kann angeklickt werden. In dieser Ansicht kann das System angeklickte Daten aus dem Beispiel in einen Ausdruck umwandeln.
-
Klicken Sie zum Erstellen des Ausdrucks auf die Elemente im Datenbeispiel, die Sie der Variablen zuordnen möchten.
Basierend auf den Beispieldaten, auf die Sie geklickt haben, erstellt das System zwei Ausdrücke.
-
Wählen Sie einen Ausdruck aus der Liste aus.
Das gewünschte Ergebnis ist die IP-Adresse mit einem type-Attribut von ipv4. Das System übernimmt diesen Wert in das Feld Ausdruck.
-
Klicken Sie auf Ausdruck testen.
Das System analysiert das Payload anhand des ausgewählten Ausdrucks und gibt die angeforderten Daten im Feld Ergebnis wird analysiert zurück.
-
Klicken Sie auf Absenden.
Die Ansicht kehrt zur Registerkarte Ausgaben des Aktivitätendesigners zurück. Die neue Analyseregel ist aufgelistet, und für eine weitere Regel steht eine leere Zeile zur Verfügung.
