AssessmentCreation – Global

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

Es gibt mehrere Möglichkeiten, die Methode createAssessments() aufzurufen. Sie müssen den Parameter typeID in allen Fällen festlegen, um einen Metriktyp oder eine Umfragedefinition zu identifizieren.

Zu den Faktoren, die das Verhalten der Methode beeinflussen, gehören:

• Ob das Ziel ein Assessment oder eine Umfrage ist
• Ob der Typ des Assessment-Zeitplans nach Bedarf oder nach Zeitplan festgelegt wird
• Umfrageplanungszeiträume
• Bereitgestellte Parameter

Wenn die Methode beispielsweise nur mit dem Parametersatz typeID aufgerufen wird, sucht die Methode nach Stakeholdern oder Umfragebenutzern, an die Einladungen gesendet werden sollen. Wenn die Methode hingegen mit den festgelegten Parametern typeID und userID aufgerufen wird, versucht sie, Einladungen an die angegebenen Benutzer zu senden.

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

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

Tabelle : 1. Parameter

Name	Typ	Beschreibung
typeID	Zeichenfolge	Die sys_id des Metriktyps oder der Umfragedefinition, für die Assessments oder Surveys erstellt werden sollen.
sourceRecordID	Zeichenfolge	Eine oder mehrere kommagetrennte Umfragedefinitions-sys_ids, die in die generierten Bewertungen aufgenommen werden sollen. Für jeden Quelldatensatz muss ein bewertbarer Datensatz mit dem angegebenen Metriktyp verknüpft sein. Wenn dieser Parameter leer gelassen wird, umfassen die generierten Bewertungen alle bewertbaren Datensätze für den angegebenen Typ. Dieser Parameter ist nur für Assessments vorgesehen.
userID	Zeichenfolge	Eine oder mehrere durch Kommas getrennte sys_ids von Benutzern, an die Assessment- oder Umfrageinstanzen gesendet werden sollen. Wenn dieser Parameter leer bleibt, erhalten die Assessment-Stakeholder oder Umfragebenutzer Instanzen. Dieser Parameter ist für On-Demand-Assessments erforderlich.

Tabelle : 2. Ergebnisse

Typ

Beschreibung

Zeichenfolge

Wenn die Methode erfolgreich ist, gibt sie eine durch Kommas getrennte Zeichenfolge zurück, z. B. 7a2ad2253784200044e0bfc8bcbe5de1, 10, b7e8b5d4c0a80169008b49e468920048 (Instanz-ID, Anzahl der Instanzen, Gruppen-ID) mit den folgenden Werten: instanceID: Sys_id der erstellten Assessment- oder Umfrageinstanz, wenn 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. #instances: Anzahl der erstellten Assessment- oder Umfrageinstanzen. groupID: Sys_id der Bewertungsgruppe, die die erstellten Assessment- oder Umfrageinstanzen enthält. Wenn die Methode keine Assessments oder Umfragen generieren kann, gibt sie einen der Fehlercodes zurück. Fehlercodes isschedule: Gibt an, dass der Parameter userID oder sourceRecordID nicht hätte verwendet werden dürfen. Wenn der Wert typeID einen Metriktyp darstellt, bei dem das Feld Zeitplantyp auf Geplant festgelegt ist, ist der Parameter typeID der einzige Parameter, der verwendet werden kann. Entwurfsstatus: Gibt an, dass der Wert typeID ein nicht veröffentlichter Metriktyp oder eine Umfragedefinition ist. Veröffentlichen Sie den Metriktyp oder die Umfragedefinition. ungültiger Typ: Gibt an, dass kein vorhandener Metriktyp vorhanden ist, der dem Wert typeID entspricht. inaktiv: Gibt an, dass der Wert typeID ein nicht aktiver Metriktyp oder eine Umfragedefinition ist Navigieren Sie zum Metriktyp oder zur Umfragedefinition und wählen Sie die Checkbox Aktiv aus. not_available: Gibt an, dass der Wert typeID ein Metriktyp oder eine Umfragedefinition ist, der keine Metriken oder Umfragefragen enthält. Fügen Sie mindestens eine Metrik oder Umfrage hinzu. notyet: Gibt an, dass mindestens einem der Anwender im Wert userID eine Umfrageinstanz für die angegebene Umfragedefinition zugewiesen ist, die noch nicht abgelaufen ist. Der Fehlercode gibt das Ablaufdatum aus. wip: Gibt an, dass mindestens einem der Anwender im Wert userID bereits eine Umfrageinstanz für die Umfrage zugewiesen ist. not_authorized: Gibt an, dass mindestens einer der Anwender im Wert userID nicht berechtigt ist, an der Umfrage teilzunehmen. Stellen Sie sicher, dass eine der folgenden Bedingungen erfüllt ist: Es gibt keine Umfragebenutzer für die angegebene Umfragedefinition. Alle Benutzer im Wert userID werden als Umfragebenutzer für die angegebene Umfragedefinition gespeichert. abgeschlossen: Gibt an, dass der Wert typeID eine Umfragedefinition ist, bei der das Feld „Zeitplanzeitraum“ auf Nur einmal festgelegt ist und dass mindestens einer der Anwender im Wert userID bereits eine Umfrageinstanz für diese Umfragedefinition abgeschlossen hat. nousers: Gibt an, dass der Parameter userID nicht verwendet wurde und eine der folgenden Bedingungen erfüllt ist: Dem angegebenen Metriktyp sind keine Stakeholder zugeordnet. Legen Sie den Parameter userID fest, oder erstellen Sie mindestens einen Stakeholder. Mit der angegebenen Umfragedefinition sind keine Umfragebenutzer verknüpft. Legen Sie den Parameter userID fest, oder erstellen Sie mindestens einen Umfragebenutzer. nosources: Gibt an, dass der Wert typeID ein Metriktyp ist, bei dem das Feld „Zeitplantyp“ auf „Bei Bedarf“ festgelegt ist und dass weder der Parameter userID noch der Parameter sourceRecordID verwendet wurde. Stellen Sie mindestens einen dieser Parameter ein.

Dieses Codebeispiel zeigt, wie Sie eine Bewertungsinstanz in einem Serviceportal-Widget generieren. 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