Bewertungserstellung – Global

Die Bewertungserstellung Die API bietet Methoden, mit denen Administratoren Bewertungen und Umfragen generieren können.

Es gibt mehrere Möglichkeiten, den aufzurufen CreateAssessments() Methode. Sie müssen festlegen typeIDParameter in allen Fällen zur Identifizierung eines Metriktyps oder einer Umfragedefinition.

Einige der Faktoren, die das Verhalten der Methode beeinflussen, sind:

• Gibt an, ob das Ziel eine Bewertung oder Umfrage ist
• Gibt an, ob der Bewertungszeitplantyp „On-Demand“ oder „geplant“ ist
• Umfragezeitplanzeiträume
• Parameter angegeben

Beispiel: Wenn die Methode nur mit aufgerufen wird typeIDParametersatz, sucht die Methode nach Stakeholdern oder Umfrageanwendern, an die Einladungen gesendet werden sollen. Im Gegensatz dazu, wenn die Methode mit aufgerufen wird typeIDUnd userIDParameter festgelegt, versucht, Einladungen an die angegebenen Anwender zu senden.

AssessmentCreation – createAssessments (Zeichenfolge typeID, Zeichenfolge sourceRecordID, Zeichenfolge userID)

Erstellt eine oder mehrere Bewertungen oder Umfragen für den angegebenen Metriktyp oder die angegebene Umfragedefinition.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Typeid	Zeichenfolge	Die sys_ID des Metriktyps oder der Umfragedefinition, für den Bewertungen oder Umfragen generiert werden sollen.
SourceRecordID	Zeichenfolge	Mindestens eine durch Kommas getrennte Umfragedefinition sys_IDs, die in die generierten Bewertungen aufgenommen werden soll. Dem angegebenen Metriktyp muss für jeden Quelldatensatz ein bewertbarer Datensatz zugeordnet sein. Wenn dieser Parameter leer gelassen wird, enthalten die generierten Bewertungen alle bewertbaren Datensätze für den angegebenen Typ. Dieser Parameter darf nur mit Bewertungen verwendet werden.
userID	Zeichenfolge	Eine oder mehrere kommagetrennte sys_IDs von Anwendern, an die Bewertungs- oder Umfrageinstanzen gesendet werden sollen. Wenn dieser Parameter leer gelassen wird, erhalten die Bewertungs-Stakeholder oder Umfrageanwender Instanzen. Dieser Parameter ist für On-Demand-Bewertungen erforderlich.

Tabelle : 2. Rückgaben

Typ

Beschreibung

Zeichenfolge

Wenn die Methode erfolgreich ist, wird eine kommagetrennte Zeichenfolge wie z. B. 7a2ad225378420004e0bfc8bcbe5de1, 10, b7e8b5d4c0a80169008b49e468920048 (Instanz-ID, Anzahl der Instanzen, Gruppen-ID) mit den folgenden Werten zurückgegeben: Instanz-ID: SYS_ID der erstellten Bewertungs- oder Umfrageinstanz, falls nur eine vorhanden ist. SYS_ID einer der Instanzen, wenn mehrere vorhanden sind. Wenn mehrere Instanzen vorhanden sind, verwenden Sie die Gruppen-ID, um Daten abzurufen. Anzahl der Instanzen: Anzahl der erstellten Bewertungs- oder Umfrageinstanzen. Gruppen-ID: SYS_ID der Bewertungsgruppe, die die erstellten Bewertungs- oder Umfrageinstanzen enthält. Wenn die Methode keine Bewertungen oder Umfragen generieren kann, gibt sie einen der Fehlercodes zurück. Fehlercodes IsScheduled: Gibt an, dass userIDOder sourceRecordIDParameter darf nicht verwendet werden. Wenn typeIDWert stellt einen Metriktyp dar, dessen Feld „Zeitplantyp“ auf „geplant“ festgelegt ist typeIDParameter ist der einzige Parameter, der verwendet werden kann. Draft_State: Gibt an, dass typeIDWert ist ein Metriktyp oder eine Umfragedefinition, die nicht veröffentlicht wird. Veröffentlichen Sie den Metriktyp oder die Umfragedefinition. Ungültiger Typ: Gibt an, dass kein Metriktyp vorhanden ist, der dem entspricht typeIDWert. Inaktiv: Gibt an, dass typeIDWert ist ein Metriktyp oder eine Umfragedefinition, die nicht aktiv ist. Navigieren Sie zum Metriktyp oder zur Umfragedefinition, und wählen Sie aus Aktiv Kontrollkästchen. Not_available: Gibt an, dass typeIDWert ist ein Metriktyp oder eine Umfragedefinition, die keine Metriken oder Umfragefragen enthält. Fügen Sie mindestens eine Metrik oder Umfragefrage hinzu. Noch nicht: Gibt an, dass mindestens einer der Anwender in userIDWert wird eine Umfrageinstanz für die angegebene Umfragedefinition zugewiesen, die noch abläuft. Der Fehlercode gibt das Ablaufdatum zurück. in bearbeitung: Gibt an, dass mindestens einer der Anwender in userIDWert ist bereits eine Umfrageinstanz für die Umfrage zugewiesen. Not_authorized: Gibt an, dass mindestens einer der Anwender in userIDWert ist nicht berechtigt, an der Umfrage teilzunehmen. Stellen Sie sicher, dass eine der folgenden Punkte wahr ist: Für die angegebene Umfragedefinition sind keine Umfrageanwender vorhanden. Alle Anwender in Anwender-ID Wert wird als Umfrageanwender für die angegebene Umfragedefinition gespeichert. Abgeschlossen: Gibt an, dass typeIDWert ist eine Umfragedefinition, bei der das Feld „Zeitplanzeitraum“ auf nur einmal festgelegt ist und mindestens einer der Anwender in ist userIDWert hat bereits eine Umfrageinstanz für diese Umfragedefinition abgeschlossen. Keine Anwender: Gibt an, dass userIDParameter wurde nicht verwendet, und einer der folgenden Elemente ist wahr: Dem angegebenen Metriktyp sind keine Stakeholder zugeordnet. Legen Sie fest userIDParameter oder erstellen Sie mindestens einen Stakeholder. Der angegebenen Umfragedefinition sind keine Umfrageanwender zugeordnet. Legen Sie fest userIDParameter oder erstellen Sie mindestens einen Umfrageanwender. Nosources: Gibt an, dass typeIDWert ist ein Metriktyp, bei dem das Feld „Zeitplantyp“ auf „bei Bedarf“ festgelegt ist und weder der Wert ist userIDNoch nicht sourceRecordIDParameter wurde verwendet. Legen Sie mindestens einen dieser Parameter fest.

Dieses Codebeispiel zeigt, wie eine Bewertungsinstanz in einem Serviceportal-Widget generiert wird. Dieses Beispiel funktioniert nicht, wenn der Zeitplantyp auf „bei Bedarf“ festgelegt ist.

(function() {
  var gdtSurvey = new GlideDateTime();
  if (gdtSurvey.getDayOfMonthUTC() == 23) {
    (new SNC.AssessmentCreation()).createAssessments('d902e09a075730101263f19d7c1ed03a', // Assessment metric type sys_id
      '4baec2fe07d3f0101263f19d7c1ed0a6', // Assessable record which is the source of the assessment
      gs.getUserID()); // Users ID to send the assessment instances to
  }
})();

Ergebnisse zurückgeben:

bbf0b9b8072330101263f19d7c1ed00b,1,33f0f978072330101263f19d7c1ed05f