createDocument

Web-Service-Methoden › Knowledge Management › Knowledge Management – Allgemeine Methoden › createDocument

createDocument

Die folgenden Parameter gelten für die Methode „createDocument“:

Parameter	Typ	Beschreibung
SID	Zeichenfolge	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
kdAttributes	Zeichenfolge[]	Gibt ein Array von Name-Wert-Paaren an, die zur Festlegung der anfänglichen Attributwerte für das neue Wissensdokument verwendet werden, wie im Folgenden dargestellt: „SUMMARY”, „Zusammenfassungstext”, „TITLE“, „Titeltext“

Parameter

Typ

Beschreibung

SID

Zeichenfolge

Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.

kdAttributes

Zeichenfolge[]

Gibt ein Array von Name-Wert-Paaren an, die zur Festlegung der anfänglichen Attributwerte für das neue Wissensdokument verwendet werden, wie im Folgenden dargestellt:

„SUMMARY”, „Zusammenfassungstext”,

„TITLE“, „Titeltext“

Die folgende Tabelle enthält Beispiele für gültige, häufig verwendete Attributwerte für ein Dokument im Rahmen der Methode „createDocument“. Daten in der Spalte „Typ“ geben den tatsächlichen Typ an, der im Zeichenfolgenformat im „attrVals“-Array an die Methode übergeben werden muss.

