modifyDocument

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

modifyDocument

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

Parameter	Typ	Beschreibung
SID	Ganzzahl	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
docId	Ganzzahl	Gibt die eindeutige ID des zu modifizierenden Dokuments an.
kdAttributes	Zeichenfolge[]	Gibt die Name-Wert-Paare für die Aktualisierung an, z. B. „SUMMARY“, „Zusammenfassungstext“, „TITLE“ und „Titeltext“.

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

Parameter	Typ	Beschreibung
MODIFY_DATE	(Zeichenfolge)	Gibt ein spezielles Feld an, das zum Sperren von Datensätzen verwendet wird, um zu verhindern, dass ein Dritter das Dokument zur selben Zeit wie Sie aktualisiert. Sie müssen das vorhandene „MODIFY_DATE“ des Dokuments übergeben. Wenn Sie das Änderungsdatum leer lassen, wird durch eine Fehlermeldung angezeigt, dass ein anderer Benutzer das Dokument aktualisiert hat.
USER_DEF_ID	Zeichenfolge	Gibt eine beliebige ID an, die Sie zur Kennzeichnung des 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)
PRIORTY_ID	Ganzzahl	Gibt die Prioritäts-ID für das Dokument an. Der Standardwert ist 20 (Normal).
START_DATE	Datum (Zeichenfolge)	Gibt das Datum an, an dem das Dokument aktiv wird. Dies wird auch in Verbindung mit „ExpirationDate“ verwendet. Lassen Sie dieses Feld leer, um kein Startdatum anzugeben, wobei das Dokument bis zum Überschreiten des Ablaufdatums aktiv ist.
EXPIRATION_DATE	Datum (Zeichenfolge)	Gibt das Datum an, an dem das Dokument abläuft. Dies wird auch in Verbindung mit „StartDate“ verwendet. Lassen Sie dieses Feld leer, um kein Ablaufdatum festzulegen.
SD_PRODUCT_ID	Ganzzahl	Gibt die Produkt-ID von CA SDM an, der dieses Dokument zugeordnet werden soll.
ASSIGNEE_ID	UUID	Gibt die eindeutige ID von CA SDM an, 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 Unicenter Service Desk 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 (0) 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 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.
INHERIT_PERMISSION	Boolescher Wert	Gibt den Status der Markierung zur Berechtigungsübernahme an. Beim Wert „True“ werden die Berechtigungen aus der Kategorie übernommen, in der das Dokument erstellt wird. In diesem Fall werden die Parameter „ReadPermissions“ und „WritePermissions“ 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.
WF_ACTION	Zeichenfolge	Gibt die Aktion für den Workflow an, den Sie diesem Dokument zuweisen möchten. Beispielsweise wird die Veröffentlichung des Dokuments mit "wf_unpublish" rückgängig gemacht.
WF_COMMENT	Zeichenfolge	Gibt den Kommentar für den Workflow an, den Sie diesem Dokument zuweisen möchten. Beispiel: Veröffentlichung rückgängig machen.
WF_CONTACT_ID	UUID	Gibt die Benutzer-ID für den Workflow an, den Sie diesem Dokument zuweisen möchten.
WF_REJECT_TO_ID	Ganzzahl	Gibt die Aufgaben-ID für den Workflow an, den Sie diesem Dokument mit übereinstimmendem Genehmigungsprozess zuweisen möchten. Aufgaben-IDs werden in der Tabelle "CI_ACTIONS" gespeichert.
CUSTOM1	Zeichenfolge	Kennzeichnet ein benutzerdefiniertes Feld.
CUSTOM2	Zeichenfolge	Kennzeichnet ein benutzerdefiniertes Feld.
CUSTOM3	Zeichenfolge	Kennzeichnet ein benutzerdefiniertes Feld.
CUSTOM4	Zeichenfolge	Kennzeichnet ein benutzerdefiniertes Feld.
CUSTOM5	Zeichenfolge	Kennzeichnet ein benutzerdefiniertes Feld.
CUSTOMNUM1	Doppelt	Kennzeichnet ein numerisches, benutzerdefiniertes Feld.
CUSTOMNUM2	Doppelt	Kennzeichnet ein numerisches, benutzerdefiniertes Feld.

Beschreibung

Modifiziert ein Dokument.

Rückgabe

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