Bewertungserstellung – Global

Die Bewertungserstellung Die API stellt Methoden bereit, 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.

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

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 es, Einladungen an die angegebenen Anwender 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 durch Kommas getrennte sys_IDs der Umfragedefinition, die in die generierten Bewertungen aufgenommen werden soll. Für jeden Quelldatensatz muss ein bewertbarer Datensatz mit dem angegebenen Metriktyp verknüpft sein. Wenn dieser Parameter leer gelassen wird, enthält 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 IsScheduled: Gibt an, dass userIDOder sourceRecordIDParameter darf nicht verwendet werden. Wenn typeIDWert stellt einen Metriktyp dar, bei dem das 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 die Checkbox Aktiv aus. Not_available: Gibt an, dass typeIDWert ist ein Metriktyp oder eine Umfragedefinition, der keine Metriken oder Umfragefragen enthält. Fügen Sie mindestens eine Metrik oder Umfrage hinzu. Noch nicht: Gibt an, dass mindestens einer der Anwender in der ist userIDWert wird einer Umfrageinstanz für die angegebene Umfragedefinition zugewiesen, die noch abläuft. Der Fehlercode gibt das Ablaufdatum aus. wip: Gibt an, dass mindestens einer der Anwender in der vorhanden ist userIDWert ist bereits eine Umfrageinstanz für die Umfrage zugewiesen. Not_Authorized: Gibt an, dass mindestens einer der Anwender in der vorhanden ist userIDWert ist nicht berechtigt, 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 typeIDWert ist eine Umfragedefinition, bei der das Feld Zeitplanzeitraum auf nur einmal festgelegt ist und mindestens einer der Anwender in der festgelegt 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 userIDGeben Sie einen Parameter an, oder erstellen Sie mindestens einen Stakeholder. Mit der angegebenen Umfragedefinition sind keine Umfragebenutzer verknüpft. Legen Sie fest userIDGeben Sie Parameter an, 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. Stellen Sie mindestens einen dieser Parameter ein.

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