Spécifications des fichiers plats entrants
Créer des devoirs
Les devoirs peuvent être créés à l'aide de fichiers plats grâce à la fonction d'exportation des notes. Un exemple de fichier plat est fourni ci-dessous, ainsi que les spécifications et les descriptions.
Note
La ligne d'en-tête doit inclure tous les champs répertoriés ci-dessous ; toutefois, seuls les champs obligatoires doivent être spécifiés dans un enregistrement.
Exemple de fichier plat
courseId|name|instructions|anonymous|group|contentAreaName|available|colour|attempts|tracked|startDate|endDate|dueDate|points|gradeSchema|optionalData GETEST1|Assignment 2|assignment instructions|false|false|Assignments|true||1|false|2023-10-17|2023-10-31|2023-10-31|100.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Spécifications des fichiers
Le nom de fichier doit se terminer par .asg ; par exemple, term2023_01.asg.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant batch du cours dans lequel ce devoir doit être créé ou mis à jour. | Oui | Chaîne (256 caractères) |
nom | Nom du devoir. | Oui | Chaîne (333 caractères) |
instructions | Instructions pour le devoir. | Non | Chaîne (2000 caractères) |
anonymes | Indique si le devoir est anonyme. Y/N | Non | Booléen (N par défaut) |
groupe | Indique s'il s'agit d'un devoir de groupe Y/N | Non | Booléen (N par défaut) |
Nom de la zone de contenu | Nom de la zone de contenu du menu du cours dans laquelle le devoir sera créé. | Non | Chaîne (255 caractères) « Devoirs » par défaut |
disponible | Disponibilité des devoirs. Y/N | Non | Booléen (N par défaut) |
couleur | Nom de couleur ou valeur de chaîne hexadécimale de la couleur de l'élément de devoir. | Non | Chaîne (10 caractères) |
essais | Nombre de tentatives accordées pour le devoir. Utilisez -1 pour un nombre illimité. | Non | Nombre entier (-1 par défaut) |
suivi | Activez le suivi de l'élément de devoir. | Non | Booléen (N par défaut) |
startDate | Afficher la date de début du devoir. | Non | Date formatée comme indiqué dans l'écran Paramètres entrants. Aucune valeur n'a été spécifiée par défaut. |
endDate | Afficher la date limite pour le devoir. | Non | Date formatée comme indiqué dans l'écran Paramètres entrants. Aucune valeur n'a été spécifiée par défaut. |
dueDate | Date d'échéance du devoir. | Non | Date formatée comme indiqué dans l'écran Paramètres entrants. Aucune valeur n'a été spécifiée par défaut. |
points | Des points sont possibles pour le devoir. | Non | Float (100,0 par défaut) |
gradeSchema | Schéma de notes appliqué au devoir pour l'affichage du centre de notes. La chaîne fournie doit correspondre au nom d'un schéma de note du cours cible pour que le paramètre soit appliqué. | Non | Chaîne (333 caractères) Le comportement par défaut est score. |
optionalData | Paires clé/valeur, chaque ensemble de paires étant séparé par deux points et clé/valeurs séparées par un signe égal. Par exemple : key1=value1:key2=value2 Le plus souvent utilisé pour suivre les valeurs uniques lors de l'extraction afin de faire correspondre les enregistrements aux systèmes sources. | Non | Chaîne (2000 caractères par paire clé/valeur) |
Créer des colonnes du centre de notes (calculé)
Les colonnes pondérées calculées par le centre de notes peuvent être créées à l'aide de fichiers plats grâce à la fonction d'exportation des notes. Les colonnes et les pondérations devront être ajoutées manuellement dans le centre de notes à la colonne pondérée calculée créée.
Note
La ligne d'en-tête doit inclure tous les champs répertoriés ci-dessous ; toutefois, seuls les champs obligatoires doivent être spécifiés dans un enregistrement.
Exemple de fichier plat
courseId|name|description|duedate|points|gradeSchema|optionalData GETEST1|GC Calculated Grade||2023-10-30|10.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Spécifications des fichiers
Le nom de fichier doit se terminer par .col ; par exemple, term2023_01.col.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant batch du cours dans lequel cette colonne de notes doit être créée ou mise à jour. | Oui | Chaîne (256 caractères) |
nom | Nom de la colonne de notes. Ce champ est utilisé pour la correspondance. | Oui | Chaîne (333 caractères) |
description | Description de la colonne de notes. | Non | Chaîne (2000 caractères) |
dueDate | Date d'échéance pour la colonne des notes. | Non | Date formatée comme indiqué dans l'écran Paramètres entrants. Aucune valeur n'a été spécifiée par défaut. |
points | Des points sont possibles pour la colonne des notes. | Non | Float (100,0 par défaut) |
gradeSchema | Schéma de notes appliqué à la colonne de notes pour affichage. La chaîne fournie doit correspondre au nom d'un schéma de note du cours cible pour que le paramètre soit appliqué. | Non | Chaîne (333 caractères) Le comportement par défaut est score. |
optionalData | Paires clé/valeur, chaque ensemble de paires étant séparé par deux points et clé/valeurs séparées par un signe égal. Par exemple : key1=value1:key2=value2 Le plus souvent utilisé pour suivre les valeurs uniques lors de l'extraction afin de faire correspondre les enregistrements aux systèmes sources. | Non | Chaîne (2000 caractères par paire clé/valeur) |
Créer des colonnes du centre de notes (non calculées)
Le but de cette interface est de créer ou de mettre à jour des colonnes du carnet de notes.
Note
La ligne d'en-tête doit inclure tous les champs répertoriés ci-dessous ; toutefois, seuls les champs obligatoires doivent être spécifiés dans un enregistrement.
Exemple de fichier plat
courseId|name|description|duedate|points|gradeSchema|optionalData GETEST1|GC Final Grade||2023-12-30|100|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
Spécifications des fichiers
Le nom de fichier doit se terminer par .colnc ; par exemple, term2023_01.colnc.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant batch du cours dans lequel cette colonne de notes doit être créée ou mise à jour | Oui | Chaîne (256 caractères) |
nom | Nom de la colonne de notes. Ce champ est utilisé pour la correspondance. | Oui | Chaîne (333 caractères) |
description | Description de la colonne de notes. | Non | Chaîne (2000 caractères) |
dueDate | Date d'échéance pour la colonne des notes. | Non | Date formatée comme indiqué dans l'écran Paramètres entrants. Aucune valeur n'a été spécifiée par défaut. |
points | Des points sont possibles pour la colonne des notes. | Non | Float (100,0 par défaut) |
gradeSchema | Schéma de notes appliqué à la colonne de notes pour affichage. La chaîne fournie doit correspondre au nom d'un schéma de note du cours cible pour que le paramètre soit appliqué. | Non | Chaîne (333 caractères) Le comportement par défaut est score. |
optionalData | Paires clé/valeur, chaque ensemble de paires étant séparé par deux points et clé/valeurs séparées par un signe égal. Par exemple : key1=value1:key2=value2 Le plus souvent utilisé pour suivre les valeurs uniques lors de l'extraction afin de faire correspondre les enregistrements aux systèmes sources. | Non | Chaîne (2000 caractères par paire clé/valeur) |
Définir des colonnes de notes externes (cours d'origine uniquement)
Le but de cette interface est de définir une colonne comme colonne de note externe. Pour marquer une colonne comme externe, une colonne de note doit être provisionnée ou créée.
Note
La ligne d'en-tête doit inclure tous les champs répertoriés ci-dessous ; toutefois, seuls les champs obligatoires doivent être spécifiés dans un enregistrement.
Exemple de fichier plat
courseId|name GETEST1|GC Final Grade
Spécifications des fichiers
Le nom de fichier doit se terminer par .colext ; par exemple, term2017_01.colext.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant batch du cours dans lequel cette colonne de notes doit être créée ou mise à jour. | Oui | Chaîne (256 caractères) |
nom | Nom de la colonne de notes. Ce champ est utilisé pour la correspondance. | Oui. | Chaîne (333 caractères) |
Créer des valeurs de colonne de notes (non calculées)
Le but de cette interface est de créer les valeurs des colonnes du carnet de notes.
Note
La ligne d'en-tête doit inclure tous les champs répertoriés ci-dessous ; toutefois, seuls les champs obligatoires doivent être spécifiés dans un enregistrement.
Exemple de fichier plat
courseId|userId|name|value GETEST1|User001|GC Final Grade|90
Spécifications des fichiers
Le nom de fichier doit se terminer par .colncval ; par exemple, term2023_01.colncval.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant batch du cours dans lequel cette colonne de notes doit être créée ou mise à jour. | Oui | Chaîne (256 caractères) |
userId | user_id de l'utilisateur pour lequel cette valeur de note doit être créée ou mise à jour | Oui | Chaîne (333 caractères) |
nom | Nom de la colonne de notes. Ce champ est utilisé pour la correspondance. | Oui | Chaîne (2000 caractères) |
value | Valeur à attribuer. | Oui | Chaîne (2000 caractères) |
Création d'un schéma de notes
Les schémas de notes peuvent être créés à l'aide de fichiers plats à l'aide des services Grades Journey. Les autres fichiers créant des devoirs ou des colonnes de notes peuvent dépendre des définitions du schéma de notes contenues dans ce fichier, mais le processeur de données n'impose aucune séquence d'exécution particulière. Par conséquent, vous devez vous assurer que les données du schéma de notes sont traitées avant d'exécuter d'autres fichiers de données dépendants.
Note
La ligne d'en-tête doit inclure tous les champs répertoriés ci-dessous ; toutefois, seuls les champs obligatoires doivent être spécifiés dans un enregistrement.
Exemple de fichier plat
title|symbols|optionalData Schema1|A=90:B=80:C=70:D=60:F=0|
Spécifications des fichiers
Le nom de fichier doit se terminer par .sch ; par exemple, term2023_01.sch.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
titre | Titre du schéma de notation | Oui | Chaîne (333 caractères) |
symboles | Symboles d'une liste avec limite inférieure (facultative), séparés par deux points. | Oui | Chaîne (2000 caractères) |
optionalData | Paires clé/valeur, chaque ensemble de paires étant séparé par deux points et clé/valeurs séparées par un signe égal. Par exemple : key1=value1:key2=value2 Le plus souvent utilisé pour suivre les valeurs uniques lors de l'extraction afin de faire correspondre les enregistrements aux systèmes sources. | Non | Chaîne (2000 caractères par paire clé/valeur) |