Méthodes de définition de champ

Cette page décrit les définitions de champs courantes qui peuvent être incluses dans la charge utile d'extraction de notes. La définition effective du champ qui doit être placée dans le champ Valeur des données se trouve au bas de chaque cellule de description.

Champs du cours

Champ	Description
Clé principale	Identifiant interne Blackboard du cours. Cette valeur est un entier à incrémentation automatique généré par le schéma de Blackboard lors de la création d'un cours et qui n'a généralement aucune signification en dehors de Blackboard. `Course.getId`
Clé de cours externe	Identificateur unique non visible par l'utilisateur, et généralement généré par le biais de l'intégration d'instantanés ou d'une intégration similaire. Si un cours est créé via l'interface graphique, la « clé de cours externe » correspondra au « code cours ». Ce champ est également connu sous le nom d'Identifiant unique de lot. `Bien sûr. GetBatchUID`
Classification	Titre de la classification de ce cours. `Course.getClassification.getTitle`
Code cours	Identifiant unique du cours destiné à l'utilisateur. `Course.getCourseID`
Disponibilité	« Y » si l'enregistrement du cours est disponible, « N » s'il n'est pas disponible. `Course.get est disponible`
Tapez	« FULL » pour les cours normaux, « COMMUNITY » pour les communautés. D'autres valeurs peuvent exister pour les cours internes, telles que « SYSTEM » ; toutefois, les notes de ces cours n'existeraient pas. `Course.GetServiceLevelType.ToFieldName`
Date de création	Date de création du cours. `Course.getCreatedDate`
Date de modification	Date de la dernière modification du cours. Notez que cela ne concerne que les modifications de l'enregistrement du cours en lui-même et NON celles du contenu, des devoirs, etc. `Course.getModifiedDate`
Titre	Titre du cours affiché à l'utilisateur ou « nom du cours ». `Cours. GetTitle`
Codes de catégorie	Liste délimitée de tous les codes de catégorie de cours (le cas échéant) pour le cours. Le sous-délimiteur est configuré dans les propriétés d'extraction. Exemple (en supposant un sous-délimiteur de tube) : MATHÉMATIQUES\|ALGÈBRE `Course.CATEGORY_IDS`
Noms de catégorie	Liste délimitée de tous les noms de catégories de cours (le cas échéant) pour le cours. Le sous-délimiteur est configuré dans les propriétés d'extraction. Exemple (en supposant un sous-délimiteur de tube) : MATHÉMATIQUES\|ALGÈBRE `Course.CATEGORY_NAMES`

Champs d'utilisateur

