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.
Objets LEARN :
Adhésion à un cours/à une communauté
Association de rôles secondaires dans l'établissement
Association d'utilisateurs hiérarchique
Objet LEARN : Utilisateur
Objet SIS : personne
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : désactiver
Champs Learn
Identifiant batch (obligatoire)
Obligatoire : oui
Unique : oui
En-tête : external_person_key
Description : identifiant unique d'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 par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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.
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 de famille (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 permettant de se connecter à Blackboard Learn. 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 : à confirmer
Description : guide d'orthographe ou de prononciation phonétique du nom de l'utilisateur.
Longueur maximale : 1 000 caractères. Caractères multi-octet acceptés.
Mot de passe
Obligatoire : non
Unique : non
En-tête : passwd
Description : mot de passe permettant de se connecter à Blackboard Learn. 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.
Disponible
Obligatoire : non
Unique : non
En-tête : available_ind
Description : disponibilité du compte d'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 possibles : « Y », « N »
Date de naissance
Obligatoire : non
Unique : non
En-tête : birthdate
Description : date de naissance de l'utilisateur.
Format : aaaammjj
Ville
Obligatoire : non
Unique : non
En-tête : city
Description : nom de la ville correspondant à l'adresse de l'utilisateur.
Longueur maximale : 50 caractères. Caractères multi-octet acceptés.
Entreprise
Obligatoire : non
Unique : non
En-tête : company
Description : nom de la société pour laquelle travaille l'utilisateur.
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.
Département
Obligatoire : non
Unique : non
En-tête : department
Description : nom du service ou de la section dans lequel 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 : plus haut niveau d'études atteint par l'utilisateur.
Valeurs possibles : « K-8 », « high school », « freshman », « sophomore », « junior », « senior », « graduate school », « post-graduate school »
Obligatoire : non
Unique : non
En-tête : email
Description : adresse e-mail de l'utilisateur. Blackboard recommande d'utiliser une valeur user_email 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 : adresse e-mail d'établissement de l'utilisateur. inst_email peut être défini sur Null. Aucune communication par e-mail n'est envoyée à inst_email.
Longueur maximale : 254 caractères.
Pronoms
Obligatoire : non
Unique : non
En-tête : pronouns
Description : 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 : identité de genre de l'utilisateur.
Valeurs possibles : « Not Disclosed », « Male », « Female »
Téléphone domicile
Obligatoire : non
Unique : non
En-tête : h_phone_1
Description : numéro de téléphone personnel 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 : autre numéro de téléphone personnel associé à l'utilisateur.
Longueur maximale : 50 caractères. Caractères multi-octet acceptés.
Titre du poste
Obligatoire : non
Unique : non
En-tête : job_title
Description : fonction exercée par 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 : second prénom de l'utilisateur.
Longueur maximale : 100 caractères. Caractères multi-octet acceptés.
Téléphone mobile
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 : autre nom d'usage 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 la méthode de chiffrement utilisée pour chiffrer le mot de passe dans la base de données.
Valeurs possibles : MD5, SSHA
Rôle premier dans l'établissement
Obligatoire : non
Unique : non
En-tête : institution_role
Description : fonction première de l'utilisateur dans l'établissement, qui détermine la vue dont dispose l'utilisateur sur les modules du portail et sur 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.
Pronoms
Obligatoire : non
Unique : non
En-tête : pronouns
Description : pronoms de l'utilisateur.
Longueur maximale : 1 000 caractères.
Identifiant batch de remplacement
Obligatoire : non
Unique : oui
En-tête : new_external_person_key
Description : ce champ est uniquement utilisé en de rares occasions lorsque la clé EXTERNAL_PERSON_KEY d'un utilisateur change.
Longueur maximale : 64 caractères. Caractères multi-octet acceptés.
Identifiant batch 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 regrouper des éléments 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 d'interface utilisateur pour « Identifiant batch de la source de données de remplacement » est « script.flatfile.UserReplacementDataSourceBatchUid ».
État de ligne
Obligatoire : non
Unique : non
En-tête : row_status
Description : définit 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 n'est ni modifiable, ni accessible. deleted : L'enregistrement est programmé pour être supprimé.
Valeurs possibles : « enabled », « disabled », « deleted »
Longueur maximale : 64 caractères. Caractères multi-octet acceptés.
Région
Obligatoire : non
Unique : non
En-tête : state
Description : nom de la région 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 : 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 : seconde ligne de l'adresse de l'utilisateur.
Longueur maximale : 100 caractères. Caractères multi-octet acceptés.
ID de l'étudiant
Obligatoire : non
Unique : non
En-tête : student_id
Description : champ d'identifiant 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 de l'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 : rôle administratif de l'utilisateur décrivant le niveau de privilège d'administration système dont dispose 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 d'utilisateurs : « account_admin », « accountadmin » ou « user_admin » Assistance système : « system_support » ou « syssupport » Créateur de cours : « course_creator » ou « creator » Assistance : « course_support » ou « support » Visiteur : « guest » Aucun : « none » Observateur : « observer » Portail administrateur : « portal_admin » ou « portal » Administrateur système : « sys_admin », « sysadmin » ou « system_admin » Administrateur eCommerce : « ecommerce_admin » Administrateur du bureau des cartes d'étudiants : « card_office_admin » Administrateur d'entrepôt : « store_admin » Il est possible d'utiliser des rôles système définis par l'utilisateur. Il vous suffit de définir cette valeur sur le « Code du rôle » figurant dans Panneau de configuration de l'administrateur > Rôle dans le système. Si aucun code n'est fourni, le système le définit par défaut sur la valeur « none ». Titre Obligatoire : non Unique : non En-tête : title Description : 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 : URL de la page Web personnelle de l'utilisateur, le cas échéant.
Longueur maximale : 100 caractères.
Téléphone professionnel
Obligatoire : non
Unique : non
En-tête : b_Phone _1
Description : numéro de téléphone professionnel de 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 : autre numéro de téléphone professionnel 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.
Objet LEARN : Cours et communauté
Objet SIS : cours ou communauté
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : désactiver
Champs Learn
Identifiant batch (obligatoire)
Obligatoire : oui
Unique : oui
En-tête : external_course_key.external_organization_key
Description : nom court utilisé par l'établissement pour identifier de manière unique la section du cours ou de la communauté. 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. Cette valeur doit être propre à chaque cours et communauté et correspond généralement à la valeur COURSE_ID ou ORGANIZATION_ID.
Longueur maximale : 64 caractères. Obligatoirement unique. Caractères multi-octet acceptés.
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 ClubÉchecs). Les caractères non autorisés sont les suivants : 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 : titre 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 par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper des éléments de cours ou de communauté. 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.
Affichage du cours
Obligatoire : non
Unique : non
En-tête : course_experience
Description : détermine l'affichage de cours qui apparaîtra pour les nouveaux cours. Ce champ autorise uniquement les insertions et ne peut pas être mis à jour par le biais de la structure SIS.
Valeurs possibles : « Original », « Ultra » ou « Instructor choice »
Vue de communauté
Obligatoire : non
Unique : non
En-tête : organization_experience
Description : permet aux clients de sélectionner l'expérience dans laquelle ils souhaitent créer leur communauté. Ce champ autorise uniquement les insertions et ne peut pas être mis à jour par le biais de la structure SIS.
Valeurs possibles : « Original », « Ultra » ou « Instructor choice »
Clé de la classification de cours
Obligatoire : non
Unique : non
En-tête : classification_key
Description : ce champ détermine la classification (matière et discipline) du cours. Il représente la clé primaire de la classification.
Longueur maximale : 450 caractères.
Possède une page de description
Obligatoire : non
Unique : non
En-tête : desc_page_ind
Description : ce champ n'est pas pris en charge pour l'instant. Les intégrations ne doivent pas l'utiliser.
Nombre de jours d'utilisation du cours
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 l'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
Niveau de service du cours
Obligatoire : non
Unique : non
En-tête : service_level
Description : champ 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 possibles : « F », « C », « R », « T », « S »
Cours autorisé aux visiteurs
Obligatoire : non
Unique : non
En-tête : allow_guest_ind
Description : autorise l'accès des visiteurs au cours.
Valeurs possibles : « Y », « N »
Cours autorisé aux observateurs
Obligatoire : non
Unique : non
En-tête : allow_observer_ind
Description : autorise l'accès des observateurs au cours.
Valeurs possibles : « Y », « N »
Disponible
Obligatoire : non
Unique : non
En-tête : available_ind
Description : établit la disponibilité du cours ou de la communauté pour Blackboard. Si le champ use_term_avail_ind est défini sur « Y », cet indicateur est ignoré, et la disponibilité du cours est déterminée par l'indicateur available_ind de sa plage de dates associée.
Valeurs possibles : « Y », « N »
Identifiant batch de cours communs
Obligatoire : non
Unique : non
En-tête : master_course_key
Description : valeur EXTERNAL_COURSE_KEY du cours parent de ce cours.
Longueur maximale : 64 caractères.
Description
Obligatoire : non
Unique : non
En-tête : description
Description : description complète du cours.
Longueur maximale : 4 000 caractères. Caractères multi-octet acceptés.
Durée
Obligatoire : non
Unique : non
En-tête : duration
Description : ce champ indique si le cours reste disponible en continu, pendant une période de cours donnée, x jours après l'inscription ou en fonction de la durée de la période de cours associée.
Les options sont les suivantes :
- En continu : = le cours est toujours accessible.
- Intervalle : 'R' = le cours est accessible dans les jours compris entre les dates START_DATE et 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' = Nb de jours après l'inscription.
- Plage de date : 'T' = tributaire de la période de cours (la durée de la période de cours associée détermine la durée de ce cours).
Valeurs possibles : « C », « R », « D », « T »
Rythme de la formation
Obligatoire : non
Unique : non
En-tête : pace
Description : indique si le cours est dispensé par un professeur ou à la carte en fonction de l'étudiant.
Valeurs possibles : « Self », « Instructor »
Date de fin
Obligatoire : non
Unique : non
En-tête : end_date
Description : date à partir de laquelle le cours n'est plus accessible.
Format : aaaammjj
Appliquer pack langue
Obligatoire : non
Unique : non
En-tête : locale_enforced
Description : indicateur déterminant si le pack langue est appliqué lorsqu'un utilisateur accède au cours. Si le pack langue n'est pas appliqué, l'utilisateur peut visualiser le cours en utilisant son pack langue favori.
Valeurs possibles : « Y », « N »
Code d'accès d'inscription
Obligatoire : non
Unique : non
En-tête : enroll_access_code
Description : code d'accès que doivent utiliser les étudiants lorsqu'ils s'inscrivent au cours.
Longueur maximale : 50 caractères.
Date de fin d'inscription
Obligatoire : non
Unique : non
En-tête : enroll_end
Description : date à partir de laquelle il n'est plus possible aux étudiants de s'inscrire.
Format : aaaammjj
Date de début d'inscription
Obligatoire : non
Unique : non
En-tête : enroll_start
Description : date à partir de laquelle les étudiants peuvent s'inscrire.
Format : aaaammjj
Type d'inscription
Obligatoire : non
Unique : non
En-tête : enroll_option
Description : détermine la méthode d'inscription.
Valeurs possibles : « instructor », « self » ou « email »
Frais
Obligatoire : non
Unique : non
En-tête : fee
Description : frais associés au cours ou à la communauté.
Numérique. 11 caractères, 2 décimales. Exemple : 1 500,00
Nom 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 : identifiant du pack langue favori. 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é limité. 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 possibles : « Y », « N »
Utilisation du disque maximum (limite logicielle)
Obligatoire : non
Unique : non
En-tête : soft_limit
Description : limite logicielle de la taille maximale des cours. Ce paramètre déclenche des e-mails d'avertissement lorsque le stockage d'un dossier de cours atteint la limite logicielle spécifiée et que les tailles maximales de cours sont effectives.
numérique. Ex : 10 Mo correspondent à 10 485 760 octets.
Identifiant batch d'association principale
Obligatoire : non
Unique : oui
En-tête : external_association_key
Description : clé externe du nœud auquel le cours doit être principalement associé. Le cours utilise les valeurs par défaut des paramètres d'outils de ce nœud pour créer ses propres paramètres. Ce champ est identique au champ « external_association_key » du flux Association de cours, à ceci près qu'il s'agit ici de l'association principale. Autrement dit, il copiera les valeurs par défaut de ses paramètres d'outils lors de la création du cours.
Les en-têtes minimaux requis pour la création de cours destinés à être associés à un nœud hiérarchique de l'établissement sont les suivants :
external_course_key
course_id
course_name
external_association_key
primary_external_node_key
Identifiant batch de nœud principal
Obligatoire : non
Unique : non
En-tête : primary_external_node_key
Description : ce champ est identique au champ « external_node_key » du flux Association de cours, à ceci près qu'il s'agit ici de l'association principale.
Les en-têtes minimaux requis pour la création de cours destinés à être associés à un nœud hiérarchique de l'établissement sont les suivants :
external_course_key
course_id
course_name
external_association_key
primary_external_node_key
Longueur maximale : 256 caractères.
Identifiant batch de remplacement
Obligatoire : non
Unique : oui
En-tête : new_external_course_key
Description : ce champ est uniquement utilisé en de rares occasions lorsque la clé EXTERNAL KEY d'un cours ou d'une communauté change.
Longueur maximale : 64 caractères. Obligatoirement unique. Caractères multi-octet acceptés.
Identifiant batch 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 regrouper des éléments 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 d'interface utilisateur pour « Identifiant batch de la source de données de remplacement » est « script.flatfile.CourseReplacementDataSourceBatchUid ».
État de ligne
Obligatoire : non
Unique : non
En-tête : row_status
Description : définit 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 n'est ni modifiable, ni accessible. deleted : L'enregistrement est programmé pour être supprimé.
Valeurs possibles : « enabled », « disabled », « deleted »
Afficher dans le catalogue
Obligatoire : non
Unique : non
En-tête : catalog_ind
Description : détermine si le cours ou la communauté apparaissent dans le catalogue.
Valeurs possibles : « 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.
Date de début
Obligatoire : non
Unique : non
En-tête : start_date
Description : date à laquelle commence l'accès à la section du cours.
Format : aaaammjj
Semestre
Obligatoire : non
Unique : non
En-tête : term_key
Description : valeur EXTERNAL_TERM_KEY associée.
Longueur maximale : 256 caractères.
Utiliser la disponibilité des plages de dates
Obligatoire : non
Unique : non
En-tête : use_term_availability_ind
Description : indicateur spécifiant que la disponibilité du cours est déterminée par celle de la période de cours TERM associée. Si cet indicateur est défini sur Y, l'application utilise la plage de dates pour available_ind, startdate et enddate ; si l'indicateur est défini sur N, l'application utilise les paramètres de cours.
Valeurs possibles : « Y », « N »
Objet LEARN : Adhésion à un cours et Adhésion à une communauté
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 SIS : adhésions à un cours ou à une communauté (inscriptions et affectations de personnel)
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : désactiver
Champs Learn
Identifiant batch du cours ou identifiant batch de communauté (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_course_key ou external_organization_key
Description : clé identique à 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 par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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 de l'utilisateur (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_person_key
Description : clé external_person_key utilisée pour identifier l'utilisateur.
Longueur maximale : 64 caractères. 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 doit ê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é d'inscription dans Blackboard Learn.
Valeurs possibles : « Y », « N »
URL de l'image
Obligatoire : non
Unique : non
En-tête : Image_URL
Description : ce champ n'est pas pris en charge et doit ê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 des étudiants
Obligatoire : non
Unique : non
En-tête : roster_ind
Description : indicateur spécifiant si l'utilisateur figure dans l'annuaire.
Valeurs possibles : « Y », « N »
Introduction
Obligatoire : non
Unique : non
En-tête : intro
Description : informations d'introduction pour la page d'accueil des utilisateurs au sein du cours.
Longueur maximale : 4 000 caractères. Caractères multi-octet acceptés.
Notes
Obligatoire : non
Unique : non
En-tête : notes
Description : informations pertinentes pour l'utilisateur et susceptibles d'avoir une incidence sur la participation au cours ou à la communauté.
Longueur illimitée. Caractères multi-octet acceptés.
Informations personnelles
Obligatoire : non
Unique : non
En-tête : pinfo
Description : données personnelles pour la page d'accueil des utilisateurs.
Longueur illimitée. Caractères multi-octet acceptés.
Professeur principal
Obligatoire : non
Unique : non
En-tête : primary_instructor
Description : indique qu'il s'agit d'un professeur principal pour l'adhésion. 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 possibles : « Y », « N »
Recevoir un e-mail
Obligatoire : non
Unique : non
En-tête : receive_email_ind
Description : indicateur précisant si l'e-mail est activé pour cet utilisateur.
Valeurs possibles : « Y », « N »
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « 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 au sein du cours.
Valeurs possibles : « Instructor », « teaching_assistant », « course_builder », « Grader », « Student », « guest », « none »
État de ligne
Obligatoire : non
Unique : non
En-tête : row_status
Description : définit 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 n'est ni modifiable, ni accessible. deleted : L'enregistrement est programmé pour être supprimé.
Valeurs possibles : « 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 d'accès au 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 d'accès au 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 d'accès au 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 d'accès au 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 d'accès au 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 d'accès au site Web de l'utilisateur.
Longueur maximale : 100 caractères.
Objet LEARN : Période de cours
Objet SIS : Plage de dates
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : désactiver
Champs Learn
Identifiant 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 période de cours. 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 par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper des éléments d'une période de cours. 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 de la période de cours.
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 l'inscription. Ce champ est utile pour l'apprentissage à son propre rythme.
Valeur numérique.
Disponible
Obligatoire : non
Unique : non
En-tête : available_ind
Description : détermine la disponibilité de la période de cours. Si ce champ est défini sur « N », les objets associés ne sont pas disponibles.
Valeurs possibles : « Y », « N »
Description
Obligatoire : non
Unique : non
En-tête : description
Description : description de la période de cours.
Longueur illimitée.
Durée
Obligatoire : non
Unique : non
En-tête : duration
Description : planifie la fenêtre de disponibilité d'une période de cours.
Les options sont les suivantes :
- Continuous : la période de cours est continue, le cours est toujours accessible.
- Range : la période de cours est valide entre les dates START_DATE et END_DATE. La date de début ou la date de fin peuvent être laissées ouvertes de façon à rendre une plage de dates valide à partir d'une certaine date ou jusqu'à une certaine date.
- Fixed : la période de cours est valide pour un nombre de jours défini (DAYS_OF_USE).
Valeurs possibles : « Continuous », « Range », « Fixed »
Date de fin
Obligatoire : non
Unique : non
En-tête : end_date
Description : date à laquelle la période de cours cesse d'être accessible.
Format : aaaammjj
Identifiant batch de remplacement
Obligatoire : non
Unique : oui
En-tête : new_external_term_key
Description : ce champ est uniquement utilisé en de rares occasions lorsque la clé EXTERNAL_PERSON_KEY d'une période de cours change.
Longueur maximale : 256 caractères. Caractères multi-octet acceptés.
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « 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 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 n'est ni modifiable, ni accessible.
- deleted : L'enregistrement est programmé pour être supprimé.
Valeurs possibles : « enabled », « disabled », « deleted »
Date de début
Obligatoire : non
Unique : non
En-tête : start_date
Description : date à laquelle la période de cours devient accessible.
Format : aaaammjj
Objet LEARN : Association de rôles secondaires dans l'établissement
Objet SIS : Rôle secondaire de l'utilisateur dans l'établissement
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : désactiver
Champs Learn
Clé de source de données (obligatoire, fournie par l'intégration ou par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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.
Code de rôle secondaire dans l'établissement (obligatoire)
Obligatoire : oui
Unique : non
En-tête : role_id
Description : identifiant du rôle secondaire dans l'établissement pour cette association.
Identifiant batch de l'utilisateur (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_person_key
Description : clé external_person_key (batch_uid) d'utilisateur à utiliser pour cette association.
Longueur maximale : 64 caractères.
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « 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 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 n'est ni modifiable, ni accessible. deleted : L'enregistrement est programmé pour être supprimé manuellement par l'administrateur à l'avenir. La ligne n'est pas supprimée automatiquement par le biais d'une tâche.
Valeurs possibles : « enabled », « disabled », « deleted »
Objet LEARN : Association observateur
Objet SIS : Association observateur
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : désactiver
Champs Learn
Clé de source de données (obligatoire, fournie par l'intégration ou par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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.
Étudiant observé (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_user_key
Description : clé external_person_key (batch_uid) d'utilisateur à 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 : clé external_person_key (batch_uid) d'observateur à 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.
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « 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 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 n'est ni modifiable, ni accessible. deleted : L'enregistrement est programmé pour être supprimé.
Valeurs possibles : « enabled », « disabled », « deleted »
Objet LEARN : Catégorie
Objet SIS : Catégorie de cours
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : désactiver
Champs Learn
Source de données de la catégorie (obligatoire)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper des éléments de catégorie.
Caractères multi-octet acceptés.
Titre (obligatoire)
Obligatoire : oui
Unique : non
En-tête : title
Description : nom de la catégorie qui sera présenté aux utilisateurs dans l'interface utilisateur.
Longueur maximale : 255 caractères. Caractères multi-octet acceptés.
Identifiant 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 s'affiche ou non sur la première page du catalogue.
Valeurs possibles : « Y », « N »
Catégorie disponible
Obligatoire : non
Unique : non
En-tête : available_ind
Description : définit la disponibilité de la catégorie dans Blackboard Learn.
Valeurs possibles : « Y », « N »
Catégorie limitée
Obligatoire : non
Unique : non
En-tête : restrict_ind
Description : indicateur précisant si le cours ou la communauté sont limités aux membres.
Valeurs possibles : « Y », « N »
Code unique de batch de parent
Obligatoire : non
Unique : non
En-tête : parent_category_key
Description : clé EXTERNAL_CATEGORY_KEY représentant la catégorie parente de cette catégorie.
Longueur maximale : 64 caractères.
État de ligne
Obligatoire : non
Unique : non
En-tête : row_status
Description : définit 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 n'est ni modifiable, ni accessible. deleted : L'enregistrement est programmé pour être supprimé. Chaîne.
Valeurs possibles : « enabled », « disabled », « deleted »
Identifiant batch de remplacement
Obligatoire : non
Unique : oui
En-tête : new_external_category_key
Description : Désigne le code de remplacement de la clé actuelle.
Longueur maximale : 64 caractères. Caractères multi-octet acceptés.
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « Identifiant batch de la source de données de remplacement » est « script.flatfile.CourseCatReplacementDataSourceBatchUid ».
Objet LEARN : adhésion à une catégorie
Objet SIS : adhésion à une catégorie
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : désactiver
Champs Learn
Identifiant batch (obligatoire)
Obligatoire : oui
Unique : oui
Description : automatiquement renseigné. N'utilisez pas ce code dans les flux de données.
Code unique de batch de catégorie (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_category_key
Description : clé EXTERNAL KEY (batch_uid) de la catégorie à laquelle le cours ou la communauté doivent être ajoutés.
Longueur maximale : 64 caractères.
Identifiant batch du cours ou identifiant batch de communauté (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_course_key ou external_organization_key
Description : clé EXTERNAL KEY (batch_uid) du cours ou de la communauté catégorisés.
Longueur maximale : 64 caractères.
Clé de source de données (obligatoire, fournie par l'intégration ou par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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é de la catégorie dans Blackboard Learn.
Valeurs possibles : « Y », « N »
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « 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 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 n'est ni modifiable, ni accessible. deleted : L'enregistrement est programmé pour être supprimé.
Valeurs possibles : « enabled », « disabled », « deleted »
Objet LEARN : Nœud hiérarchique
Objet SIS : nœud hiérarchique
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : purger
Champs Learn
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
- name
Identifiant 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 hiérarchique. 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 par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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 batch de parent (obligatoire)
Obligatoire : oui
Unique : non
En-tête : parent_node_key
Description : clé external_node_key (identifiant batch) de 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 : 1 000 caractères
Identifiant batch de remplacement
Obligatoire : non
Unique : oui
En-tête : new_external_node_key
Description : ce champ est uniquement utilisé en de rares occasions lorsque la clé EXTERNAL KEY d'un nœud change.
Longueur maximale : 255 caractères. Obligatoirement unique. Caractères multi-octet acceptés.
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « Identifiant batch de la source de données de remplacement » est « script.flatfile.NodeReplacementDataSourceBatchUid ».
Objet LEARN : Association d'utilisateurs hiérarchique
Objet SIS : association d'utilisateurs
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : purger
Champs Learn
Les en-têtes minimaux requis pour l'association d'utilisateurs à un nœud hiérarchique de l'établissement sont les suivants :
- 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 par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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 batch (obligatoire)
Obligatoire : oui
Unique : oui
En-tête : external_association_key
Description : code association, identificateur unique de l'utilisateur pour l'association de nœud. Il s'agit souvent d'une concaténation des valeurs Identifiant batch de l'utilisateur et Identifiant batch de nœud pour garantir l'unicité lorsqu'un utilisateur peut être affecté à plusieurs nœuds.
Longueur maximale : 64 caractères.
Identifiant batch de nœud (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_node_key
Description : nom de cette association, qui correspond également à l'identifiant de nœud figurant dans la zone « Modifier le nœud » de l'interface utilisateur.
Longueur maximale : 64 caractères.
Identifiant batch de l'utilisateur (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_user_key
Description : clé external_person_key (batch_uid) d'utilisateur à associer à ce nœud.
Longueur maximale : 64 caractères.
Identifiant batch de remplacement
Obligatoire : non
Unique : oui
En-tête : new_external_association_key
Description : ce champ est uniquement utilisé en de rares occasions lorsque la clé EXTERNAL KEY d'une association change.
Longueur maximale : 64 caractères. Caractères multi-octet acceptés.
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « Identifiant batch de la source de données de remplacement » est « script.flatfile.UserAssociationReplacementDataSourceBatchUid ».
Objet LEARN : Association de cours hiérarchique
Objet SIS : association de cours
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : purger
Champs Learn
Les en-têtes minimaux requis pour l'association de cours à un nœud hiérarchique de l'établissement sont les suivants :
- external_course_key
- external_node_key
- external_association_key
- data_source_key
Identifiant batch (obligatoire)
Obligatoire : oui
Unique : oui
En-tête : external_association_key
Description : chaque association de cours et de nœuds doit avoir une valeur unique qui identifie cette relation. L'identifiant batch est l'identificateur unique de la relation cours-nœud.
Longueur maximale : 64 caractères.
Identifiant batch du cours (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_course_key ou external_organization_key
Description : clé external_course_key (batch_uid) de cours à associer à ce nœud.
Longueur maximale : 64 caractères.
Clé de source de données (obligatoire, fournie par l'intégration ou par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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.
Identifiant batch de nœud (obligatoire)
Obligatoire : oui
Unique : non
En-tête : external_node_key
Description : nœud de 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 associations peuvent être spécifiées.
Valeurs possibles : « Y », « N »
Identifiant batch de remplacement
Obligatoire : non
Unique : oui
En-tête : new_external_association_key
Description : ce champ est uniquement utilisé en de rares occasions lorsque la clé EXTERNAL KEY d'une association change.
Longueur maximale : 64 caractères. Caractères multi-octet acceptés.
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « Identifiant batch de la source de données de remplacement » est « script.flatfile.CourseAssociationReplacementDataSourceBatchUid ».
Objet LEARN : Association d'objectifs
Objet SIS : association d'objectifs
Comportement d'insertion/mise à jour par défaut : insertions intelligentes ou mises à jour
Comportement de suppression par défaut : purger
Champs Learn
Identifiant batch (obligatoire)
Obligatoire : oui
Unique : oui
En-tête : ce code n'a pas d'en-tête, il est automatiquement renseigné. 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 du 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 par le fichier de données)
Obligatoire : oui
Unique : non
En-tête : data_source_key
Description : clé utilisée pour regrouper 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.
Identifiant batch 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 regrouper 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 d'interface utilisateur pour « Identifiant batch de la source de données de remplacement » est « script.flatfile.GoalAssociationReplacementDataSourceBatchUid ».
