Implémenter Grades Journey via l'intégration SITS

  1. Dans Administrateur système, sous Blackboard Building, sélectionnez Building Blocks.
  2. Sélectionnez Outils installés.
  3. Repérez Service Blackboard Grade Journey, puis sélectionnez Paramètres.
  4. En vous aidant des sections suivantes, configurez les propriétés dans chaque groupe de paramètres.

Paramètres des colonnes de devoirs et de notes (données entrantes)

Configurez les propriétés suivantes :

  • Planifier le travail
    • Définir l'état du travail : sélectionner Désactivé.
    • Planification CRON : N/A
    • Mise en service de l'onglet de contenu : choisissez le dossier par défaut dans lequel les éléments évaluables seront créés, à moins qu'ils ne soient remplacés dans la transaction.
    • Vérification de la mise en service des éléments de contenu : ce paramètre définit la règle de correspondance des éléments de contenu approvisionnés. Options disponibles :
      • Aucune restriction : ajoute toujours des éléments du flux en tant que nouveaux éléments de contenu.
      • Une seule fois : ajoute un élément donné une seule fois (utilisé pour LIS).
      • Mettre à jour les correspondances par nom : ajoute l'élément lors de la première passe et le met à jour en fonction du titre de la correspondance par élément de contenu lors des importations ultérieures.
    • Vérification de la mise en service des éléments évaluables : ce paramètre définit la règle de correspondance des colonnes de notes manuelles approvisionnées ou des colonnes de notes créées à la suite des éléments de contenu approvisionnés. Options disponibles :
      • Mettre à jour les correspondances par nom : ajoute les éléments lors de la première passe et les met à jour en fonction du titre de la correspondance par élément de contenu lors des importations ultérieures.
      • Mettre à jour les correspondances par méta-donnée : ajoute les éléments lors de la première passe et les met à jour en fonction de la valeur stockée dans l'attribut de métadonnées « Type » inclus dans la liste de données facultative de l'enregistrement de données de saisie d'éléments au cours des importations ultérieures.
  • Les options Paramètres de transfert du résultat, Format de fichier et Paramètres de la colonne de notes ne s'appliquent pas à REST.

Lorsque vous avez terminé, sélectionnez Soumettre.

Paramètres d'extraction des notes (données sortantes)

Configurez les propriétés suivantes :

  • Intégration
    • Type d'intégration : choisissez l'intégration SITS. L'intégration SITS génère trois fichiers sortants : une synthèse, un fichier d'évaluation et un fichier de réévaluation.
    • Planification CRON : choisissez la fréquence des extractions en arrière-plan. Par exemple, les extractions se produisent toutes les heures, cette valeur ayant la valeur 0 0/60 * 1/1 *? *
    • Nombre d'arrondi : choisissez le nombre maximum de chiffres décimaux d'un résultat.
    • Valeur d'extraction pour les évaluations non marquées : choisissez la valeur nulle que les éléments non marqués ou non notés doivent renvoyer.
    • Filtre de colonne : sélectionnez cette option si la liste des colonnes d'approbation et d'extraction doit être limitée à une liste CSV spécifique de noms de colonne de notes lorsque la mise en service est désactivée. Grâce à ce paramètre, l'extraction ne contient que les colonnes qui doivent être incluses dans le rapport.
    • Colonne de notes externes uniquement : sélectionnez cette option si la liste des colonnes d'approbation et d'extraction doit être limitée à la colonne de notes externes du cours, c'est-à-dire la colonne du centre de notes marquée Note externe.

      Ce paramètre prévaut sur le paramètre Filtre de colonne.

    • Mise en service activée : sélectionnez ce paramètre si la liste des colonnes d'approbation et d'extraction doit être limitée à celles qui ont été importées dans le cadre de l'élément de contenu et de l'élément évaluable approvisionnés par SIS.
    • Mappage de colonnes : saisissez une liste de paires nom/valeur séparées par une barre verticale pour identifier les champs de données des colonnes de notes à inclure pour chaque enregistrement du rapport. Si vous ne saisissez rien ici, une liste de champs par défaut est incluse dans le rapport :
      EXTERNAL_COURSE_KEY|STUDENT_ID|BATCH_UID|TITLE|MARK|GRADE|EXTENDED_DATA
  • Rôle au sein du cours exigée pour l'extraction
    • Rôles au sein du cours : spécifiez le rôle dans le cours requis pour qu'un utilisateur puisse approuver les notes (par exemple, un professeur).
    • Rôle dans l'établissement : spécifiez le rôle dans l'établissement requis pour qu'un utilisateur puisse approuver les notes (par exemple, un approbateur de notes).
    • Message de refus d'accès : saisissez un message pour les utilisateurs qui tentent d'extraire des notes sans disposer de l'autorisation appropriée.
  • Paramètres de transfert du résultat
    • Point d'accès au service Web de publication : spécifiez le point d'accès à la publication des notes.
    • Test du point d'accès au service Web Rest : ignorez ce paramètre (généralement).
  • Paramètres de sécurité REST (sortants)
    • Activer l'API REST sécurisée : activez ce paramètre si le point d'accès implémente la sécurité. Si ce paramètre est activé, définissez également les paramètres suivants :
      • Secret partagé : saisissez la clé partagée.
      • Clé API : saisissez la clé API.
      • Plage d'horodatage : ne paramétrez pas cette option.
      • Paramètre d'horodatage : saisissez le paramètre d'horodatage.
      • Paramètre MAC : entrez une valeur pour ce paramètre.
      • Paramètre de clé API : entrez une valeur pour ce paramètre.
  • Paramètres Approbation et transfert des notes
    • Approbation des notes requise : activez ce paramètre pour que les notes soient approuvées au niveau des colonnes ou des notes.
    • Afficher la page d'historique ? : activez ce paramètre si vous ne voulez pas d'approbation au niveau des notes, mais que vous souhaitez que la page d'historique soit affichée en cas d'extraction dans le cours.
    • Bouton Réaliser l'extraction activé ? : activez ce paramètre pour permettre aux évaluateurs d'exécuter l'extraction immédiatement.
    • Bouton Planifier l'extraction activé ? : activez ce paramètre pour permettre aux évaluateurs d'exécuter/approuver l'extraction.
    • Verrouiller à l'approbation ? : activez ce paramètre pour placer le centre de notes en lecture seule afin que les notes ne puissent pas être modifiées après l'extraction.

