Skip to main content

Descriptions de l'en-tête du fichier plat d'instantané

Le fichier plat d'instantané offre une possibilité d'intégration à l'aide des derniers objets de données LEARN. Vous trouverez ci-après la liste exhaustive des objets pris en charge, les conventions de dénomination des en-têtes de flux de données pour les champs d'interface utilisateur de ces objets, la description de l'utilisation des objets et les exigences relatives aux données.

Le flux de données étant un fichier texte, toutes les données sont représentées sous la forme d'une chaîne. Dans certains cas, les exigences de format et de longueur spécifiques sont indiquées. Le cas échéant, les valeurs possibles d'un champ sont spécifiées. Les champs obligatoires sont mis en évidence et indiqués.

Objet d'apprentissage pour l'utilisateur

Objet LEARN : Utilisateur

Objet système d'informations pour les étudiants : Personne

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Domaines d'apprentissage

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : external_person_key

Description : Un identifiant unique pour un utilisateur de l'établissement. Cet identifiant est fourni par l'établissement et n'est pas visible par les utilisateurs.

Il est vivement recommandé de faire en sorte que les données de clé correspondent à un identifiant fixe permanent pour chaque utilisateur. Un exemple de clé correct est un code étudiant permanent attribué lorsque la personne s'inscrit auprès de l'établissement. Notez que la base de données ne peut pas fusionner les données de comptes distincts.

Longueur maximale : 64 caractères.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour définir le regroupement des éléments de l'utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 256. Caractères multi-octet acceptés.

