Importer des objectifs

Vous pouvez utiliser une série de fichiers XML pour importer des objectifs dans Blackboard Learn. Créez un fichier XML pour chaque ensemble d'objectifs, compressez tous les fichiers XML, puis téléchargez le paquet.

N'utilisez pas la fonction « Compresser » native sur un Mac pour créer un fichier ZIP pour importer vos objectifs. À la place, utilisez la commande compress dans le terminal.

Un fichier XML ne doit pas contenir plus d'un ensemble d'objectifs. Toutefois, vous pouvez avoir un nombre illimité d'objectifs et de catégories dans un ensemble d'objectifs.

Chaque fichier comporte les informations suivantes :

  1. Informations sur l'ensemble d'objectifs.
  2. Informations sur la catégorie. Vous devez dupliquer et modifier ce code pour chaque catégorie de l'ensemble d'objectifs. Copiez ce code et collez-le sur une ligne avant la ligne à la fin du fichier.
  3. Informations sur l'objectif. Vous devez dupliquer et modifier ce code pour chaque objectif de la catégorie. Copiez ce code et collez-le sur une ligne avant la ligne vers la fin du fichier.

Téléchargement de fichiers

Dans le panneau de configuration de l'administrateur, dans la section Outils et utilitaires, sélectionnez Objectifs. Sur la page Objectifs, placez le pointeur de la souris sur Ajouter un ensemble d'objectifs pour accéder au menu et sélectionnez Importer un ensemble d'objectifs. Blackboard Learn traite tous les fichiers à la fois.


Modèle XML d'un ensemble d'objectifs, comprenant des catégories et des objectifs

<?xml version="1.0" encoding="UTF-8"?>


   uid_provider="ENTER 2 CHARACTER PROVIDER CODE HERE" status="ENTER A, I, or R" editable="ENTER TRUE OR FALSE">
   
   
   
      ENTER FULL TEXT OF GOAL SOURCE HERE.
   
   
   
   
      ENTER GOAL SET NAME HERE
   
   
   
      ENTER FULL TEXT OF GOAL SET TYPE HERE
   
   
   
          code="ENTER ID FOR CATEGORY HERE. Do not use spaces.">ENTER FULL TEXT OF CATEGORY NAME HERE
   
      ENTER FULL TEXT OF CATEGORY NAME HERE
      
      
      
      
                stem="ENTER ANY LEADING TEXT FOR THE GOAL HERE OR LEAVE BLANK" doc_num="ENTER THE ID OF THE GOAL HERE OR LEAVE BLANK">
         ENTER THE FULL TEXT OF THE GOAL STATEMENT HERE
      
   
   

Exemple

<?xml version="1.0" encoding="UTF-8"?>

   Blackboard College
   Physics Lab Goals
   Introductory Goals
   
   The Measurement Category
   
      Measurement
      
      
         learn how to use a micrometer
      
      
         understand the uncertainty in measurements
      
   
   
   The Lab Notebook Category
   
      Lab Notebooks
      
      
         record lab results in detail
      
   

Autres exemples

Pour consulter d'autres exemples de fichiers XML, connectez-vous à Behind the Blackboard et accédez à l'article 13668 intitulé « Blackboard Learn and CE/Vista Standards Documents » (« Documents portant sur Blackboard Learn et les normes CE/Vista »).


Descriptions d'élément/attribut

Modifiez les attributs et les valeurs appropriés dans le modèle.

Élément/Attribut Description
standard_document L'élément décrit les propriétés de l'ensemble d'objectifs. Le fichier ne doit contenir qu'un seul élément .
year Année au format AAAA. Par exemple, « 2013 ».
revision_date Date et heure de révision au format AAAA-MM-JJ HH:MM:SS. Par exemple, « 2013-12-20 13:40:00 ».
uid Code document. N'utilisez pas plus de 37 caractères. N'utilisez pas d'espaces.
uid_provider Identifiant à deux caractères pour le fournisseur de l'ensemble d'objectifs. Par exemple, « PS ».
status Valeur de statut à un seul caractère. Cet élément est facultatif. S'il est présent, il doit correspondre à l'une des valeurs suivantes :
  • A - (Actif) L'ensemble d'objectifs est disponible pour tous les cours.
  • I - (Inactif) L'ensemble d'objectifs n'est pas disponible pour tous les cours.
  • R - (Restreint) L'ensemble d'objectifs est visible seulement pour les cours qui sont explicitement associés à la catégorie. (Pour associer un cours à une catégorie, utilisez le menu à côté de la catégorie et choisissez Associer aux cours.)

Cette valeur est remplacée par celle que vous choisissez lorsque vous cliquez sur le bouton État dans l'interface utilisateur lorsque vous importez le fichier XML.

