SOAP-Schritt

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 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 das Abonnement ServiceNow® IntegrationHub. Nachdem das erforderliche Plugin aktiviert wurde, wird der Schritt unter Integrationen angezeigt.

    Rollen und Verfügbarkeit

    • Verfügbar als Aktionsdesigner-Aktionsschritt. Benutzer mit der Rolle „action_designer“ können eine benutzerdefinierte Aktion mit einem oder mehreren Aktionsschritten erstellen.
    • Aktionsdesigner benötigen die Rolle „web_service_admin“, um diese Webservice-Aufgaben auszuführen.
      • WSDL auswählen
      • Neue WSDL laden
      • WS-SecurityPolicy auswählen
    • ServiceNow® MID-Server unterstützt keine WS-Security-Richtlinien.

    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 Datensatz des Alias für Verbindungen und Anmeldeinformationen, den das System zum Ausführen des Aktionsschritts verwendet. Benutzer mit der Rolle „flow_designer“ oder „admin“ können einen zugeordneten 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. Ebenso müssen Sie Ihre benutzerdefinierte Aktion nicht aktualisieren, wenn sich die Verbindungsinformationen ändern. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasnamen. Der Wert der Anmeldeinformationen wird als Datenpille Passwort (2-fach verschlüsselt) im Datenbereich angezeigt.
    Hinweis:
    Dieses Feld ist verfügbar, wenn in der Liste Verbindung die Option Verbindungsalias verwenden ausgewählt wird.
    Anmeldeinformationsalias Anmeldeinformationsalias, den das System zum Ausführen des Aktionsschritts verwendet. Benutzer mit der Rolle „flow_designer“ oder „admin“ können einen zugeordneten 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. Ebenso müssen Sie Ihre benutzerdefinierte Aktion nicht aktualisieren, wenn sich die Anmeldeinformationen ändern. Weitere Informationen zu Verbindungen und Anmeldeinformationen finden Sie unter Anmeldeinformationen, Verbindungen und Aliasnamen. Der Wert der Anmeldeinformationen wird als Datenpille Passwort (2-fach verschlüsselt) im Datenbereich angezeigt.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren aus der Liste Verbindung ausgewählt wird.
    MID verwenden Option zur Verwendung eines MID-Server zum Ausführen des SOAP-Schritt. Aktivieren Sie diese Checkbox, um die Felder MID-Auswahl,MID-Anwendungund Fähigkeiten anzuzeigen.
    Hinweis:
    Dieses Feld ist verfügbar, wenn in der Liste Verbindung die Option Verbindungsalias verwenden ausgewählt wird.
    Endpunkt Der URL-Endpunkt für die SOAP-Anforderung. Wenn Verbindungsalias verwenden ausgewählt ist, ist dieses Feld schreibgeschützt und zeigt die dem Alias zugeordnete Endpunkt-URL an. Wenn Verbindung inline definieren ausgewählt ist, geben Sie eine Endpunkt-URL für die Verbindung ein.
    SOAP-Schritt testen Schaltfläche zum Testen des SOAP-Schritts. Klicken Sie zum Testen auf die Schaltfläche Test SOAP Step (SOAP-Schritt testen). Geben Sie die erforderlichen Eingabewerte ein, und klicken Sie auf die Schaltfläche Test ausführen. Nachdem der Test ausgeführt wurde, 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, läuft die Verbindungsanforderung ab. Wenn Inline-Verbindung definieren ausgewählt ist, 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.
    MID-Auswahl Option zum Auswählen des spezifischen MID-Servers oder MID-Clusters.
    • MID Server automatischauswählen: Wählt den MID Server automatisch aus.
    • Spezifischer MID Server: Verwendet den von Ihnen ausgewählten MID Server.
    • Spezifischer MID-Cluster: Verwendet den von Ihnen ausgewählten MID-Cluster.
    Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren in der Verbindungsliste ausgewählt ist und MID verwenden aktiviert ist.
    MID-Cluster Datenpille für den MID-Cluster, den Sie verwenden möchten. Dieses Feld ist verfügbar, wenn Inline-Verbindung definieren in der Liste Verbindung ausgewählt ist, MID verwenden aktiviert ist und Spezifischer MID-Cluster in der MID-Auswahlliste ausgewählt ist.
    Details anfordern
    Umschlag erstellen Die beim Erstellen des SOAP-Umschlags zu verwendende Methode.
    • Aus WSDL: Wählen Sie diese Option aus, um die Felder WSDL auswählen und Vorgang anzuzeigen.
    • Manuell: Wählen Sie diese Option aus, um WSDL-Text manuell einzugeben oder einzufügen.
    WSDL auswählen Die zum Erstellen des SOAP-Umschlags zu verwendende WSDL. Wählen Sie einen vorhandenen WSDL-Datensatz aus, oder klicken Sie auf Neue WSDL laden, um eine WSDL-Datei herunterzuladen oder manuell einzugeben. Die ausgewählte WSDL füllt die Werte der Felder Vorgang, SOAP-Aktionund SOAP-Umschlag aus.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie in der Liste „Umschlag erstellen“ die Option Aus WSDL auswählen.
    Neues WSDL laden Option zum Herunterladen oder manuellen Eingeben einer WSDL-Datei.
    Vorgang Der über die ausgewählte WSDL auszuführende Vorgang. Jede WSDL hat eine eigene Liste von verfügbaren Vorgängen.
    SOAP-Aktion Die URL zum Ausführen der SOAP-Aktion. Wenn Umschlag erstellen auf Aus WSDLfestgelegt ist, ist dieses Feld schreibgeschützt und zeigt die URL zum Ausführen der SOAP-Aktion an. Wenn Umschlag erstellen auf Manuellfestgelegt ist, 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 auf Aus WSDLfestgelegt ist, fügt das System die erforderliche XML für den von Ihnen ausgewählten Vorgang hinzu. Wenn Umschlag erstellen auf Manuellfestgelegt ist, geben Sie den XML-Text ein, den Sie verwenden möchten. Geben Sie die Werte des Datensatzes in die entsprechenden Elemente des SOAP-Umschlags ein. Geben Sie beispielsweise eine Incident-Kurzbeschreibung in das Element <short_description> ein.
    Hinweis:
    Dieses Feld ist verfügbar, wenn der AnforderungstypTextist.
    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 sie mithilfe der APIs JSONStreamingBuilder und XMLStreamingBuilder im Skriptschritt.
    Hinweis:
    Dieses Feld ist verfügbar, wenn der AnforderungstypBinärist.
    Umschlag zurücksetzen Option zum Verwerfen aller manuellen Änderungen, die Sie am SOAP-Umschlag vorgenommen haben. Aktivieren Sie diese Checkbox, um den SOAP-Umschlag in seinen ursprünglichen Zustand zurückzusetzen.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie in der Liste „Umschlag erstellen“ die Option Aus WSDL auswählen.
    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 die Felder WSDL-URL, Benutzernameund Passwort anzuzeigen, um die WSDL aus einer externen Quelle abzurufen, in der Regel vom Webservice-Provider.
    • WSDL-Inhalt manuell ausfüllen: Wählen Sie diese Option aus, um das Feld WSDL-Inhalt anzuzeigen, um WSDL-Text manuell einzugeben oder einzufügen.
    WSDL-URL Die URL des SOAP Web Service.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie in der Liste „Importmethode“ die Option Von URL herunterladen auswählen.
    Benutzername Der Benutzername zur Authentifizierung mit dem SOAP Web Service.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie in der Liste „Importmethode“ die Option Von URL herunterladen auswählen.
    Passwort Das Passwort zur Authentifizierung mit dem SOAP Web Service. Das System maskiert Passwörter in der Benutzeroberfläche immer und verhindert, dass sie als Nur-Text exportiert werden.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie in der Liste „Importmethode“ die Option Von URL herunterladen auswählen.
    WSDL-Inhalt Das XML-Dokument zur Beschreibung des SOAP Web Service und der zugehörigen Vorgänge.
    Hinweis:
    Dieses Feld ist verfügbar, wenn Sie WSDL-Inhalt manuell ausfüllen in der Liste „Importmethode“ auswählen.
    Importieren Option zum Hinzufügen der SOAP Web Service-WSDL zur Instanz.
    WS-Sicherheit verwenden
    WS-SecurityPolicy aktivieren Option, um den SOAP Web Service auf eine Sicherheitsrichtlinie zu beschränken. Aktivieren Sie diese Checkbox, um das Feld Richtlinie anzuzeigen.
    Richtlinie Der Richtliniendatensatz, den Sie zum Einschränken von Webserviceverbindungen 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 als HTTP-Header in die SOAP-Nachricht aufgenommen werden sollen. Klicken Sie auf das Plus-Symbol Plus-Symbol, um Header hinzuzufügen. Fügen Sie für jeden HTTP-Header einen Namen und einen Wert hinzu.
    Header > Wenn leer, auslassen Option zum Ausschließen einer Kopfzeile, wenn der Wert leer oder null ist.
    Hinweis:
    Diese Checkbox ist verfügbar, nachdem Sie auf den Abwärtspfeil geklickt haben, um die erweiterten Optionen anzuzeigen.

    Felder für Aktionsfehlerauswertung

    Feld Beschreibung
    Wenn dieser Schritt fehlschlägt Option, um mit der Ausführung des nächsten Schritts fortzufahren oder zur Fehlerauswertung zu wechseln. Informationen zur Verwendung des Schrittstatuscodes oder der Meldung für eine Fehlerbedingung für eine benutzerdefinierte Aktion finden Sie unter Action error evaluation.

    Größenbeschränkungen für SOAP-Antworten

    Das System schränkt die Größe von SOAP-Antworten auf 5 MB ein. Direkte SOAP-Antworten, die diesen Grenzwert überschreiten, erzeugen einen Fehler. Um größere Antworten zu unterstützen, erhöhen Sie die Größenbeschränkung für Antworten mit der Systemeigenschaft glide.pf.soap.response_payload_max_size. Diese Systemeigenschaft unterstützt einen maximalen Wert von 10 MB.