Pour l’utilitaire de téléversement en bloc dans le Dépôt d’apprentissage de Brightspace, les fichiers de configuration sont des fichiers texte placés dans le répertoire d’entrée. Une fois qu’un fichier de configuration est traité, il est déplacé dans le répertoire de sortie. Les actifs et autres fichiers demeurent dans le répertoire d’entrée.
Chaque fichier de configuration commence par une ligne qui indique le type de fichier de configuration, suivie d’une ou de plusieurs lignes pointant vers les fichiers d’actif ou les progiciels de contenu à importer. Vous pouvez inclure une ligne pointant vers un fichier de métadonnées externe ou préciser les métadonnées à appliquer durant l’importation (selon le type de fichier de configuration utilisé).
Vous pouvez créer trois types de fichiers de configuration :
-
Type 1 : Téléverser des progiciels de contenu avec des métadonnées internes
-
Type 2 : Téléverser des actifs ou des progiciels de contenu avec des métadonnées externes à l’intérieur d’un fichier XML
-
Type 3 : Téléverser des actifs ou des progiciels de contenu et appliquer les métadonnées en fonction de l’information contenue dans le fichier de configuration
Chaque type utilise un format différent pour les lignes pointant vers les fichiers à importer. Vous ne pouvez pas combiner ces types dans un seul fichier; toutes les lignes pointant vers un fichier à téléverser doivent être dans le même format, indiqué au début du fichier.
Veuillez prendre note de ce qui suit :
-
L’utilitaire n’effectue pas de « balayage d’actifs » pendant le téléversement. Si vous téléversez un fichier HTML comme actif au moyen d’un fichier de configuration de type 2 ou de type 3, les liens vers des images ou d’autres composantes internes ne fonctionneront pas; seul le fichier HTML sera téléversé. Il en va de même pour les fichiers HTM, JS et INC.
-
Vous pouvez insérer des commentaires dans un fichier de configuration en commençant une ligne avec // (double barre oblique).
-
L’utilitaire ignore les lignes vides et tous les autres espaces vides dans les fichiers de configuration.
Type 1 : Progiciel de contenu avec métadonnées internes
Première ligne : LoadType=Package
Lignes suivantes : <ID du dépôt>, <chemin d’accès vers le fichier>
Champs à inclure :
-
<ID du dépôt> – l’ID du dépôt dans lequel l’objet doit être créé. Les identifications sont affichées dans la page Propriétés du DOA sous Outils administratifs > Gérer les dépôts > Nom du dépôt > ID.
-
<chemin d’accès au fichier> – le chemin et le nom du fichier à téléverser. Les fichiers doivent être conformes aux progiciels de contenu SCORM 1.2.
Exemple
LoadType=Package
2,"\\myserver\BulkUpload\input\package1.zip"
2,"\\myserver\BulkUpload\input\package2.zip"
1,"\\myserver\BulkUpload\input\package3.zip"
Type 2 : Actif ou progiciel de contenu avec métadonnées externes
Première ligne : LoadType=XMLMetadata
Lignes suivantes : <ID du dépôt>, <chemin d’accès vers le fichier>, <chemin d’accès vers les métadonnées>
Champs à inclure :
-
<ID du dépôt> – l’ID du dépôt dans lequel l’objet doit être créé. Les identifications sont affichées dans la page Propriétés du DOA sous Outils administratifs > Gérer les dépôts > Nom du dépôt > ID.
-
<chemin d’accès au fichier> – le chemin et le nom du fichier à téléverser. Les fichiers peuvent être des progiciels de contenu conformes à la norme SCORM 1.2 ou des fichiers d’actif individuels.
-
<chemin d’accès vers les métadonnées> – le chemin et le nom du fichier de métadonnées à utiliser. Les fichiers de métadonnées doivent être conformes aux normes IMSMD 1.2.1 et XML.
Remarque : Si vous importez un progiciel de contenu de cette façon, toute métadonnée du progiciel est éliminée et les métadonnées du fichier externe sont utilisées exclusivement.
Exemple
LoadType=XMLMetadata
3,"\\myServer\BulkUpload\input\package10.zip","\\myServer\BulkUpload\metadata1.xml"
6,"\\myServer\BulkUpload\input\asset15.gif","\\myServer\BulkUpload\metadata2.xml"
Type 3 : Actif ou progiciel de contenu avec métadonnées dans le fichier de configuration
Première ligne : LoadType=CSVMetadata
Lignes suivantes : <ID du dépôt>, <chemin d’accès au fichier>, <titre>, <description>, <mot clé>, <rôle du contributeur>, <prénom du contributeur>, <npm de famille du contributeur>, <format>
Champs d’un fichier de configuration de type 3 :
-
<ID du dépôt> – l’ID du dépôt dans lequel l’objet doit être créé. Les identifications sont affichées dans la page Propriétés du DOA sous Outils administratifs > Gérer les dépôts > Nom du dépôt > ID.
-
<chemin d’accès au fichier> – le chemin et le nom du fichier à téléverser. Les fichiers peuvent être des progiciels de contenu conformes à la norme SCORM 1.2 ou des fichiers d’actif individuels.
-
<titre> – la valeur du champ IMSMD general.title.
-
<titre> – la valeur du champ IMSMD general.description.
-
<mot clé> – la valeur du champ IMSMD general.keyword (mot clé simple seulement)
-
<rôle du contributeur> – la valeur du champ IMSMD lifecycle.contribute.role*.
-
<prénom du contributeur> – la valeur du champ IMSMD lifecycle.contribute.entity*.
-
<nom de famille du contributeur> – la valeur du champ IMSMD lifecycle.contribute.entity*.
-
<format> – la valeur du champ IMSMD field technical.format.
* Le rôle, le prénom et le nom de famille sont englobés dans un seul élément lifecycle.contribute.
Veuillez prendre note de ce qui suit :
-
Mettez toutes les valeurs de métadonnées entre guillemets doubles ou simples, surtout si la valeur contient une virgule, une apostrophe ou des guillemets. Dans ces deux derniers cas, veillez à utiliser le type de ponctuation pour entourer la valeur qui n’est pas utilisée dans la valeur elle-même; vous pouvez utiliser un guillemet simple ou une apostrophe dans la valeur si vous placez la chaîne entre guillemets doubles, et vous pouvez utiliser des guillemets doubles dans la valeur si elle est placée entre guillemets simples.
-
Toutes les métadonnées dans progiciel de contenu sont supprimées et seules les métadonnées précisées dans le fichier de configuration sont utilisées.
-
Toutes les valeurs des métadonnées sont facultatives et peuvent être laissées vides (voir l’exemple).
Exemple
LoadType=CSVMetadata
2,"\\myServer\BulkUpload\input\Asset12.gif","Pomegranate","Photograph of a pomegranate","fruit",,
"Jonathan","Bernstein",
6,"\\myServer\BulkUpload\input\Asset27.mp3","L'inno di Mameli","Italian National Anthem","Italy","Composer","Michele","Navaro",
3,"\\myServer\BulkUpload\input\Asset21.wmv",'"Beat" Takeshi Kitano',,"movies",,,,
Remarque : Le troisième objet de cet exemple utilise des guillemets simples autour du titre pour que les guillemets doubles puissent être utilisés dans la valeur.