Champ	Description
Clé principale	L'identifiant Blackboard interne de l'utilisateur. Cette valeur est un entier auto-incrémenté généré par le schéma Blackboard lors de la création d'un utilisateur et qui n'a généralement aucune signification en dehors de Blackboard. `User.getId`
Clé de personne externe	Identificateur unique non visible par l'utilisateur, et généralement généré par le biais de l'intégration d'instantanés ou d'une intégration similaire. Si un utilisateur est créé via l'interface graphique, la « clé de personne externe » correspondra à l' « ID utilisateur ». Ce champ est également connu sous le nom d'Identifiant unique de lot. `User.getBatchUid`
Téléphone professionnel 1	Téléphone professionnel principal de l'utilisateur. `User.getBusinessPhone1`
Téléphone professionnel 2	Téléphone professionnel secondaire de l'utilisateur. `User.getBusinessPhone2`
L'entreprise	Société de l'utilisateur. `User.getCompany`
Pays	Pays de l'adresse de l'utilisateur. `User.getCountry`
Département	Département de l'utilisateur. `User.getDepartment`
Courrier électronique	Adresse e-mail de l'utilisateur. `User.getEmailAddress`
Nom	Nom de famille de l'utilisateur. `User.getFamilyName`
Prénom	Prénom de l'utilisateur. `User.getGivenName`
Téléphone du domicile 1	Téléphone principal du domicile de l'utilisateur. `User.getHomePhone1`
Téléphone du domicile 2	Téléphone secondaire du domicile de l'utilisateur. `User.getHomePhone2`
Disponibilité	« Y » si l'enregistrement de l'utilisateur est disponible, « N » s'il est indisponible. `User.getIsAvailable`
Intitulé du poste	Intitulé du poste de l'utilisateur. `User.getJobTitle`
Date de la dernière connexion	Date de la dernière connexion au système réussie de l'utilisateur. Si l'utilisateur ne s'est jamais connecté, cette valeur sera vide. `User.getLastLoginDate`
Deuxième prénom	Second prénom de l'utilisateur. `User.getMiddleName`
Téléphone portable	Numéro de téléphone mobile de l'utilisateur. `User.getMobilePhone`
Code étudiant	Attribut Code étudiant de l'enregistrement d'utilisateur. Non pas que cette valeur ne soit PAS garantie comme étant unique dans le système. Seuls le nom d'utilisateur et la clé de personne externe sont des champs uniques garantis. `User.getStudentId`
Titre	Titre de l'utilisateur. Ex : M. Mme Dr. `User.getTitle`
Code utilisateur	Identificateur unique de l'utilisateur divulgué aux utilisateurs. Également connu sous le nom de nom d'utilisateur. `User.getUserName`
Codes de rôles dans l'établissement	Liste délimitée par deux-points de tous les codes de rôle dans l'établissement pour l'utilisateur. L'identifiant du rôle principal sera le premier, suivi de tous les identifiants de rôle secondaires (le cas échéant) pour cet utilisateur. Personnel : Observer:Role_13 `User.INSTITUTION_ROLE_IDS`
Noms de rôles dans l'établissement	Liste délimitée par deux-points de tous les noms de rôle dans l'établissement pour l'utilisateur. Le nom du rôle principal sera le premier, suivi de tous les noms de rôles secondaires (le cas échéant) pour cet utilisateur. Personnel : Observateur : rôle 13 `User.INSTITUTION_ROLE_NAMES`
Code de rôle principal dans l'établissement	Code du rôle principal de l'utilisateur dans l'établissement. `User.PRIMARY_INSTITUTION_ROLE_ID`
Nom de rôle principal dans l'établissement	Nom du rôle principal au sein de l’établissement attribué à l'utilisateur. `User.PRIMARY_INSTITUTION_ROLE_NAME`
Codes de rôles secondaires dans l'établissement	Liste délimitée par deux-points de tous les codes de rôle secondaire (le cas échéant) de l'utilisateur. Observer:Role_13 `User.SECONDARY_INSTITUTION_ROLE_IDS`
Noms de rôles secondaires de l'utilisateur dans l'établissement	Liste délimitée par deux-points de tous les noms de rôles secondaires (le cas échéant) de l'utilisateur. Observateur : rôle 13 `User.SECONDARY_INSTITUTION_ROLE_NAMES`
Codes de rôles dans le système	Liste délimitée par deux-points de tous les codes de rôles système de l'utilisateur dans le domaine DEFAULT. L'ID de rôle système principal sera le premier, suivi de tous les ID de rôle système secondaires (le cas échéant) pour cet utilisateur. N:U:C `User.SYSTEM_ROLE_IDS`
Noms de rôles dans le système	Liste délimitée par deux-points de tous les noms de rôles système de l'utilisateur dans le domaine DEFAULT. Le nom du rôle système principal sera le premier, suivi de tous les noms de rôle système secondaires (le cas échéant) pour cet utilisateur. Aucun : Administrateur utilisateur : Administrateur du cours `User.SYSTEM_ROLE_NAMES`
Code de rôle principal dans le système	Code du rôle principal de l'utilisateur dans le système. `User.PRIMARY_SYSTEM_ROLE_ID`
Nom du rôle principal dans le système	Nom du rôle principal de l'utilisateur dans le système. `User.PRIMARY_SYSTEM_ROLE_NAME`
Codes de rôles secondaires dans le système	Liste délimitée par deux-points de tous les codes de rôles secondaires dans le système (le cas échéant) de l'utilisateur dans le domaine DEFAULT. UC : `User.SECONDARY_SYSTEM_ROLE_IDS`
Noms des rôles secondaires dans le système	Liste délimitée par deux-points de tous les noms de rôles secondaires dans le système (le cas échéant) de l'utilisateur dans le domaine DEFAULT. Administrateur des utilisateurs : Administrateur du cours `User.SECONDARY_SYSTEM_ROLE_NAMES`

Champs de note

Les champs de cette section permettent d'accéder aux informations relatives à la note d'un étudiant sur un élément (ou une colonne) spécifique à partir du Centre de notes Blackboard Learn.

