---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Geskriptete SOAP-Webservices

# Geskriptete SOAP-Webservices {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Geskriptete SOAP-Webservices erlauben eine ServiceNowAdministrator zum Erstellen anwenderdefinierter SOAP-Webservices.

Sie können Eingabe- und Ausgabeparameter für den SOAP-Webservice definieren und JavaScript zum Ausführen von Vorgängen verwenden. Obwohl diese Funktion sehr leistungsfähig ist, verwenden Sie [Direkte Webservices](https://servicenow-prod.fluidtopics.net/q1jwxcJHSdhwDgCj_Jub1Q "Ein direkter Webservice ist für jede Tabelle im System verfügbar, wenn die richtige Zugriffssteuerungsliste konfiguriert ist.")Oder [Importsätze DES SOAP-Webservice](https://servicenow-prod.fluidtopics.net/ICfavOzlz8ggjskbfhq6OQ "Webservice-Importsätze ergänzen direkte Webservices und geskriptete SOAP-Webservices, indem eine Webservice-Schnittstelle zum Importieren von Tabellen für Importsätze bereitgestellt wird.")Wann immer möglich, da sie einfacher zu implementieren und zu verwalten sind.

## Sicherheit

Geskriptete SOAP-Webservices haben dieselben Basissicherheitsoptionen wie alle SOAP-Webservices. Details zur Sicherheit von SOAP-Webservices finden Sie unter [SOAP-Webservices-Sicherheit](https://servicenow-prod.fluidtopics.net/6nvuCTfQTaoGuJ7FqnmGfA#c_SOAPWebService__SOAP-web-services-security).

Wann [Strikte Sicherheit](https://servicenow-prod.fluidtopics.net/6nvuCTfQTaoGuJ7FqnmGfA "Simple Object Access Protocol (SOAP) ist ein XML-basiertes Protokoll für den Zugriff auf Webservices über HTTP.")Wird auf einem System erzwungen, muss der HTTP-authentifizierte Anwender über verfügen [SOAP_script](https://servicenow-prod.fluidtopics.net/6nvuCTfQTaoGuJ7FqnmGfA "Simple Object Access Protocol (SOAP) ist ein XML-basiertes Protokoll für den Zugriff auf Webservices über HTTP.")Rolle zum Ausführen des geskripteten Webservice.

## WSDL {#c_ScriptedWebServices__section_px4_kjf_f3b}

Alle ServiceNowTabellen und Importsätze generieren dynamisch XML-Dokumente (Webservice Definition Language, WSDL), die das Tabellenschema und die verfügbaren Vorgänge beschreiben.

## WSDL-Compliance wird erzwungen {#c_ScriptedWebServices__section_ay4_vff_f3b}

Sie können die Antwort erzwingen, Ausgabewerte in derselben Reihenfolge aufzulisten, wie in der WSDL definiert.

Wenn Sie einen geskripteten SOAP-Webservice erstellen, basiert die generierte WSDL auf den zugehörigen Listen „Eingabeparameter" und „Ausgabeparameter". Die tatsächliche SOAP-Antwort, die vom geskripteten Service gesendet wird, wird von bestimmt Skript . Dieses Verhalten kann dazu führen, dass das Skript Ausgabewerte in einer anderen Reihenfolge zurückgibt als in der WSDL definiert.  
Um die Reihenfolge der Ausgabeparameter wie in der zugehörigen Liste definiert zu erzwingen, wählen Sie aus WSDL-Compliance Kontrollkästchen. Wenn dieses Kontrollkästchen aktiviert ist, ordnet der Webservice die vom Skript zurückgegebenen Parameter neu an, um der Reihenfolge in der WSDL zu entsprechen.  
Hinweis:  
Wenn zusätzliche Antwortparameter vom Skript zurückgegeben werden, aber nicht in der zugehörigen Liste „Antwortparameter" definiert sind, werden diese Parameter von der Antwort ausgeschlossen, wenn WSDL-Compliance Ist ausgewählt.  
{#c_ScriptedWebServices__table_ump_jgf_f3b__entry__2}

| Parameter | Bestellung |
|-|-|
| Parameter 1 | 200 |
| Parameter 2 | 300 |
| Parameter 3 | 100 |
[Tabelle : 1. Zugehörige Liste der Ausgabeparameter]

{#c_ScriptedWebServices__table_ump_jgf_f3b}

Das folgende Skript legt Werte für die definierten Ausgabeparameter fest. Beachten Sie, dass in diesem Beispielskript die Parameter in einer anderen Reihenfolge festgelegt werden als in der zugehörigen Liste „Ausgabeparameter" definiert. Beachten Sie auch den zusätzlichen Parameter param4Das nicht in der zugehörigen Liste definiert ist.

    Response.param1 = 1;
    Response.param4 = 4;
    Response.param3 = 3;

Wenn WSDL-Compliance Kontrollkästchen ist Falsch , Die vom Skript generierte SOAP-Antwort lautet wie folgt:

    <response>
                    <param1>1</param1>
                    <param4>4</param1>
                    <param3>3</param1>
    </response>

Wenn WSDL-Compliance Kontrollkästchen ist Wahr , Die vom Skript generierte SOAP-Antwort lautet wie folgt:

    <response>
                    <param3>3</param1>
                    <param1>1</param1>
    </response>

## Statisches WDSL {#c_ScriptedWebServices__section_yfd_p2f_f3b}

Einige Webservice-Clients erfordern SOAP-Zugriff auf Ihre Instanz über ein bestimmtes WSDL-Format. Dieses erforderliche Format kann sich vom standardmäßigen ServiceNow-WSDL-Format unterscheiden. In diesen Fällen können Sie eine statische WSDL erstellen, die dem erforderlichen Format entspricht.

## Globale Variablen

Um die anwenderdefinierte Verarbeitung eingehender SOAP-Anforderungen zu erleichtern, sind die folgenden globalen Variablen im Skriptkontext verfügbar:

* SoapRequestDocument : Objekt „Java org.w3c.dom.Document", das den eingehenden SOAP-Umschlag darstellt.
* SoapRequestXML : Zeichenfolgenobjekt, das die eingehende SOAP-Umschlag-XML darstellt.
* Anforderung : JavaScript-Objekt, das zugeordnete Werte (den Eingabeparameternamen zugeordnet) des eingehenden SOAP-Umschlags enthält.
* Antwort : JavaScript-Objekt, mit dem Sie die Antwortwerte anpassen können. Siehe [Passen Sie Die Antwort An](https://servicenow-prod.fluidtopics.net/1aphvf~h60PF8zGDF1WxaA "Folgen Sie diesem Beispiel, um die XML-Nutzlast einer SOAP-Antwort anzupassen und zu steuern.")
{#c_ScriptedWebServices__ul_qxr_xw2_f3b}
* **[Erstellen Sie einen neuen geskripteten SOAP-Webservice](https://servicenow-prod.fluidtopics.net/Ynjap~ODnw2pw6cFyIXlzw)**   
  Befolgen Sie diese Beispiele, um einen neuen geskripteten SOAP-Webservice zu erstellen.
* **[Passen Sie die Antwort an](https://servicenow-prod.fluidtopics.net/1aphvf~h60PF8zGDF1WxaA)**   
  Folgen Sie diesem Beispiel, um die XML-Nutzlast einer SOAP-Antwort anzupassen und zu steuern.
* **[Erstellen Sie einen geskripteten SOAP-Webservice mit einer statischen WSDL](https://servicenow-prod.fluidtopics.net/t7kqtaZVmcwjC6leXuQumA)**   
  Befolgen Sie diese Beispiele, um einen geskripteten SOAP-Webservice mit einer statischen WSDL zu erstellen.

