Skip to main content

Configurer un extrait de carnet de notes

Les extraits du carnet de notes sont des extraits entièrement automatisés qui ne nécessitent pas l'approbation des notes pour être inclus dans l'extrait. Pour accéder aux paramètres d'extrait de notes d'un extrait de carnet de notes :

  1. Accédez au Panneau de configuration de l'administrateur.

  2. Sélectionnez Extensions de plateforme dans Gestion du cloud.

  3. Choisissez Modifier les paramètres dans le menu Exportation de notes v2.

  4. Choisissez la loupe dans la colonne Configuration de la ligne GRADEBOOK_EXTRACT que vous souhaitez configurer.

Cela vous donnera accès à l'onglet Paramètres de l'extrait de notes. Cet onglet comporte six sections extensibles.

Réglages généraux

  1. Choisissez le Type d'intégration.

    • Intégration NORMALE : format de fichier délimité

    • Intégration REST : format JSON spécifique à Grades Journey

    • Intégration de Legacy Banner : format d'API REST Legacy Banner

  2. Le Calendrier CRON détermine la fréquence à laquelle le fichier de notes approuvé est extrait. Entrez une expression CRON valide pour spécifier la fréquence de l'extrait.

  3. Dans le Champ décimales, entrez le nombre de chiffres qui seront affichés après la décimale pour les valeurs de score. La valeur est tronquée et non arrondie et la valeur par défaut est de cinq.

  4. Entrez la valeur nulle à renvoyer pour les éléments non notés et non marqués ou les champs dont aucune valeur n'est stockée dans le champ Extraire la valeur des évaluations non notées (par exemple, « 0 » ou « NoValue »).

  5. Spécifiez une liste de notes séparées par des virgules qui seront considérées comme des valeurs de note valides dans le champ Notes valides. Il doit s'agir de notes alphabétiques et non de chiffres. Si une valeur de note n'est pas valide, elle n'est pas incluse dans l'extrait et déclenche une notification par e-mail. Les enregistrements exclus de l'extrait parce qu'ils ne sont pas valides sont ajoutés à un fichier joint à la notification par e-mail.

    Note

    Si vous laissez cette case vide, toutes les notes sont considérées comme valides.

  6. Entrez un masque de format de date valide dans le champ Format pour la colonne de date. Ce format sera utilisé pour toutes les valeurs de date incluses dans l'extrait. Utilisez Java SimpleDateFormat.

Filtre de périodes de cours

  1. Activez le bouton Activé pour filtrer l'extrait par période.

  2. Sélectionnez AJOUTER ou SUPPRIMER pour ajouter ou supprimer des lignes.

  3. Dans la colonne PÉRIODE DE COURS, sélectionnez les périodes de cours selon lesquelles vous souhaitez filtrer l'extrait. Seuls les cours associés aux périodes de cours sélectionnées seront inclus dans l'extrait.

  4. Entrez une date d'entrée en vigueur et une date de fin dans les colonnes appropriées. Les données seront extraites des cours associés à la période de cours donnée si la date actuelle se situe entre la date d'entrée en vigueur et la date de fin. Les dates peuvent être laissées en blanc et la date de l'extrait ne sera pas limitée.

Filtre de cours

Les cours à inclure dans l'extrait doivent répondre à tous les critères configurés.

  1. Activez le bouton Cours uniquement disponibles pour inclure uniquement les données des cours disponibles dans l'extrait du carnet de notes.

  2. Recherchez les cours qui seront inclus dans l'extrait des notes. Entrez vos paramètres de recherche et tous les cours renvoyés seront inclus. Vous pouvez effectuer une recherche en fonction des critères suivants :

    • Identifiant batch

    • Code cours

    • Nom du cours

    • Clé de source de données

    • Trimestre

    • Date de création du cours

    • Plage de dates des cours

  3. Entrez une liste d'identifiants de cours séparés par des virgules que vous ne souhaitez pas inclure dans l'extrait du carnet de notes dans la case Liste d'exclusion des cours.

Filtre de colonne