Attributwert	Typ	Beschreibung
PRIMARY_INDEX	Ganzzahl	Gibt die Kategorie-ID an, anhand der das Dokument erstellt werden soll. Verwenden Sie „1“ für die Stamm-Kategorie.
USER_DEF_ID	Zeichenfolge	Gibt eine beliebige ID an, die Sie zur Darstellung dieses Dokuments verwenden möchten.
TITLE	Zeichenfolge	Gibt den Titel des Dokuments an.
SUMMARY	Zeichenfolge	Gibt die Zusammenfassung des Dokuments an.
PROBLEM	Zeichenfolge	Gibt das Problem des Dokuments an.
RESOLUTION	Zeichenfolge	Gibt die Lösung für das Dokument an. Kann HTML enthalten.
STATUS_ID	Ganzzahl	Gibt die Status-ID für das Dokument an. Der Standardwert ist 10 (Entwurf)
PRIORITY_ID	Ganzzahl	Gibt die Prioritäts-ID für das Dokument an. Der Standardwert ist 20 (Normal).
CREATION_DATE	Datum (Zeichenfolge)	Gibt das Datum und die Uhrzeit der Dokumenterstellung an. Lassen Sie dieses Feld leer, um das aktuelle Datum zuzuweisen.
MODIFY_DATE	Datum (Zeichenfolge)	Gibt das Datum und die Uhrzeit der letzten Dokumentänderung an. Lassen Sie dieses Feld leer, um das aktuelle Datum zuzuweisen.
START_DATE	Datum (Zeichenfolge)	Gibt das Datum an, an dem das Dokument aktiv wird, und wird in Verbindung mit „Expiration_Date“ verwendet. Lassen Sie dieses Feld leer, um kein Startdatum anzugeben, wobei das Dokument bis zum Erreichen des Ablaufdatums aktiv ist.
EXPIRATION_DATE	Datum (Zeichenfolge)	Gibt das Datum an, an dem das Dokument abläuft, und wird in Verbindung mit „Start_Date“ verwendet. Lassen Sie dieses Feld leer, um kein Ablaufdatum festzulegen.
PUBLISHED_DATE	Datum (Zeichenfolge)	Gibt das Datum und die Uhrzeit der Dokumentveröffentlichung an. Lassen Sie dieses Feld leer, um das aktuelle Datum zuzuweisen, sofern der Status „Veröffentlicht“ lautet. Bei einem anderen Status wird dieser Parameter ignoriert.
SD_PRODUCT_ID	Ganzzahl	Gibt die Produkt-ID von CA SDM an, der dieses Dokument zugeordnet werden soll.
ASSIGNEE_ID	UUID	Identifiziert die eindeutige Zuweisungs-ID von CA SDM, der dieses Dokument zugeordnet ist.
SD_ASSET_ID	UUID	Gibt die Asset-ID von CA SDM an, der dieses Dokument zugeordnet werden soll.
SD_ROOTCAUSE_ID	Ganzzahl	Gibt die Ursachen-ID von CA SDM an, der dieses Dokument zugeordnet werden soll.
SD_PRIORITY_ID	Ganzzahl	Gibt die Prioritäts-ID von CA SDM an, der dieses Dokument zugeordnet werden soll.
SD_SEVERITY_ID	Ganzzahl	Gibt die Schweregrad-ID von CA SDM an, der dieses Dokument zugeordnet werden soll.
SD_IMPACT_ID	Ganzzahl	Gibt die Auswirkungs-ID von CA SDM an, der dieses Dokument zugeordnet werden soll.
SD_URGENCY_ID	Ganzzahl	Gibt die Dringlichkeits-ID von CA SDM an, der dieses Dokument zugeordnet werden soll.
AUTHOR_ID	UUID	Gibt die eindeutige ID des Kontakts an, der dieses Dokument verfasst hat. Handelt es sich bei dem Autor nicht um einen internen Kontakt, können Sie dieses Feld auf null setzen und stattdessen den Parameter „Author“ verwenden.
OWNER_ID	UUID	Gibt die eindeutige ID des Kontakts an, der dieses Dokument besitzt.
SUBJECT_EXPERT_ID	UUID	Gibt die eindeutige ID des Kontakts an, der der Experte für dieses Dokument ist.
NOTES	Zeichenfolge	Gibt die Hinweise für das Dokument an.
READ_GROUP_LIST	Zeichenfolge	Gibt die durch Bindestriche getrennte Liste der Gruppen-IDs mit Leseberechtigung für dieses Dokument an (z. B. 1-3-4). Verwenden Sie „A“, um die Berechtigung jedem Benutzer zuzuweisen.
WRITE_GROUP_LIST	Zeichenfolge	Gibt die durch Bindestriche getrennte Liste der Gruppen-IDs mit Schreibberechtigung für dieses Dokument an (z. B. 1-3-4) Verwenden Sie „A“, um die Berechtigung jedem Benutzer zuzuweisen.
INHERITPERMISSIONS	Boolescher Wert	Gibt an, dass der Status der Markierung die Berechtigungen aus der Kategorie übernimmt, in der das Dokument erstellt wird. Bei dem Wert „True“ werden die Berechtigungen übernommen, und die Parameter „ReadPermissions“ und „WritePermissions“ werden anschließend ignoriert.
DOC_TYPE_ID	Ganzzahl	Gibt die ID für den Dokumenttyp an, der für dieses Dokument vorgesehen ist: ein reguläres Dokument oder ein Baumstrukturdokument. Der Standardwert ist ein reguläres Dokument.
HITS	Ganzzahl	Gibt die Anzahl der erfolgten Aufrufe dieses Dokuments an.
DOC_TEMPLATE_ID	Ganzzahl	Gibt die ID für die Vorlage an, die Sie diesem Dokument zuweisen möchten.
WF_TEMPLATE	Ganzzahl	Gibt die ID für die Workflow-Vorlage an, die Sie diesem Dokument zuweisen möchten.
CUSTOM1	Zeichenfolge	Gibt ein benutzerdefiniertes Feld an.
CUSTOM2	Zeichenfolge	Gibt ein benutzerdefiniertes Feld an.
CUSTOM3	Zeichenfolge	Gibt ein benutzerdefiniertes Feld an.
CUSTOM4	Zeichenfolge	Gibt ein benutzerdefiniertes Feld an.
CUSTOM5	Zeichenfolge	Gibt ein benutzerdefiniertes Feld an.
CUSTOM_NUM1	Doppelt	Gibt ein numerisches, benutzerdefiniertes Feld an.
CUSTOM_NUM2	Doppelt	Gibt ein numerisches, benutzerdefiniertes Feld an.

Beschreibung

Erstellt ein neues Dokument.

Rückgabe

Ein <UDSObject>-Knoten, der das neu erstellte Wissensdokument beschreibt.