Introduction
Lorsque vous gérez des cours ILT ou VILT (formation dirigée, ou formation virtuelle dirigée par un formateur), vous pouvez importer des sessions et des événements via des fichiers CSV de manière groupée, ce qui accélère le processus sur votre plateforme.
Conditions et limitations
- Certains systèmes externes, tels que Zoom (ouvre un nouvel onglet), peuvent appliquer des limites sur le nombre d’événements créés au cours d’une période donnée. N’oubliez pas de vérifier si ces limites sont actives avant de procéder à l’importation.
Qu’est-ce qu’un fichier CSV (.csv) ?
Les fichiers CSV (valeurs séparées par des virgules) stockent des données tabulaires sous forme de texte brut. Chaque ligne d’un fichier CSV est un enregistrement/une ligne de données. Chaque enregistrement/ligne se compose d’un ou plusieurs champs/colonnes séparés par un délimiteur.
Les fichiers CSV peuvent être créés à l’aide de plusieurs logiciels (par exemple, Excel, Google Sheets, Notepad, TextEdit, Emacs). Le contenu du fichier doit respecter le format standard CSV, et le fichier doit avoir l’extension de fichier « .csv ».
Comment les fichiers CSV sont-ils généralement formatés ?
Les fichiers CSV doivent respecter un format standard :
- Les champs/colonnes sont séparés par un délimiteur composé d’un seul caractère, généralement une virgule ou un point-virgule.
- Chaque enregistrement/ligne se termine par une nouvelle ligne.
- Tous les enregistrements/lignes ont le même nombre de champs/colonnes dans le même ordre.
- Le premier enregistrement/la première ligne peut être un en-tête contenant le nom de chaque champ/colonne.
- Les données de chaque champ sont interprétées comme une séquence de caractères ou du texte brut.
- N’importe quel champ peut être encadré par des guillemets doubles.
- Un champ doit être encadré par des guillemets lorsqu’il contient un ou plusieurs caractères spéciaux.
- Les espaces de début et de fin sont considérés comme faisant partie des données d’un champ.
Importation de sessions via CSV
Pour importer de nombreuses sessions simultanément via CSV, connectez-vous à votre plateforme en tant que Superadmin. Accédez au Menu de navigation, et dans Contenu et diffusion (icône de dossier), cliquez sur le bouton Cours.
Depuis la page Cours, identifiez le cours ILT / VILT pour lequel vous souhaitez importer des sessions via CSV, cliquez sur sa description et, une fois dans l’espace du cours, accédez à l’onglet Sessions. À partir de là, cliquez sur le bouton plus et sélectionnez l’option Nouvelles sessions via CSV.
Dans le panneau Importer des sessions ILT, glissez-déposez votre fichier CSV dans la section de téléversement ou cliquez sur le bouton Parcourir pour le trouver sur votre appareil.
Pour que le téléversement réussisse, il est important de créer un fichier CSV correctement formaté. Veuillez consulter le tableau suivant pour connaître les valeurs acceptées pour les champs de données de session. Pour plus d’informations, veuillez consulter Créer et gérer des cours ILT et VILT.
| Nom du champ CSV | Description |
|---|---|
course_id |
L’identifiant interne du cours dans une base de données spécifique de la plateforme ; il est déterminé par la plateforme et ne peut être ni modifié ni supprimé. Vous devez inclure soit l’ID du cours, soit l’UUID du cours dans le fichier CSV pour que l’importation réussisse, mais les deux champs ne peuvent pas coexister dans la même ligne CSV sinon la procédure d’importation renverra une erreur. Valeurs acceptées : Numérique |
course_uuid |
L’identifiant alphanumérique unique du cours est automatiquement calculé par la plateforme lors de la création du cours. Il ne peut être ni modifié ni supprimé. Vous devez inclure soit l’ID du cours, soit l’UUID du cours dans le fichier CSV pour que l’importation réussisse, mais les deux champs ne peuvent pas coexister dans la même ligne CSV sinon vous recevrez une erreur d’importation. Valeurs acceptées : Chaîne de caractères |
instructors_username |
La liste des formateurs de la session, identifiés par leurs noms d’utilisateur. Exemple : |
instructors_id |
La liste des formateurs de la session, identifiés par leur ID utilisateur. Les champs ID du formateur et Nom d’utilisateur du formateur sont facultatifs et ne peuvent pas coexister dans la même ligne CSV, sinon vous recevrez une erreur d’importation. Valeurs acceptées : Exemple : |
id_session |
L’identifiant interne de la session dans une base de données spécifique de la plateforme. Il est déterminé par la plateforme et ne peut être ni modifié ni supprimé. Vous devez inclure soit l’ID de la session, soit l’UUID de la session dans le fichier CSV pour que l’importation réussisse, mais les deux champs ne peuvent pas coexister dans la même ligne CSV, sinon la procédure d’importation renverra une erreur. Valeurs acceptées : |
session_uuid |
L’identifiant alphanumérique unique de la session est automatiquement calculé par la plateforme lors de la création du cours. Il ne peut être ni modifié ni supprimé. Vous devez inclure soit l’ID de la session, soit l’UUID de la session dans le fichier CSV pour que l’importation réussisse, mais les deux champs ne peuvent pas coexister dans la même ligne CSV sinon la procédure d’importation renverra une erreur. Ce champ est sensible à la casse. Valeurs acceptées : Chaîne de caractères |
name |
Le nom de la session. Valeurs acceptées : Chaîne de caractères |
code |
Le code de la session. Valeurs acceptées : Chaîne de caractères |
description |
La description de la session. Valeurs acceptées : Chaîne de caractères |
min_enroll |
Le nombre minimum d’apprenants devant être inscrits à la session. Valeurs acceptées : Numérique |
max_enroll |
Le nombre maximum d’apprenants autorisés à s’inscrire à la session. Valeurs acceptées : Numérique |
score_base |
Le score maximum pour l’évaluation de la session. Il doit être supérieur ou égal à Ce champ est obligatoire lorsque le type d’évaluation de la session est défini sur Valeurs acceptées : |
enrollment_deadline |
La date limite pour que l’apprenant s’inscrive lui-même à la session. Les champs Date limite d’auto-inscription et Date limite d’auto-inscription dynamique ne peuvent pas coexister dans la même ligne CSV, sinon vous recevrez une erreur d’importation. Pour plus d’informations, consultez Gestion des auto-inscriptions et des listes d’attente. Valeurs acceptées : Format : Exemple : |
custom_deadline_days |
Le nombre de jours avant la date de début de la session pendant lesquels l’apprenant peut s’inscrire de lui-même à la session. La date de début de la session est le premier jour du premier événement de la session par ordre chronologique. Les champs Date limite d’auto-inscription et Date limite d’auto-inscription dynamique ne peuvent pas coexister dans la même ligne CSV, sinon vous recevrez une erreur d’importation. Pour plus d’informations, consultez Gestion des auto-inscriptions et des listes d’attente. Valeurs acceptées : |
evaluation_type |
Le type d’évaluation de la session. Les valeurs possibles sont :
Valeurs acceptées : |
min_attended_dates_for_completion |
Le nombre minimum d’événements auxquels les apprenants doivent assister dans une session pour que celle-ci soit marquée comme terminée. Si ce champ n’est pas défini, l’achèvement est défini sur Tous les événements. Définissez le champ Présence minimale aux événements avec un nombre supérieur ou égal à Ce champ ne peut être utilisé que lorsque le type d’évaluation de la session est défini sur Valeurs acceptées : |
|
(répétez cette ligne pour chaque champ supplémentaire de session obligatoire) |
Pour pouvoir importer la session, vous devez fournir une valeur pour chaque champ supplémentaire de session obligatoire. Valeurs acceptées : Les ID peuvent être récupérés depuis |
Pour voir un exemple de CSV correct, sélectionnez l’élément Télécharger un exemple de fichier CSV dans le panneau coulissant. Veuillez noter que les dates sont formatées comme suit : YYYY-MM-DD, mais votre tableur peut les afficher différemment selon le logiciel que vous avez utilisé pour ouvrir l’exemple de CSV.
La taille maximale du fichier CSV que vous pouvez importer sur votre plateforme pour un téléversement utilisateur est de 3 Mo.
Après avoir sélectionné le fichier, cliquez sur la section Paramètres avancés pour afficher et configurer les paramètres supplémentaires. Le système est configuré pour détecter automatiquement le Séparateur de champ, qui est nécessaire pour organiser les informations par colonnes. Les informations peuvent également être organisées par une virgule, un point-virgule ou manuellement, selon vos besoins.
Cochez l’option indiquant que la première ligne est considérée comme un En-tête uniquement si cela correspond au format de votre fichier CSV, et sélectionnez le Jeu de caractères du fichier dans le menu déroulant. Concernant le jeu de caractères du fichier, nous recommandons l’UTF-8, qui est le standard. N’oubliez pas d’utiliser des guillemets pour délimiter le contenu textuel. Cliquez sur Confirmer pour téléverser votre fichier CSV.
Le système traitera ensuite votre fichier CSV. Une fois prêt, vous serez redirigé vers la page utilisée pour mapper les champs inclus dans votre fichier CSV avec les champs Docebo disponibles.
La section Aperçu affichera un aperçu du fichier CSV tel qu’il a été lu par le système. Glissez-déposez les champs de la section Champs Docebo sur la gauche pour faire correspondre les champs avec les noms de colonnes de votre fichier CSV.
Une fois que vous avez fait correspondre les champs pour toutes vos colonnes, passez en revue toutes les informations sur la page d’importation. Avant de continuer, vous pouvez enregistrer les champs que vous avez mappés en tant que préréglage, de sorte que le même mappage soit utilisé pour vos futures importations CSV. Pour ce faire, dans la section Préréglage du panneau de gauche, cliquez sur Enregistrer comme nouveau préréglage. Dans la boîte de dialogue, donnez un nom au préréglage, puis cliquez sur Enregistrer. Une fois créé, un préréglage ne peut pas être supprimé, mais vous pouvez l’écraser en cliquant sur Remplacer le préréglage actuel.
Lorsque vous êtes prêt, cliquez sur le bouton Importer en bas de la page. Le bouton Importer n’est activé que lorsque les champs obligatoires (ID du cours, Nom de la session, Type d’évaluation du nombre maximum d’inscriptions, Score maximum si le type d’évaluation est Basé sur l’évaluation) sont mappés. Lisez les informations figurant dans le message contextuel qui s’affiche, puis cliquez sur Importer sessions ILT.
La tâche d’importation s’exécute en arrière-plan. En cas d’erreur, un fichier d’erreurs sera disponible en téléchargement. Pour trouver ce fichier, accédez au Menu de navigation, recherchez Données et analytique (icône de graphique), puis sélectionnez l’élément Procédures d’arrière-plan. Recherchez la tâche dans la liste pour télécharger le fichier.
Toutes les sessions qui ont été importées dans la plateforme seront répertoriées dans l’onglet Sessions du cours.
Rappel : les Power Users ne sont autorisés à importer des sessions que pour les cours auxquels ils sont affectés.
Importation d’événements via CSV
Pour importer des événements en bloc via CSV, depuis la page Cours, identifiez le cours ILT / VILT pour lequel vous souhaitez importer des événements via CSV, cliquez sur sa description et, une fois dans l’espace du cours, accédez à l’onglet Sessions. De là, cliquez sur le nom de la session et accédez à l’onglet Événements et présence. Cliquez sur le bouton plus dans le coin supérieur droit et sélectionnez l’option Nouveaux événements via CSV.
Dans le panneau Importer des événements ILT, glissez-déposez votre fichier CSV dans la section de téléversement, ou cliquez sur le bouton Parcourir pour le trouver sur votre appareil.
Pour que le téléversement réussisse, il est important de créer un fichier CSV correctement formaté. Veuillez vérifier le tableau suivant pour connaître les valeurs acceptées pour les champs de données d’événement. Pour plus d’informations, veuillez consulter Créer et gérer des sessions ILT et VILT.
| Nom du champ CSV | Valeurs acceptées | Description |
|---|---|---|
id_session |
Numérique | L’identifiant interne de la session dans une base de données spécifique de la plateforme. Il est déterminé par la plateforme et ne peut être ni modifié ni supprimé. Vous devez inclure soit l’ID de session, soit l’UUID de session dans le fichier CSV pour que l’importation réussisse, mais les deux champs ne peuvent pas coexister dans la même ligne CSV, sinon la procédure d’importation renverra une erreur. |
session_uuid |
Chaîne de caractères | Identifiant de session alphanumérique unique, automatiquement calculé par la plateforme lors de la création du cours. Il ne peut être ni modifié ni supprimé. Vous devez inclure soit l’ID de session, soit l’UUID de session dans le fichier CSV pour que l’importation réussisse, mais les deux champs ne peuvent pas coexister dans la même ligne CSV, sinon la procédure d’importation renverra une erreur. Ce champ est sensible à la casse. |
instructors_username |
Chaîne de caractères | La liste des formateurs de l’événement, identifiés par leurs noms d’utilisateur. Les champs ID du formateur et Nom d’utilisateur du formateur sont facultatifs et ne peuvent pas coexister dans la même ligne CSV, sinon vous recevrez une erreur d’importation. Ce champ est sensible à la casse. |
instructors_id |
Numérique (tableau) |
La liste des formateurs de l’événement, identifiés par leur ID utilisateur. Exemple : |
event_id |
Numérique | L’identifiant unique de l’événement est automatiquement calculé par la plateforme lors de la création du cours. Il ne peut être ni modifié ni supprimé. Lorsque ce champ est défini, le processus d’importation mettra à jour l’événement avec les données du CSV. |
name |
Chaîne de caractères | Le nom de l’événement. |
description |
Chaîne de caractères | Texte décrivant l’événement en question. |
day |
Date |
La date à laquelle l’événement a lieu. Exemple : |
time_begin |
Heure |
L’heure à laquelle l’événement commence. Exemple : |
time_end |
Heure |
L’heure à laquelle l’événement se termine. Exemple : |
break_begin |
Heure |
L’heure à laquelle la pause commence. Exemple : |
break_end |
Heure |
L’heure à laquelle la pause se termine. Exemple : |
timezone |
Région / Paramètres régionaux |
Ce champ doit correspondre au format du nom du fuseau horaire (sans GMT + XX:XX) de la plateforme. Exemple : Le format du fuseau horaire de Jérusalem est Ce champ est sensible à la casse. |
id_classroom |
Numérique | L’ID de la salle. Il est déterminé par la plateforme et ne peut être ni modifié ni supprimé. Il s’agit d’un champ facultatif qui peut être spécifié lorsque l’ID du site est défini. Pour plus d’informations, veuillez consulter Gérer les lieux et les salles pour les cours ILT. |
id_location |
Numérique | L’ID du lieu. Il est déterminé par la plateforme et ne peut être ni modifié ni supprimé. Chaque événement doit avoir un ID de lieu, un outil de visioconférence, ou les deux. Pour plus d’informations, veuillez consulter Gérer les lieux et les salles pour les cours ILT. |
collaboration_tool |
Chaîne de caractères | Texte facultatif pour indiquer un outil collaboratif externe permettant aux apprenants de prendre contact et d’interagir sur le sujet du cours. |
webinar_tool |
Chaîne de caractères |
Utilisez ce champ pour définir l’outil de visioconférence pour l’événement VILT.
Si votre outil de webinaire n’est pas pris en charge, définissez cette valeur sur |
id_tool_account |
Numérique | Identifiant interne du compte de webinaire. Il est déterminé par la plateforme et ne peut être ni modifié ni supprimé. Il devient un champ obligatoire lorsque le champ Outil de visioconférence a une valeur et qu’il n’est pas défini sur custom. Il ne doit pas être utilisé dans les autres cas. |
password |
Chaîne de caractères |
Mot de passe pour accéder au webinaire.
|
custom_url |
Chaîne de caractères | Ce champ est obligatoire lorsque l’option Outil de visioconférence est activée et qu’elle n’est pas définie sur custom. |
allow_recording_completion |
Booléen |
S’il est défini sur Exemple : ( |
allow_join_completion |
Booléen |
S’il est défini sur Exemple : ( |
join_in_advance_time_user |
Durée |
Spécifie le laps de temps pendant lequel un apprenant peut rejoindre une visioconférence avant l’heure de début planifiée. Exemple : une valeur de |
join_in_advance_time_teacher |
Durée |
Indique le laps de temps pendant lequel un formateur peut rejoindre une visioconférence avant l’heure de début planifiée. Exemple : une valeur de |
xapi_oauth_account |
Chaîne de caractères | Le compte OAuth xAPI (TinCan). Pour plus d’informations sur xAPI, veuillez consulter Téléverser du contenu xAPI (anciennement Tin Can API). |
xapi_url |
Chaîne de caractères | L’URL du contenu externe xAPI (Tin Can). En savoir plus sur le Téléverser du contenu xAPI (anciennement Tin Can API). |
required_completion_percentage |
Numérique | Ce champ est facultatif et ne peut être utilisé que lorsqu’un outil de visioconférence est défini sur Adobe Connect V2 Meeting ou Adobe Connect V2 Webinar.En savoir plus sur Docebo pour Adobe Connect Version 2. |
adobe_connect_v2_template |
Chaîne de caractères | Ce champ représente le SCO-ID du modèle dans le compte Adobe Connect V2. Il est facultatif et peut être transmis sous forme de chaîne vide. En savoir plus sur Docebo pour Adobe Connect Version 2. |
adobe_connect_v2_folder |
Chaîne de caractères | Ce champ représente le SCO-ID du dossier dans le compte Adobe Connect V2. Il est facultatif et peut être transmis sous forme de chaîne vide. En savoir plus sur Docebo pour Adobe Connect Version 2. |
adobe_connect_v2_room |
Chaîne de caractères | Ce champ représente le SCO-ID de la salle dans le compte Adobe Connect V2.Il est facultatif et peut être transmis sous forme de chaîne vide, mais devient obligatoire lors de l’utilisation d’ Adobe Connect V2 Webinar en tant qu’Outil de visioconférence. |
zoom_v3_account_id |
Numérique | Ce champ représente l’ID du compte Zoom version 3 associé à l’intégration. En savoir plus sur Docebo VILT pour Zoom Version 3. |
zoom_v3_host |
Numérique | Ce champ représente l’hôte Zoom V3. Il accepte l’ID utilisateur de l’utilisateur hôte comme valeur. En savoir plus sur Docebo VILT pour Zoom Version 3. |
zoom_v3_settings_template |
Chaîne de caractères | L’ID associé au modèle par Zoom. En savoir plus sur Docebo VILT pour Zoom Version 3. |
zoom_v3_percentage |
Numérique | Le pourcentage de temps que l’apprenant doit passer dans l’événement Zoom pour être marqué comme présent à l’événement. Il peut s’agir d’une valeur comprise entre 1 et 100.En savoir plus sur Docebo VILT pour Zoom Version 3. |
zoom_v3_registration_enabled |
Booléen |
Active l’inscription obligatoire pour tous les utilisateurs.
Une valeur vide indique Exemple : ( |
zoom_v3_alternative_hosts |
Numérique (tableau) |
La liste des hôtes Zoom alternatifs de l’événement, identifiés par leur ID utilisateur. Exemple : |
Pour voir un exemple de CSV correct, sélectionnez l’élément Télécharger un exemple de fichier CSV dans le panneau coulissant. Veuillez noter que les dates sont formatées comme suit : YYYY-MM-DD, mais votre tableur peut les afficher différemment selon le logiciel que vous avez utilisé pour ouvrir l’exemple de CSV.
La taille maximale d’un fichier CSV que vous pouvez importer sur votre plateforme pour un téléversement par un utilisateur est de 3 Mo.
Après avoir sélectionné le fichier, cliquez sur la section Paramètres avancés pour afficher et configurer les paramètres supplémentaires. Le système est configuré pour détecter automatiquement le Séparateur de champ, qui est nécessaire pour organiser les informations par colonnes. Les informations peuvent également être organisées par une virgule, un point-virgule ou manuellement, selon vos besoins.
Cochez l’option indiquant que la première ligne est considérée comme un En-tête uniquement si cela correspond au format de votre fichier CSV, et sélectionnez le Jeu de caractères du fichier dans le menu déroulant. Concernant le jeu de caractères du fichier, nous recommandons l’UTF-8, qui est le standard. N’oubliez pas d’utiliser des guillemets pour délimiter le contenu textuel. Cliquez sur Confirmer pour téléverser votre fichier .csv.
Le système traitera ensuite votre fichier CSV. Une fois prêt, vous serez redirigé vers la page utilisée pour mapper les champs inclus dans votre fichier CSV avec les champs Docebo disponibles.
La section Aperçu affichera un aperçu du fichier CSV tel qu’il a été lu par le système. Glissez-déposez les champs de la section Champs Docebo sur la gauche pour faire correspondre les champs avec les noms de colonnes de votre fichier CSV.
Une fois que vous avez fait correspondre les champs pour toutes vos colonnes, passez en revue toutes les informations sur la page d’importation. Avant de continuer, vous pouvez enregistrer les champs que vous avez mappés en tant que préréglage, de sorte que le même mappage soit utilisé pour vos futures importations CSV. Pour ce faire, dans l’espace Préréglage du panneau de gauche, cliquez sur Enregistrer comme nouveau préréglage. Dans la boîte de dialogue, donnez un nom au préréglage, puis cliquez sur Enregistrer. Une fois créé, un préréglage ne peut pas être supprimé, mais vous pouvez l’écraser en cliquant sur Remplacer le préréglage actuel.
Lorsque vous êtes prêt, cliquez sur le bouton Importer en bas de la page. Le bouton Importer n’est activé que lorsque les champs obligatoires (ID de la session, Nom de la date, Jour, Heure de début, Heure de fin, Fuseau horaire ainsi que les champs obligatoires des événements) sont mappés. Lisez les informations figurant dans le message contextuel qui s’affiche, puis cliquez sur Importer événements ILT.
La tâche d’importation s’exécute en arrière-plan. En cas d’erreur, un fichier d’erreurs sera disponible en téléchargement. Pour trouver ce fichier, accédez au Menu de navigation, recherchez Données et analytique (icône de graphique), puis sélectionnez l’élément Procédures d’arrière-plan. Recherchez la tâche dans la liste pour télécharger le fichier.
Tous les événements importés dans la plateforme seront répertoriés dans l’onglet Événements et présence de la session de cours.
Rappel : les Power Users ne sont autorisés à importer des événements que pour les cours auxquels ils sont affectés.