Formats de fichier CSV standard D2L

Les formats de fichier acceptés par CSV standard D2L sont les suivants :

  • Organisations
  • Utilisateurs
  • Inscriptions
  • Un fichier Manifest est requis si vous utilisez l'intégration CSV standard D2L version 1.1 ou ultérieure.
  • Attributs relatifs aux outils Tableau de bord du gestionnaire et Groupes d'apprentissage

Les fichiers sont téléversés dans une archive .zip selon la nomenclature recommandée suivante :

  • D2LStdCSV-{AAAAmmjjHHMMSS}.zip

Remarque : Seuls les fichiers d’archive .zip (sensibles à la case, en minuscules uniquement) sont autorisés pour le téléversement sur SFTP.

Les fichiers sont traités en ordre alphabétique. D2L recommande d'envoyer les fichiers selon l'ordre suivant :

  1. Organisations
  2. Utilisateurs
  3. Inscriptions
  4. Attributs

La nomenclature recommandée pour les fichiers CSV est la suivante :

  • 1-Autre- {AAAAmmjjHHMMSS}.csv
  • 2-Départements- {AAAAmmjjHHMMSS}.csv
  • 3-Semestres- {AAAAmmjjHHMMSS}.csv
  • 4-Modèles- {AAAAmmjjHHMMSS}.csv
  • 5-Offres- {AAAAmmjjHHMMSS}.csv
  • 6-Sections- {AAAAmmjjHHMMSS}.csv
  • 7-Utilisateurs- {AAAAmmjjHHMMSS}.csv
  • 8-Inscriptions- {AAAAmmjjHHMMSS}.csv
  • 9-Attributs- {AAAAmmjjHHMMSS}.csv
  • manifest.json

