Passer au contenu principal
pdf?stylesheet=default
Blackboard Help

Importer des objectifs

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 native "Compresser" 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 contient les éléments suivants :

  1. Informations sur l'ensemble d'objectifs.
  2. Informations de 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 </standard_document> à 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 </standard> vers la fin du fichier.

Comment télécharger des 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 à la liste déroulante 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"?>
<!-- Définir un ensemble d'objectifs -->
<!-- Créer un fichier XML distinct pour chaque ensemble d'objectifs -->
<standard_document year="SAISIR L'ANNÉE ICI" revision_date="SAISIR LA DATE ET L'HEURE DE LA RÉVISION ICI" uid="SAISIR LE CODE DOCUMENT ICI. N'utilisez pas d'espaces."
   uid_provider="SAISIR ICI LE CODE FOURNISSEUR À 2 CARACTÈRES" status="SAISIR A, I ou R" editable="SAISIR TRUE OU FALSE">
   
   <!-- Définir l'organisation source pour cet ensemble d'objectifs -->
   <organization org_code="SAISIR UN CODE SOURCE ICI (JUSQU'À 256 CARACTÈRES)" country_code="US">
      SAISIR LE TEXTE COMPLET DE LA SOURCE DE L'OBJECTIF ICI.
   </organization>
   
   <!-- Définir le nom de l'ensemble d'objectifs -->
   <subject code="SAISIR LE CODE DE L'ENSEMBLE D'OBJECTIFS ICI. N'utilisez pas d'espaces.">
      SAISIR LE NOM DE L'ENSEMBLE D'OBJECTIFS ICI</subject>
   
   <!-- Définir le type de l'ensemble d'objectifs -->
   <document_set uid="SAISIR L'ID DU TYPE DE L'ENSEMBLE D'OBJECTIFS. N'utilisez pas d'espaces.">
      SAISIR ICI LE TEXTE COMPLET DU TYPE DE L'ENSEMBLE D'OBJECTIFS</document_set>
   
   <!-- Définir les catégories -->
   <!-- Créer un élément <grade_range> et un élément <standard> pour chaque catégorie -->
   <grade_range lo="SAISIR LA POSITION LA PLUS BASSE DANS LA LISTE DE CATÉGORIES" hi="SAISIR LA POSITION LA PLUS HAUTE DANS LA LISTE DE CATÉGORIES"
      code="SAISIR LE CODE CATÉGORIE ICI. N'utilisez pas d'espaces.">SAISIR ICI LE NOM COMPLET DE LA CATÉGORIE</grade_range>
   <standard uid="SAISIR LE CODE CATÉGORIE ICI. N'utilisez pas d'espaces.">
      <title>SAISIR ICI LE NOM COMPLET DE LA CATÉGORIE</title>
      <grade_range_ref code="SAISIR LE CODE CATÉGORIE ICI"/>
      
      <!-- Définir les objectifs -->
      <!-- Créer un élément <item> pour chaque objectif de la catégorie -->
      <item uid="SAISIR LE CODE OBJECTIF UNIQUE ICI. N'utilisez pas d'espaces." parent_uid="SAISIR ICI LE CODE DE L'OBJECTIF PARENT OU LAISSER VIDE" label="SAISIR ICI LE TEXTE COMPLET DE TYPE D'OBJECTIF" linkable="SAISIR Y OU N"
         stem="SAISIR ICI LE TEXTE DE PRÉSENTATION POUR L'OBJECTIF OU LAISSER VIDE" doc_num="SAISIR ICI LE CODE DE L'OBJECTIF OU LAISSER VIDE">
         <statement>SAISIR ICI LE TEXTE COMPLET DE LA DÉCLARATION D'OBJECTIF</statement>
      </item>
   </standard>
   
</standard_document>

Exemple

