SOAP-Schritt

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 7 Minuten Lesedauer

    • Ermöglichen Sie Aktionsdesignern, ausgehende SOAP-Web Service-Anfragen an externe Systemen 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-Studio-Aktionsschritt. 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

    Felder

    Feld Beschreibung
    Verbindungsdetails
    Verbindung Die Art der zu verwendenden Verbindung.
    • Verbindung Inline definieren: Definieren Sie die Verbindungsinformationen innerhalb des Aktionsschritts.
    • Verbindungs-Alias verwenden: Definieren Sie die Verbindungsinformationen mithilfe der Tabelle „Verbindungsalias“. Wenn Sie einen Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie eine Aktion in mehreren Umgebungen verwenden. Ebenso müssen Sie Ihre benutzerdefinierte Aktion nicht aktualisieren, wenn sich die Verbindungsinformationen ändern.

    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. Wenn Sie einen Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie eine Aktion in mehreren Umgebungen verwenden. 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 Aliasnamen. Der Anmeldeinformationswert wird im Datenbereich als Passwortdatenpille (zweifach verschlüsselt) 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. Wenn Sie einen Alias verwenden, müssen Sie nicht mehr mehrere Anmeldeinformationen konfigurieren, wenn Sie eine Aktion in mehreren Umgebungen verwenden. Wenn sich die Anmeldeinformationen ändern, müssen Sie Ihre anwenderdefinierte Aktion nicht aktualisieren. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasnamen. Der Anmeldeinformationswert wird im Datenbereich als Passwortdatenpille (zweifach verschlüsselt) 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-Server Zum 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 Standard-Zeitüberschreitungswert für Verbindungen 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 eines bestimmten MID-Servers oder MID-Clusters. Wählen Sie eine der folgenden Optionen aus.
    • Wählen Sie DEN MID-Server automatisch aus : Ihr ServiceNowInstanz wählt aus MID-ServerOhne manuelle Eingabe.
    • Spezifischer MID-Server : Ihr ServiceNowInstanz verwendet MID-ServerDie Sie angeben.
    • Spezifischer MID-Cluster : Ihr ServiceNowInstanz verwendet den von Ihnen angegebenen MID-Cluster.

      Ein MID-Cluster ist eine Gruppe von MID-Servern, die Ihren aktivieren ServiceNowInstanz zur Verarbeitung mehrerer Integrationen und zur Verbesserung der Integrationsgeschwindigkeit. Weitere Informationen finden Sie unter Configure a MID Server 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 Spezifischer MID-Cluster Ist aus der MID-Auswahlliste ausgewählt.
    Anforderungsdetails
    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 aus der ausgewählten 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. Verfügbare Optionen:
    • Text: Eine Anforderung in JSON, XML oder einem anderen Textformat.
    • Binär: Eine Anfrage in einem binären Dateiformat.
    SOAP-Umschlag Der an den Endpunkt gesendete XML-Text. Wenn Umschlag Erstellen Ist auf festgelegt Aus WSDL , Fügt das System 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 für den Incident 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, in der Regel 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 des 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 für die Authentifizierung beim SOAP-Webservice. Das System maskiert Passwörter immer in der Anwenderoberfläche 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, um den SOAP-Webservice auf eine Sicherheitsrichtlinie zu beschränken. 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 Standardwiederholungsrichtlinie. Dieses Kontrollkästchen ist nicht verfügbar, wenn in der Verbindungsliste die Option Verbindung inline definieren ausgewählt ist.
    Wiederholungsrichtlinie Standardwiederholungsrichtlinie, die dem Verbindungsalias zugeordnet ist. Wenn Standardrichtlinie für Alias überschreiben ausgewählt ist, können Sie die Standardwiederholungsrichtlinie überschreiben und eine andere vorhandene Neuversuchsrichtlinie basierend auf Ihrer Anforderung 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 Aktionsfehlerauswertung.

    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 die Antwortgrößenbeschränkung mit glide.pf.soap.response_payload_max_sizeSystemeigenschaft. Diese Systemeigenschaft unterstützt einen maximalen Wert von 10 MB.