editable « true » ou « false ». Cet élément est facultatif. Si la valeur est définie sur true, l'ensemble d'objectifs peut être modifié dans l'interface utilisateur. Si elle est définie sur false, il ne peut pas être modifié (sauf pour définir les éléments sur Actif, Inactif ou Restreint).
organization L'élément décrit la communauté source de l'objectif. Le fichier ne doit contenir qu'un seul élément .

Remplacez le texte « SAISIR LE TEXTE COMPLET DE LA SOURCE DE L'OBJECTIF ICI. ». Par exemple, remplacez-le par « Blackboard College ».

org_code Code de la source. Il peut contenir 256 caractères au maximum. Par exemple, « BB ».
country_code Code du pays de la source (à deux caractères). Par exemple, « US ».
subject L'élément indique le nom de l'ensemble d'objectifs. Le fichier ne doit contenir qu'un seul élément .

Remplacez le texte « SAISIR LE NOM DE L'ENSEMBLE D'OBJECTIFS ICI ». Par exemple, remplacez-le par « Objectifs du laboratoire de physique ».

Ce nom s'affiche aux emplacements suivants dans l'interface utilisateur :

  1. Dans la colonne Ensemble d'objectifs de l'écran Objectifs.
  2. Dans le champ Définir le nom de l'écran Modifier l'ensemble d'objectifs.
  3. Dans la colonne Nom d'ensemble d'objectifs de l'écran Contenu.
  4. Dans la colonne Ensemble d'objectifs et la liste extensible Ensemble d'objectifs de l'écran Rechercher des objectifs.
code Code de l'ensemble d'objectifs. N'utilisez pas plus de cinq caractères. N'utilisez pas d'espaces.
document_set L'élément décrit le type d'ensemble d'objectifs. Le fichier ne doit contenir qu'un seul élément .

Remplacez le texte « SAISIR ICI LE TEXTE COMPLET DU TYPE DE L'ENSEMBLE D'OBJECTIFS ». N'utilisez pas plus de 101 caractères. Par exemple, remplacez-le par « Objectifs initiaux ».

Ce texte s'affiche aux emplacements suivants dans l'interface utilisateur :

  1. Dans le champ Définir le type de l'écran Modifier l'ensemble d'objectifs.
  2. Dans la liste extensible Type d'ensemble d'objectifs de l'écran Rechercher des objectifs.
uid Code du type d'ensemble d'objectifs. N'utilisez pas d'espaces.
grade_range L'élément décrit une catégorie. Le fichier doit contenir au moins un élément . Le nombre d'éléments doit correspondre au nombre d'éléments .

Remplacez le texte « SAISIR ICI LE NOM COMPLET DE LA CATÉGORIE ». N'utilisez pas plus de 101 caractères.

Ce texte n'est pas affiché dans l'interface utilisateur.

lo, hi Indicateurs de la position la plus basse et de la position la plus haute de cette catégorie dans la liste.

Généralement, ces indicateurs permettent de remplacer le classement alphabétique par défaut des catégories. Par exemple, ces lignes obligent la catégorie « Kindergarten » à figurer en haut de la liste :

Kindergarten
Grade 1
Grade 2
Grade 3
Grade 4

code Code de la catégorie. N'utilisez pas d'espaces.

Cela doit correspondre à un attribut code dans l'un des éléments . Ceci est utilisé pour lier l'élément avec l'élément .

standard L'élément décrit l'ensemble d'objectifs d'une catégorie.

Le fichier doit contenir au moins un élément . Le nombre d'éléments doit correspondre au nombre d'éléments .

uid Code des objectifs. Par exemple, « 001 ». Chaque doit avoir un code unique.

Ce code est présenté dans le champ Code unique de l'écran Modifier l'objectif dans l'interface utilisateur.

title Titre de la catégorie. Par exemple, « Mesure ». Le fichier ne doit contenir qu'un seul élément dans chaque élément .

Ce titre s'affiche aux emplacements suivants dans l'interface utilisateur :

  1. Dans la colonne Catégorie de l'écran Objectifs.
  2. Dans la colonne Catégorie de l'écran Contenu.
  3. Dans la liste extensible Catégorie de l'écran Rechercher des objectifs.
grade_range_ref L'élément lie l'ensemble d'objectifs à la catégorie. Le fichier ne doit contenir qu'un seul élément au sein de chaque élément du fichier.
code Saisissez l'attribut code de l'élément pour la catégorie correspondante.
item L'élément décrit un objectif. Le fichier doit contenir au moins un élément dans chaque élément .
uid Code unique de l'objectif. N'utilisez pas plus de 257 caractères.
parent_uid Code de l'objectif parent. Si aucun objectif parent n'existe, supprimez le texte de l'espace réservé et laissez cet attribut vide.
label Type d'objectif. Par exemple, « Type Instrumentation ». Dans l'interface utilisateur, ce texte est affiché dans la liste extensible Type d'objectif de l'écran Rechercher des objectifs.
linkable L'un des éléments suivants :
  • Y - l'objectif ne sera pas restreint.
  • N - l'objectif sera restreint.