Champ	Description
Clé principale	Identificateur interne Blackboard de la note. Cette valeur est un entier auto-incrémenté généré par le schéma Blackboard lors de la création d'un utilisateur et qui n'a généralement aucune signification en dehors de Blackboard. `Classe. GetID`
Note de la tentative	Note affichée de la dernière tentative par rapport à l'élément évaluable de l'inscription. Si la note n'est pas un travail ou une évaluation, il n'y aura qu'une seule tentative. `Grade.getAttemptGrade`
Résultat de la tentative	Nombre de points (valeur décimale) de la dernière tentative par rapport à l'élément évaluable de l'inscription. `Note.GetAttemptsScore`
Date de la tentative	Date à laquelle la tentative a été créée. Pour les évaluations et les travaux, il s'agit de la date à laquelle l'élément a été créé par l'élève. Pour les notes saisies manuellement (c'est-à-dire saisies directement dans la feuille de calcul du Centre de notation), il s'agit de la date à laquelle le professeur a fourni la note. Notez que cela ne doit PAS être confondu avec la date de remplacement saisie par le professeur, qui est un champ différent. `Note.getLasttemptDate`
État de la tentative	Représentation numérique de l'état de la tentative : Pas tenté Abandonnée En cours Suspendue Annulée Nécessite une notation Terminé `Grade.getStatus`
Note manuelle	Valeur d'affichage d'une note manuellement remplacée pour l'étudiant. Si la note n'a pas été modifiée manuellement, cette valeur sera vide. `Classe. Obtenir une note manuelle`
Résultat manuel	Valeur décimale d'une note manuellement remplacée pour l'étudiant. Si la note n'a pas été modifiée manuellement, cette valeur sera vide. `Note.GetManualScore`
Note affichée	Valeur de la note telle qu'elle s'affiche dans le centre de notes. Cette valeur tient compte des tentatives multiples et des notes annulées manuellement. Dans la plupart des cas, il s'agit de la valeur que vous souhaitez inclure dans l'extrait. `Grade.getSchemaValue`
Résultat affiché	Valeur décimale de la note dans le centre de notes. Cette valeur tient compte des tentatives multiples et des notes annulées manuellement. Dans la plupart des cas, il s'agit de la valeur que vous souhaitez inclure dans l'extrait. `Note.getScoreValue`
Indicateur d'exclusion	« Y » si une exemption a été accordée par l'enseignant pour la note, « N » dans le cas contraire. `Note. est exempté`
Indicateur de note nul	« Y » si la note n'existe pas, « N » dans le cas contraire. `Grade. est NullGrade`
Indicateur de note manuel/de remplacement	« Y » si la note a été remplacée manuellement par le professeur, « N » dans le cas contraire. `Note. est remplacé`
Date de remplacement	Date à laquelle la note a été remplacée par le professeur. Notez que ce n'est PAS la même chose qu'une note attribuée manuellement via la feuille de calcul du Centre de notation, mais la date à laquelle une note de remplacement réelle a été spécifiée (ajoutée ou mise à jour). `Grade.getOverrideDate`

Champs d'éléments du centre de notes

Les champs de cette section s'appliquent aux éléments (ou colonnes) du centre de notes.