<?xml version="1.0" encoding="UTF-8"?>
<standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="PHYS101" uid_provider="PS" status="A" editable="true">
   <organization org_code="BB" country_code="US">Blackboard College</organization>
   <subject code="PHYSLAB01">Objectifs du laboratoire de physique</subject>
   <document_set uid="INTRO">Objectifs initiaux</document_set>
   
   <grade_range lo="1" hi="1" code="MESURE">Catégorie de mesure</grade_range>
   <standard uid="1">
      <title>Mesure</title>
      <grade_range_ref code="MESURE"/>
      <item uid="001" parent_uid="" label="Type d'instrumentation" linkable="Y" stem="L'étudiant devra :" doc_num="MESURE_001">
         <statement>Comment utiliser un micromètre</statement>
      </item>
      <item uid="002" parent_uid="001" label="Type d'instrumentation" linkable="N" stem="L'étudiant devra :" doc_num="MESURE_002">
         <statement>Comprendre l'incertitude des mesures</statement>
      </item>
   </standard>
   
   <grade_range lo="2" hi="2" code="CARNET DE NOTES">Catégorie de carnet de notes de laboratoire</grade_range>
   <standard uid="2">
      <title>Carnets de notes de laboratoire</title>
      <grade_range_ref code="CARNET DE NOTES"/>
      <item uid="003" parent_uid="" label="Type de documentation" linkable="Y" stem="L'étudiant devra :" doc_num="NOTE_001">
         <statement>Enregistrer les résultats de laboratoire en détail</statement>
      </item>
   </standard>
</standard_document>

Descriptions d'élément/attribut

Modifiez les attributs et les valeurs correspondantes dans le modèle.

Élément/Attribut de fonction
standard_document

L'élément <standard_document> décrit les propriétés de l'ensemble d'objectifs.

Le fichier ne doit contenir qu'un seul élément <standard_document>.

year

Année au format AAAA.

Par exemple, "2103".

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. 37 caractères maximum. N'utilisez pas d'espaces.

uid_provider

Identifiant à deux caractères pour le fournisseur de l'ensemble d'objectifs.

Par exemple, "PS".

état

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 contextuel chevron simple à 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).

association

L'élément <organization> décrit l'organisation source de l'objectif.

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

Le fichier ne doit contenir qu'un seul élément <organization>.

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, "FR".

subject

L'élément <subject> indique le nom de l'ensemble d'objectifs.

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.

Voir Impact de ces fichiers sur l'interface utilisateur.

Le fichier ne doit contenir qu'un seul élément <subject>.

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 <document_set> décrit le type de l'ensemble d'objectifs.

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.

Voir Impact de ces fichiers sur l'interface utilisateur.

Le fichier ne doit contenir qu'un seul élément <document_set>.

uid

Code du type d'ensemble d'objectifs. N'utilisez pas d'espaces.
grade_range

L'élément <grade_range> décrit une catégorie.

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.

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

lo, high

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 "Maternelle" à figurer en haut de la liste :

<grade_range lo="1" hi="1" code="K">Maternelle</grade_range>
<grade_range lo="2" hi="2" code="1">Niveau 1</grade_range>
<grade_range lo="3" hi="3" code="2">Niveau 2</grade_range>
<grade_range lo="4" hi="4" code="3">Niveau 3</grade_range>
<grade_range lo="5" hi="5" code="4">Niveau 4</grade_range>

code

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

Remarque : Il doit correspondre à un attribut code dans l'un des éléments <grade_range_ref>. Il permet de lier l'élément <grade_range> à l'élément <grade_range_ref>.

standard

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

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

uid

Code des objectifs. Par exemple, "001".

Chaque élément <standard> doit posséder un code unique.

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

titre

Titre de la catégorie. Par exemple, "Mesure".

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.

Voir Impact de ces fichiers sur l'interface utilisateur.

Le fichier ne doit contenir qu'un seul élément <title> dans chaque élément <standard>.

grade_range_ref

L'élément <grade_range_ref> lie l'ensemble d'objectifs à la catégorie.

Le fichier ne doit contenir qu'un seul élément <grade_range_ref> dans chaque élément <standard>.

code

Saisissez l'attribut code de l'élément <grade_range> pour la catégorie correspondante.

