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


---

# DocumentReferenceService: Bereichsbezogen, global

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

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

Die DocumentReferenceService Die API bietet Methoden zum Verwalten von Dokumentreferenzen innerhalb einer Zieltabelle, z. B. die Tabelle „Incidents" \[Incident\] oder „Wissen" \[kb_Knowledge\]. Sie können Dokumentreferenzen verwenden, um Informationen einem Datensatz zuzuordnen.

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).  
Mit den folgenden APIs können Sie Dokumente definieren und verwalten:

* [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.
{#DocumentReferenceServiceBothAPI__ul_krc_vmf_vpb}

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

Instanziiert einen DocumentReferenceService Objekt.
{#DRS-DocumentReferenceService__table_zw5_mcg_tpb__entry__3}

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

{#DRS-DocumentReferenceService__table_zw5_mcg_tpb}  
Das folgende Beispiel zeigt, wie ein instanziiert wird DocumentReferenceService Objekt.

    var result = new sn_doc_services.DocumentReferenceService();

## DocumentReferenceService -- addDocumentReference(Zeichenfolge docSysId, Zeichenfolge targetTable, Zeichenfolge tableSysId) {#ariaid-title3}

Fügt einem Zieltabellendatensatz eine Dokumentreferenz hinzu.
{#DRS-addDocumentReference_S_S_S__table_w4z_2cg_tpb__entry__3}{#DRS-addDocumentReference_S_S_S__ph_docserv_parm_docID}

| Name | Typ | Beschreibung |
|-|-|-|
| DocSysId | Zeichenfolge | SYS_ID eines Dokumentdatensatzes in der Tabelle „Dokumente" \[ds_document\]. |
| targetTable | Zeichenfolge | Name der Zieltabelle, für die eine Dokumentreferenz bereitgestellt werden soll. |
| tableSysId | Zeichenfolge | SYS_ID des Zieltabellendatensatzes, dem die Dokumentreferenz hinzugefügt werden soll. |
[Tabelle : 2. Parameter]

{#DRS-addDocumentReference_S_S_S__table_w4z_2cg_tpb} {#DRS-addDocumentReference_S_S_S__table_x4z_2cg_tpb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | SYS_ID des neuen Datensatzes in der Tabelle „Dokumentreferenzen" \[ds_document_reference\] mit einer Erfolgsmeldung. Fehlermeldung andernfalls. { "message": "String", "status": "String" } {#DRS-addDocumentReference_S_S_S__api_docserv_codeblock_dets} |
| \<Object\>.Nachricht | Nachricht, die Erfolg oder Fehler bestätigt. Wenn erfolgreich, wird die sys_ID des Datensatzes hinzugefügt, dem die Dokumentreferenz hinzugefügt wurde. 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. {#DRS-addDocumentReference_S_S_S__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 3. Rückgaben]

{#DRS-addDocumentReference_S_S_S__table_x4z_2cg_tpb}  
Das folgende Beispiel zeigt, wie einem Datensatz in der Tabelle „Incidents \[Incident\]" eine Dokumentreferenz hinzugefügt wird.

    var docReference = new sn_doc_services.DocumentReferenceService();

    var result = docReference.addDocumentReference("<docSysId>", "incident", "<tableSysId>");

    gs.info(JSON.stringify(result, null, 2));

Ausgabe:

    {
      "message": "Adding an entry to DocumentReference for the given docId to target table : incident, sysId : <tableSysId> is successful.",
      "status": "success"
    }

## DocumentReferenceService -- removeDocumentReference(Zeichenfolge docSysId, Zeichenfolge targetTable, Zeichenfolge tableSysId) {#ariaid-title4}

Entfernt eine Dokumentreferenz aus der Tabelle „Dokumentreferenzen" \[ds_document_reference\].
{#DRS-removeDocumentReference_S_S_S__table_w4z_2cg_tpb__entry__3}{#DRS-removeDocumentReference_S_S_S__ph_docserv_parm_docID}

| Name | Typ | Beschreibung |
|-|-|-|
| DocSysId | Zeichenfolge | SYS_ID eines Dokumentdatensatzes in der Tabelle „Dokumente" \[ds_document\]. |
| targetTable | Zeichenfolge | Name der Tabelle, die die Dokumentreferenz enthält. Diese Informationen werden zusammen mit dem Dokument in der Tabelle „Dokumentreferenzen" \[ds_document_reference\] aufgeführt. |
| tableSysId | Zeichenfolge | SYS_ID des Datensatzes, aus dem das Dokument referenziert wird. Zugehörige Informationen, die mit dem Dokument aufgeführt sind, finden Sie in der Tabelle „Dokumentreferenzen" \[ds_document_reference\]. |
[Tabelle : 4. Parameter]

{#DRS-removeDocumentReference_S_S_S__table_w4z_2cg_tpb} {#DRS-removeDocumentReference_S_S_S__table_x4z_2cg_tpb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Erfolgsmeldung. Fehlermeldung andernfalls. { "message": "String", "status": "String" } {#DRS-removeDocumentReference_S_S_S__api_docserv_codeblock_dets} |
| \<Object\>.Nachricht | Nachricht, die Erfolg oder Fehler bestätigt. Wenn erfolgreich, wird die sys_ID des Datensatzes hinzugefügt, aus dem die Dokumentreferenz entfernt wurde. 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. {#DRS-removeDocumentReference_S_S_S__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 5. Rückgaben]

{#DRS-removeDocumentReference_S_S_S__table_x4z_2cg_tpb}  
Das folgende Beispiel zeigt, wie eine Dokumentreferenz aus einem Datensatz in der Tabelle „Incidents \[Incident\]" entfernt wird.

    var docReference = new sn_doc_services.DocumentReferenceService();

    var result = docReference.removeDocumentReference("<docSysId>", "incident", "<tableSysId>");

    gs.info(JSON.stringify(result, null, 2));

Ausgabe:

    {
      "message": "Deleting an entry to DocumentReference for the given docId to target table : incident, sysId : <tableSysId> is successful.",
      "status": "success"
    }


