AssessmentCreation : global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • La classe AssessmentCreation fournit des méthodes que les administrateurs peuvent utiliser pour générer des évaluations et des enquêtes.

    Il existe plusieurs façons d’appeler la méthode createAssessments . Vous devez définir le typeID paramètre dans tous les cas pour identifier un type de mesure ou une définition d’enquête.

    Voici quelques-uns des facteurs qui influencent le comportement de la méthode :
    • Indique si la cible est une évaluation ou une enquête
    • Indique si le type de calendrier d’évaluation est Sur demande ou Planifié
    • Périodes de calendrier d’enquête
    • Paramètres fournis

    Par exemple, lorsque la méthode est appelée avec uniquement le typeID jeu de paramètres, la méthode recherche des personnes concernées ou des utilisateurs d’enquêtes auxquels envoyer des invitations. En revanche, lorsque la méthode est appelée avec les typeID paramètres and userID définis, elle tente d’envoyer des invitations aux utilisateurs spécifiés.

    AssessmentCreation : createAssessments (chaîne typeID, chaîne sourceRecordID, chaîne userID)

    Crée une ou plusieurs évaluations ou enquêtes pour le type de mesure ou la définition d’enquête spécifié.

    Tableau 1. Paramètres
    Nom Type Description
    ID de type Chaîne sys_id du type de mesure ou de la définition d’enquête pour lesquels générer des évaluations ou des enquêtes.
    ID de l’enregistrement source Chaîne Une ou plusieurs définitions d’enquête séparées par des virgules sys_ids à inclure dans les évaluations générées. Un enregistrement évaluable doit être associé au type de mesure spécifié pour chaque enregistrement source. Si ce paramètre est laissé vide, les évaluations générées incluent tous les enregistrements évaluables pour le type spécifié. Ce paramètre est destiné à être utilisé avec des évaluations uniquement.
    userID Chaîne Une ou plusieurs sys_ids d’utilisateurs, séparées par des virgules, auxquelles envoyer des instances d’évaluation ou d’enquête. Si ce paramètre est laissé vide, les personnes concernées par l’évaluation ou les utilisateurs de l’enquête reçoivent des instances. Ce paramètre est requis pour les évaluations à la demande.
    Tableau 2. Renvoie
    Type Description
    Chaîne Si la méthode réussit, elle renvoie une chaîne séparée par des virgules telle que 7a2ad2253784200044e0bfc8bcbe5de1, 10, b7e8b5d4c0a80169008b49e468920048 (ID d’instance, nombre d’instances, ID de groupe) avec les valeurs suivantes :
    • instanceID : Sys_id de l’instance d’évaluation ou d’enquête créée, s’il n’y en a qu’une. Sys_id de l’une des instances, s’il y en a plusieurs. S’il existe plusieurs instances, utilisez l’ID de groupe pour récupérer les données.
    • #instances : nombre d’instances d’évaluation ou d’enquête créées.
    • groupID : Sys_id du groupe d’évaluation qui contient les instances d’évaluation ou d’enquête créées.

    Si la méthode n’est pas en mesure de générer des évaluations ou des enquêtes, elle renvoie l’un des codes d’erreur.

    Codes d'erreur
    • isscheduled : indique que le userID paramètre ou sourceRecordID n’aurait pas dû être utilisé. Lorsque la typeID valeur représente un type de mesure avec le champ Type de calendrier défini sur Planifié, le typeID paramètre est le seul qui peut être utilisé.
    • draft_state : indique que la typeID valeur est un type de mesure ou une définition d’enquête qui n’est pas publiée. Publiez le type de mesure ou la définition de l’enquête.
    • invalidtype : indique qu’il n’existe aucun type de mesure existant qui correspond à la typeID valeur.
    • inactif : indique que la typeID valeur est un type de mesure ou une définition d’enquête qui n’est pas actif. Accédez au type de mesure ou à la définition de l’enquête et cochez la case Actif .
    • not_available : indique que la typeID valeur est un type de mesure ou une définition d’enquête qui n’a pas de mesures ou de questions d’enquête. Ajoutez au moins une mesure ou une question d’enquête.
    • notyet : indique qu’au moins un des utilisateurs de la userID valeur est affecté à une instance d’enquête pour la définition d’enquête spécifiée, qui n’a pas encore expiré. Le code d’erreur renvoie la date d’expiration.
    • wip : indique qu’au moins un des utilisateurs de la userID valeur est déjà affecté à une instance d’enquête pour l’enquête.
    • not_authorized : indique qu’au moins un des utilisateurs de la userID valeur n’est pas autorisé à participer à l’enquête. Vérifiez que l’une des affirmations suivantes est vraie :
      • Il n’y a pas d’utilisateurs de l’enquête pour la définition d’enquête spécifiée.
      • Tous les utilisateurs de la valeur userID sont enregistrés en tant qu’utilisateurs d’enquête pour la définition d’enquête spécifiée.
    • terminé : indique que la typeID valeur est une définition d’enquête avec le champ Période de calendrier défini sur Une seule fois et qu’au moins un des utilisateurs de la userID valeur a déjà rempli une instance d’enquête pour cette définition d’enquête.
    • nousers : indique que le paramètre n’a pas été utilisé et que l’une userID des valeurs suivantes est vraie :
      • Aucune personne concernée n’est associée au type de mesure spécifié. Définissez le userID paramètre ou créez au moins une partie prenante.
      • Aucun utilisateur de l’enquête n’est associé à la définition d’enquête spécifiée. Définissez le paramètre ou créez au moins un utilisateur de l’enquête userID .
    • nosources : indique que la typeID valeur est un type de mesure avec le champ Type de calendrier défini sur Sur demande et qu’aucun paramètre userID nor sourceRecordID n’a été utilisé. Définissez au moins l’un de ces paramètres.

    Cet exemple de code montre comment générer une instance d’évaluation dans un widget du portail de services. Cet exemple ne fonctionnera pas si le type de calendrier est défini sur Sur demande.

    (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
  }
})();

    Résultats renvoyés :

    bbf0b9b8072330101263f19d7c1ed00b,1,33f0f978072330101263f19d7c1ed05f