Les objectifs restreints ne sont visibles que pour les cours qui sont explicitement associés à la catégorie. Dans l'écran Objectifs, une icône fléchée apparaît à côté de ces objectifs pour signaler qu'ils peuvent être ouverts dans une nouvelle fenêtre. Pour associer un cours à une catégorie, ouvrez le menu de la catégorie, puis choisissez Associer aux cours.

stem Texte de présentation de l'objectif. Par exemple, « L'étudiant devra : » Si aucun texte de présentation n'existe, supprimez le texte de l'espace réservé et laissez cet attribut vide.

Ce texte s'affiche aux emplacements suivants dans l'interface utilisateur :

  1. Dans la colonne Objectifs de l'écran Objectifs.
  2. Dans la colonne Objectif de l'écran Rechercher des objectifs.
doc_num Code objectif. Par exemple, « MESURE_001 ». N'utilisez pas plus de 101 caractères. Si vous ne voulez pas que le code objectif s'affiche, supprimez le texte réservé et laissez cet attribut vide.

Ce texte s'affiche aux emplacements suivants dans l'interface utilisateur :

  1. Dans la colonne Objectifs de l'écran Objectifs.
  2. Dans la colonne Code objectif de l'écran Modifier l'objectif.
  3. Dans la colonne Code de l'écran Contenu.
  4. Dans la liste Objectif de l'écran Rechercher des objectifs.

Schéma

Voici le schéma XML de ces fichiers XML :

<?xml version="1.0" encoding="UTF-8"?>
http://www.w3.org/2001/XMLSchema">
    
    
    
        
            
                
                
                
                
                
            
            
                
                    
                        
                        
                    
                
            
            
                
                    
                        
                    
                
            
            
                
                    
                        
                        
                    
                
            
            
                
                    
                        
                        
                        
                    
                
            
            
                
                    
                        
                        
                    
                
            
            
                
                    
                        
                        
                    
                
            
        
    
   
    
    
        
            
                
                    
                    
                
                
                
                
            
        
    
   
    
    
        
            
                
                    
                        
                            
                                
                                
                            
                        
                    
                
                
            
        
    
   
    
    
        
            
                
                    
                
                
                
            
        
    
   
    
    
        
            
                
                    
                    
                    
                
                
                
                
                
            
        
    
   
    
    
        
            
                
                
                
            
            
        
    
   
    
    
    
   
    
    
        
            
        
    
   
    
    
        
            
                
            
            
            
            
            
                
                    
                        
                        
                    
                
            
            
            
                
                    
                        
                        
                    
                
            
            
            
        
    
   
    
    
    
   
    
   
    
    
        
            
        
    
    
    
        
            
        
    
    
    
        
            
        
    
    
    
        
            
            
        
    
    
        
            
            
        
    
    
    
        
            
            
        
    
    
    
        
            
            
        
    
    
    
        
            
            
        
    
   


Impact de ces fichiers sur l'interface utilisateur

Les images ci-dessous montrent comment les éléments du fichier XML apparaissent dans l'interface utilisateur.

Les images ne sont disponibles qu'en anglais.

Écran Objectifs

Cette image montre la relation entre les éléments du fichier XML et les éléments de l'écran Objectifs.

Écran Modifier l'objectif

Cette image montre la relation entre les éléments du fichier XML et les éléments de l'écran Modifier l'objectif. Cet écran apparaît lorsque vous ouvrez le menu à droite d'un objectif dans l'écran Objectifs et que vous choisissez Modifier l'objectif. La commande Modifier l'objectif n'est pas disponible si l'attribut editable de l'élément est défini sur « false ».

Écran Modifier l'ensemble d'objectifs

Cette image montre la relation entre les éléments du fichier XML et les éléments de l'écran Modifier l'ensemble d'objectifs. Cet écran s'affiche si vous ouvrez le menu à droite d'un objectif défini sur l'écran Objectifs et choisissez Modifier. Les champs Définir le nom et Définir le type de fichiers ne sont pas modifiables si l'attribut editable de l'élément a la valeur « false ».

Écran Contenu

Cette image montre la relation entre les éléments du fichier XML et les éléments de l'écran Contenu.

Écran Rechercher des objectifs

Cette image montre la relation entre les éléments du fichier XML et les éléments de l'écran Rechercher des objectifs. Il s'agit de l'écran que vous voyez lorsque vous choisissez Ajouter des alignements sur l'écran Contenu.


Supprimer des éléments

