DocumentReferenceService: Bereichsbezogen, global

Die DocumentReferenceService -API bietet Methoden zum Verwalten von Dokumentreferenzen in einer Zieltabelle, z. B. die Tabelle „Incidents“ [incident] oder „Wissen“ [kb_knowledge]. Sie können Dokumentreferenzen verwenden, um einem Datensatz Informationen zuzuordnen.

Diese API erfordert das Plugin Dokumentverwaltung (com.snc.platform_document_management) und wird im Namespace sn_doc_services bereitgestellt. Weitere Informationen finden Sie unter Dokumentenservices.

Mit den folgenden APIs können Sie Dokumente definieren und verwalten:

• SystemDocument : Definiert ein Dokumentobjekt.
• DocumentService : Ein Dokument hinzufügen, aktualisieren oder löschen.

DocumentReferenceService: DocumentReferenceService()

Instanziiert ein DocumentReferenceService -Objekt.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie ein DocumentReferenceService -Objekt instanziiert wird.

var result = new sn_doc_services.DocumentReferenceService();

DocumentReferenceService – addDocumentReference(Zeichenfolge docSysId, Zeichenfolge targetTable, Zeichenfolge tableSysId)

Fügt einem Zieltabellendatensatz eine Dokumentreferenz hinzu.

Tabelle : 2. Parameter

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 : 3. Ergebnisse

Typ	Beschreibung
Objekt	Sys_id des neuen Datensatzes in der Tabelle „Dokumentreferenzen“ [ds_document_reference] mit einer Erfolgsmeldung. Andernfalls Fehlermeldung. { "message": "String", "status": "String" }
<Object>.message	Meldung, die den Erfolg oder Fehler bestätigt. Bei Erfolg wird die sys_id des Datensatzes einbezogen, 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. message enthält Details. Datentyp: Zeichenfolge

Das folgende Beispiel zeigt, wie Sie einem Datensatz in der Tabelle „Incidents“ [incident] eine Dokumentreferenz hinzufügen.

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 – entfernenDokumentReferenz(Zeichenfolge docSysId, Zeichenfolge targetTable, Zeichenfolge tableSysId)

Entfernt eine Dokumentreferenz aus der Tabelle „Dokumentreferenzen“ [ds_document_reference].

Tabelle : 4. Parameter

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 mit dem Dokument in der Tabelle „Dokumentreferenzen“ [ds_document_reference] aufgeführt.
tableSysId	Zeichenfolge	Sys_id des Datensatzes, aus dem auf das Dokument verwiesen wird. Zugehörige Informationen, die mit dem Dokument in der Tabelle „Dokumentreferenzen“ [ds_document_reference] aufgeführt sind.

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Objekt	Erfolgsmeldung. Andernfalls Fehlermeldung. { "message": "String", "status": "String" }
<Object>.message	Meldung, die den Erfolg oder Fehler bestätigt. Bei Erfolg wird die sys_id des Datensatzes einbezogen, 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. message enthält Details. Datentyp: Zeichenfolge

Das folgende Beispiel zeigt, wie Sie eine Dokumentreferenz aus einem Datensatz in der Incident-Tabelle [Incident] entfernen.

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