Rubrique précédente: getDocumentRubrique suivante: modifyDocument


createDocument

Les paramètres suivants s’appliquent à la méthode createDocument :

Paramètre

Type

Description

SID

Chaîne

Identifie la session extraite depuis la connexion.

kdAttributes

Chaîne[]

Identifie une table de paires nom-valeur pour définir les valeurs d'attributs initiales du nouveau document de connaissances, comme l'illustre l'exemple suivant :

“SUMMARY”,”Summary text”,

"TITLE","Title text"

Dans le cadre de la méthode createDocument, le tableau ci-dessous contient des exemples de valeurs d’attributs valides et couramment utilisées pour un document. Les données de la colonne Type indiquent la nature exacte des informations qui doivent être analysées par la méthode au format chaîne dans le tableau de la chaîne attrVals.

Valeur de l’attribut

Type

Description

PRIMARY_INDEX

Nombre entier

Identifie l’ID de la catégorie dans laquelle le document est créé. Utilisez 1 pour la catégorie racine.

USER_DEF_ID

Chaîne

Identifie tous les ID à utiliser pour représenter le document.

TITLE

Chaîne

Identifie le titre du document.

SUMMARY

Chaîne

Identifie le résumé du document.

PROBLEM

Chaîne

Identifie le problème du document.

RESOLUTION

Chaîne

Identifie la résolution du document. Cette chaîne peut contenir des données au format html.

STATUS_ID

Nombre entier

Identifie l’ID d’état du document. La valeur par défaut est 10 (Version).

PRIORITY_ID

Nombre entier

Identifie l’ID de priorité du document. La valeur par défaut est (Normal).

CREATION_DATE

Date (Chaîne)

Identifie la date et l’heure auxquelles le document a été créé. Ne pas renseigner pour spécifier la date du jour.

MODIFY_DATE

Date (Chaîne)

Identifie la date et l’heure de la dernière modification du document. Ne pas renseigner pour spécifier la date du jour.

START_DATE

Date (Chaîne)

Identifie la date à laquelle le document devient actif et est utilisé avec Expiration_Date. Ne pas renseigner si vous ne souhaitez pas spécifier de date de début. Le document reste actif tant qu’il n’a pas atteint la date d’expiration.

EXPIRATION_DATE

Date (Chaîne)

Identifie la date d'expiration du document et doit être utilisé avec Start_Date. Ne pas renseigner si vous ne souhaitez pas spécifier de date d’expiration.

PUBLISHED_DATE

Date (Chaîne)

Identifie la date et l’heure auxquelles le commentaire a été publié. Ne pas renseigner pour affecter la date actuelle si l’état est Publié. Si l’état n’est pas Publié, ce paramètre est ignoré.

SD_PRODUCT_ID

Nombre entier

Identifie l'ID de produit de CA SDM auquel associer ce document.

ASSIGNEE_ID

UUID

Identifie, dans CA SDM, l'ID unique du destinataire auquel ce document est affecté.

SD_ASSET_ID

UUID

Identifie l'ID de l'actif de CA SDM auquel associer ce document.

SD_ROOTCAUSE_ID

Nombre entier

Identifie l'ID de la cause première de CA SDM à laquelle associer ce document.

SD_PRIORITY_ID

Nombre entier

Identifie l'ID de priorité de CA SDM à laquelle associer ce document.

SD_SEVERITY_ID

Nombre entier

Identifie l'ID de sévérité de CA SDM à laquelle associer ce document.

SD_IMPACT_ID

Nombre entier

Identifie l'ID d'impact de CA SDM auquel associer ce document.

SD_URGENCY_ID

Nombre entier

Identifie l'ID d'urgence de CA SDM à laquelle associer ce document.

AUTHOR_ID

UUID

Identifie l’ID unique du contact qui a créé ce document. Si l’auteur n’est pas un contact interne, vous pouvez définir ce champ sur zéro et utiliser le paramètre Auteur à la place.

OWNER_ID

UUID

Identifie l’ID unique du contact propriétaire du document.

SUBJECT_EXPERT_ID

UUID

Identifie l’ID unique du contact expert du sujet du document.

NOTES

Chaîne

Identifie les remarques du document.

READ_GROUP_LIST

Chaîne

Identifie la liste de données séparées par des tirets des ID de groupe dotés de l'autorisation de lecture pour ce document (par exemple : 1-3-4). Utilisez la lettre A pour affecter une autorisation à tout le monde.

WRITE_GROUP_LIST

Chaîne

Identifie la liste de données séparées par des tirets des ID de groupe dotés de l'autorisation d'écriture pour ce document (par exemple : 1-3-4). Utilisez la lettre A pour affecter une autorisation à tout le monde.

INHERITPERMISSIONS

Booléen

Indique l’état de l’indicateur Hériter des autorisations dans la catégorie dans laquelle le document est créé.

Définir sur Vrai si vous souhaitez hériter des autorisations. Les paramètres ReadPermissions et WritePermissions seront ignorés.

DOC_TYPE_ID

Nombre entier

Identifie l’ID du futur type de document, à savoir document standard ou document d’arborescence. Par défaut, il s’agit d’un document standard.

HITS

Nombre entier

Indique le nombre de fois où le document a été affiché.

DOC_TEMPLATE_ID

Nombre entier

Identifie l’ID du modèle que vous souhaitez affecter à ce document.

WF_TEMPLATE

Nombre entier

Identifie l’ID du modèle de flux de travaux que vous souhaitez affecter à ce document.

CUSTOM1

Chaîne

Définit un champ personnalisé.

CUSTOM2

Chaîne

Définit un champ personnalisé.

CUSTOM3

Chaîne

Définit un champ personnalisé.

CUSTOM4

Chaîne

Définit un champ personnalisé.

CUSTOM5

Chaîne

Définit un champ personnalisé.

CUSTOM_NUM1

Double

Définit un champ numérique personnalisé.

CUSTOM_NUM2

Double

Définit un champ numérique personnalisé.

Description

Crée un document.

Eléments renvoyés

Un nœud <UDSObject> décrivant le document de connaissances créé.