SOAP-Schritt

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 7 Minuten Lesedauer

    • Aktivieren Sie Aktionsdesigner, ausgehende SOAP-Webserviceanforderungen an externe Systeme zu senden.

    Hinweis:
    SOAP-Schritt Ist im Basissystem nicht verfügbar und erfordert ServiceNow® IntegrationHubAbonnement. Nachdem das erforderliche Plugin aktiviert wurde, ist der Schritt unter Integrationen sichtbar.

    Rollen und Verfügbarkeit

    • Verfügbar als Workflow-StudioAktionsschritt. Anwender mit der Rolle „action_Designer“ können eine anwenderdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.
    • Aktionsdesigner benötigen die Rolle „Web_Service_admin“, um diese Webservices-Aufgaben auszuführen.
      • Wählen Sie WSDL aus
      • Neue WSDL laden
      • Wählen Sie eine WS-Sicherheitsrichtlinie aus
    • Die ServiceNow® MID-ServerUnterstützt keine WS-Sicherheitsrichtlinien.

    Felder

    Feld Beschreibung
    Verbindungsdetails
    Verbindung Der Typ der zu verwendenden Verbindung.
    • Definieren Sie Die Verbindung Inline : Definieren Sie Verbindungsinformationen im Aktionsschritt.
    • Verwenden Sie Den Verbindungsalias : Definieren Sie Verbindungsinformationen mithilfe der Tabelle „Verbindungsalias“. Durch die Verwendung eines Alias müssen bei der Verwendung einer Aktion in mehreren Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungsinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren.

    Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Einführung in Anmeldeinformationen, Verbindungen und Aliasse .
    Verbindungsalias Alias-Datensatz für Verbindungen und Anmeldeinformationen, den das System zur Ausführung des Aktionsschritts verwendet. Anwender mit der Rolle „Flow_Designer“ oder „admin“ können einen zugehörigen Verbindungsdatensatz erstellen oder auswählen. Durch die Verwendung eines Alias müssen bei der Verwendung einer Aktion in mehreren Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungsinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasse . Der Anmeldeinformationswert wird als Passwortdatenpille (zweifach verschlüsselt) im Datenbereich angezeigt.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Verwenden Sie Den Verbindungsalias Ist aus der Verbindungsliste ausgewählt.
    Anmeldeinformationsalias Anmeldeinformationsalias, den das System zur Ausführung des Aktionsschritts verwendet. Anwender mit der Rolle „Flow_Designer“ oder „admin“ können einen zugehörigen Verbindungsdatensatz erstellen oder auswählen. Durch die Verwendung eines Alias müssen bei der Verwendung einer Aktion in mehreren Umgebungen nicht mehrere Anmeldeinformationen konfiguriert werden. Wenn sich die Anmeldeinformationsinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasse . Der Anmeldeinformationswert wird als Passwortdatenpille (zweifach verschlüsselt) im Datenbereich angezeigt.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    MID verwenden Option zur Verwendung von MID-ServerZum Ausführen von SOAP-Schritt. Aktivieren Sie dieses Kontrollkästchen, um anzuzeigen MID-Auswahl , MID-Anwendung , Und Fähigkeiten Felder.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Verwenden Sie Den Verbindungsalias Ist aus der Verbindungsliste ausgewählt.
    Endpunkt Der URL-Endpunkt für die SOAP-Anforderung. Wenn Verwenden Sie Den Verbindungsalias Ist ausgewählt, ist dieses Feld schreibgeschützt und zeigt die Endpunkt-URL an, die dem Alias zugeordnet ist. Wenn Definieren Sie Die Verbindung Inline Ist ausgewählt, geben Sie eine Endpunkt-URL für die Verbindung ein.
    SOAP-Schritt testen Schaltfläche zum Testen des SOAP-Schritts. Wählen Sie zum Testen aus Testen Sie den SOAP-Schritt Schaltfläche. Geben Sie alle erforderlichen Eingabewerte ein, und wählen Sie aus Test Ausführen Schaltfläche. Nach den Testläufen werden alle Schrittausgaben oder Fehlermeldungen im Abschnitt „Testergebnisse“ des Testfensters angezeigt.
    Verbindungszeitüberschreitung
    Anzahl der Millisekunden, die das System auf eine erfolgreiche Hostverbindung wartet. Wenn der Schritt während dieser Zeit keine erfolgreiche Verbindung herstellt, tritt bei der Verbindungsanforderung eine Zeitüberschreitung auf. Wenn Definieren Sie Die Verbindung Inline Ist ausgewählt, geben Sie einen Zeitüberschreitungswert für die Verbindung ein. Lassen Sie dieses Feld leer, um den standardmäßigen Zeitüberschreitungswert für die Systemverbindung zu verwenden.
    Hinweis:
    Vermeiden Sie das Festlegen von Verbindungszeitüberschreitung Wert auf Null, da dies zu einer veralteten Verbindung führen kann.
    MID-Auswahl Option zum Auswählen des spezifischen MID-Servers oder MID-Clusters.
    • MID-Server automatisch auswählen : Wählt den MID-Server automatisch aus.
    • Bestimmter MID-Server : Verwendet den von Ihnen ausgewählten MID-Server.
    • Bestimmter MID-Cluster : Verwendet den von Ihnen ausgewählten MID-Cluster.
    Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste und ausgewählt MID verwenden Ist aktiviert.
    MID-Cluster Datenpille für den MID-Cluster, den Sie verwenden möchten. Dieses Feld ist verfügbar, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt, MID verwenden Ist aktiviert, und Bestimmter MID-Cluster Ist aus der MID-Auswahlliste ausgewählt.
    Details anfordern
    Umschlag erstellen Die Methode, die beim Erstellen des SOAP-Umschlags verwendet werden soll.
    • Aus WSDL : Wählen Sie diese Option aus, um anzuzeigen Wählen Sie eine WSDL aus Und Vorgang Felder.
    • Manuell : Wählen Sie diese Option aus, um WSDL-Text manuell einzugeben oder einzufügen.
    WSDL auswählen Die WSDL, die zum Erstellen des SOAP-Umschlags verwendet werden soll. Wählen Sie einen vorhandenen WSDL-Datensatz aus, oder klicken Sie auf Neue WSDL laden Zum Herunterladen oder manuellen Eingeben einer WSDL-Datei. Die ausgewählte WSDL füllt die Werte von aus Vorgang , SOAP-Aktion , Und SOAP-Umschlag Felder.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie auswählen Aus WSDL Aus der Liste „Umschlag erstellen“.
    Neues WSDL laden Option zum Herunterladen oder manuellen Eingeben einer WSDL-Datei.
    Vorgang Der Vorgang, der über die ausgewählte WSDL ausgeführt werden soll. Jede WSDL verfügt über eine eigene Liste verfügbarer Vorgänge.
    SOAP-Aktion Die URL zum Ausführen der SOAP-Aktion. Wenn Umschlag Erstellen Ist auf festgelegt Aus WSDL , Dieses Feld ist schreibgeschützt und zeigt die URL zum Ausführen der SOAP-Aktion an. Wenn Umschlag Erstellen Ist auf festgelegt Manuell Geben Sie eine URL ein, um die SOAP-Aktion auszuführen.
    Anforderungstyp Format der Anforderung. Optionen umfassen.
    • Text : Eine Anforderung in JSON, XML oder einem anderen Textformat.
    • Binär : Eine Anforderung in einem binären Dateiformat.
    SOAP-Umschlag Der an den Endpunkt gesendete XML-Text. Wenn Umschlag Erstellen Ist auf festgelegt Aus WSDL , Das System fügt die erforderliche XML für hinzu Vorgang Die Sie auswählen. Wenn Umschlag Erstellen Ist auf festgelegt Manuell , Geben Sie den XML-Text ein, den Sie verwenden möchten. Geben Sie Datensatzwerte in die entsprechenden SOAP-Umschlagelemente ein. Geben Sie beispielsweise eine Kurzbeschreibung des Incidents in ein <short_description> Element.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Anforderungstyp Ist Text .
    Anhang Anhangsdatensatz, der die Anforderung enthält. Sie können diesen Datensatz in einem vorherigen Schritt suchen oder erstellen und ihn als Eingabevariable definieren. Erstellen Sie es mit JSONStreamingBuilder Und XMLStreamingBuilder APIs im Skriptschritt.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Anforderungstyp Ist Binär .
    Umschlag zurücksetzen Option zum Verwerfen aller manuellen Änderungen, die Sie am SOAP-Umschlag vorgenommen haben. Aktivieren Sie dieses Kontrollkästchen, um den SOAP-Umschlag auf den ursprünglichen Status zurückzusetzen.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie auswählen Aus WSDL Aus der Liste „Umschlag erstellen“.
    Neue WSDL
    Name Der Name des WSDL-Datensatzes, den Sie erstellen möchten.
    Importmethode Die Methode zum Eingeben von WSDL.
    • Von URL herunterladen : Wählen Sie diese Option aus, um anzuzeigen WSDL-URL , Anwendername , Und Passwort Felder zum Abrufen der WSDL aus einer externen Quelle, normalerweise dem Webservice Provider.
    • Füllen Sie WSDL-Inhalt manuell aus : Wählen Sie diese Option aus, um anzuzeigen WSDL-Inhalt Feld zum manuellen Eingeben oder Einfügen von WSDL-Text.
    WSDL-URL Die URL zum SOAP-Webservice.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie auswählen Von URL herunterladen Aus der Liste Importmethode.
    Anwendername Der Anwendername, der beim SOAP-Webservice authentifiziert werden soll.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie auswählen Von URL herunterladen Aus der Liste Importmethode.
    Passwort Das Passwort, das beim SOAP-Webservice authentifiziert werden soll. Das System maskiert Passwörter in der Anwenderoberfläche immer und verhindert den Export als nur-Text.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie auswählen Von URL herunterladen Aus der Liste Importmethode.
    WSDL-Inhalt Das XML-Dokument, das den SOAP-Webservice und seine Vorgänge beschreibt.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie auswählen Füllen Sie WSDL-Inhalt manuell aus Aus der Liste Importmethode.
    Importieren Option zum Hinzufügen der SOAP-Webservice-WSDL zur Instanz.
    WS-Sicherheit verwenden
    WS-SecurityPolicy aktivieren Option zum Einschränken des SOAP-Webservice auf eine Sicherheitsrichtlinie. Aktivieren Sie dieses Kontrollkästchen, um anzuzeigen Richtlinie Feld.
    Richtlinie Der Richtliniendatensatz, den Sie zum Einschränken von Webservice-Verbindungen verwenden möchten. Wählen Sie einen vorhandenen Richtliniendatensatz aus.
    Wiederholungsrichtlinie
    Wiederholungsrichtlinie aktivieren Option zum Aktivieren der Wiederholungsrichtlinie. Weitere Informationen finden Sie unter Wiederholungsrichtlinie .
    Standardrichtlinie für Alias überschreiben Option zum Überschreiben der standardmäßigen Wiederholungsrichtlinie. Dieses Kontrollkästchen gilt nicht, wenn Definieren Sie Die Verbindung Inline Ist aus der Verbindungsliste ausgewählt.
    Wiederholungsrichtlinie Standardmäßige Wiederholungsrichtlinie, die zugeordnet ist Verbindungsalias . Wenn Überschreiben Sie die Standardrichtlinie für den Alias Ist ausgewählt, können Sie die standardmäßige Wiederholungsrichtlinie überschreiben und eine andere vorhandene Wiederholungsrichtlinie basierend auf Ihren Anforderungen auswählen.
    Erweiterte Optionen
    Header Die Name-Wert-Paare, die in die SOAP-Nachricht als HTTP-Header aufgenommen werden sollen. Klicken Sie auf das Plus-Symbol Plus-SymbolZum Hinzufügen von Headern. Fügen Sie ein hinzu Name Und Wert Für jeden HTTP-Header.
    Header > Wenn leer, auslassen Option zum Ausschließen eines Headers, wenn der Wert leer oder null ist.
    Hinweis:
    Dieses Kontrollkästchen ist verfügbar, nachdem Sie auf den Abwärtspfeil geklickt haben, um die erweiterten Optionen anzuzeigen.

    Auswertung des Aktionsfehlers

    Wenn dieser Schritt fehlschlägt
    Datentyp: Choice

    Option, um den nächsten Schritt fortzusetzen oder zur Fehlerauswertung zu wechseln. Informationen zur Verwendung des Schrittstatuscodes oder der Meldung für eine anwenderdefinierte Aktionsfehlerbedingung finden Sie unter Auswertung des Aktionsfehlers.

    Größenbeschränkung der SOAP-Antwort

    Das System beschränkt die Größe von SOAP-Antworten auf 5 MB. Direkte SOAP-Antworten, die diesen Grenzwert überschreiten, generieren einen Fehler. Um größere Antwortgrößen zu unterstützen, erhöhen Sie den Grenzwert für die Antwortgröße mit glide.pf.soap.response_payload_max_sizeSystemeigenschaft. Diese Systemeigenschaft unterstützt einen Höchstwert von 10 MB.