Champ	Description
Clé principale	Identificateur interne Blackboard de l'élément évaluable. Cette valeur est un entier auto-incrémenté généré par le schéma Blackboard lors de la création d'un utilisateur et qui n'a généralement aucune signification en dehors de Blackboard. `Article.getID`
Indicateur de note externe	« Y » s'il s'agit de la note externe du cours. « N » dans le cas contraire. Notez qu'il ne peut y avoir qu'un seul élément marqué comme note externe par cours. `Item.IS_EXTERNAL_GRADE`
Description affichée	Description de l'élément évaluable destinée à l'utilisateur. `item.getDescriptionForDisplay.getText`
Nom de colonne affiché	Le nom de la colonne affiché est une valeur obligatoire dans le centre de notes Blackboard et sera la valeur affichée aux utilisateurs finaux SAUF si un titre affiché a été fourni. `Item.getDisplayColumnName`
Nombre de points possibles	Nombre décimal représentant le nombre de points possibles pour l'élément évaluable. `Article. Obtenir des points d'affichage`
Titre affiché	La valeur Titre affiché n'est pas requise ; Toutefois, si elle est fournie pour un élément dans le centre de notes, elle sera affichée pour les utilisateurs finaux à la place du « Nom de colonne affiché ». `Item.getDisplayTitle`

Champs d'adhésion

Champ	Description
Clé principale	Identifiant interne Blackboard pour l'inscription. Cette valeur est un entier auto-incrémenté généré par le schéma Blackboard lors de la création d'un utilisateur et qui n'a généralement aucune signification en dehors de Blackboard. `Membre. getID`
Disponibilité	« Y » si l'enregistrement d'inscription est disponible, « N » s'il est indisponible. `Membre. GET est disponible`
Date de début d'inscription	Date à laquelle l'utilisateur a été inscrit au cours. Notez que cette valeur peut être nulle si la date d'inscription n'a pas été explicitement fournie avec l'intégration. `Membre. Obtenir la date d'inscription`
Date de modification	Date de la dernière modification de l'enregistrement d'inscription. `Member.getModifiedDate`
Date du dernier accès	Date du dernier accès de l'utilisateur au cours. Cette valeur sera nulle si l'utilisateur n'a pas accédé au cours. `Member.getLastDate d'accès`

Champ de données statiques

Champ	Description
Valeur statique	Permet d'inclure du contenu statique dans le mappage de colonnes, où XXX est la valeur du contenu statique à inclure. Des caractères spéciaux peuvent être inclus dans la valeur statique de ce champ. Les caractères spéciaux doivent être configurés en tant que valeur codée. Par exemple : PROCESSSTATUS= : :static : :I%7C écrira la valeur « I\| » dans le fichier d'extrait avec l'en-tête de colonne PROCESSSTATUS. `::static::XXX`

Champ

Description

Valeur statique

Permet d'inclure du contenu statique dans le mappage de colonnes, où XXX est la valeur du contenu statique à inclure.

Des caractères spéciaux peuvent être inclus dans la valeur statique de ce champ. Les caractères spéciaux doivent être configurés en tant que valeur codée. Par exemple :

PROCESSSTATUS= : :static : :I%7C écrira la valeur « I| » dans le fichier d'extrait avec l'en-tête de colonne PROCESSSTATUS.

::static::XXX

Valeurs dérivées spéciales

Les champs de cette section sont des champs spéciaux qui tirent leurs valeurs d'autres champs.

Champ	Description
Grade.PERCENTAGE_SCORE	Contiendra la valeur des points effectifs divisés par les points possibles, uniquement si elle peut être calculée. Dans le cas contraire, il sera vide.
Grade.LETTER_GRADE	Cette valeur ne sera affichée comme valeur du schéma que si une lettre est spécifiée. Dans le cas contraire, il sera vide.
Item.EXTERNAL_SEQNUM	Cette valeur sera la valeur spécifiée dans le mappage de séquence externe.
User.OPTIONAL_DATA:XXX	Cette valeur correspond à la valeur des données facultatives d'inscription des utilisateurs spécifiées sous XXX. Ex : si le provisionnement entrant transmet un champ de données facultatif COHORT avec les données d'inscription des utilisateurs, l'implémentation à inclure dans l'extrait serait la suivante : User.OPTIONAL_DATA: COHORT
Grade.OPTIONAL_DATA:XXX	Cette valeur sera la valeur des données facultatives de notation, comme spécifié dans XXX. Ex : si le provisionnement entrant transmet un champ de données facultatif PartTerm avec l'élément évaluable, l'implémentation à inclure dans l'extrait serait la suivante : Grade.OPTIONAL_DATA:PartTerm
Grade.getCategoryName	Cette valeur correspond au nom de la catégorie de note (par ex., Devoir).
User.EXTRACTOR_BATCH_UID	Cette valeur correspond au batch_uid de l'utilisateur qui a approuvé l'extraction.
User.EXTRACTOR_USER_ID	Cette valeur correspond au code utilisateur de l'utilisateur qui a approuvé l'extraction.
User.EXTRACTOR_FULLNAME	Cette valeur correspond au nom complet de l'utilisateur qui a approuvé l'extraction.
User.EXTRACTOR_EMAIL	Cette valeur correspond à l'adresse e-mail de l'utilisateur qui a approuvé l'extraction.
User.GRADER_FULLNAME	Cette valeur correspond au nom complet du dernier évaluateur de l'élément évaluable.
User.GRADER_EMAIL	Cette valeur sera le courriel du dernier évaluateur de l'élément évaluable.
Course.TERM_CODE	Cette valeur correspond au nom de la période à laquelle la section du cours est associée.
X::regEx:Y	La valeur sera le résultat de l'expression régulière spécifiée par Y pour le champ X. Exemple : Course.getLotUID : :regEx : ^.* ? _ (.* ?) où le cours lot_uid est 202210_12345 renverrait 12345
Grade.getPostedDate	Cette valeur correspond à la date de publication (pour les cours Ultra).
Term.getSourceId	Cette valeur correspond à l'ID source de la période à laquelle le cours est associé.