Rubrique précédente: deleteCommentRubrique suivante: updateRating


rateDocument

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

Paramètre

Type

Description

SID

Nombre entier

Identifie la session extraite depuis la connexion.

docId

Nombre entier

Identifie l’ID de document à évaluer.

rating

Nombre entier

Identifie l’évaluation à donner au document (échelle de 0 à 4, où 0 est le minimum et 4 le maximum).

multiplier

Nombre entier

Identifie le paramètre multiplicateur (multiplier). Ce paramètre permet de simuler plusieurs évaluations à la fois. Utilisez la valeur par défaut 1 pour une seule évaluation et les autres chiffres pour les évaluations multiples.

Par exemple, si vous soumettez 3, cela revient à appeler la méthode 3 fois. Trois évaluations associées à la valeur fournie dans le paramètre d'évaluation sont ajoutées à la base de données.

ticketPerId

Chaîne

Identifie l’ID persistant d’un ticket lié à ce document de connaissances.

onTicketAccept

Booléen

Vérifie que le document a été accepté en tant que solution pour le ticket.

solveUserProblem

Booléen

Vérifie que le document a résolu le problème de l’utilisateur. Elle indique la façon dont l’utilisateur a répondu à la question « Ce document
a-t-il résolu votre problème ? » de l’enquête sur la solution.

isDefault

Booléen

Indique un statut d’évaluation par défaut. Si vous définissez l’évaluation uniquement parce que l’utilisateur a affiché le document et non parce qu’il l’a réellement évalué, définissez le paramètre sur Vrai. Cette valeur est utilisée à des fins de rapport.

Description

Evalue un document spécifique.

Eléments renvoyés

Un nœud <UDSObject> avec les nœuds<Attributes> enfants suivants décrivant l’évaluation BU_TRANS :

Valeur de l’élément XML

Type de données

Description

id

Nombre entier

Définit l’identificateur unique de l’évaluation la plus récente. Utilisez-le avec la méthode updateRating() pour modifier l’évaluation ultérieurement.

DOC_ID

Nombre entier

Identifie l’ID de document.

INDEX_ID

Nombre entier

Identifie l’ID de catégorie.

BU_RATING

Chaîne

Identifie l’évaluation donnée au document.

HIT_NO_VOTE

Nombre entier

Identifie l'évaluation définie parce qu'un utilisateur a affiché le document et non parce qu'il l'a réellement évalué, ou inversement.