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


---

# DocumentVersionService: Bereichsbezogen, global

# DocumentVersionService: Bereichsbezogen, global {#ariaid-title1}

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

Die DocumentVersionService Die API bietet einen Service zum Erstellen und Löschen von Dokumentversionen. Jede Version ist ein Element, das den Dokumentinhalt enthält und wird mithilfe einer einzelnen URL oder eines einzelnen Anhangs bereitgestellt. Ein Anhang kann nur in der Tabellen-UI „Dokumentversionen" \[ds_document_Version\] und nicht mit der API hinzugefügt werden.

Diese API erfordert DokumentverwaltungPlugin (com.snc.platform_document_management) und wird in bereitgestellt `sn_doc_Services `Namespace. Informationen finden Sie unter [Dokumentservices](https://www.servicenow.com/docs/access?context=document-services-landing-page&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

Bevor Sie eine Dokumentversion erstellen, müssen Sie zuerst einen Dokumentdatensatz definieren und hinzufügen.

* [Systemdokument](https://servicenow-prod.fluidtopics.net/TbmTybFy91fR9ZQugSmgFw#SystemDocumentBothAPI "Die Systemdokument Die API bietet Methoden zum Festlegen von Feldern eines Datensatzes in der Tabelle „Dokumente“ [ds_document].")-- Definieren Sie ein Dokumentobjekt.
* [DocumentService](https://servicenow-prod.fluidtopics.net/_goxCLzTWhfVJff2X~tfJQ#DocumentServiceBothAPI "Die DocumentService Die API bietet Methoden zum Erstellen, Löschen und Aktualisieren eines Dokuments.")-- Dokument hinzufügen, aktualisieren oder löschen.
{#DocumentVersionServiceBothAPI__ul_qyt_tpr_wpb}

## DocumentVersionService -- DocumentVersionService() {#ariaid-title2}

Instanziiert einen DocumentVersionService Objekt.
{#DocVersSvc-DocumentVersionService__table_zw5_mcg_tpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#DocVersSvc-DocumentVersionService__table_zw5_mcg_tpb}  
Das folgende Beispiel zeigt, wie ein instanziiert wird DocumentVersionService Objekt.

    var versionSvc = new sn_doc_services.DocumentVersionService();

## DocumentVersionService -- createDocumentVersion(SystemDocumentVersion docVersion) {#ariaid-title3}

Erstellt einen Dokumentversionsdatensatz in der Tabelle „Versionen" \[ds_document_Version\].
{#DocVersSvc-createDocumentVersion_O__table_w4z_2cg_tpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| DocVersion | [SystemdokumentVersion](https://servicenow-prod.fluidtopics.net/Kllhw_M6oOHp9V5rwAy1hQ#SystemDocumentVersionBothAPI "Die SystemdokumentVersion Die API bietet Methoden zum Festlegen der Werte der Quellversion eines Dokuments in der Tabelle „Versionen“ [ds_document_Version].") | Mindestens eine Eigenschaft, die Felder einer Dokumentversion darstellt. |
[Tabelle : 2. Parameter]

{#DocVersSvc-createDocumentVersion_O__table_w4z_2cg_tpb} {#DocVersSvc-createDocumentVersion_O__table_tj4_p5j_34b__entry__2}{#DocVersSvc-createDocumentVersion_O__row_pdfgen_ret_msgCnv}

| Typ | Beschreibung |
|-|-|
| Objekt | SYS_ID des neuen Datensatzes in der Tabelle „Versionen" \[ds_document_Version\] mit einer Erfolgsmeldung. Fehlermeldung andernfalls. { "message": "String", "request_id": "String", "status": "String" } |
| \<Object\>.Nachricht | Nachricht, die Erfolg oder Fehler bestätigt. Wenn erfolgreich, werden die sys_ID des Dokumentdatensatzes und die sys_ID der neuen Dokumentversion hinzugefügt. Datentyp: Zeichenfolge |
| \<Object\>.Request_ID | SYS_ID des neuen Datensatzes in der Tabelle „Versionen" \[ds_document_Version\]. Datentyp: Zeichenfolge |
| \<Object\>.Status | Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: * Erfolg: Der Vorgang war erfolgreich. * Fehler: Der Vorgang war nicht erfolgreich. Die messageStellt Details bereit. {#DocVersSvc-createDocumentVersion_O__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 3. Rückgaben]

{#DocVersSvc-createDocumentVersion_O__table_tj4_p5j_34b}  
Das folgende Beispiel zeigt, wie ausgefüllt wird SystemdokumentVersion Objekteigenschaften und erstellen Sie eine neue Dokumentversion. Siehe auch [SystemdokumentVersion](https://servicenow-prod.fluidtopics.net/Kllhw_M6oOHp9V5rwAy1hQ#SystemDocumentVersionBothAPI "Die SystemdokumentVersion Die API bietet Methoden zum Festlegen der Werte der Quellversion eines Dokuments in der Tabelle „Versionen“ [ds_document_Version].").

    var versionDefinition = new sn_doc_services.SystemDocumentVersion('491efbee24187410f877a6fed1c2b0a9');

    versionDefinition.type('url');
    versionDefinition.url('http://one/1.0');

    var versionSvc = new sn_doc_services.DocumentVersionService();
    gs.info(JSON.stringify(versionSvc.createDocumentVersion(versionDefinition), null, 2));

Ausgabe:

    {
      "message": "Adding an entry to DocumentVersion for the given docId : 491efbee24187410f877a6fed1c2b0a9, sysId : d5a340d9242cf810f877a6fed1c2b069 is successful.",
      "request_id": "d5a340d9242cf810f877a6fed1c2b069",
      "status": "success"
    }

## DocumentVersionService -- deleteDocumentVersion(Zeichenfolge docVersionSysId) {#ariaid-title4}

Löscht eine Dokumentversion.
{#DocVersSvc-deleteDocumentVersion_S__table_w4z_2cg_tpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| docVersionSysId | Zeichenfolge | SYS_ID einer Dokumentversion in der Tabelle „Versionen" \[ds_document_Version\]. |
[Tabelle : 4. Parameter]

{#DocVersSvc-deleteDocumentVersion_S__table_w4z_2cg_tpb} {#DocVersSvc-deleteDocumentVersion_S__table_x4z_2cg_tpb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Erfolgsmeldung. Fehlermeldung andernfalls. { "message": "String", "status": "String" } {#DocVersSvc-deleteDocumentVersion_S__api_docserv_codeblock_dets} |
| \<Object\>.Nachricht | Nachricht, die Erfolg oder Fehler bestätigt. Wenn erfolgreich, wird die sys_ID der gelöschten Dokumentversion hinzugefügt. Datentyp: Zeichenfolge |
| \<Object\>.Status | Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: * Erfolg: Der Vorgang war erfolgreich. * Fehler: Der Vorgang war nicht erfolgreich. Die messageStellt Details bereit. {#DocVersSvc-deleteDocumentVersion_S__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 5. Rückgaben]

{#DocVersSvc-deleteDocumentVersion_S__table_x4z_2cg_tpb}  
Das folgende Beispiel zeigt, wie eine vorhandene Dokumentversion gelöscht wird.

    var vId = "<versionSysId>";
    var versionSvc = new sn_doc_services.DocumentVersionService();

    gs.info(JSON.stringify(versionSvc.deleteDocumentVersion(vId), null, 2));

Ausgabe:

    {
      "message": "Deleting an entry to DocumentVersion for the given documentVersionSysId : , sysId : <versionSysId> is successful.",
      "status": "success"
    }


