Spécifications des fichiers plats entrants
Créer des travaux
Les travaux 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
GJTEST1|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, période2023_01.asg.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant unique de lot du cours dans lequel ce travail doit être créé ou mis à jour. | Oui | Chaîne (256 caractères) |
Nom | Nom du travail. | Oui | Chaîne (333 caractères) |
instructions | Instructions pour le travail. | Non | Chaîne (2000 caractères) |
anonymes | Indique si le travail est anonyme. Y/N | Non | Booléen (N par défaut) |
groupe | Indique s'il s'agit d'un travail 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 travail sera créé. Pour les cours Ultra, cet en-tête peut être utilisé pour approvisionner un sous-dossier et y placer du contenu. La valeur est au format « parent@> @child » où « parent » est le nom du dossier de niveau supérieur (parent) et « child » est le nom du sous-dossier. Si le sous-dossier existe déjà, le travail sera ajouté au sous-dossier existant. Si le sous-dossier n'existe pas, il sera créé dans le dossier parent. | Non | Chaîne (255 caractères) « Travaux » par défaut |
disponible | Disponibilité des travaux. 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 travail. | Non | Chaîne (10 caractères) |
essais | Nombre de tentatives accordées pour le travail. Utilisez -1 pour un nombre illimité. | Non | Nombre entier (-1 par défaut) |
suivi | Activez le suivi de l'élément de travail. | Non | Booléen (N par défaut) |
Date de début | Afficher la date de début du travail. | Non | Date formatée comme indiqué dans l'écran Paramètres entrants. Aucune valeur n'a été spécifiée par défaut. |
Date de fin | Afficher la date limite pour le travail. | Non | Date formatée comme indiqué dans l'écran Paramètres entrants. Aucune valeur n'a été spécifiée par défaut. |
Date d'échéance | Date d'échéance du travail. | 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 travail. | Non | Float (100,0 par défaut) |
Schéma de notes | Schéma de notes appliqué au travail pour l'affichage du Centre de notation. La chaîne fournie doit correspondre au nom d'un schéma de notes du cours cible pour que le paramètre soit appliqué. | Non | Chaîne (333 caractères) Le comportement par défaut est résultat. |
Données facultatives | 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 notation (calculé)
Les colonnes pondérées calculées par le Centre de notation 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 notation à 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
GJTEST1|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, période2023_01.col.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant unique de lot 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) |
Date d'échéance | 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) |
Schéma de notes | Schéma de notes appliqué à la colonne de notes pour affichage. La chaîne fournie doit correspondre au nom d'un schéma de notes du cours cible pour que le paramètre soit appliqué. | Non | Chaîne (333 caractères) Le comportement par défaut est résultat. |
Données facultatives | 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 notation (non calculées)
Le but de cette interface est de créer ou de mettre à jour des colonnes du relevé 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
GJTEST1|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, période2023_01.colnc.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant unique de lot 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) |
Date d'échéance | 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) |
Schéma de notes | Schéma de notes appliqué à la colonne de notes pour affichage. La chaîne fournie doit correspondre au nom d'un schéma de notes du cours cible pour que le paramètre soit appliqué. | Non | Chaîne (333 caractères) Le comportement par défaut est résultat. |
Données facultatives | 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 notes 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
GJTEST1|GC Final Grade
Spécifications des fichiers
Le nom de fichier doit se terminer par .colext ; par exemple, période2017_01.colext.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant unique de lot 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 relevé 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
GJTEST1|User001|GC Final Grade|90
Spécifications des fichiers
Le nom de fichier doit se terminer par .colncval ; par exemple, période2023_01.colncval.
En-tête de champ | Description | Obligatoire | Type et taille maximale |
|---|---|---|---|
courseId | Identifiant unique de lot du cours dans lequel cette colonne de notes doit être créée ou mise à jour. | Oui | Chaîne (256 caractères) |
ID utilisateur | 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) |
valeur | 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 travaux 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, période2023_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) |
Données facultatives | 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) |