# Extension XML - Assistant d'administration - Aide

# Table des matières

Connexion à une base de données

- Zones et éléments de contrôle
- Tâches
- Connexion à une base de données
- Changement de base de données

  Utilisation du tableau de bord Administration de l'Extension XML

- Zones et éléments de contrôle
- Tâches

  Activation ou désactivation d'une base de données

- Tâche : Activation d'une base de données
- Tâche : Désactivation d'une base de données

  Importation de DTD

- Zones et éléments de contrôle
- Tâche : Importation d'une DTD

  Utilisation des fichiers DAD

- Zones et éléments de contrôle
- Spécification d'une DAD - Etape 1 pour tous les types
- Sélection de la validation - Etape 2 pour tous les types
- Tables annexes - Etape 3 pour le type colonne XML
- Spécification de texte- Etape 3 pour le type mappage du noeud RDB ou mappage SQL
- Spécification d'une instruction SQL - Etape 4 pour le type mappage SQL
- Mappage de SQL- Etape 5 pour le type mappage SQL
- Mappage de noeuds RDB - Etape 4 pour le type mappage du noeud RDB
- Sauvegarde d'une DAD - Dernière étape pour tous les types
- Tâches
- Création ou édition d'une DAD pour colonnes XML
- Création ou édition d'une DAD pour collections XML

  Utilisation des colonnes XML

- Zones et éléments de contrôle
- Sélection d'une tâche (pour les colonnes)
- Ajout d'une colonne XML
- Activation d'une colonne XML
- Désactivation d'une colonne XML
- Tâches
- Ajout d'une colonne XML
- Activation d'une colonne XML
- Désactivation d'une colonne XML

  Utilisation des collections XML