élément

L'élément <item> décrit un objectif.

Le fichier doit contenir au moins un élément <item> dans chaque élément <standard> du fichier.

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 d'instrumentation".

Dans l'interface utilisateur, ce texte est affiché dans la liste extensible Type d'objectif de l'écran Rechercher des objectifs. Voir Impact de ces fichiers sur l'interface utilisateur.

linkable

L’une des opérations suivantes :

  • 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, ils sont reconnaissables grâce à cette icône : icône d'objectif restreint. (Pour associer un cours à une catégorie, cliquez sur le menu contextuel chevron simple à côté de la catégorie et choisissez Associer aux cours.)

stem

Texte de présentation de l'objectif. Par exemple, "L'élève 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.

Voir Impact de ces fichiers sur l'interface utilisateur.

doc_num

Code objectif. N'utilisez pas plus de 101 caractères. Par exemple, "MESURE_001". 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.

Voir Impact de ces fichiers sur l'interface utilisateur.

   

Schéma

Voici le schéma XML de ces fichiers XML :

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <!-- ================================== -->
    <!-- Document standard  -->
    <xs:element name="standard_document">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="organization"/>
                <xs:element ref="subject"/>
                <xs:element ref="document_set"/>
                <xs:element ref="grade_range" maxOccurs="unbounded"/>
                <xs:element ref="standard" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="year" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\d\d\d\d"/>
                        <!-- Par exemple, "2014" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid_provider" use="required">
                <xs:simpleType>
                    <xs:restriction base="ST_two-character_code">
                        <!-- Par exemple, "PS" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\S{1,37}"/>
                        <!-- Par exemple, "PHYS101" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="status" use="optional">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="A"/>
                        <xs:enumeration value="I"/>
                        <xs:enumeration value="R"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="revision_date" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d"/>
                        <!-- Par exemple, "2014-01-30 09:15:00" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="editable" use="optional">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="true"/>
                        <xs:enumeration value="false"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Établissement -->
    <xs:element name="organization">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                    <xs:attribute name="org_code" type="ST_256-character_code" use="required"/>
                    <xs:attribute name="country_code" type="ST_two-character_code" use="required"/>
                </xs:extension>
                <!-- Par exemple, "Blackboard College" -->
                <!-- Par exemple, "BB" -->
                <!-- Par exemple, "US" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Objet -->
    <xs:element name="subject">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                    <xs:attribute name="code" use="required">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:pattern value="\S{1,5}"/>
                                <!-- Par exemple, "LAB01" -->
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:extension>
                <!-- Par exemple, "Objectifs du laboratoire de physique" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Ensemble de documents -->
    <xs:element name="document_set">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_1_to_101_characters">
                    <xs:attribute name="uid" type="ST_string_with_no_spaces" use="required"/>
                </xs:extension>
                <!-- Par exemple, "Objectifs initiaux" -->
                <!-- Par exemple, "INTRO" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Plage de notes -->
    <xs:element name="grade_range">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_1_to_101_characters">
                    <xs:attribute name="lo" type="xs:integer" use="required"/>
                    <xs:attribute name="hi" type="xs:integer" use="required"/>
                    <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
                </xs:extension>
                <!-- Par exemple, "Catégorie de mesures" -->
                <!-- Par exemple, "1" -->
                <!-- Par exemple, "1" -->
                <!-- Par exemple, "CARNET DE NOTES" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Standard -->
    <xs:element name="standard">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="title"/>
                <xs:element ref="grade_range_ref"/>
                <xs:element ref="item" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="uid" type="ST_non_blank_string" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Titre -->
    <xs:element name="title" type="ST_non_blank_string"/>
    <!-- Par exemple, "Carnets de notes de laboratoire" -->
    <!-- ================================== -->
    <!-- Référence de plage de notes -->
    <xs:element name="grade_range_ref">
        <xs:complexType>
            <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Élément -->
    <xs:element name="item">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="statement"/>
            </xs:sequence>
            <xs:attribute name="uid" type="ST_goal_uid" use="required"/>
            <xs:attribute name="stem" type="xs:string" use="required"/>
            <xs:attribute name="parent_uid" type="ST_parent_goal_uid" use="required"/>
            <xs:attribute name="linkable" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="N"/>
                        <xs:enumeration value="Y"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="label" type="ST__string" use="required"/>
            <xs:attribute name="doc_num" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value=".{0,101}"/>
                        <!-- 0 à 101 caractères -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <!-- Par exemple, "l'étudiant devra :" ou vide -->
            <!-- Par exemple, "Type d'instrumentation" -->
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Déclaration -->
    <xs:element name="statement" type="ST_non_blank_string"/>
    <!-- Par exemple, "comprendre l'incertitude des mesures" -->
    <!-- ================================== -->
    <!-- Types de données simples -->
    <!-- ================================== -->
    <!-- Chaîne sans espace -->
    <xs:simpleType name="ST_string_with_no_spaces">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S+"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Code à deux caractères -->
    <xs:simpleType name="ST_two-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S\S"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Code à 256 caractères -->
    <xs:simpleType name="ST_256-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S{1,256}"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- UID d'objectifs -->
    <xs:simpleType name="ST_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,257}"/>
            <!-- 1 à 257 caractères -->
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ST_parent_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,257}"/>
            <!-- 0 à 257 caractères -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Pas plus de 101 caractères -->
    <xs:simpleType name="ST_1_to_101_characters">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,101}"/>
            <!-- 1 à 101 caractères -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Chaîne non vide -->
    <xs:simpleType name="ST_non_blank_string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,}"/>
            <!-- Au moins 1 caractère -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Chaîne pouvant être vide -->
    <xs:simpleType name="ST__string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,}"/>
            <!-- Peut être vide-->
        </xs:restriction>
    </xs:simpleType>
    <!-- ================================== -->
