--- sourceDocument: Yokohama Now Platform-Fähigkeiten sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/yokohama/servicenow-platform Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Now Platform-Fähigkeiten ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Erstellen Sie eine Analyseregel # Erstellen Sie eine Analyseregel {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer 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 Erforderliche Rollen: Activity_admin, activity_Creator ## Warum und wann dieser Vorgang ausgeführt wird ## Prozedur 1. Navigieren zu AlleWorkflowWorkflow-Editoran. 2. Von Anwenderdefiniert Registerkarte in der Palette öffnen Sie eine anwenderdefinierte Aktivität. 3. Wechseln Sie im Formular „Aktivitätsdesigner" zu Ausgabe Phase. 4. 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](https://www.servicenow.com/docs/R24VxietU8S3QGRZ7e0GWw#r_ActivityDesignerParsingSources "Diese Tabelle listet die Analysequellen auf, die für jede Ausführungsvorlage verfügbar sind."). 5. 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. {#t_CreateAParsingRule__table_yry_ptm_cr__entry__2} | 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](https://www.servicenow.com/docs/R24VxietU8S3QGRZ7e0GWw#r_ActivityDesignerParsingSources "Diese Tabelle listet die Analysequellen auf, die für jede Ausführungsvorlage verfügbar sind."). | | 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. {#t_CreateAParsingRule__ul_bgb_d5m_cr} | | 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. | [Tabelle : 1. Analyseregelfelder] {#t_CreateAParsingRule__table_yry_ptm_cr} 6. Klicken Sie auf, um die Eingaben erneut zu testen Ruft die Beispielnutzlast aus dem Test ab . Mit dieser Aktion wird das Testformular erneut geöffnet, sodass Sie verschiedene Testwerte ersetzen und eine andere Nutzlast erstellen können. 7. Klicken Sie Auf Speichern Damit die Analyseregeln die vorherige Nutzlast mit der soeben erstellten Nutzlast überschreiben. 8. Um einen Ausdruck für die Analyseregel zu erstellen, klicken Sie auf den spezifischen Parameter, den Sie in der Beispielnutzlast anzeigen möchten. Der Wert für diesen Parameter wird in angezeigt Ergebnis wird analysiert Und das System erstellt den entsprechenden Ausdruck in Ausdruck Feld. 9. Klicken Sie Auf Übermitteln Um die Analyseregel für diese Variable zu speichern. ## Aktivitätendesigner analysiert Quellen {#ariaid-title2} Diese Tabelle listet die Analysequellen auf, die für jede Ausführungsvorlage verfügbar sind. {#r_ActivityDesignerParsingSources__table_wjw_bvm_cr__entry__2} | Vorlage | Quelle | |-|-| | SOAP-Webservice | * ExecutionResult.body (Standard) * ExecutionResult.Status_Code * ExecutionResult.Header * ExecutionResult.error {#r_ActivityDesignerParsingSources__ul_fxx_fvm_cr} | | JDBC | * ExecutionResult.output (Standard) * ExecutionResult.Fehlernachrichten * executionResult.probeCompletedEccId * ExecutionResult.totalRows {#r_ActivityDesignerParsingSources__ul_vnc_h1c_kt} | | JavaScript-Probe | * ExecutionResult.Payload (Standard) * ExecutionResult.Ausgabe * ExecutionResult.eccSysId * ExecutionResult.Fehlernachrichten {#r_ActivityDesignerParsingSources__ul_qjz_gvm_cr} | | PowerShell | * ExecutionResult.output (Standard) * ExecutionResult.Tags * ExecutionResult.hresult * ExecutionResult.eccSysId * ExecutionResult.Fehlernachrichten {#r_ActivityDesignerParsingSources__ul_wg2_hvm_cr} | | REST-Webservice | * ExecutionResult.body (Standard) * ExecutionResult.Status_Code * ExecutionResult.Header * ExecutionResult.error {#r_ActivityDesignerParsingSources__ul_ew3_hvm_cr} | | SFTP | * ExecutionResult.output (Standard) * ExecutionResult.eccSysId * ExecutionResult.Fehlernachrichten * ExecutionResult.Tags {#r_ActivityDesignerParsingSources__ul_htz_c1c_kt} | | Probe | * ExecutionResult.output (Standard) * ExecutionResult.Payload * ExecutionResult.eccSysId {#r_ActivityDesignerParsingSources__ul_yc4_hvm_cr} | | SSH | * ExecutionResult.output (Standard) * ExecutionResult.eccSysId * ExecutionResult.Fehlernachrichten * ExecutionResult.Tags {#r_ActivityDesignerParsingSources__ul_cjt_hvm_cr} | | JMS | * ExecutionResult.Status * ExecutionResult.Standard-Header * ExecutionResult.customHeaders * ExecutionResult.messagePayload * ExecutionResult.eccSysId * ExecutionResult.Fehlernachrichten {#r_ActivityDesignerParsingSources__ul_s4t_tzb_kt} | [Tabelle : 2. Quellen werden analysiert] {#r_ActivityDesignerParsingSources__table_wjw_bvm_cr} ## Beispiel für Aktivitätendesigner-Analyseregel {#ariaid-title3} 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 Erforderliche Rolle: Activity_Creator, activity_admin ### 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 1. Navigieren zu AlleWorkflowWorkflow-Editor Und öffnen Sie die Aktivität, die auf dem Host ausgeführt wird. 2. Klicken Sie auf Eingaben Und beachten Sie Befehl . Abbildung : 2. PowerShell-Eingabebefehl für Analysenregel 3. Führen Sie in einer PowerShell-Konsole aus Befehl Auf dem Host, um das XML-Beispiel zu extrahieren, das die benötigten Werte enthält. 4. Kopieren Sie die Daten, die in die Zwischenablage zurückgegeben werden. 5. Klicken Sie im Aktivitätendesigner auf Ausgaben Registerkarte und fügen Sie die zurückgegebenen Daten in ein Beispielnutzlastdaten Feld. In diesem Beispiel enthalten die Daten IP-Adressen in zwei verschiedenen Formaten und den Domänennamen. 6. Wählen Sie den Analysetyp für die Quelle aus. Im folgenden Beispiel würden Sie auswählen XML . 7. 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. 8. 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. 9. 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. 10. 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. 11. 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.