Le filtre de colonne est utilisé pour déterminer quelles colonnes de notes sont extraites.

  • Filtre de colonnes Remplissez cette case si vous souhaitez extraire uniquement des colonnes spécifiques lorsque le provisionnement est désactivé. Entrez les colonnes dans une liste de noms de colonnes séparés par des virgules. L'objectif de ce paramètre est de permettre à l'extrait de contenir uniquement les colonnes qui doivent être signalées.

  • Colonne de note externe (original) ou note globale (Ultra) uniquement Cochez cette case si vous souhaitez extraire uniquement la colonne de note externe (dans les cours d'origine) ou la note globale (dans les cours Ultra). Ce paramètre est prioritaire sur le paramètre Filtre de colonne et le paramètre Provisioning Enabled. Si cette option est sélectionnée, c'est la seule colonne de notes qui sera extraite.

  • Provisionnement activé Cochez cette case si vous souhaitez extraire uniquement les colonnes de notes importées dans le cadre des éléments évaluables provisionnés depuis le système d'informations pour les étudiants. Ce paramètre est prioritaire sur le paramètre Filtre de colonne.

  • Inclure uniquement les lignes depuis la dernière exécution Cochez cette case si vous souhaitez inclure uniquement les enregistrements de colonnes de notes dont la valeur de note a changé depuis le dernier extrait.

  • Exclure « toutes » les colonnes calculées Cochez cette case en combinaison avec le filtre de colonne précédent pour empêcher l'inclusion de colonnes calculées dans l'extrait de notes lorsque la valeur de la colonne change.

  • Exclure « tous » les enregistrements dont les notes sont vides Cochez cette case pour empêcher l'inclusion des enregistrements sans valeur de note dans l'extrait du carnet de notes.

  • Validation des métadonnées de colonne Si vous choisissez Provisionnement activé, une boîte de dialogue Validation des métadonnées de colonne apparaît. Si vous le souhaitez, entrez un ensemble de paires clé/valeur et leur nombre d'occurrences attendu dans les métadonnées de la colonne de notes pour déterminer si le cours peut être extrait. Si ces paramètres ne sont pas respectés, le système renvoie une erreur et les données du cours ne sont pas extraites.

Cartographie des colonnes

Entrez une liste de paires nom/valeur séparées par un symbole circulaire pour identifier les champs de données de la colonne de notes à inclure pour chaque enregistrement du rapport. Si ce champ est laissé vide, une liste de champs par défaut sera transmise dans l'extrait.

Voici un exemple de mappage :

external_course_key=Course.getBatchUid|External_person_key.=User.getBatchUid|student_id=User.getStudentId|column=Item.getDisplayColumnName|grade=Grade.getSchemaValue

Mappage de colonnes supplémentaire

Activez le bouton Activer pour chacun des champs de données supplémentaires suivants si vous souhaitez les inclure dans l'extrait :

  • Date de dernière participation Date à laquelle un devoir ou une tentative d'évaluation a été créé pour la dernière fois. La valeur de l'en-tête peut être modifiée en mettant à jour le champ EXTRACTION KEY. La valeur par défaut est last_attendance_date.

  • Feed-back du formateur Commentaire fourni par le professeur ou l'approbateur dans une colonne de notes calculées. La valeur de l'en-tête peut être modifiée en mettant à jour le champ EXTRACTION KEY. La valeur par défaut est instructor_comment. Ce paramètre ne s'applique normalement pas à l'extrait du carnet de notes étant donné que le feed-back du professeur est fourni dans le cadre du workflow d'approbation.

Paramètres de transfert des résultats

Option d'intégration NORMALE

Paramètres de transfert des résultats

  1. Dans le champ Filename Mask, définissez le modèle pour le nom de l'extrait de fichier. Lorsque le type de transfert est défini sur Fichier combiné, « combined_ » est ajouté au début du nom du fichier.

  2. Choisissez la Méthode de transfert. Le SFTP est la méthode de transfert la plus courante et ses paramètres sont décrits dans ces étapes.

  3. Choisissez le Type de transfert.

    • Chaque fichier entraîne le transfert individuel d'un seul fichier d'extrait par cours

    • Les résultats combinés du fichier dans un seul fichier seront tous approuvés pour tous les cours

  4. Activez Utiliser Windows EOL si cela doit être traité dans un environnement Windows nécessitant Windows EOL.

  5. Entrez l'URL ou l'adresse IP du serveur SFTP dans le champ Serveur.

  6. Entrez le port du serveur SFTP (généralement 22) dans le champ Port.

  7. Entrez le nom d'utilisateur SFTP dans le champ Nom d'utilisateur.

  8. Entrez le mot de passe SFTP dans le champ Mot de passe.

  9. Entrez le chemin des fichiers d'extrait dans le champ Chemin.

Format de fichier d'extraction

  1. Entrez le Séparateur de champs à utiliser pour le fichier d'extrait. La valeur par défaut est un tube (|).

  2. Entrez le Qualificatif de champ. Il s'agit du caractère à utiliser si les données extraites contiennent le délimiteur. La valeur par défaut est un guillemet double («).

Option d'intégration REST

Paramètres de transfert des résultats

  1. Spécifiez le point final pour les notes à publier dans le champ Post Webservice Endpoint.

  2. Entrez le nombre maximum d'enregistrements à inclure dans une transaction dans le champ Nombre maximum d'enregistrements restants.

Options de sécurité restantes (sortantes)

Sélectionnez Oui pour Activer l'interface de programmation d'application REST sécurisée. Si cette option est activée, définissez également un mécanisme de sécurité.

OAuth 1.0

  • Secret partagé  : entrez le secret partagé OAuth

  • Clé API  : entrez la clé API OAuth

Sécurité MAC

En savoir plus sur la Sécurité MAC.

  • Secret partagé : entrez le secret partagé

  • Clé API : entrez la clé API

  • Paramètre d'horodatage : entrez le paramètre qui indiquera la valeur d'horodatage dans la chaîne de requête

  • Paramètre MAC : entrez le paramètre qui indiquera la valeur MAC dans la chaîne de requête

  • Paramètre de clé API : entrez le paramètre qui indiquera la valeur MAC dans la chaîne de requête

OAuth 2.0

L'exportation des notes enverra une demande au point de terminaison configuré avec l'URL du jeton REST. L'autorisation sera envoyée sous forme d'en-tête de demande. Le type de subvention sera client_credentials et sera envoyé dans le corps de la requête : grant_type : « client_credentials ».

  • Clé REST  : entrez la clé qui sera utilisée pour accéder à l'interface de programmation d'application

  • Secret REST  : entrez le secret qui sera utilisé pour accéder à l'interface de programmation d'application

  • URL du jeton REST  : entrez l'URL qui sera utilisée pour demander un jeton d'accès

Sélectionnez Soumettre pour enregistrer vos choix.