</xs:schema>

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 comment le fichier XML est mappé aux éléments de l’écran Objectifs.

UI_relationships_C.Goals.new.png

Écran Modifier l'objectif

Cette image montre comment le fichier XML est mappé aux éléments de l’écran Modifier l'objectif. (Il s'agit de l'écran qui apparaît si vous cliquez sur le menu contextuel  icon.single_chevron.png  à droite d'un objectif sur l’écran Objectifs et choisissez Modifier l'objectif. La commande Modifier l'objectif n'est pas disponible si l’attribut editable dans l’élément <standard_document> est défini sur "false".)

UI_relationships_D.Edit_Goals.new.png

Écran Modifier l'ensemble d'objectifs

Cette image montre comment le fichier XML est mappé aux éléments de l’écran Modifier l'ensemble d'objectifs. (Il s'agit de l'écran qui apparaît si vous cliquez sur le menu contextuel  icon.double_chevron.png  à droite d'un ensemble d’objectifs sur l’écran Objectifs et choisissez Modifier. Les champs Définir le nom et Définir les types de fichier ne sont pas modifiables si l’attribut editable dans l’élément <standard_document> est défini sur "false".)

UI_relationships_E.Edit_Goal_Set.new.png

Écran Contenu

Cette image montre comment le fichier XML est mappé aux éléments de l’écran Contenu.

UI_relationships_A.Content.new.png

Écran Rechercher des objectifs

Cette image montre comment le fichier XML est mappé aux éléments de l’écran Rechercher des objectifs. (Il s'agit de l'écran que vous voyez lorsque vous choisissez Ajouter des alignements de l’écran Contenu.)

UI_relationships_B.Discover_Goals.new.png

Suppression d'éléments

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

Ajout et remplacement d’é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 <standard_document>, <document_set>, <standard> et <item>) doit être unique pour tous les fichiers.
  • Ces codes uniques forment une hiérarchie :
    • <standard_document>
    • <document_set>
    • <standard>
    • <élément>