Lorsque vous avez terminé, sélectionnez Soumettre.

Paramètres des notifications

Si vous le souhaitez, revenez au menu Paramètres et modifiez les paramètres de notification.

Paramètres de sécurité de l'API REST (sécurité des données entrantes)

Configurez les propriétés suivantes :

  • Paramètres de sécurité REST (sortants)
    • Activer l'API REST sécurisée : activez ce paramètre si les points d'accès entrants implémentent la sécurité.
    • Filtre IP : activez le filtre pour toutes les adresses IP entrantes. Si ce paramètre est activé, définissez également les paramètres suivants :
      • Secret partagé : saisissez la clé partagée.
      • Clé API : saisissez la clé API.
      • Plage d'horodatage : ne paramétrez pas cette option.
      • Paramètre d'horodatage : saisissez le paramètre d'horodatage.
      • Paramètre MAC : entrez une valeur pour ce paramètre.
      • Paramètre de clé API : entrez une valeur pour ce paramètre.

Lorsque vous avez terminé, sélectionnez Soumettre.

Niveaux de journalisation

Configurez les propriétés suivantes :

  • Configuration de la journalisation
    • Verbosité du journal : configurez ce paramètre pour déterminer le niveau de journalisation dans le fichier /logs/custom/bbc-GradeyJourney.log. La valeur par défaut est INFO, mais vous pouvez ajouter DEBUG à des fins de dépannage. La configuration de production doit avoir la valeur INFO à moins que le débogage ne soit effectué.

Exécuter un test de validation

  1. Accédez à Administrateur système > Paramètres d'extraction des notes (données sortantes).
  2. Sélectionnez la méthode de transfert Local et définissez le chemin d'accès à un dossier local qui peut être lu, mis à jour et supprimé depuis l'instance utilisateur Blackboard Learn exécutée. Choisissez l'intégration SITS en fonction de vos besoins. Sélectionnez Soumettre.
  3. Dans Paramètres, sélectionnez Paramètres des colonnes de devoirs et de notes (données entrantes).
  4. Désactivez le paramètre Recevoir les fichiers d'entrée par FTP et définissez le chemin d'accès à un dossier local qui peut être lu, mis à jour et supprimé depuis l'instance utilisateur Blackboard exécutée. Sélectionnez Soumettre.
  5. Créez une colonne de notes pondérées dans le cours à l'aide d'un fichier plat. Créez les fichiers utilisateur pour les inscriptions.
  6. Connectez-vous à Learn en tant que professeur et accédez au cours.
  7. Accédez au centre de notes. La nouvelle colonne de notes pondérées apparaît.
  8. Créez un devoir et mappez-le à 100 % à la colonne pondérée.
  9. Entrez les notes des devoirs.
  10. Dans le menu Gérer, sélectionnez Approbation et transfert des notes.
  11. Cliquez sur Extraire et Planifier au niveau du cours, de la colonne de notes ou des notes.
  12. Si l'extraction a réussi, le ou les fichiers apparaissent dans le dossier d'extraction.
  13. Dans le cas contraire, consultez le journal enregistré dans <bb home>/custom/log/bbgs-GradeJourney.log.