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


---

# API-Funktionen für SOAP-Direkt-Webservices

# API-Funktionen für SOAP-Direkt-Webservices {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die Standard-SOAP-API ist eine Satz kleiner, global definierter Funktionen, die auf einer Zielressource ausgeführt werden können.
Die Zielressource (oder Tabelle) wird in der URL durch das Format `https://<table name>`definiert.\<instance name\> .service-now.com/.do .
{#r_DirectWebServiceAPIFunctions__id_brv_hgt_3xb__entry__2}

| Methodenübersicht | Beschreibung |
|-|-|
| [insert](https://servicenow-prod.fluidtopics.net/9V4ja4dnVWakRh9Nlm7dfw "Erstellt einen neuen Datensatz für die in der URL angegebene Tabelle.") | Erstellt einen neuen Datensatz für die in der URL angegebene Tabelle. |
| [insertMultiple](https://servicenow-prod.fluidtopics.net/tGfPBeBDR9GVGLQCzg8hXQ "Erstellt mehrere neue Datensätze für die in der URL angegebene Tabelle.") | Erstellt mehrere neue Datensätze für die in der URL angegebene Tabelle. Aktivieren Sie die [Webservice-](https://www.servicenow.com/docs/access?context=c_WebServiceImportSets&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US)Importsätze, um mehrere Einfügungen zu ermöglichen. |
| [Aktualisieren](https://servicenow-prod.fluidtopics.net/hQw2~XPA_riNZFjf3MQXwg "Aktualisiert einen vorhandenen Datensatz in der Zieltabelle in der URL, die durch das obligatorische Feld sys_id identifiziert wird.") | Aktualisiert einen vorhandenen Datensatz in der Zieltabelle in der URL, die durch das obligatorische Feld sys_id identifiziert wird. |
| [deleteRecord](https://servicenow-prod.fluidtopics.net/iO3DfV8NytICdKlJSL_8NA "Löschen Sie einen Datensatz aus der Zieltabelle, indem Sie dessen sys_id angeben.") | Löscht einen Datensatz aus der Zieltabelle, indem dessen `sys_id` angegeben wird. |
| [deleteMultiple](https://servicenow-prod.fluidtopics.net/OzxikhReC3uv~7S8OvWcWg "Löscht mehrere Datensätze anhand von Beispielwerten aus der Zieltabelle.") | Löscht mehrere Datensätze anhand von Beispielwerten aus der Zieltabelle. |
[Tabelle : 1. Datenänderungs-API]

{#r_DirectWebServiceAPIFunctions__id_brv_hgt_3xb} {#r_DirectWebServiceAPIFunctions__id_wz4_3gt_3xb__entry__2}

| Methodenübersicht | Beschreibung |
|-|-|
| [getKeys](https://servicenow-prod.fluidtopics.net/0mZmXap__o93dQ3NmUaYjw "Fragen Sie die Zieltabelle nach Beispielwerten ab, und geben Sie eine durch Kommas getrennte Liste sys_id zurück.") | Fragen Sie die Zieltabelle nach Beispielwerten ab, und geben Sie eine durch Kommas getrennte Liste `sys_id` zurück. |
| [getRecords](https://servicenow-prod.fluidtopics.net/XeARqlOhkdVE6grOAFez0A "Fragen Sie die Zieltabelle nach Beispielwerten ab, und geben Sie alle übereinstimmenden Datensätze und ihre Felder zurück.") | Fragen Sie die Zieltabelle nach Beispielwerten ab, und geben Sie alle übereinstimmenden Datensätze und ihre Felder zurück. |
| get | Fragen Sie einen einzelnen Datensatz aus der Zieltabelle mit `sys_id` ab, und geben Sie den Datensatz und seine Felder zurück. |
| [aggregate](https://servicenow-prod.fluidtopics.net/V~6VpNHuQcbIztuhTi8IIQ "Fragen Sie eine Tabelle mit einer aggregate-Funktion einschließlich SUMME, ANZAHL, MIN, MAX, LETZTER und DURCHSCHNITT ab.") | Fragen Sie mit den Zusammenfassungsfunktionen SUMME, ANZAHL MIN, MAX, LETZTER und DURCHSCHNITT ab. Aktivieren Sie das Plugin „Aggregate Web Service", um die Zusammenfassungsfunktionen zu aktivieren. |
[Tabelle : 2. Datenabruf-API]

{#r_DirectWebServiceAPIFunctions__id_wz4_3gt_3xb}
* **[Datenabruf-API](https://servicenow-prod.fluidtopics.net/rmxOnjzLr1k~HlBeuq5GVw)**   
  Zusammenfassungen und Beschreibungen der API-Methoden für die Datenabfrage.
* **[Datenänderungs-API](https://servicenow-prod.fluidtopics.net/wk8C2NiQ1C943u6~p5fdFw)**   
  Zusammenfassungen und Beschreibungen der API für die Datenänderungsmethode.

**Zugehörige Konzepte**   

* [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.")