Le code unique de l’élément <standard> interagit également avec l'attribut code de l’élément <grade_range>, 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 codes uniques 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.
    Code unique <standard_
    document>

    Code unique <document_set>
    Code <grade_range>
    Code unique <standard>
    Code unique <item>
    STANDARD_DOC_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1span>">Ensemble d'objectifs 1</subject>
       <document_set uid="DOC_SET_1">Type d'ensemble d'objectifs 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Catégorie 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Catégorie 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>Voici l'objectif.</statement>
          </item>
       </standard>
    </standard_document>

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

    Code unique <document_set>
    Code <grade_range>
    Code unique <standard>
    Code unique <item>
    STANDARD_DOC_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_A

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Ensemble d'objectifs 1</subject>
       <document_set uid="DOC_SET_1">Type d'ensemble d'objectifs 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">Catégorie A</grade_range>
       <standard uid="STANDARD_A">
          <title>Catégorie A</title>
          <grade_range_ref code="CATEGORY_A"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>Voici l'objectif.</statement>
          </item>
       </standard>
    </standard_document>

    Une catégorie et un objectif ont été créés

    Si vous changez le code unique de l'élément <standard>, vous devez également modifier l’attribut code de l’élément <grade_range>. Si vous ne modifiez que le code unique de l'élément <standard>, l'importation échoue.

  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"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Ensemble d'objectifs 1</subject>
       <document_set uid="DOC_SET_1">Type d'ensemble d'objectifs 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">Catégorie A</grade_range>
       <standard uid="STANDARD_A">
          <title>Catégorie A</title>
          <grade_range_ref code="CATEGORY_A"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>Voici le nouvel objectif.</statement>
          </item>
       </standard>
    </standard_document>

    L'objectif a été révisé

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.
    Code unique <standard_
    document>

    Code <subject>
    Code unique <document_
    set >

    Code <grade_
    range>

    Code unique <standard>
    Code unique <item>
    STANDARD_DOC_1 SUBJECT_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Ensemble d'objectifs 1</subject>
       <document_set uid="DOC_SET_1">Type d'ensemble d'objectifs 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Catégorie 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Catégorie 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>Voici l'objectif.</statement>
          </item>
       </standard>
    </standard_document>

    Scénario de départ
  2. Ensuite, si vous téléchargez un fichier avec les attributs suivants, l'ensemble d'objectifs est renommé (de "Ensemble d’objectifs 1" en "Ensemble d’objectifs B").
    Code unique <standard_
    document>

    Code <subject>
    Code unique <document_
    set >

    Code <grade_
    range>

    Code unique <standard>
    Code unique <item>
    STANDARD_DOC_1 SUBJECT_B DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_B">Ensemble d'objectifs B</subject>
       <document_set uid="DOC_SET_1">Type d'ensemble d'objectifs 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Catégorie 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Catégorie 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>Voici l'objectif.</statement>
          </item>
       </standard>
    </standard_document>

    L'ensemble d’objectifs a été renommé

Cette procédure fonctionne également pour renommer l'attribut code de l’élément <grade_range>.

Ajout ou modification d'éléments plus hauts dans la hiérarchie

Vous recevez une erreur et le fichier n'est pas téléchargé si les codes uniques des éléments situés plus bas dans la hiérarchie ont déjà été utilisés avec des codes uniques 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.
    Code unique <standard_
    document>

    Code unique <document_
    set >

    Code <grade_
    range>

    Code unique <standard>
    Code unique <item>
    STANDARD_DOC_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1
     

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Ensemble d'objectifs 1</subject>
       <document_set uid="DOC_SET_1">Type d'ensemble d'objectifs 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Catégorie 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Catégorie 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>Voici l'objectif.</statement>
          </item>
       </standard>
    </standard_document>

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

    Code unique <document_
    set >

    Code <grade_
    range>

    Code unique <standard>
    Code unique <item>
    STANDARD_DOC_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Ensemble d'objectifs 1</subject>
       <document_set uid="DOC_SET_1">Type d'ensemble d'objectifs 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Catégorie 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Catégorie 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>Voici l'objectif.</statement>
          </item>
       </standard>
    </standard_document>

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.