Erstellen Sie eine Analyseregel
Füllen Sie Ausgabevariablen, die in einer anwenderdefinierten Aktivität definiert sind, mit Nutzlastdaten 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 Datenstrukturgenerator in Variablenname Feld in Regeln werden analysiert generator.
Abbildung : 1. Zuordnung von Variablen zu Analyseregeln Das Analyseregelformular wird für die ausgewählte Variable angezeigt. Standardmäßig ist der Analysetyp auf festgelegt Direkt , Die die Variable mit allen Daten aus der ausgewählten Nutzlast ausfüllt, ohne den Inhalt zu analysieren. Jede Vorlage hat einen bestimmten Standard Quelle wird analysiert .
-
Füllen Sie das Formular mithilfe der Felder in der Tabelle aus.
In diesem Beispiel ist der ausgewählte Analysetyp XML , Mit dem Sie bestimmte Parameter aus der Nutzlast zum Analysieren auswählen können.
Tabelle : 1. Analyseregelfelder Feld Beschreibung Quelle wird analysiert Quelle der vom Zielhost oder Endpunkt zurückgegebenen Daten. Jede Vorlage wird für eine bestimmte Standardnutzlast geöffnet. Die verfügbaren Auswahlmöglichkeiten hängen von der für die Aktivität ausgewählten Ausführungsvorlage ab. Sie können lokale Variablen auch als Analysequelle verwenden, wenn zuvor für sie eine Analyseregel definiert wurde. Eine Liste der verfügbaren Nutzlasten für jede Vorlage finden Sie unter Aktivitätendesigner analysiert Quellen. Ausdruck Ausdruck, der zum Extrahieren bestimmter Daten aus der ausgewählten Analysequelle verwendet wird. Dieser Ausdruck wird aus erstellt Anklickbare Daten In der Beispielnutzlast und wird im ausgewählten Format angezeigt Analysetyp Feld. Beim Testen kann der Ausdruck mehrere Ergebnisse zurückgeben. Ermitteln Sie, welche Auswahl zuverlässige oder vorhersagbare Ergebnisse liefert, bevor Sie Ihren Ausdruck auswählen. Hinweis:Das System kann keine anklickbaren Elemente generieren Regulärer Ausdruck Ausdrücke aus Beispieldaten. Sie müssen alle regulären Ausdrücke manuell schreiben.Variablenname Variablenname wurde überarbeitet, da er im endgültigen Ausgabeausdruck verwendet wird. Das System fügt hinzu AktivityAusgabe Oder AktivityLocal Präfix für die von Ihnen angegebene Variable. Analysetyp Die Sprache, die zum Abfragen der Nutzlast des Zielhosts verwendet werden soll. Die Auswahlmöglichkeiten sind: - Direkt : Ordnet dem gesamten Inhalt der in ausgewählten Nutzlast zu Quelle wird analysiert Feld, ohne Analyse. Dies ist der Standardanalysetyp.
- XML : XPath-Abfrage, die zum Auswählen von Knoten aus einer XML-Nutzlast verwendet wird.
- JSON : JSONPath-Abfrage zum Auswählen von Teilen einer JSON-Nutzlast.
- Regulärer Ausdruck : Analysemethode, die einen regulären Ausdruck verwendet, um Daten aus einer Nutzlast zu extrahieren. Der RegEx-Analysetyp unterstützt keine mehrzeilige Analyse, und Groß-/Kleinschreibung wird nicht beachtet.
Kurzbeschreibung Kurze Beschreibung dieser Analyseregel. Beispiel-Payloaddaten Beispieldaten aus der Quelle, die die angeforderten Daten enthalten. Dieses Feld ist für nicht verfügbar Direkt Typen werden analysiert. Nachdem Sie auf geklickt haben Analysieren Sie Beispieldaten , Die Daten in diesem Feld können nicht bearbeitet werden, können jedoch angeklickt werden, um Ausdrücke zu erstellen. Klicken Sie Auf Bearbeiten Sie Beispieldaten Um das Feld erneut bearbeitbar zu machen. Ergebnisse werden analysiert Zeigt die Daten an, die vom ausgewählten Ausdruck von der Quelle zurückgegeben werden. Dieses Feld ist für nicht verfügbar Direkt Typen werden analysiert.
Aktivitätendesigner analysiert Quellen
Diese Tabelle listet die Analysequellen auf, 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 Aktivitätendesigner-Analyseregel
In diesem Beispiel ist die Analyseregel so konfiguriert, dass sie ausgefüllt wird AktivityAusgabe.ipv4 Variable mit dem Wert für die IP-Adresse von einem Domänenserver unter Verwendung von PowerShell.
Vorbereitungen
Warum und wann dieser Vorgang ausgeführt wird
Um die Beispieldaten zu generieren, muss der Administrator den Befehl tatsächlich auf dem Host ausführen und dann die zurückgegebenen Daten in einfügen Beispielnutzlastdaten Feld beim Erstellen der Analyseregel. Der Administrator kann dann einen Ausdruck erstellen, der IP-Adressen aus diesem Beispiel in zwei Formaten zurückgibt: ipv4 Und ipv6 . In diesem Beispiel erstellt das System zwei Ausdrücke, die für die Analyseregel verwendet werden sollen.
Prozedur
-
Klicken Sie auf Eingaben Und beachten Sie Befehl .
Abbildung : 2. PowerShell-Eingabebefehl für Analysenregel -
Wählen Sie den Analysetyp für die Quelle aus.
Im folgenden Beispiel würden Sie auswählen XML .
-
Klicken Sie Auf Analysieren Sie Beispieldaten .
Das System zeigt die XML im richtigen Format an und wird zu Anklickbar . In dieser Ansicht kann das System angeklickte Daten aus dem Beispiel in einen Ausdruck übersetzen.
-
Klicken Sie zum Erstellen des Ausdrucks auf die Elemente im Datenbeispiel, das Sie der Variable 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, die einen hat Typ Attribut von ipv4 . Das System füllt aus Ausdruck Feld mit dieser Auswahl.
-
Klicken Sie Auf Testausdruck .
Das System analysiert die Nutzlast mit dem ausgewählten Ausdruck und gibt die angeforderten Daten in zurück Ergebnis wird analysiert Feld.
-
Klicken Sie auf Absenden.
Die Ansicht kehrt zu zurück Ausgaben Registerkarte des Aktivitäts-Designers. Die neue Analyseregel wird aufgelistet, und für eine andere Regel ist eine leere Zeile verfügbar.