--- sourceDocument: Xanadu-API-Referenz sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-API-Referenz ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Direkte Webservices # Direkte Webservices {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](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 ein XML-SOAP-Dokument im Dokumenten-Stil „wörtlich" (Document/Literal). Um eine WSDL-Beschreibung und ein XML-Schema für einen direkten Webservice abzurufen, zeigen Sie auf die relative URL\ .do?WSDL. Um beispielsweise die WSDL für die Incident-Tabelle im Online-Demo-System abzurufen, verwenden Sie die folgende URL: https://\.service-now.com/incident.do?WSDL. ## Erweiterte Abfrageparameter {#c_DirectWebServices__section_nj5_kfy_23b} Mit erweiterten Abfrageparametern können Sie die zurückgegebenen Ergebnisse einer SOAP-Abfrage filtern und ändern, wenn Sie die Funktionen get, getKeysund getRecords verwenden. Hinweis: Namen von erweiterten Abfrageelementen sind 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 einem URL-Parameter `sysparm_query` angegeben werden kann. Siehe das Beispiel für die codierte Abfrageerstellung in den Beispielen für RSS-Feed-Generator. | `<__encoded_query>active=true^category='hardware'` | | __order_by | Weisen Sie die zurückgegebenen Ergebnisse an, nach dem angegebenen Feld sortiert zu werden. | `<__order_by>priority` | | __order_by_desc | Weisen Sie die zurückgegebenen Ergebnisse an, nach dem angegebenen Feld absteigender Reihenfolge sortiert zu werden. | `<__order_by_desc>opened_date` | | __exclude_columns | Geben Sie eine Liste mit durch Kommas getrennten Feldnamen an, die aus der Ergebnismenge ausgeschlossen werden sollen. | `<__exclude_columns>sys_created_on,sys_created_by,caller_id,priority` | | __limit | Begrenzen Sie die Anzahl der zurückgegebenen Datensätze. | `<__limit>100` | | __first_row | Weisen Sie an, dass die Ergebnisse um diese Anzahl von Datensätzen ab Beginn des Satzes versetzt werden. Bei Verwendung mit `__last_row` wird ein Ergebnisfenster abgefragt. Die Ergebnisse sind einschließlich der ersten Zeilennummer. | `<__first_row>250` | | __last_row | Weisen Sie an, dass die Ergebnisse durch diese Anzahl von Datensätzen ab Beginn des Satzes oder des Werts `__start_row` begrenzt werden, falls angegeben. Bei Verwendung mit `__first_row` wird ein Ergebnisfenster abgefragt. Die Ergebnisse sind kleiner als die letzte Zeilennummer und enthalten nicht die letzte Zeile. | `<__last_row>500` | | __use_view | Geben Sie eine Formularansicht nach Namen an, um die zurückgegebenen Ergebnisse einzuschränken und zu erweitern. Wenn die Formularansicht tief referenzierte Felder enthält, wie caller_id.email, wird dieses Feld ebenfalls im Ergebnis zurückgegeben. | `<__use_view>soap_view` | [Tabelle : 1. Verfügbare erweiterte Abfrageparameter] {#c_DirectWebServices__table_xwm_4fy_23b} ## Namespace für direkte Webservices {#c_DirectWebServices__section_lc1_lgy_23b} ## Einen eindeutigen Namespace für jede Tabelle angeben {#c_DirectWebServices__section_hb2_kgy_23b} Die Eigenschaft glide.wsdl.definition.use_unique_namespace stellt sicher, dass die direkte Webservice-WSDL jeder Tabelle ein eindeutiges Attribut targetNamespace aufweist. Diese Eigenschaft ist standardmäßig auf true festgelegt, was erfordert, dass die direkte Webservice-WSDL einer Tabelle den targetNamespace -Wert http://www.service-now.com/\verwendet. Bei „ false " (oder wenn die Eigenschaft nicht vorhanden ist) verwenden alle Tabellen denselben targetNamespace -Wert http://www.service-now.com. Da alle Tabellen auch dieselben Vorgangsnamen verwenden, kann ein Webservice-Client, der versucht, mehr als einen ServiceNow -Webservice zu verbrauchen, nicht zwischen Anforderungen zwischen mehreren Tabellen unterscheiden. Die Verwendung eines eindeutigen Werts targetNamespace ermöglicht es Webservice-Clients, Anforderungen zwischen mehreren Tabellen zu unterscheiden. Beispielsweise verwendet die direkte Webservice-WSDL für die Incident-Tabelle diesen Wert targetNamepsace : ## Namespace-Anforderungen festlegen {#c_DirectWebServices__section_yvp_mgy_23b} Das WSDL-Schema von ServiceNow deklariert standardmäßig ein Attribut elementFormDefault="unqualified". Dieses Attribut gibt an, ob lokal deklarierte Elemente durch den targetNamepsace in einem Instanzdokument qualifiziert werden müssen. Wenn der Wert dieses Attributs nicht qualifiziertist, dürfen lokal deklarierte Elemente nicht von targetNamepsacequalifiziert werden. Wenn der Wert dieses Attributs qualifiziertist, müssen lokal deklarierte Elemente durch targetNamepsacequalifiziert werden. Dies ist jedoch nicht kompatibel mit der Art und Weise, wie aus WSDL (z. B. .NET, Axis2, webMethods) generierte Clients das eingebettete Schema verarbeiten. Dadurch wird der Schema-Namespace entfernt, wodurch die Webservice-Antwort nicht mehr analysiert werden kann. Um dieses Kompatibilitätsproblem zu lösen, wird eine boolesche Eigenschaft namens glide.wsdl.schema.UnqualifiedElementFormDefault eingeführt. Der Wert der Eigenschaft ist standardmäßig true. Durch Einstellen auf false können aus WSDL generierte Clients den Rückgabewert des Webservice-Aufrufs analysieren. Sie können diese Eigenschaft auf der Seite mit den Webservices-Eigenschaften unter ändern SystemeigenschaftenWebservices. ## Doppelte Servicenamen zulassen {#c_DirectWebServices__section_ytf_qjv_bdb} Standardmäßig sind Servicenamen aus dynamisch generierten WSDLs eindeutig und haben folgendes Format: ServiceNow_
Um doppelte Servicenamen zuzulassen, können Administratoren die Eigenschaft glide.wsdl.unique_service_name auf falsesetzen. Erstellen Sie die Eigenschaft, falls sie nicht vorhanden ist. * **[Verwenden Sie Formulare, um die Abfrageantwort einzuschränken oder zu erweitern](https://servicenow-prod.fluidtopics.net/URlChnsNPevg2s16IAO_SA)** Gelegentlich muss die Anzahl der Feldwerte begrenzt werden, die eine SOAP-Abfrage zurückgibt. * **[Geben Sie den Anzeigewert für Referenzvariablen zurück](https://servicenow-prod.fluidtopics.net/0PS~OowBZgK3_TqFieWxIA)** Wenn Sie einen Datensatz mit der Funktion get oder getRecords abfragen, 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/YXRL9v4IX2Vw_LUZfvZmFQ)** Sie können einen leeren Wert über einen SOAP-Parameter übergeben, um den entsprechenden Wert in der Zielinstanz zu löschen. * **[Rufen Sie Journaleinträge über direkte Webdienste ab](https://servicenow-prod.fluidtopics.net/ipr8g9YScUDHaoHNvXzlWw)** Um den Inhalt eines Journalfelds abzurufen, führen Sie eine zweite SOAP-Anforderung für die Tabelle „sys_journal_field" aus, um die entsprechenden Journaldatensätze für den betreffenden Datensatz zurückzuholen. * **[Auswahlfelder über direkte Webservices abrufen](https://servicenow-prod.fluidtopics.net/TpN4WuQyNPEqCWzjC~t9Pg)** Verwenden Sie die Auswahl Wert und nicht Bezeichnung, um Auswahlfelder abzurufen oder festzulegen. * **[Eine HTTP-Sitzung für alle SOAP-Aufrufe beibehalten](https://servicenow-prod.fluidtopics.net/IAUXrYck_kU2r8Ku5Nbc1Q)** Wenn ein SOAP-Client in kurzer Zeit viele Aufrufe durchführt, möchten Sie möglicherweise eine einzige HTTP-Sitzung für alle SOAP-Aufrufe wiederverwenden. * **[API-Funktionen für SOAP-Direkt-Webservices](https://servicenow-prod.fluidtopics.net/kSeHJyQPEm4y7npo0TjVRA)** Die Standard-SOAP-API ist eine Satz kleiner, global definierter Funktionen, die auf einer Zielressource ausgeführt werden können. **Zugehörige Konzepte** * [SOAP Web Service](https://servicenow-prod.fluidtopics.net/rhd1jVCjstZ7GaHOS1EyyA "Simple Object Access Protocol (SOAP) ist ein XML-basiertes Protokoll für den Zugriff auf Webservices über HTTP.")