- Zones et éléments de contrôle
- Sélection d'une tâche (pour les collections)
- Activation d'une collection XML
- Désactivation d'une collection XML
- Tâches
- Activation d'une collection XML
- Désactivation d'une collection XML

  # Connexion à une base de données

  A partir de cet assistant, vous pouvez vous connecter à la base de données qui contient ou contiendra des données XML.

  ## Zones et éléments de contrôle

  Adresse
    Tapez le nom de la base de données JDBC à laquelle vous voulez vous connecter, ou sélectionnez une adresse dans la liste. Dans cette base de données, l'assistant exécute des tâches en temps réel. Si vous avez recours à la liste, les derniers ID utilisateur et pilote JDBC associés à l'adresse sélectionnée s'affichent dans les zones ci-après. Cette zone est obligatoire. La syntaxe de cette adresse est la suivante :

    |Pour les configurations autonomes (recommandé) :

        jdbc:db2:nom_bd

    Où :

    nom_bd
      Représente le nom de la base de données à laquelle vous vous connectez et qui contient les documents XML.

    Par exemple :

        jdbc:db2:sales_db

    Pour les configurations de réseau :

        jdbc:db2://|hôte:numéro_port/nom_bd

    Où :

    |hôte
      |Représente le nom du serveur sur lequel se situe l'Extension XML.

    numéro_port
      Représente le numéro de port utilisé pour la connexion au serveur. Pour le connaître, tapez la commande suivante sur la ligne de commande DB2 du poste serveur :

          db2jstrt port#

    nom_bd
      Représente le nom de la base de données à laquelle vous vous connectez et qui contient les documents XML.

    Par exemple :

        jdbc:db2://host1.ibm.com/sales_db

  ID utilisateur
    Tapez ou confirmez l'ID utilisateur sous lequel vous avez accédé à la base de données. Cette zone est obligatoire.

  Mot de passe
    Tapez le mot de passe sous lequel vous avez accédé à la base de données. Cette zone est obligatoire.

  Pilote JDBC
    Tapez ou confirmez l'emplacement du pilote associé à la base de données. Cette zone est obligatoire. Le pilote doit correspondre à l'une des valeurs suivantes :

    |Pour les configurations autonomes (par défaut) :

        COM.ibm.db2.jdbc.app.DB2Driver

    Pour les configurations de réseau :

        COM.ibm.db2.jdbc.net.DB2Driver

  Fin
    Termine l'opération de connexion à une base de données et ouvre le tableau de bord.

  Annulation
    Annule l'assistant.

  ## Tâches

  ### Connexion à une base de données

  Lorsque vous démarrez l'assistant d'administration de l'Extension XML, la fenêtre d'ouverture de session s'affiche et vous vous connectez à une base de données.

  1. Dans la zone Adresse, entrez l'adresse JDBC qualifiée complète de la source de données IBM DB2 UDB à laquelle vous voulez vous connecter.
  2. Dans les zones ID util et Mot de passe, entrez ou confirmez l'ID utilisateur et le mot de passe DB2 d'accès à la base de données à laquelle vous voulez vous connecter.
  3. Dans la zone Pilote JDBC, tapez ou confirmez le nom du pilote JDBC pour l'adresse indiquée.
  4. Cliquez sur Fin pour vous connecter à la base de données et passer au tableau de bord.

  ### Changement de base de données

  1. A partir du tableau de bord, cliquez sur Changement de base de données.
  2. Dans la zone Adresse, entrez l'adresse JDBC qualifiée complète de la source de données IBM DB2 UDB à laquelle vous voulez vous connecter.
  3. Dans les zones ID util et Mot de passe, tapez ou confirmez l'ID utilisateur et le mot de passe DB2 d'accès à la base de données à laquelle vous voulez vous connecter.
  4. Dans la zone Pilote JDBC, tapez ou confirmez le nom du pilote JDBC pour l'adresse indiquée.
  5. Cliquez sur Fin pour vous connecter à la nouvelle base de données et revenir au tableau de bord. L'Extension XML vous déconnecte de la base de données initiale et vous connecte à la nouvelle base de données.

  # Utilisation du tableau de bord Administration de l'Extension XML

  Le tableau de bord Administration de l'Extension XML permet d'accéder à des assistants qui facilitent la réalisation des tâches d'administration, telles que l'activation d'une base de données, l'édition d'une définition d'accès au document (DAD) et l'activation de colonnes ou de collections XML. Pour lancer un assistant, sélectionnez la tâche correspondante.

  ## Zones et éléments de contrôle

  Changement de base de données
    Ouvre une fenêtre de connexion à une base de données déterminée. Pour accéder à des documents XML ou les stocker, vous devez être connecté à une base de données. Cette opération effectuée, vous pouvez passer à une autre base de données à partir du tableau de bord.

  Activation de la base de données/Désactivation de la base de données
    Active ou désactive une base de données pour l'Extension XML. Il s'agit d'un bouton bascule qui varie selon que la base de données est déjà désactivée ou activée. Pour activer la base de données, l'Extension XML crée des types UDT, des fonctions UDF, une table de référence des DTD pour stocker des DTD et les informations associées, ainsi qu'une table d'usage contenant des informations communes pour chaque colonne activée. Pour désactiver une base de données, l'Extension XML retire les types UDT, les fonctions UDF, la table de référence DTD et la table d'usage XML. Pour désactiver une base de données, vous devez d'abord désactiver toutes les colonnes et collections XML associées.

  Importation d'une DTD
    Ouvre la fenêtre Importation d'une DTD qui permet d'importer un fichier DTD dans le référentiel des DTD de la base de données en cours. La définition du type de document (DTD) permet de valider les données XML dans une colonne ou une collection XML. Elle est facultative pour les données de colonne XML mais obligatoire pour les données de collection XML. |

  |Edition d'une DAD
    |Ouvre la fenêtre Spécification d'une DAD qui permet d'éditer un fichier DAD |existant ou d'en créer un nouveau. La définition d'accès au document (DAD) définit le |mode de collecte des données XML et leur stockage dans DB2. Elle précise également les |attributs et les éléments clés associés qui permettent de rechercher ces données. |Pour l'indexation, la DAD de colonne XML mappe la colonne XML vers des tables annexes. La |DAD de collection XML mappe les données DB2 vers la structure de document XML.

  Utilisation des colonnes XML
    |Ouvre une fenêtre qui permet d'ajouter, d'activer ou de |désactiver une colonne XML dans une table. Pour accéder aux données XML et les stocker, |activez une colonne DB2 pour données de type XML.

  Utilisation des collections XML
    Ouvre une fenêtre qui permet d'activer ou de désactiver une collection XML dans une base de données. Une collection permet d'accéder aux données XML et de les stocker à l'aide d'un ensemble de tables relationnelles.

  ## Tâches

  A partir du tableau de bord, vous pouvez réaliser les tâches Extension XML suivantes :

  - Connexion à une base de données ou changement de base de données
  - Activation ou désactivation d'une base de données
  - Importation d'une DTD
  - |Edition d'une DAD
  - Utilisation des colonnes XML
  - Utilisation des collections XML

  # Activation ou désactivation d'une base de données

  A partir de cet assistant, vous pouvez activer ou désactiver une base de données. L'activation d'une base de données entraîne la création des éléments requis pour l'utilisation de l'Extension XML (types UDT, fonctions UDF, procédures mémorisées et tables de prise en charge de la gestion). Vous devez activer la base de données pour pouvoir y stocker, composer ou décomposer des documents XML. La désactivation d'une base de données entraîne le retrait des types UDT, des fonctions UDF, des procédures mémorisées et des tables de prise en charge de la gestion.

  ## Tâche : Activation d'une base de données

  A partir du tableau de bord, cliquez sur Activation de la base de données pour activer la base de données en cours. Si celle-ci est déjà activée, seule l'option Désactivation de la base de données est disponible.

  Une fois la base de données activée, vous revenez au tableau de bord.

  ## Tâche : Désactivation d'une base de données

  A partir du tableau de bord, cliquez sur Désactivation de la base de données pour désactiver la base de données en cours. Si celle-ci est déjà désactivée, seule l'option Activation de la base de données est disponible.

  Une fois la base de données désactivée, vous revenez au tableau de bord.

  # Importation de DTD

  Cet assistant permet d'importer une DTD pour valider un document XML stocké dans une colonne XML ou en cours de composition à partir de données DB2 d'une collection XML.

  ## Zones et éléments de contrôle

  Nom de fichier DTD
    Tapez le nom du fichier DTD ou cliquez sur ... pour parcourir la liste des DTD disponibles. Cette zone est obligatoire.

  ID DTD
    Tapez le nom de la DTD. Cet identificateur associe la DTD à la DAD de document XML et précise son emplacement. Cette valeur identifie la DTD et peut correspondre à son chemin dans le système local. L'identificateur de DTD doit être identique à la valeur figurant dans le fichier DAD pour l'<ID DTD>. Cette zone est obligatoire.

  Auteur
    Tapez le nom de l'auteur de la DTD. Ce nom s'affiche automatiquement lorsqu'il est précisé dans le référentiel des DTD. Cette zone est facultative.

  Fin
    Insère la DTD dans le référentiel des DTD et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ## Tâche : Importation d'une DTD

  1. A partir du tableau de bord, cliquez sur Importation d'une DTD pour importer un fichier DTD dans le référentiel des DTD de la base de données en cours. L'assistant Importation d'une DTD s'affiche.
  2. Tapez le nom du fichier DTD dans la zone Nom de fichier DTD, ou cliquez sur ... pour parcourir la liste des DTD disponibles.
  3. Tapez l'identificateur de la DTD dans la zone ID DTD.
  4. Vous pouvez également indiquer l'auteur de la DTD dans la zone Auteur.

     L'Extension XML affiche automatiquement le nom de l'auteur si ce dernier est précisé dans la DTD.

  5. Cliquez sur Fin pour insérer la DTD dans le référentiel des DTD (table DB2XML.DTD_REF) et revenir au tableau de bord.

  # Utilisation des fichiers DAD

  Cet assistant permet de créer ou d'éditer des fichiers DAD pour définir le mode d'utilisation des documents XML avec DB2. Les fichiers DAD permettent de :

  - Stocker des documents XML dans des colonnes et de définir des tables annexes indexées pour la recherche structurelle rapide.
  - Composer des documents XML à partir d'une ou plusieurs tables DB2 définies dans une collection XML.
  - Décomposer des documents XML en une ou plusieurs tables DB2 définies dans une collection XML.

  Pour plus de détails sur ces techniques, reportez-vous au Guide de programmation et d'administration de l'Extension XML DB2.

  ## Zones et éléments de contrôle

  ### Spécification d'une DAD - Etape 1 pour tous les types

  Nom de fichier
    Tapez un nom de fichier existant ou cliquez sur ... pour parcourir la liste des DAD disponibles. Si vous créez une DAD, laissez cette zone à blanc. Si le fichier DAD existe déjà, son type s'affiche dans la zone Type et le bouton Suivant devient disponible.

  Type
    Si vous créez une DAD, sélectionnez l'un des types de fichiers DAD ci-après :
    - Colonne XML, pour indiquer le mode d'indexation des documents stockés dans une colonne.
    - Mappage SQL d'une collection XML, pour mapper les données relationnelles et les documents XML par une seule instruction SQL.
    - Mappage du noeud RDB d'une collection XML, pour indiquer des définitions de noeud pour les tables, les colonnes et les conditions en vue de définir le mode de stockage des données XML.

  Suivant
    Permet d'atteindre l'étape suivante (Sélection de la validation).

  Fin
    Vous activez ce bouton lorsque vous terminez la création ou la modification d'un fichier DAD. Termine l'opération et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Sélection de la validation - Etape 2 pour tous les types

  Validation des documents XML avec la DTD
    Sélectionnez cette option pour valider les documents XML. Les documents valides permettent d'effectuer des recherches structurées sur les données. Vos documents sont validés conformément à la DTD indiquée dans le fichier DAD. Vous devez valider les données XML avant de les insérer dans DB2 car vous ne pouvez pas le faire lorsque celles-ci y figurent déjà.

  ID DTD
    Tapez le nom de la DTD ou sélectionnez-le dans la liste des DTD disponibles. Si vous n'avez importé aucune DTD dans le référentiel des DTD de votre base de données, vous ne pouvez pas valider vos documents XML.

  |Pas de validation
    Sélectionnez cette option pour poursuivre la procédure sans valider les documents XML.

  Précédent
    Permet d'atteindre l'étape précédente (fenêtre Spécification d'une DAD).

  Suivant
    Permet d'atteindre l'étape suivante. Ouvre la fenêtre Gestion des tables annexes, Spécification d'une instruction SQL ou Spécification de texte selon que vous utilisez respectivement les colonnes XML, le mappage SQL d'une collection XML ou le mappage du noeud RDB d'une collection XML.

  Fin
    Vous activez ce bouton lorsque vous terminez la création ou la modification d'un fichier DAD. Termine l'opération et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Tables annexes - Etape 3 pour le type colonne XML

  |Liste des tables et colonnes existantes
    |Ce tableau contient la liste des tables annexes qui doivent être créées lorsqu'une colonne |XML utilisant ce fichier DAD est créée. Vous pouvez sélectionner le |nom d'une table ou d'une colonne existante que vous souhaitez modifier ou supprimer ou |taper un nouveau nom dans les zones qui suivent.

  Nom de la table
    Tapez le nom d'une nouvelle table annexe devant contenir la colonne. Si vous avez sélectionné une colonne dans la liste, le nom de la table annexe s'affiche pour que vous le modifiez. Cette zone est obligatoire. Par exemple :

        ORDER_SIDE_TAB

  Nom de la colonne
    Tapez le nom de la colonne. Si vous avez sélectionné un nom dans la liste des colonnes, celui-ci s'affiche pour que vous le modifiez. Cette zone est obligatoire. Par exemple :

        CUSTOMER_NAME

  Type
    Sélectionnez ou modifiez le type de la colonne, tel que DATE, CHAR, INTEGER ou VARCHAR. Cette zone est obligatoire.

  Longueur
    Si vous avez sélectionné VARCHAR, tapez ou modifiez le nombre maximal de caractères indiquant la longueur de la colonne. Cette zone n'est disponible que pour le type VARCHAR. Par exemple :

        30

  Chemin d'accès
    Tapez ou modifiez le chemin d'emplacement d'un élément ou d'un attribut. Cette zone est obligatoire. Par exemple :

        /ORDER/CUSTOMER/NAME

  Occurrences multiples
    Cochez cette case pour indiquer si l'élément ou l'attribut de colonne peut être utilisé plusieurs fois ou non dans un même document. Cochez la case pour permettre des occurrences multiples, sinon laissez-la désélectionnée.

  Ajout
    Sauvegarde la table ou la colonne avec les détails précisés et permet de poursuivre les opérations d'ajout, de modification ou de suppression de tables ou de colonnes.

  Modification
    Sauvegarde les modifications apportées dans les zones Nom de la table, Nom de la colonne, Type, Longueur, Chemin d'accès ou Occurrences multiples. Lorsque vous modifiez le nom d'une table ou d'une colonne, l'ancien objet est retiré de la liste et le nouvel objet y est ajouté.

  Retrait
    Retire de la liste l'élément mis en évidence.

  Précédent
    Permet d'atteindre l'étape précédente (Sélection de la validation).

  Suivant
    Permet d'atteindre l'étape suivante (Sauvegarde d'une DAD).

  Fin
    Vous activez ce bouton lorsque vous terminez la création ou la modification d'un fichier DAD. Termine l'opération et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Spécification de texte- Etape 3 pour le type mappage du noeud RDB ou mappage SQL

  Prologue
    Tapez un nom de prologue. Si vous éditez une DAD existante, son nom s'affiche. Le nom doit avoir le format suivant :

        <?xml version="1.0" ?>

    Cette zone est obligatoire.

  Doctype
    Tapez le type de document XML. Si vous éditez une DAD existante, le type de document s'affiche. Cette zone est obligatoire. Par exemple :

        <!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">

  Précédent
    Permet d'atteindre l'étape précédente (Sélection de la validation).

  Suivant
    Permet d'atteindre l'étape suivante (Mappage de noeuds RDB ou Spécification d'une instruction SQL, selon qu'il s'agit respectivement du type mappage du noeud RDB ou mappage SQL).

  Fin
    Vous activez ce bouton lorsque vous terminez la création ou la modification d'un fichier DAD. Termine l'opération et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Spécification d'une instruction SQL - Etape 4 pour le type mappage SQL

  Instruction SQL
    Tapez une instruction SQL SELECT. Si vous éditez un fichier DAD existant, l'instruction SQL s'affiche. Elle mappe les colonnes de la clause SELECT vers les attributs ou les éléments du document XML. La clause FROM définit les tables qui contiennent les données. La clause WHERE indique les conditions de jointure et de recherche. Toutes les tables de la collection doivent pouvoir faire l'objet d'une jointure par une seule instruction SELECT. Cette zone est obligatoire. Par exemple :

        SELECT o.order_key, customer_name, customer_email, p.part_key, color, quantity,
           price, tax, ship_id, date, mode from order_tab o, part_tab p,
        table (select substr(char(timestamp(generate_unique())),16)
          as ship_id, date, mode, part_key from ship_tab) s
              WHERE o.order_key = 1 and
                    p.price > 20000 and
                    p.order_key = o.order_key and
                    s.part_key = p.part_key
              ORDER BY order_key, part_key, ship_id

    L'instruction SQL respecte les instructions suivantes :

    - Les colonnes sont indiquées dans l'ordre descendant, en fonction de la hiérarchie de la structure du document XML.
    - Les colonnes d'une même entité sont regroupées et chaque groupe comporte une colonne ID objet.
    - La colonne ID objet est la première colonne de chaque groupe.
    - Lorsque les tables n'utilisent pas de colonne conditionnelle à clé unique, générez cette colonne à l'aide de la fonction intégrée DB2 generate_unique.
    - Les colonnes ID objet sont indiquées dans l'ordre descendant dans l'instruction ORDER BY. Les noms de colonnes de l'instruction ORDER BY ne doivent être qualifiés par aucun nom de schéma et de table et doivent être identiques au noms de colonnes indiqués dans la clause SELECT.

  Test SQL
    Vérifie si l'instruction SQL est valide. Dans l'affirmative, l'exemple de résultats s'affiche dans la zone Exemple de résultats. Dans la négative, un message d'erreur vous demande de corriger l'instruction et de réessayer.

  Exemple de résultats
    Affiche l'exemple de résultats du test auquel votre instruction SQL a été soumise, dans la mesure où celle-ci est valide. Cette zone est accessible en lecture uniquement.

  Précédent
    Permet d'atteindre l'étape précédente (Sélection de la validation).

  Suivant
    Permet d'atteindre l'étape suivante (Mappage SQL).

  Fin
    Vous activez ce bouton lorsque vous terminez la création ou la modification d'un fichier DAD. Termine l'opération et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Mappage de SQL- Etape 5 pour le type mappage SQL

  Mappe DAD
    Sur la mappe DAD affichée, sélectionnez le noeud à partir duquel le mappage doit être établi. Vous pouvez mapper les éléments et les attributs du document XML vers les noeuds d'éléments et d'attributs correspondant aux données DB2. Les noeuds indiquent le chemin des données XML aux données DB2. Sélectionnez un noeud pour activer l'option Nouvel élément. La sélection d'un noeud entraîne l'affichage des zones correspondantes dans la boîte d'options Détails.

  Type du noeud
    Sélectionnez un type de noeud dans la liste des types valides pour ce point de la mappe. Les zones qui s'affichent dans la boîte d'options Détails dépendent du type de noeud sélectionné. Cette zone est obligatoire.

    Elément
      Représente un élément XML défini dans la DTD du document XML. Permet d'associer l'élément XML à une colonne dans une table DB2. Un noeud d'élément peut être doté de noeuds d'attributs, de noeuds d'éléments enfants ou de noeuds de texte. Un noeud de niveau inférieur est associé à un noeud de texte et à un nom de colonne dans l'arborescence.

    Attribut
      Représente un attribut XML défini dans la DTD du document XML. Permet d'associer l'attribut XML à une colonne dans une table DB2. Un noeud d'attribut peut être doté d'un noeud de texte. Il est associé à un nom de colonne dans l'arborescence.

    Texte
      Indique le contenu textuel d'un noeud d'élément. Un noeud de texte est associé à un nom de colonne dans l'arborescence.

  Nom du noeud
    Tapez le nom du noeud. Cette zone est obligatoire. Par exemple :

        Order

  Colonne
    Si vous avez choisi Attribut, Elément ou Texte pour le type de noeud, sélectionnez un nom de colonne. Cette zone est obligatoire. Si vous indiquez le type de noeud Colonne, vous ne pouvez sélectionner qu'une colonne existant déjà dans votre base de données DB2. Par exemple :

        Customer_Name

  Ajout
    Ajoute l'intitulé approprié à l'élément vide que vous créez dans l'arborescence.

  Modification
    Modifie le noeud mis en évidence. Vous pouvez sélectionner le même noeud ou un noeud différent et apporter des modifications supplémentaires.

  Retrait
    Retire l'élément ou l'attribut mis en évidence.

  Nouvel élément
    Crée un noeud par l'effacement des zones de la boîte d'options Détails, ajoute un élément vide au-dessous de l'élément mis en évidence dans l'arborescence, puis met en évidence le nouvel élément vide.

  Précédent
    Permet d'atteindre l'étape précédente (Spécification d'une instruction SQL).

  Suivant
    Permet d'atteindre l'étape suivante (Sauvegarde d'une DAD).

  Fin
    Vous activez ce bouton lorsque vous terminez la création ou la modification d'un fichier DAD. Termine l'opération et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Mappage de noeuds RDB - Etape 4 pour le type mappage du noeud RDB

  Mappe DAD
    Sur la mappe DAD affichée, sélectionnez le noeud à partir duquel le mappage doit être établi. Vous mappez les éléments et les attributs du document XML vers les noeuds d'éléments et d'attributs correspondant aux données DB2. Les noeuds indiquent le chemin des données XML aux données DB2. Ils précisent la table et la colonne qui contiennent les données et la condition d'extraction de celles-ci. Sélectionnez un noeud pour activer l'option Nouvel élément. La sélection d'un noeud entraîne l'affichage des zones correspondantes dans la boîte d'options Détails.

  Type du noeud
    Sélectionnez un type de noeud dans la liste des types valides pour ce point de la mappe. Les zones qui s'affichent dans la boîte d'options Détails dépendent du type de noeud sélectionné. Il peut s'agir des zones Elément, Attribut, Texte, Table, Colonne ou Condition, en fonction du choix effectué sur la mappe DAD. Cette zone est obligatoire.

    Elément
      Représente un élément XML défini dans la DTD du document XML. Permet d'associer l'élément XML à une colonne dans une table DB2. Un noeud d'élément être doté de noeuds d'attributs, de noeuds d'éléments enfants, de noeuds de texte, de noeuds de tables ou de noeuds de conditions. Un élément racine comporte des noeuds de tables pour indiquer l'utilisation de toutes les tables lors de la génération de documents XML et leur connexion via un noeud de condition. Cette zone est obligatoire. Par exemple :

          element_node name="Order"

    Attribut
      Représente un noeud d'attribut XML défini dans la DTD du document XML. Permet d'associer l'attribut XML à une colonne dans une table DB2. Un noeud d'attribut peut être doté d'un noeud de texte. Il est associé à un nom de colonne dans la mappe DAD. Les données résident sur le noeud d'attribut et de texte de chaque élément. Cette zone est obligatoire. Par exemple :

          attribute_node name="key"

      |

    |Table
      |Représente la table associée au contenu du noeud de texte ou du |noeud d'attribut. Indique le nom d'une table DB2 dans laquelle le contenu|du noeud de texte ou du noeud d'attribut sera stocké ou de laquelle il sera |retiré. Par exemple :

          |table_node name=order_tab

      |

    |Colonne
      |Représente la colonne dans laquelle se trouve le contenu de noeud de texte ou du |noeud d'attribut. Indique le nom d'une colonne de table DB2 dans laquelle le contenu|du noeud de texte ou du noeud d'attribut sera stocké ou de laquelle il sera |retiré. Par exemple :

          |column name="order_key"

  Nom du noeud
    Tapez le nom d'un élément ou d'un attribut. Cette zone est obligatoire. Par exemple :

        element_node name="Price"

  Texte
    Indique le contenu textuel d'un élément et les données de colonne d'une table relationnelle pour les noeuds d'éléments de niveau inférieur. Contient un élément table, un élément colonne et, pour le noeud racine (root), un élément condition.

  Nom de la table
    Nom de la table qui contient la colonne. Par exemple :

        table name="order_tab"
        table name="part_tab"
        table name="ship_tab"

  Clé de la table
    Clé primaire de la table, correspondant à une ou plusieurs colonnes (clé composée). Cette clé permet de relier les tables entre elles dans une collection. Exemple de clé composée :

        table name="part_tab" key="part_key, price"

  Colonne
    Nom de la colonne qui contient les données pour le texte de l'élément et vers laquelle l'élément et l'attribut sont mappés. Par exemple :

        column name="order_key" type="integer"

  Condition
    Dans les éléments racines (root), indique le mode de jointure des tables de collection XML. Dans les éléments de niveau inférieur, indique les critères de sélection des données XML à l'aide des valeurs "=", "<", ">" ou "LIKE". Exemple de condition pour un élément racine :

                        order_tab.order_key = part_tab.order_key AND
        part_tab.part_key = ship_tab.part_key

    Exemple de critère de sélection de données XML :

        price > 2500.00

  Ajout
    Ajoute l'intitulé approprié à l'élément vide que vous créez dans l'arborescence.

  Modification
    Modifie le noeud mis en évidence. Vous pouvez sélectionner le même noeud ou un noeud différent et apporter des modifications supplémentaires.

  Retrait
    Retire l'élément mis en évidence.

  Nouvel élément
    Crée un noeud par l'effacement des zones de la boîte d'options Détails, ajoute un élément vide au-dessous de l'élément mis en évidence dans l'arborescence, puis met en évidence le nouvel élément vide.

  Précédent
    Permet d'atteindre l'étape précédente (Spécification de texte).

  Suivant
    Permet d'atteindre la fenêtre suivante (Sauvegarde d'une DAD).

  Fin
    Vous activez ce bouton lorsque vous terminez la création ou la modification d'un fichier DAD. Termine l'opération et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Sauvegarde d'une DAD - Dernière étape pour tous les types

  Nom de fichier
    Tapez le nom de la DAD (nouvelle ou modifiée) à sauvegarder. Vous pouvez également cliquer sur ... pour ouvrir la fenêtre de l'explorateur de fichiers locaux qui permet de sélectionner l'emplacement de sauvegarde de la DAD. Cette zone est obligatoire.

  Précédent
    Permet d'atteindre l'étape précédente.

  Fin
    Sauvegarde le fichier DAD et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ## Tâches

  ### Création ou édition d'une DAD pour colonnes XML

  Lorsque vous créez une DAD de colonne XML, vous indiquez le type de données du document XML et définissez des tables annexes pour l'indexation.

  1. A partir du tableau de bord, |cliquez sur Edition d'une DAD pour éditer ou créer un |fichier DAD XML. L'assistant Utilisation des fichiers DAD s'ouvre et affiche la fenêtre |Spécification d'une DAD.
  2. Vous pouvez éditer un fichier DAD existant ou en créer un nouveau.
     - Pour éditer une DAD existante, procédez comme suit :
       1. Cliquez sur ... pour parcourir la liste des DAD disponibles, ou tapez le nom de fichier DAD voulu dans la zone Nom de fichier.
       2. Vérifiez que l'assistant reconnaît le fichier DAD indiqué.
          - Dans l'affirmative, le bouton Suivant devient disponible et Colonne XML s'affiche dans la zone Type.
          - Dans la négative, vous ne pouvez pas cliquer sur Suivant. Tapez un autre nom de fichier DAD existant dans la zone Nom de fichier, ou cliquez sur ... pour parcourir à nouveau la liste des DAD disponibles. Réessayez jusqu'à ce que le bouton Suivant devienne disponible.
       3. Cliquez sur Suivant.
     - Pour créer une DAD, procédez comme suit :
       1. Laissez la zone Nom de fichier à blanc.
       2. Dans la liste Type, cliquez sur Colonne XML.
       3. Cliquez sur Suivant.
  3. Dans la fenêtre Sélection de la validation, vous pouvez choisir de valider vos documents XML avec une DTD.
     - Pour effectuer la validation, procédez comme suit :
       1. Cliquez sur Validation des documents XML avec la DTD.
       2. Dans la liste ID DTD, sélectionnez la DTD à utiliser pour la validation.

       Si vous n'avez importé aucune DTD dans le référentiel des DTD de votre base de données, vous ne pouvez pas valider vos documents XML.

     - Cliquez sur |Pas de validation pour poursuivre l'opération sans valider vos documents XML.
  4. Cliquez sur Suivant.
  5. Vous pouvez ajouter, éditer ou retirer une table annexe dans la fenêtre Tables annexes.
     - Pour ajouter une table annexe ou une colonne de table annexe, procédez comme suit :

       Pour ajouter une table annexe, vous devez définir ses colonnes. Procédez comme suit pour chaque colonne de la table annexe.

       1. Remplissez les zones de la boîte d'options Détails dans la fenêtre Tables annexes.
          1. Nom de la table : Tapez le nom de la table qui doit contenir la colonne.
          2. Nom de la colonne : Tapez le nom de la colonne.
          3. Type : Sélectionnez un type de colonne dans la liste.
          4. Longueur (type VARCHAR uniquement) : Tapez le nombre maximal de caractères VARCHAR.
          5. Chemin d'accès : Tapez le chemin de l'élément ou de l'attribut.
          6. Occurrences multiples : Sélectionnez Oui ou Non dans la liste.

             Cette option indique si l'élément ou l'attribut de colonne peut être utilisé plusieurs fois dans un même document. Important : Si vous cochez la case Occurrences multiples pour une colonne, vous ne pouvez indiquer qu'une seule colonne dans la table annexe qui la contient.

       2. Cliquez sur Ajout pour ajouter une colonne.
       3. Poursuivez les opérations d'ajout, d'édition ou de retrait de colonnes pour la table annexe, ou cliquez sur Suivant.
     - Pour éditer une colonne de table annexe existante, procédez comme suit :

       Pour mettre à jour une table annexe, modifiez les définitions des colonnes existantes.

       1. Dans la table annexe, cliquez sur le nom de la colonne à éditer.
       2. Editez les zones de la boîte d'options Détails.
       3. Cliquez sur Modification pour sauvegarder vos modifications.
       4. Poursuivez les opérations d'ajout, d'édition ou de retrait de colonnes pour chaque table annexe, ou cliquez sur Suivant.
     - Pour retirer une colonne de table annexe existante, procédez comme suit :
       1. Dans la table annexe, cliquez sur la colonne à retirer.
       2. Cliquez sur Retrait.
       3. Poursuivez les opérations d'ajout, d'édition ou de retrait de colonnes de table annexe, ou cliquez sur Suivant.
     - Pour retirer une table annexe existante, procédez comme suit :

       Pour retirer la table annexe, supprimez chacune de ses colonnes.

       1. Cliquez sur chaque colonne de la table annexe à retirer.
       2. Cliquez sur Retrait.
       3. Poursuivez les opérations d'ajout, d'édition ou de retrait de colonnes de tables annexes, ou cliquez sur Suivant.
  6. Dans la zone Nom de fichier de la fenêtre Spécification d'une DAD, tapez un nom de fichier de sortie pour la DAD modifiée.
  7. Cliquez sur Fin pour sauvegarder le fichier DAD et revenir au tableau de bord.

  ### Création ou édition d'une DAD pour collections XML

  Lorsque vous créez la DAD de collection XML, vous mappez le document XML vers la source de données DB2 à l'aide de l'une des méthodes suivantes :

  - Composition d'un fichier XML, à l'aide du mappage SQL
  - Composition d'un fichier XML, à l'aide du mappage du noeud RDB
  - Décomposition d'un fichier XML, à l'aide du mappage du noeud RDB

  #### Composition à l'aide du mappage SQL

  1. A partir du tableau de bord, cliquez sur |Edition d'une DAD. La fenêtre Spécification d'une DAD s'affiche.
  2. Vous pouvez éditer un fichier DAD existant ou en créer un nouveau.

     Pour créer un fichier DAD, procédez comme suit :

     1. Laissez la zone Nom de fichier à blanc.
     2. Dans la liste Type, cliquez sur Mappage SQL d'une collection XML.
     3. Cliquez sur Suivant pour ouvrir la fenêtre Sélection de la validation.

     Pour éditer un fichier DAD existant, procédez comme suit :

     1. Tapez le nom du fichier DAD dans la zone Nom de fichier, ou cliquez sur ... pour parcourir la liste des DAD disponibles.
     2. Vérifiez que l'assistant reconnaît le fichier DAD indiqué.
        - Dans l'affirmative, le bouton Suivant devient disponible et Mappage SQL d'une collection XML s'affiche dans la zone Type.
        - Dans la négative, vous ne pouvez pas cliquer sur Suivant. Tapez un autre nom de fichier existant, ou cliquez sur ... pour parcourir à nouveau la liste des DAD disponibles. Réessayez jusqu'à ce que le bouton Suivant devienne disponible.
     3. Cliquez sur Suivant pour ouvrir la fenêtre Sélection de la validation.
  3. Dans la fenêtre Sélection de la validation, vous pouvez choisir de valider vos documents XML avec une DTD.
     - Pour effectuer la validation, procédez comme suit :
       1. Cliquez sur Validation des documents XML avec la DTD.
       2. Dans la liste ID DTD, sélectionnez la DTD à utiliser pour la validation.

       Si vous n'avez importé aucune DTD dans le référentiel des DTD de votre base de données, vous ne pouvez pas valider vos documents XML.

     - Cliquez sur |Pas de validation pour poursuivre l'opération sans valider vos documents XML.
  4. Cliquez sur Suivant pour ouvrir la fenêtre Spécification de texte.
  5. Dans la zone Prologue, tapez le prologue du document XML à composer.

         <?xml version="1.0"?>

     Si vous éditez une DAD existante, le prologue s'affiche automatiquement dans la zone Prologue.

  6. Dans la zone Doctype de la fenêtre Spécification de texte, tapez le type du document XML en désignant la DTD associée. Par exemple :

         |<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">

     Si vous éditez une DAD existante, le type de document s'affiche automatiquement dans la zone Doctype.

  7. Cliquez sur Suivant pour ouvrir la fenêtre Spécification d'une instruction SQL.
  8. Tapez une instruction SQL SELECT valide dans la zone Instruction SQL.

     Si vous éditez une DAD existante, l'instruction SQL s'affiche automatiquement dans la zone Instruction SQL.

  9. Cliquez sur Test SQL pour vérifier la validité de l'instruction SQL.
     - Dans l'affirmative, l'exemple de résultats s'affiche dans la zone Exemple de résultats.
     - Dans la négative, cette zone contient un message d'erreur qui vous demande de corriger l'instruction SQL SELECT et de réessayer.
  10. |Cliquez sur Suivant pour ouvrir la fenêtre Mappage SQL.
  11. Pour sélectionner un noeud d'élément ou d'attribut de départ pour le mappage, cliquez sur celui-ci dans la zone située à gauche de la fenêtre |Mappage SQL.

      Mappez les éléments et les attributs du document XML vers les noeuds d'éléments et d'attributs correspondant aux données DB2. Ces noeuds indiquent le chemin des données XML aux données DB2.

      - Pour ajouter le noeud racine (root), procédez comme suit :
        1. Sélectionnez l'icône Root.
        2. Cliquez sur Nouvel élément pour définir un nouveau noeud.
        3. Dans la boîte d'options Détails, indiquez Elément pour Type du noeud.
        4. Entrez le nom du noeud racine dans la zone Nom du noeud.
        5. Cliquez sur Ajout pour créer le noeud.

           Vous avez créé le noeud ou l'élément racine, parent de tous les autres noeuds d'éléments et d'attributs de la mappe. Vous pouvez à présent lui ajouter des éléments enfants et des attributs.

      - Pour ajouter un élément enfant ou un noeud d'attribut, procédez comme suit :
        1. Pour ajouter un élément enfant ou un attribut, cliquez sur un noeud parent dans la zone située à gauche.

           Si vous n'avez sélectionné aucun noeud parent, l'option Nouvel Elément n'est pas disponible.

        2. Cliquez sur Nouvel élément.
        3. Sélectionnez un type de noeud dans la liste Type du noeud de la boîte d'options Détails.

           La liste Type du noeud n'affiche que les types de noeuds valides pour ce point de la mappe.

        4. Renseignez la zone Nom du noeud dans la boîte d'options Détails.
        5. Si vous avez indiqué le type de noeud Attribut, Elément ou Texte pour un élément de niveau inférieur, sélectionnez une colonne dans la zone Colonne de la boîte d'options Détails.

           Restriction : Vous ne pouvez pas créer de colonne à l'aide de l'assistant d'administration. Si vous indiquez le type de noeud Colonne, vous ne pouvez sélectionner qu'une colonne existant déjà dans votre base de données DB2.

        6. Cliquez sur Ajout pour ajouter le noeud.

           Vous pouvez modifier un noeud ultérieurement. Pour ce faire, cliquez sur celui-ci dans la zone située à gauche et apportez toutes les modifications souhaitées dans la zone de groupe Détails. Cliquez sur Modification pour mettre à jour l'élément.

           Vous pouvez également ajouter des éléments enfants ou des attributs au noeud. Pour ce faire, mettez-le en évidence et répétez la procédure d'ajout.

        7. Poursuivez l'édition de la mappe SQL, ou cliquez sur Suivant pour ouvrir la fenêtre Spécification d'une DAD.
      - Pour retirer un noeud, procédez comme suit :
        1. Cliquez sur un noeud figurant dans la zone située à gauche.
        2. Cliquez sur Retrait.
        3. Poursuivez l'édition de la mappe SQL, ou cliquez sur Suivant pour ouvrir la fenêtre Spécification d'une DAD.

        Si vous avez retiré un noeud de niveau inférieur, un autre élément, pouvant nécessiter la définition d'un nom de colonne, le remplace dans l'arborescence.

  12. Dans la zone Nom de fichier de la fenêtre Spécification d'une DAD, tapez un nom de fichier de sortie pour la DAD modifiée.
  13. Cliquez sur Fin pour revenir au tableau de bord.

  #### Composition à l'aide du mappage du noeud RDB

  1. A partir du tableau de bord, cliquez sur |Edition d'une DAD. La fenêtre Spécification d'une DAD s'affiche.
  2. Vous pouvez éditer un fichier DAD existant ou en créer un nouveau.

     Pour éditer une DAD existante, procédez comme suit :

     1. Tapez le nom du fichier DAD dans la zone Nom de fichier, ou cliquez sur ... pour parcourir la liste des DAD disponibles.
     2. Vérifiez que l'assistant reconnaît le fichier DAD indiqué.
        - Dans l'affirmative, le bouton Suivant devient disponible et Mappage du noeud RDB d'une collection XML s'affiche dans la zone Type.
        - Dans la négative, vous ne pouvez pas cliquer sur Suivant. Tapez un autre nom de fichier DAD existant dans la zone Nom de fichier, ou cliquez sur ... pour parcourir à nouveau la liste des DAD disponibles. Réessayez jusqu'à ce que le bouton Suivant devienne disponible.
     3. Cliquez sur Suivant pour ouvrir la fenêtre Sélection de la validation.

     Pour créer une DAD, procédez comme suit :

     1. Laissez la zone Nom de fichier à blanc.
     2. Sélectionnez Mappage du noeud RDB d'une collection XML dans la liste Type.
     3. Cliquez sur Suivant pour ouvrir la fenêtre Sélection de la validation.
  3. Dans la fenêtre Sélection de la validation, vous pouvez choisir de valider vos documents XML avec une DTD.
     - Pour effectuer la validation, procédez comme suit :
       1. Cliquez sur Validation des documents XML avec la DTD.
       2. Dans la liste ID DTD, sélectionnez la DTD à utiliser pour la validation.

       Si vous n'avez importé aucune DTD dans le référentiel des DTD de votre base de données, vous ne pouvez pas valider vos documents XML.

     - Cliquez sur |Pas de validation pour poursuivre l'opération sans valider vos documents XML.
  4. Cliquez sur Suivant pour ouvrir la fenêtre Spécification de texte.
  5. Tapez le nom de prologue dans la zone Prologue de la fenêtre Spécification de texte.

         <?xml version="1.0"?>

     Si vous éditez une DAD existante, le prologue s'affiche automatiquement dans la zone Prologue.

  6. Entrez le type du document XML dans la zone Doctype. Par exemple :

         |<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">

     Si vous éditez une DAD existante, le type de document s'affiche automatiquement dans la zone Doctype.

  7. |Cliquez sur Suivant pour ouvrir la fenêtre Mappage de noeuds RDB.
  8. Pour sélectionner un noeud d'élément ou d'attribut de départ pour le mappage, cliquez sur celui-ci dans la zone située à gauche de la fenêtre |Mappage de noeuds RDB.

     Mappez les éléments et les attributs du document XML vers les noeuds d'éléments et d'attributs correspondant aux données DB2. Ces noeuds indiquent le chemin des données XML aux données DB2.

  9. Pour ajouter le noeud racine (root), procédez comme suit :
     1. Sélectionnez l'icône Root.
     2. Cliquez sur Nouvel élément pour définir un nouveau noeud.
     3. Dans la boîte d'options Détails, indiquez Elément pour Type du noeud.
     4. Entrez le nom du noeud racine dans la zone Nom du noeud.
     5. Cliquez sur Ajout pour créer le noeud.

        Vous avez créé le noeud ou l'élément racine, parent de tous les autres noeuds d'éléments et d'attributs de la mappe. Le noeud racine comporte des éléments enfants de table et une condition de jointure.

        Ajoutez des noeuds de tables pour chaque table faisant partie de la collection.

        1. Mettez le nom de noeud racine en évidence et sélectionnez Nouvel élément.
        2. Dans la boîte d'options Détails, indiquez Table pour Type du noeud.
        3. Sélectionnez le nom de la table dans la liste Nom de la table. La table doit déjà exister.
        4. Cliquez sur Ajout pour ajouter le noeud de table.
        5. Répétez ces étapes pour chaque table.

        Ajoutez une condition de jointure pour les noeuds de tables.

        1. Mettez le nom de noeud racine en évidence et sélectionnez Nouvel élément.
        2. Dans la boîte d'options Détails, indiquez Condition pour Type du noeud.
        3. Dans la zone Condition, entrez la condition de jointure en respectant la syntaxe suivante :

               table_name.table_column = table_name.table_column AND
               table_name.table_column = table_name.table_column ...

           Incluez toutes les conditions nécessaires pour créer la condition de jointure, en les réunissant par AND.

        4. Cliquez sur Ajout pour ajouter la condition.

     Vous pouvez à présent lui ajouter des éléments enfants et des attributs.

  10. Pour ajouter un élément enfant ou un noeud d'attribut, procédez comme suit :
      1. Pour ajouter un élément enfant ou un attribut, cliquez sur un noeud parent dans la zone située à gauche.
      2. Cliquez sur Nouvel élément. Si vous n'avez sélectionné aucun noeud parent, l'option Nouvel Elément n'est pas disponible.
      3. Sélectionnez un type de noeud dans la liste Type du noeud de la boîte d'options Détails.

         La liste Type du noeud n'affiche que les types de noeuds valides pour ce point de la mappe, c'est-à-dire Elément ou Attribut.

      4. Entrez le nom de l'élément ou de l'attribut dans la zone Nom du noeud.
      5. Si vous avez indiqué le type de noeud Attribut ou Elément pour un élément de niveau inférieur, sélectionnez une colonne dans la zone Colonne de la boîte d'options Détails.

         Restriction : Vous ne pouvez pas créer de colonne à l'aide de l'assistant d'administration. Si vous indiquez le type de noeud Colonne, vous ne pouvez sélectionner qu'une colonne existant déjà dans votre base de données DB2.

      6. Cliquez sur Ajout pour ajouter le noeud.

         Vous pouvez modifier un noeud ultérieurement. Pour ce faire, cliquez sur celui-ci dans la zone située à gauche et apportez toutes les modifications souhaitées dans la zone de groupe Détails. Cliquez sur Modification pour mettre à jour l'élément.

         Vous pouvez également ajouter des éléments enfants ou des attributs au noeud. Pour ce faire, mettez-le en évidence et répétez la procédure d'ajout.

      7. Pour mapper le contenu d'un noeud d'élément ou d'attribut vers une table relationnelle, procédez comme suit :
         1. Indiquez un noeud de texte.
            1. Cliquez sur le noeud parent.
            2. Cliquez sur Nouvel élément.
            3. Dans la zone Type du noeud, sélectionnez Texte.
            4. Sélectionnez Ajout pour ajouter le noeud.
         2. Ajoutez un noeud de table.
            1. Sélectionnez le noeud de texte que vous venez de créer et cliquez sur Nouvel élément.
            2. Dans la zone Type du noeud, sélectionnez Table et indiquez un nom de table pour l'élément.
            3. Cliquez sur Ajout pour ajouter le noeud.
         3. Ajoutez un noeud de colonne.
            1. Resélectionnez le noeud de texte et cliquez sur Nouvel élément.
            2. Dans la zone Type du noeud, sélectionnez Colonne et indiquez un nom de colonne pour l'élément.
            3. Cliquez sur Ajout pour ajouter le noeud.

            Restriction : Vous ne pouvez pas créer de colonne à l'aide de l'assistant d'administration. Si vous indiquez le type de noeud Colonne, vous ne pouvez sélectionner qu'une colonne existant déjà dans votre base de données DB2.

         4. Vous pouvez ajouter une condition pour la colonne.
            1. Resélectionnez le noeud de texte et cliquez sur Nouvel élément.
            2. Dans la zone Type du noeud, sélectionnez Condition et indiquez une condition en respectant avec sa syntaxe :

                   operator LIKE|<|>|= value

            3. Cliquez sur Ajout pour ajouter le noeud.
      8. Poursuivez l'édition de la mappe du noeud RDB, ou cliquez sur Suivant pour ouvrir la fenêtre Spécification d'une DAD.
  11. Pour retirer un noeud, procédez comme suit :
      1. Cliquez sur un noeud figurant dans la zone située à gauche.
      2. Cliquez sur Retrait.
      3. Poursuivez l'édition de la mappe du noeud RDB, ou cliquez sur Suivant pour ouvrir la fenêtre Spécification d'une DAD.
  12. Dans la zone Nom de fichier de la fenêtre Spécification d'une DAD, tapez un nom de fichier de sortie pour la DAD modifiée.
  13. Cliquez sur Fin pour retirer le noeud et revenir au tableau de bord.

  #### Décomposition à l'aide du mappage du noeud RDB

  1. A partir du tableau de bord, cliquez sur |Edition d'une DAD. La fenêtre Spécification d'une DAD s'affiche.
  2. Vous pouvez éditer un fichier DAD existant ou en créer un nouveau.

     Pour éditer une DAD existante, procédez comme suit :

     1. Tapez le nom du fichier DAD dans la zone Nom de fichier, ou cliquez sur ... pour parcourir la liste des DAD disponibles.
     2. Vérifiez que l'assistant reconnaît le fichier DAD indiqué.
        - Dans l'affirmative, le bouton Suivant devient disponible et Mappage du noeud RDB d'une collection XML s'affiche dans la zone Type.
        - Dans la négative, vous ne pouvez pas cliquer sur Suivant. Tapez un autre nom de fichier DAD existant dans la zone Nom de fichier, ou cliquez sur ... pour parcourir à nouveau la liste des DAD disponibles. Réessayez jusqu'à ce que le bouton Suivant devienne disponible.
     3. Cliquez sur Suivant pour ouvrir la fenêtre Sélection de la validation.

     Pour créer une DAD, procédez comme suit :

     1. Laissez la zone Nom de fichier à blanc.
     2. Sélectionnez Mappage du noeud RDB d'une collection XML dans la liste Type.
     3. Cliquez sur Suivant pour ouvrir la fenêtre Sélection de la validation.
  3. Dans la fenêtre Sélection de la validation, vous pouvez choisir de valider vos documents XML avec une DTD.
     - Pour effectuer la validation, procédez comme suit :
       1. Cliquez sur Validation des documents XML avec la DTD.
       2. Dans la liste ID DTD, sélectionnez la DTD à utiliser pour la validation.

       Si vous n'avez importé aucune DTD dans le référentiel des DTD de votre base de données, vous ne pouvez pas valider vos documents XML.

     - Cliquez sur |Pas de validation pour poursuivre l'opération sans valider vos documents XML.
  4. Cliquez sur Suivant pour ouvrir la fenêtre Spécification de texte.
  5. Si vous décomposez uniquement un document XML, ignorez la zone Prologue. Si vous utilisez le fichier DAD pour des opérations de composition et de décomposition, tapez le nom de prologue dans la zone Prologue de la fenêtre Spécification de texte. Le prologue est facultatif lorsque vous décomposez des documents XML en données DB2.

         <?xml version="1.0"?>

     Si vous éditez une DAD existante, le prologue s'affiche automatiquement dans la zone Prologue.

  6. Si vous décomposez uniquement un document XML, ignorez la zone Doctype. Si vous utilisez le fichier DAD pour des opérations de composition et de décomposition, entrez le type de document XML dans la zone Doctype.

     Si vous éditez une DAD existante, le type de document s'affiche automatiquement dans la zone Doctype. Par exemple :

         |<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">

  7. Cliquez sur Suivant pour ouvrir la fenêtre Mappage RDB.
  8. Pour sélectionner un noeud d'élément ou d'attribut de départ pour le mappage, cliquez sur celui-ci dans la zone située à gauche de la fenêtre Mappage RDB.

     Mappez les éléments et les attributs du document XML vers les noeuds d'éléments et d'attributs correspondant aux données DB2. Ces noeuds indiquent le chemin des données XML aux données DB2.

  9. Pour ajouter le noeud racine (root), procédez comme suit :
     1. Sélectionnez l'icône Root.
     2. Cliquez sur Nouvel élément pour définir un nouveau noeud.
     3. Dans la boîte d'options Détails, indiquez Elément pour Type du noeud.
     4. Entrez le nom du noeud racine dans la zone Nom du noeud.
     5. Cliquez sur Ajout pour créer le noeud.

        Vous avez créé le noeud ou l'élément racine, parent de tous les autres noeuds d'éléments et d'attributs de la mappe. Le noeud racine comporte des éléments enfants de table et une condition de jointure.

        Ajoutez des noeuds de tables pour chaque table faisant partie de la collection.

        1. Mettez le nom de noeud racine en évidence et sélectionnez Nouvel élément.
        2. Dans la boîte d'options Détails, indiquez Table pour Type du noeud.
        3. Sélectionnez le nom de la table dans la liste Nom de la table. La table doit déjà exister.
        4. Dans la zone Clé de la table, indiquez une colonne de clé pour la table.
        5. Cliquez sur Ajout pour ajouter le noeud de table.
        6. Répétez ces étapes pour chaque table.

        Ajoutez une condition de jointure pour les noeuds de tables.

        1. Mettez le nom de noeud racine en évidence et sélectionnez Nouvel élément.
        2. Dans la boîte d'options Détails, indiquez Condition pour Type du noeud.
        3. Dans la zone Condition, entrez la condition de jointure en respectant la syntaxe suivante :

               table_name.table_column = table_name.table_column AND
               table_name.table_column = table_name.table_column ...

        4. Cliquez sur Ajout pour ajouter la condition.

     Vous pouvez à présent lui ajouter des éléments enfants et des attributs.

  10. Pour ajouter un élément enfant ou un noeud d'attribut, procédez comme suit :
      1. Pour ajouter un élément enfant ou un attribut, cliquez sur un noeud parent dans la zone située à gauche.

         Si vous n'avez sélectionné aucun noeud parent, l'option Nouvel élément n'est pas disponible.

      2. Cliquez sur Nouvel élément.
      3. Sélectionnez un type de noeud dans la liste Type du noeud de la boîte d'options Détails.

         La liste Type du noeud n'affiche que les types de noeuds valides pour ce point de la mappe, c'est-à-dire Elément ou Attribut.

      4. Cliquez sur Ajout pour ajouter le noeud. Vous pouvez modifier un noeud ultérieurement. Pour ce faire, cliquez sur celui-ci dans la zone située à gauche et apportez toutes les modifications souhaitées dans la boîte d'options Détails. Cliquez sur Modification pour mettre à jour l'élément.
      5. Pour mapper le contenu d'un noeud d'élément ou d'attribut vers une table relationnelle, procédez comme suit :
         1. Indiquez un noeud de texte.
            1. Cliquez sur le noeud parent.
            2. Cliquez sur Nouvel élément.
            3. Dans la zone Type du noeud, sélectionnez Texte.
            4. Sélectionnez Ajout pour ajouter le noeud.
         2. Ajoutez un noeud de table.
            1. Sélectionnez le noeud de texte que vous venez de créer et cliquez sur Nouvel élément.
            2. Dans la zone Type du noeud, sélectionnez Table et indiquez un nom de table pour l'élément.
            3. Cliquez sur Ajout pour ajouter le noeud.
         3. Ajoutez un noeud de colonne.
            1. Resélectionnez le noeud de texte et cliquez sur Nouvel élément.
            2. Dans la zone Type du noeud, sélectionnez Colonne et indiquez un nom de colonne pour l'élément.
            3. Dans la zone Type, indiquez le type de base à affecter à la colonne pour que celle-ci puisse stocker les données non balisées.
            4. Cliquez sur Ajout pour ajouter le noeud.

            Restriction : Vous ne pouvez pas créer de colonne à l'aide de l'assistant d'administration. Si vous indiquez le type de noeud Colonne, vous ne pouvez sélectionner qu'une colonne existant déjà dans votre base de données DB2.

         4. Vous pouvez ajouter une condition pour la colonne.
            1. Resélectionnez le noeud de texte et cliquez sur Nouvel élément.
            2. Dans la zone Type du noeud, sélectionnez Condition et indiquez une condition en respectant avec sa syntaxe :

                   operator LIKE|<|>|= value

            3. Cliquez sur Ajout pour ajouter le noeud.
      6. Poursuivez l'édition de la mappe du noeud RDB, ou cliquez sur Suivant pour ouvrir la fenêtre Spécification d'une DAD.
  11. Pour retirer un noeud, procédez comme suit :
      1. Cliquez sur un noeud figurant dans la zone située à gauche.
      2. Cliquez sur Retrait.
      3. Poursuivez l'édition de la mappe du noeud RDB, ou cliquez sur Suivant pour ouvrir la fenêtre Spécification d'une DAD.
  12. Dans la zone Nom de fichier de la fenêtre Spécification d'une DAD, tapez un nom de fichier de sortie pour la DAD modifiée.
  13. Cliquez sur Fin pour retirer le noeud et revenir au tableau de bord.

  # Utilisation des colonnes XML

  A partir de cet assistant, vous pouvez ajouter, activer ou désactiver des colonnes XML pour l'Extension XML.

  ## Zones et éléments de contrôle

  ### Sélection d'une tâche (pour les colonnes)

  Ajout d'une colonne XML
    Sélectionnez cette option pour ouvrir la fenêtre Ajout d'une colonne XML qui permet d'ajouter une colonne dans une table. Cette colonne contiendra un document XML entier. Cette option n'est disponible que si la base de données est activée.

  |Activation d'une colonne XML
    Sélectionnez cette option pour ouvrir la fenêtre |Activation d'une colonne XML qui permet de vous connecter à une base de données et d'activer une colonne XML pour qu'elle puisse contenir des types UDT Extension XML. Cette option n'est disponible que si la base de données est activée et que des colonnes sont créées pour des documents XML.

  |Désactivation d'une colonne XML
    Sélectionnez cette option pour ouvrir la fenêtre |Désactivation d'une colonne XML qui permet de désactiver une colonne existante. Si la base de données n'est pas activée ou qu'une colonne XML activée n'existe pas, cette option n'est pas disponible. Une colonne désactivée ne peut plus contenir de documents XML. Pour pouvoir retirer une table XML, vous devez d'abord désactiver la colonne XML qu'elle contient. Si vous ne le faites pas, l'Extension XML conserve les tables annexes qu'elle a créées et l'entrée de colonne XML dans la table d'usage XML.

  Suivant
    Ouvre la fenêtre sélectionnée pour ajouter, activer ou désactiver une colonne XML.

  Fin
    Disponible lorsque vous avez fini d'utiliser la colonne.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Ajout d'une colonne XML

  Nom de la table
    Tapez le nom de la table ou sélectionnez-le dans la liste des DTD disponibles. La table doit être définie pour pouvoir ajouter une colonne XML. Par exemple :

        SALES_DB

  Nom de la colonne
    Tapez le nom à utiliser pour la colonne XML. Par exemple :

        ORDER

  |Type de données
    Sélectionnez un type de données dans la liste des types disponibles (par exemple, XMLCLOB, XMLVARCHAR ou XMLFILE). Par exemple :

        XMLVARCHAR

  Précédent
    Ouvre la fenêtre Sélection d'une tâche que vous avez affichée pour utiliser les colonnes XML.

  Fin
    Ajoute la colonne XML et revient au tableau de bord.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Activation d'une colonne XML

  Nom de la table
    Tapez le nom de la table contenant une colonne XML ou sélectionnez-le dans la liste des tables disponibles. Par exemple :

        SALES_TAB

  Nom de la colonne
    Tapez le nom d'une colonne XML de la table ou sélectionnez-le dans la liste des colonnes disponibles. Par exemple :

        ORDER

  Nom de fichier DAD
    Tapez l'emplacement du fichier DAD qui mappe le document XML vers la colonne et les tables annexes XML, ou cliquez sur ... pour parcourir la liste des DAD disponibles. Par exemple :

        c:\dxx\samples\dad\getstart.dad

  Espace table
    Vous pouvez taper le nom d'un espace table existant pour les tables annexes associées à la colonne XML. Si vous laissez cette zone à blanc, l'Extension XML utilise un espace table par défaut.

  Vue par défaut
    Vous pouvez taper le nom d'une vue par défaut qui permet d'effectuer la jointure de la table XML et de toutes ses tables annexes.

  |ID racine
    Action recommandée, mais facultative : Tapez le nom de colonne de la clé primaire pour associer toutes les tables annexes à la table d'application. Si vous n'indiquez aucun ID racine (ROOT ID), l'Extension XML ajoute une colonne DXXROOT_ID dans la table et génère un identificateur par défaut.

  Précédent
    Ouvre la fenêtre Sélection d'une tâche que vous avez affichée pour utiliser les colonnes XML.

  Fin
    Ajoute la colonne XML et revient au tableau de bord. Pour activer la colonne, l'Extension XML détermine si la table XML est associée à une clé primaire, crée les tables annexes indiquées dans le fichier DAD et génère une vue par défaut de la table XML et des tables annexes.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Désactivation d'une colonne XML

  Nom de la table
    Tapez le nom de la table contenant la colonne XML ou sélectionnez-le dans la liste des tables disponibles.

  Nom de la colonne
    Tapez le nom d'une colonne de la table ou sélectionnez-le dans la liste des colonnes disponibles.

  Précédent
    Ouvre la fenêtre Sélection d'une tâche que vous avez affichée pour utiliser les colonnes XML.

  Fin
    Désactive la colonne XML et revient au tableau de bord. Une colonne XML désactivée ne peut plus contenir de documents XML.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ## Tâches

  ### Ajout d'une colonne XML

  1. A partir du tableau de bord, cliquez sur Utilisation des colonnes XML. La fenêtre Sélection d'une tâche s'affiche.
  2. Cliquez sur Ajout d'une colonne XML. La fenêtre Ajout d'une colonne XML s'affiche.
  3. Tapez le nom de la table à modifier ou sélectionnez-le dans la liste Nom de la table.
  4. Dans la zone Nom de la colonne, tapez le nom de la colonne à ajouter.
  5. Dans la liste |Type de données, sélectionnez un type UDT pour la colonne.
  6. Cliquez sur Fin pour ajouter la colonne de type XML.

  ### Activation d'une colonne XML

  1. A partir du tableau de bord, cliquez sur Utilisation des colonnes XML pour afficher les tâches liées aux colonnes de l'Extension XML. La fenêtre Sélection d'une tâche s'affiche.
  2. Cliquez sur |Activation d'une colonne XML puis sur Suivant, pour activer une colonne de table existant dans la base de données.
  3. Dans la zone Nom de la table, sélectionnez la table qui contient la colonne XML.
  4. Dans la zone Nom de la colonne, sélectionnez la colonne à activer. Il doit s'agir d'une colonne existante de type XML.
  5. Tapez le chemin et le nom du fichier DAD dans la zone Nom de fichier DAD, ou cliquez sur ... pour parcourir la liste des DAD disponibles.
  6. Vous pouvez également indiquer dans la zone Espace table le nom d'un espace table existant.

     L'espace table contient les tables annexes générées par l'Extension XML. Les tables annexes sont créées dans l'espace table que vous précisez, ou dans l'espace table par défaut, si vous n'en indiquez aucun.

  7. Vous pouvez également indiquer dans la zone Vue par défaut le nom de la vue par défaut.

     Si vous l'indiquez, la vue par défaut est automatiquement générée lors de la création de la colonne. Elle effectue la jointure de la table XML et de toutes ses tables annexes.

  8. Vous pouvez également indiquer dans la zone ID racine le nom de colonne de la clé primaire figurant dans la table d'application. Cette méthode est recommandée.

     L'Extension XML utilise l'ID racine en tant qu'identificateur unique pour associer toutes les tables annexes à la table d'application. Si vous n'indiquez aucun ID racine (root), l'Extension XML ajoute une colonne DXXROOT_ID dans la table d'application et génère un identificateur par défaut.

  9. Cliquez sur Fin pour activer la colonne XML, créer les tables annexes et revenir au tableau de bord.
     - Si l'activation de la colonne aboutit, un message d'information l'indique.
     - Si l'activation de la colonne échoue, un message d'erreur s'affiche. Corrigez les valeurs dans les zones d'entrée jusqu'à l'aboutissement de l'opération.

  ### Désactivation d'une colonne XML

  1. A partir du tableau de bord, cliquez sur Utilisation des colonnes XML pour afficher les tâches liées aux colonnes de l'Extension XML. La fenêtre Sélection d'une tâche s'affiche.
  2. Cliquez sur | Désactivation d'une colonne puis sur Suivant dans la fenêtre Sélection d'une tâche, pour désactiver une colonne de table existant dans la base de données.
  3. Dans la zone Nom de la table, sélectionnez la table qui contient la colonne XML.
  4. Dans la zone Nom de la colonne, sélectionnez la colonne à désactiver.
  5. Cliquez sur Fin.
     - Si la désactivation de la colonne aboutit, un message d'information l'indique.
     - Si la désactivation de la colonne échoue, un message d'erreur s'affiche. Corrigez les valeurs dans les zones d'entrée jusqu'à l'aboutissement de l'opération.

  # Utilisation des collections XML

  A partir de cet assistant, vous pouvez activer ou désactiver des collections XML.

  ## Zones et éléments de contrôle

  ### Sélection d'une tâche (pour les collections)

  Activation d'une collection XML
    Sélectionnez cette option pour ouvrir la fenêtre Activation d'une collection XML. L'activation d'une colonne XML lance l'analyse du fichier DAD pour identifier les tables et les colonnes liées aux documents XML. Elle déclenche également l'enregistrement des données de contrôle. Cette option n'est disponible que si la base de données est activée et qu'il existe un fichier DAD.

  Désactivation d'une collection XML
    Sélectionnez cette option pour ouvrir la fenêtre Désactivation d'une collection qui permet de retirer les marqueurs identifiant les tables et les colonnes au sein d'une collection XML. Si la collection n'est pas activée, cette option n'est pas disponible.

  Suivant
    Ouvre la fenêtre sélectionnée pour activer ou désactiver une collection XML.

  Fin
    Disponible lorsque vous avez terminé d'utiliser la collection.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Activation d'une collection XML

  Nom de la collection
    Tapez le nom de la collection XML à activer.

  Nom de fichier DAD
    Tapez le nom du fichier DAD qui mappe la structure du document XML vers les tables DB2 utilisées pour les opérations de composition ou de décomposition, ou cliquez sur ... pour parcourir la liste des DAD disponibles.

  ...
    Ouvre une fenêtre Recherche dans laquelle vous pouvez sélectionner un nom de fichier DAD existant.

  Espace table
    Tapez le nom d'un espace table déjà créé, s'il en existe un. Cet espace table contiendra les nouvelles tables DB2 générées pour les opérations de composition ou de décomposition.

  Précédent
    Ouvre la fenêtre Sélection d'une tâche affichée pour utiliser les collections XML.

  Fin
    Active la collection XML et revient au tableau de bord. Pour activer la collection, l'Extension XML identifie les tables et les colonnes du document XML à l'aide du fichier DAD et enregistre les données de contrôle dans la table XML_USAGE.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ### Désactivation d'une collection XML

  Nom de la collection
    Sélectionnez dans la liste des collections le nom de la collection XML à désactiver.

  Précédent
    Ouvre la fenêtre Sélection d'une tâche affichée pour utiliser les collections XML.

  Fin
    Désactive la collection XML et revient au tableau de bord. Pour désactiver une collection, l'Extension XML retire les marqueurs identifiant les tables et les colonnes au sein d'une collection XML.

  Annulation
    Annule l'assistant et revient au tableau de bord.

  ## Tâches

  ### Activation d'une collection XML

  1. A partir du tableau de bord, cliquez sur Utilisation des collections XML. La fenêtre Sélection d'une tâche s'affiche.
  2. Cliquez sur |Activation d'une collection XML puis sur Suivant. La fenêtre Activation d'une collection s'affiche.
  3. Dans la zone Nom de la collection, sélectionnez le nom de la collection à activer.
  4. Tapez le nom du fichier DAD dans la zone Nom de fichier DAD, ou cliquez sur ... pour parcourir la liste des DAD disponibles.
  5. Vous pouvez également indiquer dans la zone Espace table le nom d'un espace table existant.

     Cet espace table contiendra les nouvelles tables DB2 générées pour les opérations de décomposition.

  6. Cliquez sur Fin pour activer la collection et revenir au tableau de bord.
     - Si l'activation de la collection aboutit, un message d'information l'indique.
     - Si l'activation de la collection échoue, un message d'erreur s'affiche. Corrigez les valeurs dans les zones d'entrée jusqu'à l'aboutissement de l'opération.

  ### Désactivation d'une collection XML

  1. A partir du tableau de bord, cliquez sur Utilisation des collections XML pour afficher les tâches liées aux collections de l'Extension XML. La fenêtre Sélection d'une tâche s'affiche.
  2. Cliquez sur Désactivation d'une collection XML puis sur Suivant pour désactiver une collection XML. La fenêtre Désactivation d'une collection s'affiche.
  3. Dans la zone Nom de la collection, tapez le nom de la collection à désactiver.
  4. Cliquez sur Fin pour désactiver la collection et revenir au tableau de bord.
     - Si la désactivation de la collection aboutit, un message d'information l'indique.
     - Si la désactivation de la collection échoue, un message d'erreur s'affiche. Corrigez les valeurs dans les zones d'entrée jusqu'à l'aboutissement de l'opération.