---
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


---

# Direkte Webservices

# Direkte Webservices {#ariaid-title1}

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

Ein direkter Webservice ist für jede Tabelle im System verfügbar, wenn die richtige Zugriffssteuerungsliste konfiguriert ist.

Das unterstützte Format der eingehenden Nachricht ist XML-SOAP-Dokumente im Dokumentstil (Dokument/Literal). Um eine WSDL-Beschreibung und ein XML-Schema für den direkten Webservice abzurufen, verweisen Sie auf die relative URL \<tablename\>.do?WSDL . Verwenden Sie beispielsweise die folgende URL, um die WSDL für die Incident-Tabelle im Online-Demosystem abzurufen: https://\<instance name\>.service-now.com/incident.do?WSDL .

## Erweiterte Abfrageparameter {#c_DirectWebServices__section_nj5_kfy_23b}

Mit erweiterten Abfrageparametern können Sie die Rückgabeergebnisse einer SOAP-Abfrage filtern und ändern, wenn Sie verwenden Abrufen , GetKeys , Und GetRecords Funktionen.  
Hinweis:  
Namen der erweiterten Abfrageelemente werden zwei Unterstriche vorangestellt.
{#c_DirectWebServices__table_xwm_4fy_23b__entry__3}

| Parameter | Beschreibung | Beispiel |
|-|-|-|
| __encoded_query | Geben Sie eine codierte Abfragezeichenfolge an, die zum Filtern der zurückgegebenen Ergebnisse verwendet werden soll. Das codierte Abfragezeichenfolgenformat ähnelt dem Wert, der in angegeben werden kann `Sysparm_query `URL-Parameter. Sehen Sie sich das Beispiel für die codierte Abfrageerstellung in den RSS-Feed-Generator-Beispielen an. | `<__encoded_query>Active=wahr^category='Hardware'</__encoded_query>` |
| __order_by | Weisen Sie an, dass die zurückgegebenen Ergebnisse nach dem angegebenen Feld sortiert werden. | `<__order_by>Priorität</__order_by>` |
| __order_by_desc | Weisen Sie an, die zurückgegebenen Ergebnisse nach dem angegebenen Feld in absteigender Reihenfolge zu sortieren. | `<__order_by_desc>opened_date</__order_by_desc>` |
| __ausschließen_Spalten | Geben Sie eine Liste von kommagetrennten Feldnamen an, die aus dem Ergebnissatz ausgeschlossen werden sollen. | `<__exclude_columns>sys_created_on,sys_created_by,caller_ID,Priorität</__exclude_columns>` |
| __Limit | Beschränken Sie die Anzahl der zurückgegebenen Datensätze. | `<__limit>100</__limit>` |
| __first_row | Weisen Sie die Ergebnisse an, um diese Anzahl von Datensätzen vom Anfang des Satzes versetzt zu werden. Bei Verwendung mit `__Last_row `Hat die Auswirkung, dass ein Ergebnisfenster abgefragt wird. Die Ergebnisse enthalten die erste Zeilennummer. | `<__first_row>250</__first_row>` |
| __Last_row | Weisen Sie an, dass die Ergebnisse durch diese Anzahl von Datensätzen vom Anfang des Satzes oder begrenzt werden sollen `__Start_row `Wert, wenn angegeben. Bei Verwendung mit `__first_row `Hat die Auswirkung, dass ein Ergebnisfenster abgefragt wird. Die Ergebnisse sind kleiner als die letzte Zeilennummer und enthalten nicht die letzte Zeile. | `<__Last_row>500</__Last_row>` |
| __use_View | Geben Sie eine Formularansicht anhand des Namens an, die zum Einschränken und erweitern der zurückgegebenen Ergebnisse verwendet werden soll. Wenn die Formularansicht tief referenzierte Felder wie enthält Anrufer_ID.E-Mail , Dieses Feld wird auch im Ergebnis zurückgegeben. | `<__use_View>SOAP_View</__use_View>` |
[Tabelle : 1. Verfügbare erweiterte Abfrageparameter]

{#c_DirectWebServices__table_xwm_4fy_23b}

## Namespace für direkte Webservices {#c_DirectWebServices__section_lc1_lgy_23b}

## Gibt einen eindeutigen Namespace für jede Tabelle an {#c_DirectWebServices__section_hb2_kgy_23b}

Die glide.wsdl.definition.use_unique_namespaceDie Eigenschaft stellt sicher, dass die direkte Webservice-WSDL jeder Tabelle eine eindeutige hat targetNamespaceAttribut. Diese Eigenschaft ist Wahr Standardmäßig, was erfordert, dass die direkte Webservice-WSDL einer Tabelle verwendet targetNamespaceWert von http://www.service-now.com/ \<table name\>. Wann Falsch (Oder wenn die Eigenschaft nicht vorhanden ist) verwenden alle Tabellen dasselbe targetNamespaceWert von http://www.service-now.com . Da alle Tabellen auch dieselben Vorgangsnamen haben, versucht ein Webservice-Client, mehr als eine zu verbrauchen ServiceNowWebservice kann nicht zwischen Anforderungen zwischen mehreren Tabellen unterscheiden. Verwenden einer eindeutigen targetNamespaceMit dem Wert können Webservice-Clients Anforderungen zwischen mehreren Tabellen unterscheiden.

Beispiel: Die direkte Webservice-WSDL für die Incident-Tabelle verwendet dies targetNamepsaceWert:

    <wsdl:definitions xmlns:soapenc= "http://schemas.xmlsoap.org/soap/encoding/"xmlns:wsdl = "http://schemas.xmlsoap.org/wsdl/"xmlns:http = "http://schemas.xmlsoap.org/wsdl/http/"xmlns:tns = "http://www.service-now.com/incident"xmlns:xsd = "http://www.w3.org/2001/XMLSchema"xmlns:mime = "http://schemas.xmlsoap.org/wsdl/mime/"xmlns:soap = "http://schemas.xmlsoap.org/wsdl/soap/"targetNamespace = "http://www.service-now.com/incident" ><wsdl:types><xsd:schema elementFormDefault = "unqualified"targetNamespace = "http://www.service-now.com/incident" >

## Namespace-Anforderungen werden festgelegt {#c_DirectWebServices__section_yvp_mgy_23b}

Das WSDL-Schema von ServiceNow deklariert standardmäßig ein Attribut von elementFormDefault="unqualified". Dieses Attribut gibt an, ob lokal deklarierte Elemente von qualifiziert werden müssen targetNamepsaceIn einem Instanzdokument. Wenn der Wert dieses Attributs ist Nicht qualifiziert , Dann dürfen lokal deklarierte Elemente nicht von qualifiziert werden targetNamepsace. Wenn der Wert dieses Attributs ist Qualifiziert , Dann müssen lokal deklarierte Elemente von qualifiziert werden targetNamepsace.

Dies ist jedoch nicht mit der Art und Weise kompatibel, wie Clients, die aus WSDL generiert wurden (z. B. .NET, Axis2, webMethods), das eingebettete Schema verarbeiten. Dadurch wird der Schema-Namespace entfernt, sodass die Webserviceantwort nicht mehr analysiert werden kann.

Um dieses Kompatibilitätsproblem zu beheben, wird eine boolesche Eigenschaft aufgerufen glide.wsdl.schema.UnqualifiedElementFormDefaultWird eingeführt. Diese Eigenschaft hat den Wert von Wahr Standardmäßig. Wird auf festgelegt Falsch Ermöglicht Clients, die aus WSDL generiert wurden, das Analysieren des Rückgabewerts des Webserviceaufrufs. Sie können diese Eigenschaft auf der Seite „Webservices-Eigenschaften" unter ändern SystemeigenschaftenWebservicesan.

## Doppelte Servicenamen werden zugelassen {#c_DirectWebServices__section_ytf_qjv_bdb}

Standardmäßig sind Servicenamen aus dynamisch generierter WSDL eindeutig und haben das folgende Format:

    ServiceNow_<table name>

Um doppelte Servicenamen zuzulassen, können Administratoren festlegen glide.wsdl.unique_service_nameEigenschaft bis Falsch . Erstellen Sie die Eigenschaft, wenn sie nicht vorhanden ist.
* **[Verwenden Sie Formulare, um die Abfrageantwort einzuschränken oder zu erweitern](https://servicenow-prod.fluidtopics.net/bdl~wLpkd1ogkd8RB4r_nw)**   
  Gelegentlich muss die Anzahl der Feldwerte beschränkt werden, die eine SOAP-Abfrage zurückgibt.
* **[Gibt den Anzeigewert für Referenzvariablen zurück](https://servicenow-prod.fluidtopics.net/htqaVxCptWSABqw16r9mPA)**   
  Wenn Sie einen Datensatz mit abfragen getOder getRecordsFunktion, gibt die Instanz alle Felder zurück, die diesem Datensatz zugeordnet sind. Die Felder sind häufig Referenzfelder, die eine sys_ID für einen Datensatz in einer anderen Tabelle enthalten.
* **[Löschen Sie Werte aus einer Zielinstanz](https://servicenow-prod.fluidtopics.net/6ssPVohYoS8NEh3pTxoE6Q)**   
  Sie können einen leeren Wert über einen SOAP-Parameter übergeben, um den entsprechenden Wert in der Zielinstanz zu löschen.
* **[Ruft Journaleinträge mit direkten Webservices ab](https://servicenow-prod.fluidtopics.net/7Y9U84Qi799TWCNa4VdEvg)**   
  Um den Inhalt eines Journalfelds abzurufen, stellen Sie eine zweite SOAP-Anforderung für die Tabelle „sys_Journal_field", um die entsprechenden Journaldatensätze für den betreffenden Datensatz zurückzurufen.
* **[Ruft Auswahlfelder mit direkten Webservices ab](https://servicenow-prod.fluidtopics.net/z5AV0RlYL9HZ18uCV0vxsg)**   
  Verwenden Sie die Auswahl, um Auswahlfelder abzurufen oder festzulegen Wert , Nicht die Bezeichnung .
* **[Behalten Sie eine HTTP-Sitzung für alle SOAP-Aufrufe bei](https://servicenow-prod.fluidtopics.net/zC6UXmEB9zoez45LEPySUw)**   
  Wenn ein SOAP-Client in kurzer Zeit viele Aufrufe tätigt, möchten Sie möglicherweise eine einzelne HTTP-Sitzung für alle SOAP-Aufrufe wiederverwenden.
* **[API-Funktionen des SOAP-direkten Webservice](https://servicenow-prod.fluidtopics.net/mO3ouVfePI72UfBzR7NyKA)**   
  Die Standard-SOAP-API ist eine Reihe kleiner, global definierter Funktionen, die für eine Zielressource ausgeführt werden können.

**Zugehörige Konzepte**   

* [SOAP-Webservice](https://servicenow-prod.fluidtopics.net/6nvuCTfQTaoGuJ7FqnmGfA "Simple Object Access Protocol (SOAP) ist ein XML-basiertes Protokoll für den Zugriff auf Webservices über HTTP.")