Règles courantes relatives au contenu de fichier

  • Les valeurs des fichiers sont sensibles à la casse. Les instructions spécifient la casse requise.
  • Une valeur vide est représentée par deux virgules sans espace entre elles. (Par exemple, « ,, » indique une valeur vide, alors que « , , » indique un caractère d'espace, analysé en tant que valeur non valide.)
  • Les fichiers CSV doivent afficher un en-tête (première ligne) qui correspond exactement (casse et virgules) aux en-têtes présentés dans les exemples des sections ci-dessous.
  • Les lignes subséquentes du fichier contiennent les données à traiter (création, mise à jour, suppression).
  • Les fichiers CSV doivent être encodés au format UTF-8.
  • Les fichiers CSV et manifest doivent être inclus dans une archive .zip.
  • Les fichiers CSV devraient contenir des données différentielles de SIS (delta) plutôt que des données complètes.
  • L'envoi d'une MISE À JOUR lorsque l'objet n'existe pas devient une demande de CRÉATION. Les actions courantes sont la MISE À JOUR et la SUPPRESSION.
  • Un fichier Manifest est requis si vous utilisez l'intégration CSV standard D2L version 1.1 ou ultérieure. Le fichier Manifest est un fichier JSON qui annonce la version de CSV standard D2L que vous utilisez. Pour obtenir de plus amples renseignements, reportez-vous au sujet Manifest.

Unité organisationnelle

L'intégration prend en charge les types d'unité organisationnelle suivants :

  • Autres unités organisationnelles (UO personnalisées hors de la structure organisationnelle standard de D2L)
  • Départements
  • Semestres
  • Modèles de cours
  • Offres de cours
  • Sections

L'intégration CSV standard D2L permet de créer, d'actualiser et de supprimer des unités organisationnelles aux niveaux répertoriés ci-dessus.

Si vous envoyez un grand nombre de types d'unité organisationnelle dans un seul fichier CSV, assurez-vous que leur hiérarchie est respectée dans le fichier (par exemple, le type Départements doit être envoyé avant Modèles de cours). Une tentative d'envoi d'une UO primaire avant la création d'une UO secondaire entraînera l'échec de l'opération.

Si vous envoyez des relations d'utilisateur, assurez-vous que le fichier respecte la hiérarchie vérificateurs et/ou parents/tuteurs (p. ex., les parents ou tuteurs doivent être envoyés avant les élèves). Le non-respect de cette directive entraînera l'échec de la relation.

Les conventions d'appellation des unités organisationnelles (nom/code) doivent respecter celles décrites dans votre SIS. Brightspace peut accepter le nombre d'UO qu'il vous faut; les noms d'UO et les codes peuvent être fournis tels quels par le biais de fichiers CSV tant qu'ils respectent les exigences de Brightspace en matière de caractères non valides et qu'ils soient uniques au niveau des différentes unités organisationnelles. Les codes d'UO seront tronqués si plus de 50 caractères sont utilisés, ce qui pourrait entraîner la duplication de codes d'UO dans Brightspace ou empêcher la création d'une unité organisationnelle.

Caractères interdits : , : % & # * ? < > | \ "' et espaces de début ou de fin.

Autres unités organisationnelles, Départements, Semestres, Modèles de cours, Offres de cours et Sections de cours

Le traitement de ces unités organisationnelles crée la structure organisationnelle dans votre instance de Brightspace. Ces éléments doivent être transmis au moins une fois pour indiquer à la plateforme CSV standard D2L les unités organisationnelles qu'elle pourra contrôler. Lorsque l'intégration contrôle une unité organisationnelle, toutes les modifications ultérieures apportées à cette UO devront uniquement être effectuées par le biais de l'intégration CSV standard D2L afin d'assurer la propriété exacte des données.

Les unités organisationnelles ne devraient être renvoyées que lorsqu'elles sont créées ou mises à jour dans votre SIS/SIRH.

L'intégration CSV standard D2L permet les opérations suivantes :

  • Créer une unité organisationnelle si elle n'existe pas déjà.
  • Effectuer la mise en correspondance avec une UO existante créée par une source différente de CSV standard D2L (si l'option de mise en correspondance est sélectionnée dans la configuration).
  • Mettre à jour le nom d'une UO qu'elle contrôle.
  • Modèle de cours : Attribuer et mettre à jour un département primaire basé sur le code de département
  • Offre de cours : Attribuer et mettre à jour un modèle de cours et un semestre primaires basés sur le code primaire
  • Offre de cours : Mettre à jour tous les détails de cours, y compris le nom et les dates. Offres de cours inactives.
  • Section de cours : La suppression d'une section de cours désinscrit automatiquement les utilisateurs de la section supprimée.
  • Supprimer une UO qu'elle contrôle.

L'intégration CSV standard D2L ne permet pas les opérations suivantes :

  • Mettre à jour les codes d'unité organisationnelle.
  • Supprimer les UO créées de façon manuelle, à moins qu'elles n'aient été mises en correspondance avec l'intégration CSV standard D2L.
  • Supprimer une unité organisationnelle qui comprend des liens vers des UO secondaires (les UO secondaires doivent être supprimées en premier).
    • Exception : Si des sections sont définies pour une suppression dans l'interface, des offres de cours peuvent être supprimées si elles sont liées à ces sections.

    Utilisateurs

    Le traitement du type d'utilisateur crée, actualise, désactive ou supprime des utilisateurs dans Brightspace. Le type Utilisateur pourrait également créer, mettre à jour ou supprimer la relation primaire-secondaire dans Brightspace. Les utilisateurs doivent être transmis au moins une fois pour indiquer à l'intégration les utilisateurs qui peuvent être créés, mis à jour ou supprimés, ainsi que les inscriptions qui peuvent être gérées.

    Les caractères interdits sont les suivants : \ / : * ? " < > | ' , ;

    L'intégration CSV standard D2L permet les opérations suivantes :

    • Créer un utilisateur s'il n'existe pas déjà et l'inscrire dans l'organisation.
    • Mettre à jour le nom d'utilisateur, le prénom, le nom de famille, le prénom préféré, le nom de famille préféré, le mot de passe et l'adresse courriel.
    • Le mot de passe n'est pas requis et il est recommandé de ne pas le transmettre si vous utilisez l'authentification unique (SSO).
    • Actualiser le rôle de niveau d'organisation.
    • Activer, désactiver ou supprimer un utilisateur.
    • Si un utilisateur existant affiche le même ID défini par l'organisation, il peut être mis en correspondance avec l'utilisateur existant.
    • Mettre à jour une relation parent/tuteur – enfant pour Brightspace pour les parents et les tuteurs et les tuteurs.
    • Mettre à jour une relation entre les vérificateurs et les utilisateurs vérifiés.

    OU

    • Si un utilisateur existant affiche le même nom d'utilisateur, il peut être mis en correspondance avec l'utilisateur existant

    L'intégration CSV standard D2L ne permet pas les opérations suivantes :

    • Mettre à jour l'ID défini par l'organisation; cette opération peut toutefois être effectuée manuellement dans l'interface d'administration d'IPSIS.
    • Supprimer des utilisateurs créés de façon manuelle, à moins qu'ils n'aient été mis en correspondance avec l'intégration CSV standard D2L.

    Inscriptions

    Le traitement des enregistrements de type d’inscription inscrit ou désinscrit des utilisateurs dans une unité organisationnelle spécifique de Brightspace. Les inscriptions devraient être transmises lorsque des modifications sont apportées au système d'information pour bien refléter ces changements dans Brightspace. Une désinscription ne devrait être transmise qu'une seule fois. Le renvoi d'une désinscription entraîne l'affichage d'un avertissement dans votre journal IPSIS.

    L'intégration CSV standard D2L permet les opérations suivantes :

    • Inscrire des utilisateurs dans des unités organisationnelles.
    • Désinscrire des utilisateurs d'unités organisationnelles.

    Attributs relatifs aux outils Tableau de bord du gestionnaire et Groupes d'apprentissage

    À partir de D2L Standard CSV, les attributs du tableau de bord du gestionnaire et des groupes d'apprentissage permettent ce qui suit :

    • Établir la structure de rapports utilisée dans le Tableau de bord du gestionnaire.
    • Fournir des attributs permettant la création des règles d'appartenance automatique dans les groupes d'apprentissage

    Toutefois, à partir de D2L Standard CSV, les attributs du tableau de bord du gestionnaire et des groupes d’apprentissage ne vous permettent pas ceci :

    • Créer des comptes d'utilisateur.