Prénom (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : firstname

Description : Prénom de l’utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Nom (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : lastname

Description : Nom de famille de l’utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Nom d'utilisateur (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : user_id

Description : Nom d'utilisateur utilisé pour se connecter à Mon Blackboard. Le nom d'utilisateur doit être unique.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Prononciation du nom

Obligatoire : Non

Unique : Non

En-tête : TBC

Description: guide d'orthographe ou de prononciation phonétique du nom de l'utilisateur.

Longueur maximale : 1000 caractères. Caractères multi-octet acceptés.

Mot de passe

Obligatoire : Non

Unique : Non

En-tête : passwd

Description : Le mot de passe utilisé pour se connecter à My Blackboard. Si aucun mot de passe n'est fourni dans le flux de données, Learn remplit automatiquement ce champ avec un mot de passe SHA-512 à des fins de sécurité.

Longueur maximale : 32 caractères. Caractères multi-octet acceptés.

Nom de domaine

Obligatoire : Non

Unique : Non

En-tête : domain_name

Description : Le nom d'hôte de la marque à utiliser dans les courriels de notification avant que l'utilisateur ne se connecte. La valeur doit être l’un des noms d’hôte configurés pour le système. Les valeurs non valides sont ignorées sans avertissement et l'utilisateur est créé avec le nom d'hôte par défaut. Défini uniquement lors de l'insertion, les mises à jour sont ignorées. (format par exemple : blackboard.college.edu, college.blackboard.com)

Longueur maximale : 255 caractères

Disponible

Obligatoire : Non

Unique : Non

En-tête : available_ind

Description : Disponibilité du compte utilisateur dans l’interface utilisateur. Si ce champ est défini sur Non, le compte d'utilisateur est grisé pour l'administrateur et pour les professeurs. L'utilisateur ne pourra pas se connecter au système. Les valeurs possibles sont « Y » pour oui ou « N » pour non.

Valeurs prises en charge : « Y », « N ».

Date de naissance

Obligatoire : Non

Unique : Non

En-tête : birthdate

Description : Date de naissance de l’utilisateur.

Format : yyyymmdd

Ville

Obligatoire : Non

Unique : Non

En-tête : city

Description : Nom de la ville qui correspond à l'adresse de l'utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Société

Obligatoire : Non

Unique : Non

En-tête : company

Description : Le nom de l’entreprise pour laquelle l’utilisateur travaille.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Pays

Obligatoire : Non

Unique : Non

En-tête : country

Description : Nom du pays correspondant à l'adresse de l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Service

Obligatoire : Non

Unique : Non

En-tête : department

Description : Nom du service ou de la sous-section où travaille l'utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Niveau de formation

Obligatoire : Non

Unique : Non

En-tête : educ_level

Description : Niveau d'études le plus élevé atteint par l'utilisateur.

Valeurs prises en charge : « K-8 », « lycée », « première année », « deuxième année », « troisième année », « terminal », « études supérieures », « post-études supérieures »

E-mail

Obligatoire : Non

Unique : Non

En-tête : email

Description : L’adresse e-mail de l’utilisateur. Blackboard recommande d'utiliser une valeur user_e-mail non Null. Les utilisateurs dépourvus d'adresse e-mail ne peuvent pas envoyer d'e-mails.

Longueur maximale : 100 caractères.

Adresse e-mail de l'établissement

Obligatoire : Non

Unique : Oui

En-tête : inst_email

Description : L'adresse électronique de l'établissement de l'utilisateur. inst_e-mail peut être défini sur Null. Aucune communication par e-mail n'est envoyée à inst_e-mail.

Longueur maximale : 254 caractères.

Pronoms

Obligatoire : Non

Unique : Non

En-tête : pronouns

Description : Il s’agit des pronoms de l’utilisateur. L'ajout de plusieurs valeurs de pronoms est accepté en utilisant la virgule comme séparateur.

Longueur maximale : 1 000 caractères.

Sexe

Obligatoire : Non

Unique : Non

En-tête : gender

Description : Le genre de l’utilisateur.

Valeurs prises en charge : « Non divulgué », « Masculin », « Féminin ».

Téléphone domicile

Obligatoire : Non

Unique : Non

En-tête : h_phone_1

Description : Numéro de téléphone du domicile de l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Téléphone domicile (secondaire)

Obligatoire : Non

Unique : Non

En-tête : h_phone_2

Description : Un numéro de téléphone supplémentaire associé à l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Fonction

Obligatoire : Non

Unique : Non

En-tête : job_title

Description : Le titre du poste associé à l'utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Deuxième prénom

Obligatoire : Non

Unique : Non

En-tête : middlename

Description : Deuxième prénom de l’utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Téléphone portable

Obligatoire : Non

Unique : Non

En-tête : m_phone

Description : numéro de téléphone portable ou de téléavertisseur de l'utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Autre nom

Obligatoire : Non

Unique : Non

En-tête : othername

Description : Il s'agit de l'autre nom favori de l'utilisateur.

Longueur maximale : 100 caractères.

Type de chiffrement du mot de passe

Obligatoire : Non

Unique : Non

En-tête : pwencryptiontype

Description : Ce champ définit le type de chiffrement du mot de passe utilisé pour chiffrer le mot de passe dans la base de données.

Les valeurs prises en charge sont les suivantes : MD5, SSO

Rôle premier dans l'établissement

Obligatoire : Non

Unique : Non

En-tête : institution_role

Description : La fonction principale dans l'établissement de l'utilisateur, qui détermine la vue de l'utilisateur sur les modules du portail et d'autres éléments.

Pour obtenir la liste des rôles dans l'établissement valides dans le système, consultez « Gérer les rôles dans l'établissement » dans le panneau de configuration de l'administrateur.

Identifiant batch de remplacement

Obligatoire : Non

Unique : Oui

En-tête : new_external_person_key

Description : Ce champ n'est utilisé que dans les rares cas où la clé EXTERNAL_PERSON_KEY d'un utilisateur change.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de l’utilisateur. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement d'utilisateur est « script.flatfile.UserReplacementDataSourceBatchUid ».

État de ligne

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : Définit la valeur de l'enregistrement sur l'une des valeurs suivantes : Activé : Accès normal à l'enregistrement. Désactivé : l'enregistrement est visible dans certaines zones de l'interface utilisateur, mais il est impossible de le modifier ou d'y accéder. Supprimé : la suppression de l'enregistrement est prévue.

Valeurs prises en charge : « enabled », « disabled », « deleted »

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

Région

Obligatoire : Non

Unique : Non

En-tête : statut

Description : Le nom de l’État ou de la province correspondant à l’adresse de l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Adresse 1

Obligatoire : Non

Unique : Non

En-tête : street_1

Description : La première ligne de l’adresse de l’utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Adresse 2

Obligatoire : Non

Unique : Non

En-tête : street_2

Description : La deuxième ligne de l'adresse de l'utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Code étudiant

Obligatoire : Non

Unique : Non

En-tête : student_id

Description : Champ d'identification générique. Il s'agit d'un champ en lecture seule.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Suffixe

Obligatoire : Non

Unique : Non

En-tête : suffix

Description : Suffixe du nom d'utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Rôle dans le système

Obligatoire : Non

Unique : Non

En-tête : system_role

Description : Le rôle administratif de l'utilisateur, décrivant le niveau de privilège d'administration système de l'utilisateur. Le rôle « none » n'accorde aucun privilège d'administration système ou de création de cours. Il s'agit du rôle le plus couramment attribué.

Les chaînes acceptables sont les suivantes :

  • Administrateur utilisateur : "account_admin", "accountadmin" ou "user_admin" Support système : "system_support" ou "syssupport"

  • Créateur du cours : "course_creator" ou "creator"

  • Assistance : "course_support" ou "support"

  • Invité : « invité »

  • Aucun : « aucun »

  • Observateur : « observateur »

  • Administrateur du portail : "portal_admin" ou "portal"

  • Administrateur du système : « sys_admin », « sysadmin » ou « system_admin ».

  • Administrateur du commerce électronique : « ecommerce_admin »

  • Administrateur de bureau de cartes : "card_office_admin"

  • Administrateur de la boutique : « store_admin »

Pour créer des rôles système définis par l'utilisateur, il faut faire correspondre l'« ID de rôle » qui se trouve dans Panneau de l'administrateur > Rôle système. S’il n’y en a pas, le système prend par défaut la valeur « aucun ».

Titre

Obligatoire : Non

Unique : Non

En-tête : titre

Description : Le titre que l'utilisateur préfère utiliser.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Site Web

Obligatoire : Non

Unique : Non

En-tête : webpage

Description : l’URL de la page web personnelle de l’utilisateur, s’il en a une.

Longueur maximale : 100 caractères.

Téléphone professionnel

Obligatoire : Non

Unique : Non

En-tête : b_Phone_1

Description : Le numéro de téléphone professionnel associé à l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Téléphone bureau (secondaire)

Obligatoire : Non

Unique : Non

En-tête : b_phone_2

Description : Un numéro de téléphone professionnel supplémentaire associé à l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Code postal

Obligatoire : Non

Unique : Non

En-tête : zip_code

Description : Code postal de l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Objets LEARN : Cours/Communauté

Objet système d'informations pour les étudiants : cours ou communauté

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Domaines d'apprentissage

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : external_person_key

Description : Un identifiant unique pour un utilisateur de l'établissement. Cet identifiant est fourni par l'établissement et n'est pas visible par les utilisateurs.

Longueur maximale : 64 caractères.

Code cours ou Code communauté (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : course_id ou organization_id

Description : Nom court utilisé par l'établissement pour identifier de manière unique le cours ou la communauté (par exemple, math101_F99 ou ChessClub). Les caractères suivants ne peuvent pas être utilisés : espace ( ) & / ' +

Longueur maximale : 100 caractères. Obligatoirement unique et non modifiable.

Nom du cours ou Nom de la communauté (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : course_name/organization_name

Description : Intitulé complet du cours ou de la communauté. Destiné à être affiché.

Longueur maximale : 255 caractères. Caractères multi-octet acceptés.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour définir le regroupement des éléments de l'utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 256. Caractères multi-octet acceptés.

Prénom (obligatoire)

Obligatoire : Non

Unique : Non

En-tête : TBC

Description: guide d'orthographe ou de prononciation phonétique du nom de l'utilisateur.

Longueur maximale : 1000 caractères. Caractères multi-octet acceptés.

Mot de passe

Obligatoire : Non

Unique : Non

En-tête : passwd

Description : Le mot de passe utilisé pour se connecter à My Blackboard. Si aucun mot de passe n'est fourni dans le flux de données, Learn remplit automatiquement ce champ avec un mot de passe SHA-512 à des fins de sécurité.

Longueur maximale : 32 caractères. Caractères multi-octet acceptés.

Nom de domaine

Obligatoire : Non

Unique : Non

En-tête : domain_name

Description : Le nom d'hôte de la marque à utiliser dans les courriels de notification avant que l'utilisateur ne se connecte. La valeur doit être l’un des noms d’hôte configurés pour le système. Les valeurs non valides sont ignorées sans avertissement et l'utilisateur est créé avec le nom d'hôte par défaut. Défini uniquement lors de l'insertion, les mises à jour sont ignorées. (format par exemple : blackboard.college.edu, college.blackboard.com)

Longueur maximale : 255 caractères

hasDescriptionPage

Obligatoire : Non

Unique : Non

En-tête : desc_page_ind

Description : Ce champ n’est pas pris en charge pour le moment. Les intégrations ne doivent pas l'utiliser.

numDaysOfUse

Obligatoire : Non

Unique : Non

En-tête : days_of_use

Description : Nombre de jours pendant lesquels les étudiants peuvent accéder au cours après leur inscription. Ce champ est utile pour l'apprentissage à son propre rythme. Cette valeur n'est utilisée que si la durée est définie comme fixe (« FIXED ») et indique le nombre de jours pendant lesquels le cours est utilisable après sa création.

Valeur numérique. Par exemple : 120

serviceLevelType

Obligatoire : Non

Unique : Non

En-tête : service_level

Description : Généralement non utilisé dans les flux de données. Ignorez-le.

Spécifie le type du cours.

C (Community) = communauté

F (Full) = cours

R (Registered) = non utilisé

T (Test_Drive) = non utilisé

S (System) = cours avec fonctions limitées pour protéger les données qui le constituent.

Valeurs prises en charge : « F », « C », « R », « T », «vS ».

Cours autorisé aux visiteurs

Obligatoire : Non

Unique : Non

En-tête : allow_guest_ind

Description : Permet aux invités d'accéder au cours.

Valeurs prises en charge : « Y », « N »

Cours autorisé aux observateurs

Obligatoire : Non

Unique : Non

En-tête : allow_observer_ind

Description : Permet à l’observateur d’accéder au cours.

Valeurs prises en charge : « Y », « N ».

Disponible

Obligatoire : Non

Unique : Non

En-tête : available_ind

Description : Disponibilité du compte utilisateur dans l’interface utilisateur. Si ce champ est défini sur Non, le compte d'utilisateur est grisé pour l'administrateur et pour les professeurs. L'utilisateur ne pourra pas se connecter au système. Les valeurs possibles sont « Y » pour oui ou « N » pour non.

Valeurs prises en charge : « Y », « N ».

Date de naissance

Obligatoire : Non

Unique : Non

En-tête : birthdate

Description : Date de naissance de l’utilisateur.

Format : yyyymmdd

Ville

Obligatoire : Non

Unique : Non

En-tête : city

Description : Nom de la ville qui correspond à l'adresse de l'utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Société

Obligatoire : Non

Unique : Non

En-tête : company

Description : Le nom de l’entreprise pour laquelle l’utilisateur travaille.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

  • Continu : « C » = Le cours est toujours accessible.

  • Plage : « R » = Le cours est accessible dans les jours compris entre la START_DATE et la END_DATE La date de début ou la date de fin peuvent être laissées ouvertes de façon à rendre un cours accessible à partir d'une certaine date ou jusqu'à une certaine date.

  • Durée : « D » = N jours à compter de l'effectif

  • Terme : « T » = dicté par la période de cours (la durée de la période de cours associée contrôle la durée de ce cours)

Pays

Rythme de la formation

Obligatoire : Non

Unique : Non

En-tête : country

Description : Nom du pays correspondant à l'adresse de l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Service

Obligatoire : Non

Unique : Non

En-tête : department

Description : Nom du service ou de la sous-section où travaille l'utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Niveau de formation

Obligatoire : Non

Unique : Non

En-tête : educ_level

Description : Niveau d'études le plus élevé atteint par l'utilisateur.

Valeurs prises en charge : « K-8 », « lycée », « première année », « deuxième année », « troisième année », « terminal », « études supérieures », « post-études supérieures »

E-mail

Obligatoire : Non

Unique : Non

En-tête : email

Description : L’adresse e-mail de l’utilisateur. Blackboard recommande d'utiliser une valeur user_e-mail non Null. Les utilisateurs dépourvus d'adresse e-mail ne peuvent pas envoyer d'e-mails.

Longueur maximale : 100 caractères.

Date de fin d'inscription

Obligatoire : Non

Unique : Non

En-tête : enroll_end

Description : Date à laquelle l'effectif n'est plus disponible pour les étudiants.

Format : yyyymmdd

Date de début d'inscription

Obligatoire : Non

Unique : Non

En-tête : enroll_start

Description : Date à laquelle l’effectif peut commencer.

Format : yyyymmdd

Type d'inscription

Obligatoire : Non

Unique : Non

En-tête : enroll_option

Description : Détermine la méthode d'inscription.

Valeurs prises en charge : « instructeur », « self » ou « e-mail ».

Frais

Obligatoire : Non

Unique : Non

En-tête : fee

Description : Frais associés à ce cours ou à cette communauté.

Numérique. 11 caractères, 2 décimales. Exemple : 1 500,00

Adresse e-mail de l'établissement

Obligatoire : Non

Unique : Non

En-tête : institution_name

Description : Nom de l'établissement.

Longueur maximale : 255 caractères. Caractères multi-octet acceptés.

Pack langue

Obligatoire : Non

Unique : Non

En-tête : locale

Description : ID du pack linguistique préféré. Cette valeur est exprimée sous la forme xx_XX ; par exemple, le pack langue français est représenté par l'identifiant fr_FR.

Longueur maximale : 20 caractères.

Verrouillé

Obligatoire : Non

Unique : Non

En-tête : lockout_ind

Description : Indique si l'accès au cours ou à la communauté a été restreint. Si ce champ est défini sur « Y », l'accès au cours ou à la communauté est limité par les valeurs END_DATE et START_DATE.

Valeurs prises en charge : « Y », « N »

Utilisation du disque maximum (limite logicielle)

Obligatoire : Non

Unique : Non

En-tête : soft_limit

Description : Limite souple du quota de cours. Ce paramètre déclenche l'envoi de courriers électroniques d'avertissement lorsque le stockage des dossiers de cours atteint la limite logicielle soft_limit spécifiée et que des quotas de cours sont en vigueur.

Numérique. ex : 10MB serait 10485760 octets.

Identifiant batch d'association principale

Obligatoire : Non

Unique : Oui

En-tête : inst_email

Description : L'adresse électronique de l'établissement de l'utilisateur. inst_e-mail peut être défini sur Null. Aucune communication par e-mail n'est envoyée à inst_e-mail.

Longueur maximale : 254 caractères.

Pronoms

course_id

course_name

external_association_key

primary_external_node_key

Identifiant batch de nœud principal

Obligatoire : Non

Unique : Non

En-tête : pronouns

Description : Il s’agit des pronoms de l’utilisateur. L'ajout de plusieurs valeurs de pronoms est accepté en utilisant la virgule comme séparateur.

Longueur maximale : 1 000 caractères.

Sexe

Obligatoire : Non

Unique : Non

En-tête : gender

Description : Le genre de l’utilisateur.

Longueur maximale : 100 caractères.

Identifiant batch de remplacement

Obligatoire : Non

Unique : Oui

En-tête : new_external_person_key

Description : Ce champ n'est utilisé que dans les rares cas où la clé EXTERNAL_PERSON_KEY d'un utilisateur change.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de l’utilisateur. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement d'utilisateur est « script.flatfile.UserReplacementDataSourceBatchUid ».

État de ligne

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : Définit la valeur de l'enregistrement sur l'une des valeurs suivantes : Activé : Accès normal à l'enregistrement. Désactivé : l'enregistrement est visible dans certaines zones de l'interface utilisateur, mais il est impossible de le modifier ou d'y accéder. Supprimé : la suppression de l'enregistrement est prévue.

Valeurs prises en charge : « enabled », « disabled », « deleted »

Afficher dans le catalogue

Obligatoire : Non

Unique : Non

En-tête : catalog_ind

Description : Indique si le cours ou l'organisation apparaît dans le catalogue.

Valeurs prises en charge : « Y », « N »

Clé de copie de cours source/Clé de copie de communauté source

Obligatoire : Non

Unique : Non

En-tête : template_course_key.template_organization_key

Description : Clé externe de la source de contenu pour les opérations de copie.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

Région

Obligatoire : Non

Unique : Non

En-tête : statut

Description : Le nom de l’État ou de la province correspondant à l’adresse de l’utilisateur.

Longueur maximale : 50 caractères. Caractères multi-octet acceptés.

Adresse 1

Obligatoire : Non

Unique : Non

En-tête : street_1

Description : La première ligne de l’adresse de l’utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Adresse 2

Obligatoire : Non

Unique : Non

En-tête : street_2

Description : La deuxième ligne de l'adresse de l'utilisateur.

Longueur maximale : 100 caractères. Caractères multi-octet acceptés.

Objet LEARN : Adhésion à un cours et à une communauté

Note

Les cours et les communautés requièrent les mêmes champs. L'en-tête varie selon que vous créez un cours ou une communauté. Notez les différences lorsque vous construisez les flux de données.

Objet système d'informations pour les étudiants : Adhésions à un cours ou à une communauté (effectifs et devoirs du personnel)

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Domaines d'apprentissage

UID du batch de cours ou identifiant batch de la communauté (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_course_key ou external_organization_key

Description : Il s'agit de la même clé que celle utilisée pour identifier le cours ou la communauté.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 256 caractères. Caractères multi-octet acceptés.

Identifiant batch utilisateur (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_person_key

Description : il s'agit de la clé external_person_key utilisée pour identifier l'utilisateur.

Longueur maximale : 64. Caractères multi-octet acceptés.

hasCartridgeAccess (dispose d'un accès au cartouche)

Obligatoire : Non

Unique : Non

En-tête : hascartridgeaccess

Description : Ce champ n'est pas pris en charge et devrait être supprimé. Ignorez-le. Les nouvelles intégrations ne doivent pas utiliser ce champ. Si des intégrations existantes l'utilisent, elles doivent cesser de le faire.

Disponible

Obligatoire : Non

Unique : Non

En-tête : available_ind

Description : Définit la disponibilité des effectifs dans Blackboard Learn.

Valeurs prises en charge : « Y », « N »

URL de l'image

Obligatoire : Non

Unique : Non

En-tête : URL_image

Description : Ce champ n'est pas pris en charge et devrait être supprimé. Ignorez-le. Les nouvelles intégrations ne doivent pas utiliser ce champ. Si des intégrations existantes l'utilisent, elles doivent cesser de le faire.

Inclure dans l'annuaire

Obligatoire : Non

Unique : Non

En-tête : annuaire_ind

Description : drapeau indiquant si l'utilisateur est affiché dans l'annuaire.

Valeurs prises en charge : « Y », « N »

Introduction

Obligatoire : Non

Unique : Non

En-tête : introduction

Description : informations d'introduction à la page d'accueil de l'utilisateur dans le cours.

Longueur maximale : 4000 caractères. Caractères multi-octet acceptés.

Notes

Obligatoire : Non

Unique : Non

En-tête : notes

Description : informations pertinentes pour cet utilisateur qui peuvent avoir une incidence sur la participation au cours ou à la participation de la communauté.

Longueur illimitée. Caractères multi-octet acceptés.

Informations personnelles

Obligatoire : Non

Unique : Non

En-tête : pinfo

Description : Informations personnelles pour la page d'accueil de l'utilisateur.

Longueur illimitée. Caractères multi-octet acceptés.

Professeur principal

Obligatoire : Non

Unique : Non

En-tête : primary_instructor

Description : indique que le membre est un professeur principal. Le membre doit posséder un rôle au sein du cours avec l'indicateur « Traiter en tant que professeur ». Si le membre n'est pas professeur ou ne dispose pas de cet indicateur, l'option n'apparaît pas. Si vous attribuez un rôle au sein d'un cours où celui-ci ne dispose pas de l'indicateur « Traiter en tant que professeur », un Y dans l'enregistrement d'adhésion est rejeté.

Valeurs prises en charge : « Y », « N »

Recevoir un e-mail

Obligatoire : Non

Unique : Non

En-tête : receive_email_ind

Description : Indique si l'e-mail est activé pour cet utilisateur.

Valeurs prises en charge : « Y », « N »

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.MemberReplacementDataSourceBatchUid »

Rôle

Obligatoire : Non

Unique : Non

En-tête : role

Description : rôle de l'utilisateur dans le cours.

Valeurs prises en charge : « Instructor », « teaching_assistant », « course_builder », « Grader », « Student », « guest », « none »

État de ligne

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : définit la valeur de l'enregistrement sur l'une des valeurs suivantes : Activé : accès normal à l'enregistrement. Désactivé : l'enregistrement est visible dans certaines zones de l'interface utilisateur, mais il est impossible de le modifier ou d'y accéder. Supprimé : la suppression de l'enregistrement est prévue.

Valeurs prises en charge : « enabled », « disabled », « deleted »

Description du site Web 1

Obligatoire : Non

Unique : Non

En-tête : link_description_1

Description : Description du site Web de l'utilisateur

Longueur maximale : 255 caractères.

Nom du site Web 1

Obligatoire : Non

Unique : Non

En-tête : link_name_1

Description : nom utilisé dans le lien vers le site Web de l'utilisateur

Longueur maximale : 100 caractères.

URL du site Web 1

Obligatoire : Non

Unique : Non

En-tête : link_url_1

Description : URL utilisée dans le lien vers le site Web de l'utilisateur

Longueur maximale : 100 caractères.

Description du site Web 2

Obligatoire : Non

Unique : Non

En-tête : link_description_2

Description : Description du site Web de l'utilisateur

Longueur maximale : 255 caractères.

Nom du site Web 2

Obligatoire : Non

Unique : Non

En-tête : link_name_2

Description : nom utilisé dans le lien vers le site Web de l'utilisateur

Longueur maximale : 100 caractères.

URL du site Web 2

Obligatoire : Non

Unique : Non

En-tête : link_url_2

Description : URL utilisée dans le lien vers le site Web de l'utilisateur

Longueur maximale : 100 caractères.

Description du site Web 3

Obligatoire : Non

Unique : Non

En-tête : link_description_3

Description : Description du site Web de l'utilisateur

Longueur maximale : 255 caractères.

Nom du site Web 3

Obligatoire : Non

Unique : Non

En-tête : link_name_3

Description : nom utilisé dans le lien vers le site Web de l'utilisateur

Longueur maximale : 100 caractères.

URL du site Web 3

Obligatoire : Non

Unique : Non

En-tête : link_url_3

Description : URL utilisée dans le lien vers le site Web de l'utilisateur

Longueur maximale : 100 caractères.

Objet LEARN : Termes

Objet système d'informations pour les étudiants : Durée

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Domaines d'apprentissage

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : external_term_key

Description : nom court utilisé par l'établissement pour identifier de manière unique la plage de dates. Ce nom n'est pas visible par les utilisateurs. Il peut uniquement comporter des lettres, des chiffres, des tirets et des points. Les espaces et signes de ponctuation ne sont pas autorisés.

Longueur maximale : 256 caractères. Caractères multi-octet acceptés.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments du terme. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 256 caractères. Caractères multi-octet acceptés.

Nom (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : name

Description : nom du terme.

Longueur maximale : 333 caractères.

daysOfUse

Obligatoire : Non

Unique : Non

En-tête : days_of_use

Description : Nombre de jours pendant lesquels les étudiants peuvent accéder au cours après leur effectif. Ce champ est utile pour l'enseignement à la carte.

Valeur numérique.

Disponible

Obligatoire : Non

Unique : Non

En-tête : available_ind

Description : Détermine la durée de disponibilité. Si ce champ est défini sur « N », les objets associés ne sont pas disponibles.

Valeurs prises en charge : « Y », « N »

Description

Obligatoire : Non

Unique : Non

En-tête : description

Description : Description du terme

Longueur illimitée.

Durée

Obligatoire : Non

Unique : Non

En-tête : durée

Description : fenêtre de disponibilité des horaires.

Les options sont les suivantes :

  • Continu : Le terme est toujours accessible.

  • Plage : Le terme est valide dans les jours compris entre une date de début et une date de fin. La date de début ou la date de fin peuvent être laissées ouvertes de façon à rendre un trimestre valide à partir d'une certaine date ou jusqu'à une certaine date.

  • Corrigé : Le terme est valide pendant un nombre de jours défini (DAYS_OF_USE).

Valeurs prises en charge : continu, plage, fixe

Date de fin

Obligatoire : Non

Unique : Non

En-tête : end_date

Description : Il s'agit de la date à laquelle le terme cesse d'être accessible.

Format : yyyymmdd

Identifiant batch de remplacement

Obligatoire : Non

Unique : Oui

En-tête : new_external_term_key

Description : Ce champ n'est utilisé que dans les rares cas où la EXTERNAL KEY d'un terme change.

Longueur maximale : 256 caractères. Caractères multi-octet acceptés.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.TermReplacementDataSourceBatchUid »

État de ligne

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : définit la valeur de l'enregistrement sur l'une des valeurs suivantes :

  • Activé : accès normal à l'enregistrement.

  • Désactivé : l'enregistrement est visible dans certaines zones de l'interface utilisateur, mais il est impossible de le modifier ou d'y accéder.

  • Supprimé : la suppression de l'enregistrement est prévue.

Valeurs prises en charge : « enabled », « disabled », « deleted »

Date de début

Obligatoire : Non

Unique : Non

En-tête : start_date

Description : Il s'agit de la date à laquelle le terme commence à être accessible.

Format : yyyymmdd

Objet LEARN : Association des rôles des établissements secondaires

Objet système d'informations pour les étudiants : Rôle de l'établissement secondaire utilisateur

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Domaines d'apprentissage

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 256 caractères. Caractères multi-octet acceptés.

Numéro de rôle de l'établissement secondaire (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : role_id

Description : identifiant du rôle de l'établissement secondaire pour cette association.

Identifiant batch utilisateur (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_person_key

Description : L'utilisateur external_person_key (batch_uid) à utiliser pour cette association.

Longueur maximale : 64 caractères.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.SecondaryInstRoleReplacementDataSourceBatchUid »

État de ligne

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : définit la valeur de l'enregistrement sur l'une des valeurs suivantes : Activé : accès normal à l'enregistrement. Désactivé : l'enregistrement est visible dans certaines zones de l'interface utilisateur, mais il est impossible de le modifier ou d'y accéder. Supprimé : l'enregistrement devrait être supprimé manuellement par l'administrateur à l'avenir. La ligne n'est pas supprimée automatiquement par le biais d'une tâche.

Valeurs prises en charge : « enabled », « disabled », « deleted »

Objet LEARN : Association Observateur

Objet système d'informations pour les étudiants : Association d'observateurs

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Domaines d'apprentissage

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 256. Caractères multi-octet acceptés.

Étudiant observateur (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_user_key

Description : L'utilisateur external_person_key (batch_uid) à utiliser pour cette association. Identifiant unique d'un utilisateur dont le rôle dans l'établissement correspond à Étudiant. Cet identifiant est fourni par l'établissement et n'est pas visible par les utilisateurs.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

Observateur (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_observer_key

Description : L'observateur external_person_key (batch_uid) à utiliser pour cette association. Identifiant unique d'un utilisateur dont le rôle système dans l'établissement correspond à Observateur.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.AssociateObserverReplacementDataSourceBatchUid »

État de ligne

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : définit la valeur de l'enregistrement sur l'une des valeurs suivantes : Activé : accès normal à l'enregistrement. Désactivé : l'enregistrement est visible dans certaines zones de l'interface utilisateur, mais il est impossible de le modifier ou d'y accéder. Supprimé : la suppression de l'enregistrement est prévue.

Valeurs prises en charge : « enabled », « disabled », « deleted »

OBJET D'APPRENTISSAGE : Catégorie

Objet système d'informations pour les étudiants : Catégorie de cours

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Domaines d'apprentissage

dataSourceBatchUid (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments de catégorie.

Caractères multi-octet acceptés.

titre (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : titre

Description : nom de la catégorie tel qu'il apparaîtra aux utilisateurs dans l'interface utilisateur.

Longueur maximale : 255 caractères. Caractères multi-octet acceptés.

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : external_category_key

Description : doit être unique. Notez que ce champ correspond au champ Mnémonique de catégorie dans l'interface utilisateur.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

description

Obligatoire : Non

Unique : Non

En-tête : description

Description : Description de la catégorie.

Catégorie sur la première page

Obligatoire : Non

Unique : Non

En-tête : frontpage_ind

Description : Détermine si la catégorie est affichée ou non sur la première page du catalogue.

Valeurs prises en charge : « Y », « N »

Catégorie disponible

Obligatoire : Non

Unique : Non

En-tête : available_ind

Description : Définit la disponibilité des catégories dans Blackboard Learn.

Valeurs prises en charge : « Y », « N »

Catégorie limitée

Obligatoire : Non

Unique : Non

En-tête : restrict_ind

Description : Indique si le cours ou la communauté est réservé aux membres.

Valeurs prises en charge : « Y », « N »

Code unique de batch de parent

Obligatoire : Non

Unique : Non

En-tête : parent_category_key

Description : La CLÉ EXTERNAL_CATEGORY_KEY représentant la catégorie parent dont cette catégorie est une enfant.

Longueur maximale : 64 caractères.

rowStatus

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : définit la valeur de l'enregistrement sur l'une des valeurs suivantes : Activé : accès normal à l'enregistrement. Désactivé : l'enregistrement est visible dans certaines zones de l'interface utilisateur, mais il est impossible de le modifier ou d'y accéder. Supprimé : la suppression de l'enregistrement est prévue. Chaîne.

Valeurs prises en charge : « enabled », « disabled », « deleted »

Identifiant batch de remplacement

Obligatoire : Non

Unique : Oui

En-tête : new_external_category_key

Description : Désigne le remplacement de la clé actuelle.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.CourseCatReplacementDataSourceBatchUid »

APPRENDRE L'OBJET : sujet

Objet du système d'informations pour les étudiants : sujet

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Apprendre les champs : Objet

UID du lot (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : external_subject_key

Description : Nom court utilisé par l'établissement pour identifier le sujet de manière unique. Ce nom n'est pas visible par les utilisateurs. Ne peut contenir que des lettres, des chiffres, des tirets et des points. Les espaces ou la ponctuation ne sont pas autorisés. Doit être unique pour tous les sujets, cours et communautés, et est souvent le même que le SUBJECT_ID.

Longueur maximale : 64 caractères. Doit être unique. Les caractères multi-octets sont acceptés.

ID de la rubrique (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : subject_id

Description : Nom court utilisé par l'établissement pour identifier de manière unique le sujet. La valeur doit respecter le format {SubjectTitle}__{SubjectIdentifier}, avec deux traits de soulignement consécutifs séparant le titre et l'identifiant de la matière. Le titre du sujet ne peut contenir que des lettres, des chiffres, des traits d'union (-), des points (.) et des traits de soulignement (_), et l'identifiant du sujet ne peut contenir que des lettres et des chiffres. Les caractères suivants ne peuvent pas être utilisés : espace ( ), &, /, ', +. Exemple : CHEM__abc123.

Longueur maximale : 100 caractères. Obligatoirement unique et non modifiable.

Nom du sujet (requis)

Obligatoire : Oui

Unique : Non

En-tête : subject_name

Description : Titre complet du sujet. Il est utilisé pour l’affichage.

Longueur maximale : 255 caractères. Les caractères multi-octets sont acceptés.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

Header: data_source_key

Description : Clé utilisée pour établir un regroupement d'éléments du sujet. Remarque : ces informations peuvent être fournies par la configuration de l'intégration et ne sont donc pas nécessaires dans le fichier.

Max. longueur : 256. Les caractères multi-octets sont acceptés.

Disponible

Obligatoire : Non

Unique : Non

En-tête : available_ind

Description : Établit la disponibilité de la rubrique dans Blackboard.

Valeurs prises en charge : « Y », « N ».

Description

Obligatoire : Non

Unique : Non

En-tête : description

Description : Description complète du sujet.

Longueur maximale : 4000 caractères. Les caractères multi-octets sont acceptés.

Type de discussion

Obligatoire : Oui

Unique : Non

En-tête : subject_type

Description : Ce champ est utilisé pour indiquer la classification curriculaire du sujet dans le système de gestion de l'apprentissage. Les options sont les suivantes :

  • Undergraduate : 'U' = Le sujet représente un programme d'études de premier cycle.

  • Graduate : 'G' = Le sujet représente un cursus d'études supérieures.

  • Développement : « D » = La matière représente un programme de développement ou de rattrapage.

  • Diplôme de premier cycle non transférable : "N" = La matière représente un programme de premier cycle qui n'est pas transférable.

  • Transférable : "T" = la matière représente un programme d'études de premier cycle qui est transférable.

  • Professionnel : "P" = Le sujet représente un programme d'études professionnelles ou de formation continue.

Valeurs prises en charge : "U", "G", "D", "N", "T", "P".

Remplacement de l’UID du lot

Obligatoire : Non

Unique : Oui

En-tête : new_external_subject_key

Description : Ce champ est utilisé uniquement dans les rares cas où la clé externe d'un sujet change.

Longueur maximale : 64 caractères. Doit être unique. Les caractères multi-octets sont acceptés.

Remplacement de l'identifiant de lot de la source de données

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de l’objet. Remplace la source de données existante en associant les données au groupe désigné par la clé de source de données de remplacement spécifiée. Remarque : le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est "script.flatfile.SubjectReplacementDataSourceBatchUid".

État de ligne

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : Définit la valeur de l'enregistrement sur l'une des valeurs suivantes : Activé : Accès normal à l'enregistrement. Désactivé : L'enregistrement est visible dans certaines zones de l'interface utilisateur, mais ne peut pas être modifié ou affiché. Supprimé : la suppression de l'enregistrement est prévue.

Valeurs prises en charge : « enabled », « disabled », « deleted »

OBJET D'APPRENTISSAGE : Catégorie Adhésion

Objet système d'informations pour les étudiants : Catégorie d'adhésion

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : Désactiver

Domaines d'apprentissage

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

Description : saisie automatique. N'utilisez pas ce code dans les flux de données.

Identifiant du lot de la catégorie (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_category_key

Description : EXTERNAL KEY (batch_uid) de la catégorie à laquelle ajouter le cours/la communauté.

Longueur maximale : 64 caractères.

UID du batch de cours ou identifiant batch de la communauté (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_course_key

Description : external_organization_key EXTERNAL KEY (batch_uid) du cours ou de la communauté catégorisée.

Longueur maximale : 64 caractères.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Caractères multi-octet acceptés.

Est disponible

Obligatoire : Non

Unique : Oui

En-tête : available_ind

Description : Définit la disponibilité des catégories dans Blackboard Learn.

Valeurs prises en charge : « Y », « N »

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.CourseCatMemReplacementDataSourceBatchUid »

État de ligne

Obligatoire : Non

Unique : Non

En-tête : row_status

Description : définit la valeur de l'enregistrement sur l'une des valeurs suivantes : Activé : accès normal à l'enregistrement. Désactivé : l'enregistrement est visible dans certaines zones de l'interface utilisateur, mais il est impossible de le modifier ou d'y accéder. Supprimé : la suppression de l'enregistrement est prévue.

Valeurs prises en charge : « enabled », « disabled », « deleted »

Objet LEARN : nœud de hiérarchie

Objet système d'informations pour les étudiants : nœud de hiérarchie

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : purge

Domaines d'apprentissage

Les en-têtes minimaux requis pour la création d'un nœud hiérarchique de l'établissement sont les suivants :

  • external_node_key

  • data_source_key

  • parent_node_key

  • nom

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : external_node_key

Description : Identifiant utilisé par l'établissement pour identifier de manière unique le nœud de hiérarchie. Ce nom n'est pas visible par les utilisateurs. Il peut uniquement comporter des lettres, des chiffres, des tirets et des points. Les espaces et signes de ponctuation ne sont pas autorisés.

Longueur maximale : 255 caractères. Caractères multi-octet acceptés.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 255 caractères. Caractères multi-octet acceptés.

Identifiant du batch parent (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : parent_node_key

Description : parent external_node_key (identifiant batch) pour ce nœud.

Longueur maximale : 64 caractères.

Nom (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : name

Description : nom du nœud

Longueur maximale : 255

Description

Obligatoire : Non

Unique : Non

En-tête : description

Description : Description du nœud

Longueur maximale : 1000.

Identifiant batch de remplacement

Obligatoire : Non

Unique : Oui

En-tête : new_external_node_key

Description : Ce champ n'est utilisé que dans les rares cas où la EXTERNAL KEY d'un nœud change.

Longueur maximale : 255 caractères. Obligatoirement unique. Caractères multi-octet acceptés.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.NodeReplacementDataSourceBatchUid »

Objet LEARN : Association d'utilisateurs hiérarchiques

Objet système d'informations pour les étudiants : Association d'utilisateurs

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : purge

Domaines d'apprentissage

Les en-têtes minimaux requis pour l'association d'utilisateurs à un nœud hiérarchique de l'établissement sont :

  • external_user_key

  • external_node_key

  • external_association_key

  • data_source_key

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 255 caractères. Caractères multi-octet acceptés.

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : external_association_key

Description : ID d'association, qui est l'identifiant unique de l'association entre l'utilisateur et le nœud. Il s'agit souvent d'une concaténation des valeurs User identifiant batch et Node identifiant batch pour garantir l'unicité lorsqu'un utilisateur peut être affecté à plusieurs nœuds.

Longueur maximale : 64 caractères.

ID du batch du nœud (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_node_key

Description : le nœud pour cette association, qui est également l'identifiant du nœud qui se trouve dans la zone « Modifier le nœud » de l'interface graphique

Longueur maximale : 64.

Identifiant batch utilisateur (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_user_key

Description : L'utilisateur external_person_key (batch_uid) à associer à ce nœud.

Longueur maximale : 64.

Identifiant batch de remplacement

Obligatoire : Non

Unique : Oui

En-tête : new_external_association_key

Description : Ce champ n'est utilisé que dans les rares cas où la EXTERNAL KEY d'une association change.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.UserAssociationReplacementDataSourceBatchUid »

Objet LEARN : Association de cours hiérarchiques

Objet système d'informations pour les étudiants : Association de cours

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : purge

Domaines d'apprentissage

Les en-têtes minimaux requis pour l'association de cours à un nœud hiérarchique de l'établissement sont :

  • external_course_key

  • external_node_key

  • external_association_key

  • data_source_key

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : external_association_key

Description : chaque association de cours et de nœud doit avoir une valeur unique qui identifie cette relation. L'identifiant batch est l'identifiant unique de la relation cours-nœud.

Longueur maximale : 64 caractères.

Identifiant batch de cours (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_course_key

Description : le cours external_course_key (batch_uid) à associer à ce nœud.

Longueur maximale : 64 caractères.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 255 caractères. Caractères multi-octet acceptés.

ID du batch du nœud (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : external_node_key

Description : nœud pour cette association.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

Indicateur d'association principal

Obligatoire : Non

Unique : Non

En-tête : is_primary_association

Description : indicateur désignant cette association comme association principale lorsque d'autres peuvent être spécifiées.

Valeurs prises en charge : « Y », « N ».

Identifiant batch de remplacement

Obligatoire : Non

Unique : Oui

En-tête : new_external_association_key

Description : Ce champ n'est utilisé que dans les rares cas où la EXTERNAL KEY d'une association change.

Longueur maximale : 64 caractères. Caractères multi-octet acceptés.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.CourseAssociationReplacementDataSourceBatchUid »

Objet LEARN : Association d'objectifs

Objet système d'informations pour les étudiants : Association de buts

Comportement d'insertion/mise à jour par défaut : Insertions ou mises à jour intelligentes

Comportement de suppression par défaut : purge

Domaines d'apprentissage

Code unique de batch (obligatoire)

Obligatoire : Oui

Unique : Oui

En-tête : This has no header, it is auto populated. Ignorez-le dans les flux d'intégration.

Description : identifiant unique de la relation entre le cours et l'objectif (standard).

Longueur maximale : 64 caractères.

Identifiant batch de cours (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : course_key

Description : identifiant unique (external_course_key) du cours auquel l'objectif (standard) sera associé

Longueur maximale : 64 caractères.

Clé de source de données (obligatoire) Fournie par l'intégration ou le fichier de données.

Obligatoire : Oui

Unique : Non

En-tête : data_source_key

Description : Clé utilisée pour établir le regroupement des éléments utilisateur. Notez que cette clé peut être fournie par la configuration de l'intégration et n'est alors pas requise dans le fichier.

Longueur maximale : 255 caractères. Caractères multi-octet acceptés.

Ensemble de sous-objectifs (obligatoire)

Obligatoire : Oui

Unique : Non

En-tête : std_sub_doc_key

Description : identifiant unique de l'objectif (standard) à associer à un cours.

Longueur maximale : 64 caractères.

ID du lot de la source de données de remplacement

Obligatoire : Non

Unique : Non

En-tête : new_data_source_key

Description : Nouvelle clé utilisée pour établir le regroupement des éléments de données. Remplace la source de données existante associant les données au groupe désigné par la clé de source de données de remplacement. Remarque : Le champ de mappage de l'interface utilisateur pour l'identifiant batch de la source de données de remplacement est « script.flatfile.GoalAssociationReplacementDataSourceBatchUid »