Vorheriges Thema: deleteCommentNächstes Thema: updateRating


rateDocument

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

Parameter

Typ

Beschreibung

SID

Ganzzahl

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

docId

Ganzzahl

Gibt die einzustufende Dokument-ID an.

rating

Ganzzahl

Gibt die für das Dokument anzugebende Einstufung an (auf einer Skala von 0–4, wobei 0 die niedrigste und 4 die höchste Einstufung ist).

multiplier

Ganzzahl

Gibt den Multiplikatorparameter an. Dieser Parameter kann dazu verwendet werden, viele Einstufungen gleichzeitig zu simulieren. Verwenden Sie den Standardwert 1 für eine einzelne Einstufung und eine andere Zahl für mehrere.

Wenn Sie beispielsweise den Wert 3 einreichen, entspricht dies dem dreimaligen Aufruf der Methode Drei Einstufungen werden mit dem von Ihnen für den Einstufungsparameter angegebenen Wert zur Datenbank hinzugefügt.

ticketPerId

Zeichenfolge

Gibt die permanente ID eines Tickets an, das mit diesem Wissensdokument verbunden ist.

onTicketAccept

Boolescher Wert

Bestimmt, ob das Dokument als Lösung für das Ticket akzeptiert wurde.

solveUserProblem

Boolescher Wert

Bestimmt, ob dieses Dokument das Problem des Benutzers gelöst hat. Es gibt an, wie der Benutzer auf die Frage „Hat dieses Dokument
Ihr Problem gelöst?“ in der Lösungsumfrage geantwortet hat.

isDefault

Boolescher Wert

Gibt einen Standardeinstufungsstatus an. Wenn Sie die Einstufung festlegen, weil der Benutzer das Dokument nur angesehen, nicht jedoch eingestuft hat, setzen Sie den Wert auf „True“. Dies wird aus Gründen der Berichterstattung verwendet.

Beschreibung

Stuft ein bestimmtes Dokument ein.

Rückgabe

Ein <UDSObject>-Knoten mit den folgenden untergeordneten <Attributes>-Knoten, der die Einstufung „BU_TRANS“ beschreibt:

Wert des XML-Elements

Datentyp

Beschreibung

ID

Ganzzahl

Gibt die eindeutige ID der zuletzt hinzugefügten Einstufung an. Verwenden Sie dies mit der Methode „updateRating()“, wenn Sie die Einstufung zu einem späteren Zeitpunkt modifizieren möchten.

DOC_ID

Ganzzahl

Gibt die Dokument-ID an.

INDEX_ID

Ganzzahl

Gibt die Kategorie-ID an.

BU_RATING

Zeichenfolge

Gibt die Einstufung an, die dem Dokument gegeben wurde.

HIT_NO_VOTE

Ganzzahl

Gibt die Einstufung an, die vorgenommen wurde, weil ein Benutzer das Dokument angezeigt, nicht jedoch eingestuft hat oder umgekehrt.