Vous ne pouvez pas supprimer d'éléments en téléchargeant de nouveaux fichiers. Pour supprimer des éléments, passez par l'interface utilisateur.


Ajouter et remplacer des éléments

La façon la plus simple d'ajouter ou de remplacer des éléments est de supprimer les éléments existants (via l'interface utilisateur), puis de télécharger un fichier qui contient les informations mises à jour.

Si vous avez besoin d'ajouter ou de remplacer des éléments sans l'aide de l'interface utilisateur, les sections ci-dessous décrivent le processus.

Hiérarchie des codes uniques

  • L'ensemble de codes uniques pour chaque objectif (en d'autres termes, l'ensemble de codes uniques pour , , et ) doit être unique pour tous les fichiers.
  • Ces codes uniques forment une hiérarchie :

Le code unique de l'élément interagit également avec l'attribut code de l'élément , tel que décrit ci-dessous.

Ajout de nouveaux éléments

Vous pouvez ajouter de nouveaux éléments ou remplacer des éléments anciens en conservant les éléments situés en haut de la hiérarchie et en utilisant des UID différents pour les éléments situés plus bas dans la hiérarchie.

Exemple

  1. Supposons que vous commenciez par télécharger un fichier avec les attributs suivants. Cela va créer un ensemble d'objectifs, une catégorie et un objectif.
    document>
    Code unique

    Code unique

    CODE

    Code unique

    Code unique
    STANDARD_DOC_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       ">Goal Set 1
       DOC_SET_1">Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

  2. Ensuite, si vous téléchargez un fichier avec les attributs suivants, cela créera une catégorie et un objectif.
    document>
    Code unique

    Code unique

    CODE

    Code unique

    Code unique
    STANDARD_DOC_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_A

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       Goal Set 1
       DOC_SET_1">Goal Set Type 1
       CATEGORY_A">Category A
       STANDARD_A">
          Category A
          
          ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

    Si vous changez le code unique de l'élément , vous devez également modifier l'attribut code de l'élément . Si vous modifiez uniquement le code unique de l'élément , l'importation échouera.

  3. Ensuite, si vous téléchargez un fichier avec les mêmes attributs, mais avec un contenu différent, l'instruction d'objectif est mise à jour.

    <?xml version="1.0" encoding="UTF-8"?>

       Blackboard College
       Goal Set 1
       Goal Set Type 1
       Category A
       
          Category A
          
          
             This is the new goal.
          
       

Modification des noms

Si vous téléchargez des informations avec le même ensemble de codes uniques, mais avec des attributs code différents, les éléments sont renommés.

Exemple

  1. Supposons que vous commenciez par télécharger un fichier avec les attributs suivants. Cela va créer un ensemble d'objectifs, une catégorie et un objectif.
    document>
    Code unique

    CODE
    set>
    Code unique
    range>
    CODE

    Code unique

    Code unique
    STANDARD_DOC_1 SUBJECT_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       SUBJECT_1">Goal Set 1
       Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

  2. Ensuite, si vous téléchargez un fichier avec les attributs suivants, l'ensemble d'objectifs est renommé (« Ensemble d'objectifs 1 » devient « Ensemble d'objectifs B »).
    document>
    Code unique

    CODE
    set>
    Code unique
    range>
    CODE

    Code unique

    Code unique
    STANDARD_DOC_1 SUBJECT_B DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       SUBJECT_B">Goal Set B
       DOC_SET_1">Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

Cette procédure fonctionne également pour renommer l'attribut code de l'élément .

Ajout ou modification des éléments situés plus haut dans la hiérarchie

Vous recevez une erreur et le fichier n'est pas téléchargé si les UID des éléments situés plus bas dans la hiérarchie ont déjà été utilisés avec des UID différents pour les éléments situés plus haut dans la hiérarchie.

Exemple

  1. Supposons que vous commenciez par télécharger un fichier avec les attributs suivants. Cela va créer un ensemble d'objectifs, une catégorie et un objectif.
    document>
    Code unique
    set>
    Code unique
    range>
    CODE

    Code unique

    Code unique
    STANDARD_DOC_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       Blackboard College
       Goal Set 1
       DOC_SET_1">Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

  2. Si vous essayez ensuite de télécharger un fichier avec les attributs suivants, le téléchargement échoue.
    document>
    Code unique
    set>
    Code unique
    range>
    CODE

    Code unique

    Code unique
    STANDARD_DOC_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
       Blackboard College
       Goal Set 1
       DOC_SET_1">Goal Set Type 1
       CATEGORY_1">Category 1
       STANDARD_1">
          Category 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

Si vous voulez ajouter ou modifier des éléments plus hauts dans la hiérarchie, vous devez utiliser des codes uniques différents pour les éléments situés plus bas dans la hiérarchie.