# Guide til XML Extender-administration - Hjælp

# Indhold

Opret forbindelse til database

- Vindueselementer
- Opgaver
- Opret forbindelse til databasen
- Skift til en anden database

  Ikonbånd til XML Extender-administration

- Vindueselementer
- Opgaver

  Aktivér eller deaktivér database

- Opgave: Aktivér database
- Opgave: Deaktivér database

  Importér DTD'er

- Vindueselementer
- Opgave: Importér DTD

  Arbejd med DAD-filer

- Vindueselementer
- Angiv DAD - første trin for alle typer
- Vælg validering - trin 2 for alle typer
- Sidetabeller - trin 3 for XML-kolonnetype
- Angiv tekst - trin 3 for SQL-konverteringstype eller RDB-nodekonverteringstype
- Angiv SQL-sætning - trin 4 for SQL-konverteringstype
- Konvertér SQL - trin 5 for SQL-konverteringstype
- Konvertér RDB-noder - trin 4 for RDB-nodekonverteringstype
- Gem DAD - sidste trin for alle typer
- Opgaver
- Opret eller redigér DAD til XML-kolonner
- Opret eller redigér DAD til XML-grupper

  Arbejd med XML-kolonner

- Vindueselementer
- Vælg opgave (kolonner)
- Tilføj XML-kolonne
- Aktivér XM-kolonne
- Deaktivér XML-kolonne
- Opgaver
- Tilføj XML-kolonne
- Aktivér XML-kolonne
- Deaktivér XML-kolonne

  Arbejd med XML-grupper

- Vindueselementer
- Vælg opgave (grupper)
- Aktivér XML-gruppe
- Deaktivér XML-gruppe
- Opgaver
- Aktivér XML-gruppe
- Deaktivér XML-gruppe

  # Opret forbindelse til database

  Vha. denne guide kan du oprette forbindelse til den database, der indeholder eller kan indeholde XML-data.

  ## Vindueselementer

  Adresse
    Skriv navnet på den JDBC-database, du vil oprette forbindelse til, eller vælg en adresse i oversigten. Vha. guiden kan du udføre interaktive opgaver i databasen. Hvis du vælger en adresse i oversigten, vises den bruger-id og det JDBC-styreprogram, der sidst har været knyttet til adressen, i nedenstående felter. Feltet skal udfyldes. Adressen angives med følgende syntaks:

    |Til enkeltstående konfigurationer (anbefales):

        jdbc:db2:database_navn

    Hvor:

    database_navn
      er den database, du opretter forbindelse til, og hvor du gemmer XML-dokumenter.

    F.eks.:

        jdbc:db2:salg_db

    Netværkskonfigurationer:

        jdbc:db2://|vært:portnummer/databasenavn

    Hvor:

    |vært
      |Er navnet på den server, som XML Extender er placeret på.

    portnummer
      er nummeret på den port, der anvendes til serverforbindelsen. Angiv følgende kommando på en DB2-kommandolinie på serveren for at finde portnummeret:

          db2jstrt port#

    databasenavn
      er den database, du opretter forbindelse til, og hvor du gemmer XML-dokumenter.

    F.eks.:

        jdbc:db2://vært1.ibm.com/salg_db

  Bruger-id
    Skriv og validér den bruger-id, du anvender til databasen. Feltet skal udfyldes.

  Kodeord
    Skriv det kodeord, du anvender til databasen. Feltet skal udfyldes.

  JDBC-styreprogram
    Skriv eller validér placeringen af styreprogrammet til databasen. Feltet skal udfyldes. Styreprogrammet skal indeholde én af følgende værdier:

    |Til enkeltstående konfigurationer (standardværdi):

        COM.ibm.db2.jdbc.app.DB2Driver

    Netværkskonfigurationer:

        COM.ibm.db2.jdbc.net.DB2Driver

  Afslut
    Afslut logon til databasen, og vend tilbage til ikonbåndet.

  Annullér
    Annullér guiden.

  ## Opgaver

  ### Opret forbindelse til databasen

  Når du starter Guide til XML Extender-administration, vises logon-vinduet, og du logget på en database.

  1. Angiv den fuldstændige JDBC-adresse til den IBM DB2 UDB-datakilde, du opretter forbindelse til, i feltet Adresse.
  2. Angiv eller validér DB2-bruger-id og kodeord til den database, du opretter forbindelse til, i felterne Bruger-id og Kodeord.
  3. Skriv eller validér navnet på JDBC-styreprogrammet for den angivne adresse i feltet JDBC-styreprogram.
  4. Klik på Afslut for at oprette forbindelse til databasen og få vist ikonbåndet.

  ### Skift til en anden database

  1. Klik på Skift Database på ikonbåndet.
  2. Angiv den fuldstændige JDBC-adresse til den IBM DB2 UDB-datakilde, du opretter forbindelse til, i feltet Adresse.
  3. Angiv eller validér DB2-bruger-id og kodeord til den database, du opretter forbindelse til, i felterne Bruger-id og Kodeord.
  4. Skriv eller validér navnet på JDBC-styreprogrammet for den angivne adresse i feltet JDBC-styreprogram.
  5. Klik på Afslut for at oprette forbindelse til den ny database og få vist ikonbåndet. XML Extender afbryder forbindelsen til den oprindelige database og opretter forbindelse til den ny.

  # Ikonbånd til XML Extender-administration

  Ikonbåndet til Guide til XML Extender-administration giver adgang til guider, hvor du kan udføre administrationsopgaver, f.eks. aktivere en database, redigere DAD-filer (DAD - Data Access Definition) og aktivere XML-kolonner eller -grupper. Vælg den opgave, der skal startes en guide til.

  ## Vindueselementer

  Skift database
    Åbn et vindue, hvor du kan logge på en bestemt database. Du skal have forbindelse til en database for at gemme eller få adgang til XML-dokumenter. Når du er logget på en database, kan du skifte til en anden vha. ikonbåndet.

  Aktivér database/Deaktivér database
    Aktivér eller deaktiver en database for XML Extender. Trykknappen skifter mellem at aktivere og deaktivere databasen. For at aktivere databasen oprettes brugerdefinerede typer og funktioner, en DTD-referencetabel til lagring af DTD'er og oplysninger om disse og en USAGE-tabel til lagring af almindelige oplysninger om hver aktiveret kolonne i XML Extender. For at deaktivere en database slettes brugerdefinerede typer og funktioner, DTD-referencetabellen og USAGE-tabellen i XML Extender. Du skal deaktivere alle XML-kolonner og -grupper, før du kan deaktivere databasen.

  Importér DTD
    Åbn vinduet Importér DTD, hvor du kan importere en DTD-fil til DTD-opbevaringsstedet i den aktuelle database. Vha. DTD'en kan du validere XML-data i en XML-kolonne eller en XML-gruppe. Det er valgfrit for XML-kolonnedata, men nødvendigt for XML-gruppedata. |

  |Redigér DAD
    |Åbn vinduet Angiv DAD, hvor du kan redigere en eksisterende |DAD-fil eller oprette en ny. En DAD definerer, hvordan |XML-data grupperes og gemmes i DB2. Du kan definere |attributter og nøgleelementer i dine data, så der kan søges i dem. |XML-kolonne-DAD'er konverterer XML-kolonner til side tabeller for indeksering. |XML-gruppe-DAD'er konverterer DB2-data til XML-dokumentstrukturen.

  Arbejd med XML-kolonner
    |Åbn et vindue, hvor du kan tilføje en XML-kolonne, aktivere eller |deaktivere XML-kolonner i en tabel. Du kan gemme og få adgang til XML-data, |når en DB2-kolonne er aktiveret for XML-datatyper.

  Arbejd med XML-grupper
    Åbn et vindue, hvor du kan aktivere eller deaktivere XML-grupper i en database. I en gruppe kan du gemme eller få adgang til XML-data vha. et sæt relationelle tabeller.

  ## Opgaver

  Fra ikonbåndet kan du udføre følgende XML Extender-opgaver:

  - Opret forbindelse til en database, eller skift til en anden database
  - Aktivér eller deaktivér database
  - Importér DTD
  - |Redigér DAD
  - Arbejd med XML-kolonner
  - Arbejd med XML-grupper

  # Aktivér eller deaktivér database

  Vha. denne guide kan du aktivere eller deaktivere en database. Når du aktiverer en database, oprettes de brugerdefinerede typer og funktioner, lagrede procedurer og administrative USAGE-tabeller, der er nødvendige for at bruge XML Extender. Databasen skal være aktiveret, hvis du skal gemme, sammensætte eller opløse XML-dokumenter i databasen. Når du deaktiverer databasen, slettes de brugerdefinerede typer og funktioner, lagrede procedurer og administrative USAGE-tabeller.

  ## Opgave: Aktivér database

  Klik på Aktivér Database på ikonbåndet for at aktivere den aktuelle database. Hvis en database allerede er aktiveret, kan du vælge Deaktivér Database.

  Når databasen er deaktiveret, vises ikonbåndet igen.

  ## Opgave: Deaktivér database

  Klik på Deaktivér Database på ikonbåndet for at deaktivere den aktuelle database. Hvis der ikke er en aktiv database, kan du vælge Aktivér Database.

  Når databasen er aktiveret, vises ikonbåndet igen.

  # Importér DTD'er

  Vha. guiden kan du importere en DTD for at validere et XML-dokument, der er lagret i en XML-kolonne, eller sammensættes af DB2-data i en XML-gruppe.

  ## Vindueselementer

  DTD
    Skriv navnet på en DTD, eller klik på ... for at få vist en oversigt over tilgængelige DTD'er. Feltet skal udfyldes.

  DTD-id
    Angiv DTD-id'en. Id'en knytter DTD'en til XML-dokument-DAD'en og angiver dens placering. DTD-id'en er en id for DTD'en og kan være den sti, der angiver placeringen af DTD'en på det lokale system. DTD-id'en skal svare til den værdi, der er angivet i DAD-filen for <DTDID>-elementet. Feltet skal udfyldes.

  Author
    Skriv navnet på DTD-udgiveren. Navnet vises automatisk, hvis det er angivet i DTD-opbevaringsstedet. Feltet er valgfrit.

  Afslut
    DTD'en indsættes i DTD-opbevaringsstedet, og ikonbåndet vises igen.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ## Opgave: Importér DTD

  1. Klik på Importér DTD på ikonbåndet for at importere en DTD-fil til DTD-opbevaringsstedet i den aktuelle database. Guiden Importér DTD vises.
  2. Skriv navnet på DTD'en i feltet DTD, eller klik på ... for at søge efter en DTD-fil.
  3. Skriv DTD-id'en i feltet DTD-id.
  4. Valgfrit: Skriv navnet på udgiveren af DTD'en i feltet Author.

     Udgiverens navn vises automatisk, hvis det er angivet i DTD'en.

  5. Klik på Afslut for at indsætte DTD'en i DTD-opbevaringstabellen DB2XML.DTD_REF og vende tilbage til ikonbåndet.

  # Arbejd med DAD-filer

  Fra denne guide kan du oprette eller redigere DAD-filer for at definere, hvordan XML-dokumenter anvendes i DB2. DAD-filer anvendes til følgende:

  - Lagring af XML-dokumenter i kolonner og definition af sidetabeller, der er indekseret til hurtig strukturel søgning.
  - Sammensætning af XML-dokumenter fra en eller flere DB2-tabeller, der er defineret i en XML-gruppe.
  - Opløsning af XML-dokumenter i en eller flere DB2-tabeller, der er defineret i en XML-gruppe.

  Der er flere oplysninger i DB2 XML Extender Administration and Programming om fremgangsmåderne.

  ## Vindueselementer

  ### Angiv DAD - første trin for alle typer

  Filnavn
    Skriv navnet på en DAD, eller klik på ... for at få vist en oversigt over tilgængelige DAD'er. Lad feltet stå tomt, hvis du opretter en ny DAD. Hvis DAD-filen findes, vises dens type i feltet Type, og du kan vælge Næste.

  Type
    Hvis du opretter en ny DAD, skal du vælge en af følgende typer DAD-filer:
    - XML-kolonne, hvis du vil angive, hvordan dokumenter, der er lagret i en kolonne, skal indekseres.
    - XML SQL-gruppekonvertering, hvis der skal foretages konvertering mellem relationelle data og XML-dokumenter vha. en enkelt SQL-sætning.
    - XML RDB-gruppenodekonvertering, hvis der skal anvendes nodedefinitioner af tabeller, kolonner og betingelser til definition af, hvordan XML-data lagres.

  Næste
    Tryk på Næste, hvis du vil fortsætte til næste trin: Vælg validering.

  Afslut
    Aktiveres, når du afslutter oprettelse eller ændring af DAD-filer. Vælg Afslut for at afslutte behandlingen og vende tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Vælg validering - trin 2 for alle typer

  Validér XML-dokumenter med DTD'en
    Validér XML-dokumenter. Med gyldige dokumenter kan du udføre struktureret søgning i data. Dine dokumenter valideres mod den DTD, der er angivet i DAD-filen. Du bør validere XML-data, før du indsætter data i DB2, fordi du ikke kan validere data, der allerede er indsat i DB2.

  DTD-id
    Angiv DTD'en, eller vælg navnet i oversigten over DTD'er. Hvis du ikke har importeret nogen DTD'er til DTD-opbevaringsstedet for databasen, kan du ikke validere XML-dokumenter.

  |Validér ikke
    Fortsæt uden at validere XML-dokumenter.

  Forrige
    Gå til forrige trin: Angiv DAD

  Næste
    Gå til næste trin. Åbn vinduet Administrér sidetabeller, hvis du arbejder med XML-kolonner, eller vinduet Angiv SQL-sætning, hvis du arbejder med XML SQL-gruppekonvertering, eller vinduet Angiv tekst, hvis du arbejder med XML RDB-gruppenodekonvertering.

  Afslut
    Aktiveres, når du afslutter oprettelse eller ændring af DAD-filer. Vælg Afslut for at afslutte behandlingen og vende tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Sidetabeller - trin 3 for XML-kolonnetyper

  |Oversigt over eksisterende tabeller og kolonner
    |Tabellen indeholder en oversigt over sidetabeller, der skal oprettes, når |en XML-kolonne, der anvender denne DAD-fil, oprettes. Du kan vælge navnet |på en eksisterende tabel og kolonne, som du vil ændre eller fjeren, |eller du kan skrive et nyt navn i felterne nedenfor.

  Tabelnavn
    Skriv navnet på en ny sidetabel, der indeholder en kolonne. Hvis du vælger en kolonne i oversigten, vises den tilhørende tabel, som du kan ændre. Feltet skal udfyldes. F.eks.:

        ORDRE_SIDE_TAB

  Kolonnenavn
    Skriv kolonnenavnet. Hvis du har valgt en kolonne i oversigten, vises dens kolonnenavn, som du kan ændre. Feltet skal udfyldes. F.eks.:

        KUNDE_NAVN

  Type
    Vælg eller revidér kolonnetypen, f.eks. DATE, CHAR, INTEGER eller VARCHAR. Feltet skal udfyldes.

  Længde
    Hvis du vælger VARCHAR, kan du i dette felt angive det maksimale antal tegn for længden af kolonnen. Feltet er kun aktiveret, hvis typen er VARCHAR. F.eks.:

        30

  Sti
    Angiv eller revidér stien til et element eller en attribut. Feltet skal udfyldes. F.eks.:

        /ORDRE/KUNDE/NAVN

  Flere forekomster
    Markér afkrydsningsfeltet for at angive, om elementet eller kolonneattributten kan anvendes mere end én gang i et dokument eller kun én gang.

  Tilføj
    Gem tabellen eller kolonnen med de oplysninger, du angiver, og giver mulighed for at tilføje, ændre eller slette en tabel eller en kolonne.

  Revidér
    Gem de ændringer, du har udført i felterne Tabelnavn, Kolonnenavn, Type, Længde, Sti eller Flere forekomster. Når du ændrer navnet på en tabel eller kolonne, slettes det gamle element i oversigten, og det nye tilføjes.

  Fjern
    Fjern det aktuelt marerede element fra oversigten.

  Forrige
    Gå til forrige trin: Vælg validering

  Næste
    Gå til næste trin: Gem DAD.

  Afslut
    Aktiveres, når du afslutter oprettelse eller ændring af DAD-filer. Vælg Afslut for at afslutte behandlingen og vende tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Angiv tekst - trin 3 for SQL-konverteringstype eller RDB-nodekonverteringstype

  Prolog
    Skriv et prolognavn. Hvis du redigerer en DAD, vises navnet. Navnet skal være i formatet

        <?xml version="1.0" ?>

    Feltet skal udfyldes.

  Doctype
    Skriv XML-dokumentets type. Hvis du redigerer en DAD, vises dokumenttypen automatisk. Feltet skal udfyldes. F.eks.:

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

  Forrige
    Gå til forrige trin: Vælg validering

  Næste
    Gå til næste trin: Konvertér RDB-noder, hvis typen er RDB-nodekonvertering, eller Angiv SQL-sætning, hvis typen er SQL-konvertering.

  Afslut
    Aktiveres, når du afslutter oprettelse eller ændring af DAD-filer. Vælg Afslut for at afslutte behandlingen og vende tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Angiv SQL-sætning - trin 4 for SQL-konverteringstype

  SQL-sætning
    Skriv en SQL SELECT-sætning. Hvis du redigerer en DAD, vises SQL-sætningen. Sætningen konverterer kolonnerne i SELECT-udtrykket til XML-elementer eller -attributter i XML-dokumentet. FROM-udtrykket definerer tabellen, der indeholder data. WHERE-udtrykket angiver JOIN- og søgebetingelser. Alle tabellerne i gruppen skal kunne sammenkædes af én SELECT-sætning. Feltet skal udfyldes. F.eks.:

        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

    SQL-sætningen følger nedenstående retningslinier:

    - Kolonner angives i rækkefølgen fra øverst til nederst i henhold til det hierarki, der udgør XML-dokumentets struktur.
    - Kolonnerne i en entitet grupperes sammen, og hver gruppe har en objekt-id-kolonne.
    - Objekt-id-kolonnen er den første kolonne i hver gruppe.
    - Anvend den indbyggede DB2-funktion generate_unique for at generere tabeller, der ikke anvender en betingelseskolonne med en enkelt nøgle.
    - Objekt-id-kolonnerne vises i rækkefølge fra øverst til nederst i ORDER BY-sætninger. Kolonnerne i ORDER BY bør ikke kvalificeres af noget skema- eller tabelnavn, og må ikke svare til kolonnenavnene i SELECT-udtrykket.

  Test SQL
    Gyldigheden af SQL-sætningen testes. Hvis SQL-sætningen er gyldig, vises testresultaterne i feltet Testresultater. Hvis sætningen ikke er gyldig, får du vist en fejlmeddelelse. Ret sætningen, og prøv igen.

  Testresultater
    Vi ser testresultaterne fra testen af SQL-sætningen, hvis sætningen er gyldig. Feltet er skrivebeskyttet.

  Forrige
    Gå til forrige trin: Vælg validering

  Næste
    Gå til næste trin: Konvertér SQL

  Afslut
    Aktiveres, når du afslutter oprettelse eller ændring af DAD-filer. Vælg Afslut for at afslutte behandlingen og vende tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Konvertér SQL - trin 5 for SQL-konverteringstype

  DAD-konvertering
    Vælg den node, der skal konverteres fra, i den viste DAD-konvertering. Du kan konvertere elementer og attributter i XML-dokumentet til elementer og attributnoder, der svarer til DB2-data. Noden indeholder stien fra XML-data til DB2-data. Vælg en node for at aktivere Nyt element. Når du vælger en node, vises de tilhørende felter under Oplysninger.

  Nodetype
    Vælg en nodetype i oversigten over typer, der er gyldige i denne fase af konverteringen. Der vises forskellige felter under Oplysninger, alt efter hvilken nodetype du har valgt. Feltet skal udfyldes.

    Element
      Repræsenterer et XML-element, der er defineret i DTD'en, der er knyttet til XML-dokumentet, og bruges til at knytte XML-elementet til en kolonne i en DB2-tabel. En elementnode kan have attributnoder, underordnede elementnoder eller tekstnoder. En node på nederste niveau har tilknyttet en tekstnode og et kolonnenavn i træstrukturen.

    Attribut
      Repræsenterer en XML-attribut, der er defineret i DTD'en, der er knyttet til XML-dokumentet, og anvendes til at knytte en XML-attribut til en kolonne i en DB2-tabel. En attributnode kan have tilknyttet en tekstnode og har tilknyttet et kolonnenavn i træstrukturen.

    Tekst
      Angiver tekstindholdet for en elementnode. En tekstnode har tilknyttet et kolonnenavn i træstrukturen.

  Nodenavn
    Skriv nodenavnet. Feltet skal udfyldes. F.eks.:

        Ordre

  Kolonne
    Vælg et kolonnenavn, hvis du har valgt Attribut, Element eller Tekst som nodetype. Feltet skal udfyldes. Hvis du angiver Kolonne som nodetype, kan du kun vælge en kolonne, der allerede findes i DB2-databasen. F.eks.:

        Kunde_navn

  Tilføj
    Tilføj den relevante label til det tomme element, der er føjet til træstrukturen.

  Revidér
    Vælg Revidér, hvis du vil ændre den markerede node. Du kan senere vælge denne eller en anden node og foretage flere ændringer.

  Fjern
    Fjern det element eller den attribut, der er markeret.

  Nyt element
    Opret en ny node ved at slette felterne under Oplysninger, tilføj et tomt element under det aktuelt markerede i træstrukturen, og markér det nye tomme element.

  Forrige
    Gå til forrige trin: Angiv SQL-sætning

  Næste
    Gå til næste trin: Gem DAD.

  Afslut
    Aktiveres, når du afslutter oprettelse eller ændring af DAD-filer. Vælg Afslut for at afslutte behandlingen og vende tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Konvertér RDB-noder - trin 4 for RDB-nodekonverteringstype

  DAD-konvertering
    Vælg den node, der skal konverteres fra, i den viste DAD-konvertering. Du kan konvertere elementer og attributter i XML-dokumentet til elementer og attributnoder, der svarer til DB2-data. Noden indeholder stien fra XML-data til DB2-data. De angiver, hvilken tabel og kolonne der indeholder de pågældende data, og under hvilke betingelser du kan få disse data. Vælg en node for at aktivere Nyt element. Når du vælger en node, vises de tilhørende felter under Oplysninger.

  Nodetype
    Vælg en nodetype i oversigten over typer, der er gyldige i denne fase af konverteringen. Der vises forskellige felter under Oplysninger, alt efter hvilken nodetype du har valgt. Der kan vises Element, Attribut, Tekst, Tabel, Kolonne eller Betingelse, afhængig af hvad du har valgt i DAD-konverteringen. Feltet skal udfyldes.

    Element
      Repræsenterer et XML-element, der er defineret i DTD'en, der er knyttet til XML-dokumentet, og bruges til at knytte XML-elementet til en kolonne i en DB2-tabel. En elementnode kan have attributnoder, underordnede elementnoder, tekstnoder, tabelnoder eller betingelsesnoder. Et hovedelement har tabelnoder, der anvendes til at angive alle tabeller, der anvendes til at generere XML-dokumenter, og en betingelsesnode, der anvendes til at oprette forbindelse til tabellerne. Feltet skal udfyldes. F.eks.:

          element_node name="Order"

    Attribut
      Repræsenterer en XML-attributnode, der er defineret i DTD'en, der er knyttet til XML-dokumentet og anvendes til at knytte en XML-attribut til en kolonne i en DB2-tabel. En attributnode kan have tilknyttet en tekstnode og har tilknyttet et kolonnenavn i DAD-konverteringen. Data forbliver i attributnoden og tekstnoden for hvert element. Feltet skal udfyldes. F.eks.:

          attribute_node name="key"

      |

    |Tabel
      |Den tabel, der er knyttet til tekstnoden eller indholdet |af attributnoden. Det angiver navnet på en DB2-tabel, som indholdet |af tekstnoden eller attributnoden enten bliver gemt i eller hentet |fra. F.eks.:

          |tabelnodenavn=ordre_tab

      |

    |Kolonne
      |Den kolonne, der indeholder indholdet af tekstnoden eller |attributnoden. Det angivet navnet på en DB2-tabelkolonne, som|indholdet af tekstnoden eller attributnoden enten gemmes i eller |hentes fra. F.eks.:

          |kolonnenavn="ordre_key"

  Nodenavn
    Skriv navnet på et element eller en attribut. Feltet skal udfyldes. F.eks.:

        element_node name="Price"

  Tekst
    Angiver tekstindholdet i et element og kolonnedata i en relationel tabel for noder på nederste niveau. Indeholder et tabelelement og et kolonneelement. Hovednoden indeholder desuden et betingelseselement.

  Tabelnavn
    Navnet på den tabel, der indeholder kolonnen. F.eks.:

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

  Tabelnøgle
    Den primære nøgle for en tabel. Den består af en enkelt kolonne eller af flere kolonner (sammensat nøgle). Nøglen anvendes til at binde tabeller sammen i en gruppe. Eksempel på sammensat nøgle:

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

  Kolonne
    Navnet på den kolonne, der indeholder data for elementteksten, og som elementet og attributten er konverteret til. F.eks.:

        column name="order_key" type="integer"

  Betingelse
    Angiver den måde, XML-gruppetabeller skal sammenkædes på i hovedelementer. For elementer på lavere niveauer angiver den kriterier for valg af XML-data med værdier for "=", "<", ">" eller "LIKE". Eksempel på betingelse for hovedelement:

        order_tab.order_key = part_tab.order_key AND
        part_tabe.part_key = ship_tab.part._key

    Eksempel på kriterier for valg af XML-data:

        price > 2500.00

  Tilføj
    Tilføj den relevante label til det tomme element, der er føjet til træstrukturen.

  Revidér
    Vælg Revidér, hvis du vil ændre den markerede node. Du kan senere vælge denne eller en anden node og foretage flere ændringer.

  Fjern
    Fjern det element eller den attribut, der er markeret.

  Nyt element
    Opret en ny node ved at slette felterne under Oplysninger, tilføj et tomt element under det aktuelt markerede i træstrukturen, og markér det nye tomme element.

  Forrige
    Gå til forrige trin: Angiv tekst

  Næste
    Gå til næste trin: Gem DAD.

  Afslut
    Aktiveres, når du afslutter oprettelse eller ændring af DAD-filer. Vælg Afslut for at afslutte behandlingen og vende tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Gem DAD - sidste trin for alle typer

  Filnavn
    Skriv et navn på den ændrede eller nye DAD, som du vil gemme, eller klik på ... for at åbne den lokale browser, så du kan vælge, hvor DAD'en skal placeres. Feltet skal udfyldes.

  Forrige
    Gå til forrige trin.

  Afslut
    Gem DAD'en, og vend tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ## Opgaver

  ### Opret eller redigér DAD til XML-kolonner

  Når du opretter en DAD til en XML-kolonne, skal du angive datatypen for XML-dokumentet og definere sidetabeller, der anvendes til indeksering.

  1. |Klik på Redigér DAD på ikonbåndet for at redigereeller |oprette en XML DAD-fil. Guiden Arbejd med guide til DAD-filer åbnes, og vinduet |Angiv DAD vises.
  2. Vælg, om du vil redigere en DAD eller oprette en ny.
     - Sådan redigeres en DAD:
       1. Klik på ... for at få vist en oversigt over eksisterende DAD'er, eller skriv navnet på DAD-filen i feltet Filnavn.
       2. Kontrollér, at guiden genkender den angivne DAD.
          - Hvis guiden genkender den angivne DAD, kan du vælge Næste, og XML-kolonnen vises i feltet Type.
          - Hvis guiden ikke genkender DAD'en, kan du ikke vælge Næste. Skriv navnet på DAD'en i feltet Filnavn igen, eller klik på ... for at søge efter den. Fortsæt, til Næste kan vælges.
       3. Klik på Næste.
     - Sådan opretter du en ny DAD:
       1. Lad feltet Filnavn være tomt.
       2. Klik på XML-kolonne i oversigten Type.
       3. Klik på Næste.
  3. Vælg, om XML-dokumenter skal valideres med en DTD i vinduet Vælg validering.
     - Sådan validerer du:
       1. Klik på Validér XML-dokumenter med DTD'en.
       2. Vælg den DTD, der skal anvendes, i oversigten DTD-id.

       Hvis du ikke har importeret nogen DTD'er til DTD-opbevaringsstedet for databasen, kan du ikke validere XML-dokumenter.

     - Klik på |Validér IKKE. hvis du vil fortsætte uden at validere XML-dokumenter.
  4. Klik på Næste.
  5. Vælg, om du vil fjerne, redigere eller tilføje en ny sidetabel i vinduet Sidetabeller.
     - Sådan tilføjer du en nye sidetabel eller sidetabelkolonne:

       Definér kolonnerne i tabellen for at tilføje en ny sidetabel. Gør følgende for hver kolonne i sidetabellen:

       1. Udfyld felterne under Oplysninger i vinduet Sidetabeller.
          1. Tabelnavn: Skriv navnet på den tabel, der indeholder kolonnen.
          2. Kolonnenavn: Skriv kolonnenavnet.
          3. Type: Vælg en kolonnetype i oversigten.
          4. Længde (angår kun VARCHAR-typen): Angiv det maksimale antal VARCHAR-tegn.
          5. Sti: Angiv placeringen af elementet eller attributten.
          6. Flere forekomster: Vælg Nej eller Ja i oversigten.

             Vælg Ja, hvis elementet eller attributten skal kunne anvendes mere end én gang i et dokument. Bemærk: Hvis du angiver flere forekomster for en kolonne, kan du kun angive én kolonne i den sidetabel, der indeholder kolonnen.

       2. Klik på Tilføj for at tilføje kolonnen.
       3. Fortsæt med at tilføje, redigere eller fjerne kolonner i sidetabellen, eller klik på Næste.
     - Sådan redigerer du en sidetabelkolonne:

       Du kan opdatere en sidetabel ved at ændre definitionerne af dens kolonner.

       1. Klik på sidetabellen og den kolonne, du vil redigere.
       2. Redigér felterne under Oplysninger.
       3. Klik på Revidér for at gemme ændringerne.
       4. Fortsæt med at tilføje, redigere eller fjerne kolonner for hver sidetabel, eller klik på Næste.
     - Sådan fjerner du en sidetabelkolonne:
       1. Klik på de sidetabeller og kolonner, du vil fjerne.
       2. Vælg Fjern.
       3. Fortsæt med at tilføje, redigere eller fjerne sidetabelkolonner, eller klik på Næste.
     - Sådan fjerner du en sidetabelkolonne:

       Slet alle kolonner i sidetabellen for at slette tabellen.

       1. Klik på hver kolonne i den tabel, du vil fjerne.
       2. Vælg Fjern.
       3. Fortsæt med at tilføje, redigere eller fjerne sidetabelkolonner, eller klik på Næste.
  6. Skriv navnet på outputfilen for den ændrede DAD i feltet Filnavn i vinduet Angiv DAD.
  7. Klik på Afslut for at gemme DAD'en og vende tilbage til ikonbåndet.

  ### Opret eller redigér DAD til XML-grupper

  Når du opretter en DAD til XML-gruppen, skal du konvertere XML-dokumentet til DB2-datakilden på en af følgende måder:

  - Sammensæt en XML-fil vha. SQL-konvertering.
  - Sammensæt en XML-fil vha. RDB-nodekonvertering.
  - Opløs en XML-fil vha. RDB-nodekonvertering.

  #### Sammensæt en XML-fil vha. SQL-konvertering

  1. Klik på |Redigér DAD på ikonbåndet. Vinduet Angiv DAD vises.
  2. Vælg, om du vil redigere en DAD eller oprette en ny.

     Sådan opretter du en ny DAD:

     1. Lad feltet Filnavn være tomt.
     2. Vælg XML SQL-gruppekonvertering i oversigten Type.
     3. Klik på Næste for at åbne vinduet Vælg validering.

     Sådan redigeres en DAD:

     1. Skriv navnet på DAD'en i feltet Filnavn, eller klik på ... for at søge efter en.
     2. Kontrollér, at guiden genkender den angivne DAD.
        - Hvis guiden genkender den angivne DAD, kan du vælge Næste, og XML SQL-gruppekonvertering vises i feltet Type.
        - Hvis guiden ikke genkender DAD'en, kan du ikke vælge Næste. Skriv navnet på DAD'en igen, eller klik på ... for at søge efter den. Gentag de tidligere trin, til Næste kan vælges.
     3. Klik på Næste for at åbne vinduet Vælg validering.
  3. Vælg, om XML-dokumenter skal valideres med en DTD i vinduet Vælg validering.
     - Sådan validerer du:
       1. Klik på Validér XML-dokumenter med DTD'en.
       2. Vælg den DTD, der skal anvendes, i oversigten DTD-id.

       Hvis du ikke har importeret nogen DTD'er til DTD-opbevaringsstedet for databasen, kan du ikke validere XML-dokumenter.

     - Klik på |Validér IKKE. hvis du vil fortsætte uden at validere XML-dokumenter.
  4. Klik på Næste for at åbne vinduet Angiv tekst.
  5. Skriv navnet på prologen i feltet Prolog for at angive prologen til det XML-dokument, der skal sammensættes.

         <?xml version="1.0"?>

     Hvis du redigerer en DAD, vises prologen automatisk i feltet Prolog.

  6. Skriv XML-dokumentets type i feltet Doctype i vinduet Angiv tekst. Typen peger på DTD'en til XML-dokumentet. F.eks.:

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

     Hvis du redigerer en DAD, vises dokumenttypen automatisk i feltet Doctype.

  7. Klik på Næste for at åbne vinduet Angiv SQL-sætning.
  8. Skriv en gyldig SQL SELECT-sætning i feltet SQL-sætning.

     Hvis du redigerer en DAD, vises SQL-sætningen automatisk i feltet SQL-sætning.

  9. Klik på Test SQL for at teste gyldigheden af SQL-sætningen.
     - Hvis SQL-sætningen er gyldig, vises testresultaterne i feltet Testresultater.
     - Hvis SQL-sætningen ikke er gyldig, vises der en fejlmeddelelse i feltet Testresultater. I fejlmeddelelsen bliver du bedt om at rette SQL-sætningen og prøve igen.
  10. |Klik på Næste for at åbne vinduet Konvertér SQL.
  11. Vælg et element eller en attributnode, der skal konverteres fra, ved at klikke på den i feltet til venstre for vinduet |Konvertér SQL.

      Konvertér elementer og attributter i XML-dokumentet til elementer og attributnoder, der svarer til DB2-data. Noderne indeholder en sti fra XML-data til DB2-data.

      - Sådan tilføjes en hovednode:
        1. Vælg ikonen Hovednode.
        2. Klik på Nyt element for at definere en ny node.
        3. Angiv Nodetype som Element under Oplysninger.
        4. Skriv navnet på hovednoden i feltet Nodenavn.
        5. Klik på Tilføj for at oprette den ny node.

           Du har oprettet hovednoden eller -elementet, der er overordnet alle andre elementer og attributnoder i konverteringen. Du kan nu tilføje underordnede elementer og attributter til noden.

      - Sådan tilføjes et underordnet element eller en attributnode:
        1. Klik på en overordnet node i feltet til venstre for at tilføje et underordnet element eller en attribut.

           Hvis du ikke har valgt en overordnet node, kan Nyt Element ikke vælges.

        2. Klik på Nyt element.
        3. Vælg nodetypen i oversigten Nodetype under Oplysninger.

           Oversigten Nodetype viser kun de nodetyper, der er gyldige i denne fase af konverteringen.

        4. Skriv nodenavnet i feltet Nodenavn under Oplysninger.
        5. Hvis du som nodetype har angivet Attribut, Element eller Tekst for et element på nederste niveau, skal du vælge en kolonne i feltet Kolonne under Oplysninger.

           Bemærk: Nye kolonner kan ikke oprettes vha. administrationsguiden. Hvis du angiver Kolonne som nodetype, kan du kun vælge en kolonne, der allerede findes i DB2-databasen.

        6. Klik på Tilføj for at tilføje den ny node.

           Du kan senere ændre en node ved at klikke på den i feltet til venstre og redigere alle felter under Oplysninger. Klik på Revidér for at opdatere elementet.

           Du kan også tilføje underordnede elementer eller attributter til noden ved at markere den og gentage trinene for tilføjelse.

        7. Forsæt med at redigere SQL-konverteringen, eller klik på Næste for at åbne vinduet Angiv DAD.
      - Sådan fjerner du en node:
        1. Klik på en node i feltet til venstre.
        2. Vælg Fjern.
        3. Forsæt med at redigere SQL-konverteringen, eller klik på Næste for at åbne vinduet Angiv DAD.

        Bemærk, at hvis du fjerner en node på nederste niveau, bliver en anden node den nederste. Du skal så evt. definere en kolonne til den.

  12. Skriv navnet på outputfilen for den ændrede DAD i feltet Filnavn i vinduet Angiv DAD.
  13. Klik på Afslut for at vende tilbage til ikonbåndet.

  #### Sammensæt en XML-fil vha. RDB-nodekonvertering

  1. Klik på |Redigér DAD på ikonbåndet. Vinduet Angiv DAD vises.
  2. Vælg, om du vil redigere en DAD eller oprette en ny.

     Sådan redigeres en DAD:

     1. Skriv navnet på DAD'en i feltet Filnavn, eller klik på ... for at søge efter en.
     2. Kontrollér, at guiden genkender den angivne DAD.
        - Hvis guiden genkender den angivne DAD, kan du vælge Næste, og XML RDB-gruppenodekonvertering vises i feltet Type.
        - Hvis guiden ikke genkender DAD'en, kan du ikke vælge Næste. Skriv navnet på DAD'en i feltet Filnavn igen, eller klik på ... for at søge efter den. Fortsæt, til Næste kan vælges.
     3. Klik på Næste for at åbne vinduet Vælg validering.

     Sådan opretter du en ny DAD:

     1. Lad feltet Filnavn være tomt.
     2. Vælg XML RDB-gruppenodekonvertering i oversigten Type.
     3. Klik på Næste for at åbne vinduet Vælg validering.
  3. Vælg, om XML-dokumenter skal valideres med en DTD i vinduet Vælg validering.
     - Sådan validerer du:
       1. Klik på Validér XML-dokumenter med DTD'en.
       2. Vælg den DTD, der skal anvendes, i oversigten DTD-id.

       Hvis du ikke har importeret nogen DTD'er til DTD-opbevaringsstedet for databasen, kan du ikke validere XML-dokumenter.

     - Klik på |Validér IKKE. hvis du vil fortsætte uden at validere XML-dokumenter.
  4. Klik på Næste for at åbne vinduet Angiv tekst.
  5. Skriv navnet på prologen i feltet Prolog i vinduet Angiv tekst.

         <?xml version="1.0"?>

     Hvis du redigerer en DAD, vises prologen automatisk i feltet Prolog.

  6. Skriv XML-dokumentets type i feltet Doctype i vinduet Angiv tekst. F.eks.:

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

     Hvis du redigerer en DAD, vises dokumenttypen automatisk i feltet Doctype.

  7. |Klik på Næste for at åbne vinduet Konvertér RDB-noder.
  8. Vælg et element eller en attributnode, der skal konverteres fra, ved at klikke på den i feltet til venstre for |vinduet Konvertér RDB-noder.

     Konvertér elementer og attributter i XML-dokumentet til elementer og attributnoder, der svarer til DB2-data. Noderne indeholder en sti fra XML-data til DB2-data.

  9. Sådan tilføjes en hovednode:
     1. Vælg ikonen Hovednode.
     2. Klik på Nyt element for at definere en ny node.
     3. Angiv Nodetype som Element under Oplysninger.
     4. Skriv navnet på hovednoden i feltet Nodenavn.
     5. Klik på Tilføj for at oprette den ny node.

        Du har oprettet hovednoden eller -elementet, der er overordnet alle andre elementer og attributnoder i konverteringen. Hovednoden har underordnede tabelelementer og en sammenkædningsbetingelse.

        Tilføj tabelnoder for hver tabel, der er en del af gruppen.

        1. Markér hovednoden, og vælg Nyt element.
        2. Angiv Nodetype som Tabel under Oplysninger.
        3. Vælg tabellen i oversigten Tabelnavn. Tabellen skal være en en eksisterende tabel.
        4. Klik på Tilføj for at tilføje den ny node.
        5. Gentag trinene for hver tabel.

        Tilføj en sammenkædningsbetingelse for tabelnoden.

        1. Markér hovednoden, og vælg Nyt element.
        2. Angiv Nodetype som Betingelse under Oplysninger.
        3. Angiv sammenkædningsbetingelsen i feltet Betingelse vha. følgende syntaks:

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

           Medtag så mange betingelser som nødvendigt, sammenkædet med AND, for at oprette sammenkædningsbetingelsen.

        4. Klik på Tilføj for at tilføje betingelsen.

     Du kan nu tilføje underordnede elementer og attributter til noden.

  10. Sådan tilføjes et underordnet element eller en attributnode:
      1. Klik på en overordnet node i feltet til venstre for at tilføje et underordnet element eller en attribut.
      2. Klik på Nyt element. Hvis du ikke har valgt en overordnet node, kan Nyt Element ikke vælges.
      3. Vælg nodetypen i oversigten Nodetype under Oplysninger.

         Oversigten Nodetype viser kun de nodetyper, der er gyldige i denne fase af konverteringen, dvs. Element eller Attribut.

      4. Skriv navnet på elementet eller attributten i feltet Nodenavn.
      5. Hvis du har angivet Attribut som nodetype, eller Element for et element på nederste niveau, skal du vælge en kolonne i feltet Kolonne under Oplysninger.

         Bemærk: Nye kolonner kan ikke oprettes vha. administrationsguiden. Hvis du angiver Kolonne som nodetype, kan du kun vælge en kolonne, der allerede findes i DB2-databasen.

      6. Klik på Tilføj for at tilføje den ny node.

         Du kan senere ændre en node ved at klikke på den i feltet til venstre og redigere alle felter under Oplysninger. Klik på Revidér for at opdatere elementet.

         Du kan også tilføje underordnede elementer eller attributter til noden ved at markere den og gentage trinene for tilføjelse.

      7. Sådan konverterer du indholdet af et element eller en attributnode til en relationel tabel:
         1. Angiv en tekstnode.
            1. Klik på den overordnede node.
            2. Klik på Nyt element.
            3. Vælg Tekst i feltet Nodetype.
            4. Vælg Tilføj for at tilføje noden.
         2. Tilføj en tabelnode.
            1. Vælg den tekstnode, du har oprettet, og klik på Nyt element.
            2. Vælg Tabel i feltet Nodetype, og angiv tabelnavn for elementet.
            3. Klik på Tilføj for at tilføje noden.
         3. Tilføj en kolonnenode.
            1. Vælg tekstnoden igen, og klik på Nyt element.
            2. Vælg Kolonne i feltet Nodetype, og angiv kolonnenavn for elementet.
            3. Klik på Tilføj for at tilføje noden.

            Bemærk: Nye kolonner kan ikke oprettes vha. administrationsguiden. Hvis du angiver Kolonne som nodetype, kan du kun vælge en kolonne, der allerede findes i DB2-databasen.

         4. Tilføj evt. en betingelse for kolonnen.
            1. Vælg tekstnoden igen, og klik på Nyt element.
            2. Vælg Betingelse i feltet Nodetype, og betingelsen med syntaksen:

                   operator LIKE|<|>|= værdi

            3. Klik på Tilføj for at tilføje noden.
      8. Forsæt med at redigere RDB-nodekonverteringen, eller klik på Næste for at åbne vinduet Angiv DAD.
  11. Sådan fjerner du en node:
      1. Klik på en node i feltet til venstre.
      2. Vælg Fjern.
      3. Forsæt med at redigere RDB-nodekonverteringen, eller klik på Næste for at åbne vinduet Angiv DAD.
  12. Skriv navnet på outputfilen for den ændrede DAD i feltet Filnavn i vinduet Angiv DAD.
  13. Klik på Afslut for at fjerne noden og vende tilbage til ikonbåndet.

  #### Opløs en XML-fil vha. RDB-nodekonvertering

  1. Klik på |Redigér DAD på ikonbåndet. Vinduet Angiv DAD vises.
  2. Vælg, om du vil redigere en DAD eller oprette en ny.

     Sådan redigeres en DAD:

     1. Skriv navnet på DAD'en i feltet Filnavn, eller klik på ... for at søge efter en.
     2. Kontrollér, at guiden genkender den angivne DAD.
        - Hvis guiden genkender den angivne DAD, kan du vælge Næste, og XML RDB-gruppenodekonvertering vises i feltet Type.
        - Hvis guiden ikke genkender DAD'en, kan du ikke vælge Næste. Skriv navnet på DAD'en i feltet Filnavn igen, eller klik på ... for at søge efter den. Fortsæt, til Næste kan vælges.
     3. Klik på Næste for at åbne vinduet Vælg validering.

     Sådan opretter du en ny DAD:

     1. Lad feltet Filnavn være tomt.
     2. Vælg XML RDB-gruppenodekonvertering i oversigten Type.
     3. Klik på Næste for at åbne vinduet Vælg validering.
  3. Vælg, om XML-dokumenter skal valideres med en DTD i vinduet Vælg validering.
     - Sådan validerer du:
       1. Klik på Validér XML-dokumenter med DTD'en.
       2. Vælg den DTD, der skal anvendes, i oversigten DTD-id.

       Hvis du ikke har importeret nogen DTD'er til DTD-opbevaringsstedet for databasen, kan du ikke validere XML-dokumenter.

     - Klik på |Validér IKKE. hvis du vil fortsætte uden at validere XML-dokumenter.
  4. Klik på Næste for at åbne vinduet Angiv tekst.
  5. Hvis du kun opløser et XML-dokument, kan du ignorere feltet Prolog. Hvis du anvender DAD'en til både sammensætning og opløsning, skal du skrive navnet på prologen i feltet Prolog i vinduet Angiv tekst. Prologen er ikke nødvendig, når du opløser XML-dokumenter til DB2-data.

         <?xml version="1.0"?>

     Hvis du redigerer en DAD, vises prologen automatisk i feltet Prolog.

  6. Hvis du kun opløser et XML-dokument, kan du ignorere feltet Doctype. Hvis du anvender DAD'en til både sammensætning og opløsning, skal du skrive XML-dokumentets type i feltet Doctype.

     Hvis du redigerer en DAD, vises dokumenttypen automatisk i feltet Doctype. F.eks.:

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

  7. Klik på Næste for at åbne vinduet RDB-konvertering.
  8. Vælg et element eller en attributnode, der skal konverteres fra, ved at klikke på den i feltet til venstre for vinduet RDB-konvertering.

     Konvertér elementer og attributter i XML-dokumentet til elementer og attributnoder, der svarer til DB2-data. Noderne indeholder en sti fra XML-data til DB2-data.

  9. Sådan tilføjes en hovednode:
     1. Vælg ikonen Hovednode.
     2. Klik på Nyt element for at definere en ny node.
     3. Angiv Nodetype som Element under Oplysninger.
     4. Skriv navnet på hovednoden i feltet Nodenavn.
     5. Klik på Tilføj for at oprette den ny node.

        Du har oprettet hovednoden eller -elementet, der er overordnet alle andre elementer og attributnoder i konverteringen. Hovednoden har underordnede tabelelementer og en sammenkædningsbetingelse.

        Tilføj tabelnoder for hver tabel, der er en del af gruppen.

        1. Markér hovednoden, og vælg Nyt element.
        2. Angiv Nodetype som Tabel under Oplysninger.
        3. Vælg tabellen i oversigten Tabelnavn. Tabellen skal være en en eksisterende tabel.
        4. Angiv en nøglekolonne for tabellen i feltet Tabelnøgle.
        5. Klik på Tilføj for at tilføje den ny node.
        6. Gentag trinene for hver tabel.

        Tilføj en sammenkædningsbetingelse for tabelnoden.

        1. Markér hovednoden, og vælg Nyt element.
        2. Angiv Nodetype som Betingelse under Oplysninger.
        3. Angiv sammenkædningsbetingelsen i feltet Betingelse vha. følgende syntaks:

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

        4. Klik på Tilføj for at tilføje betingelsen.

     Du kan nu tilføje underordnede elementer og attributter til noden.

  10. Sådan tilføjes et underordnet element eller en attributnode:
      1. Klik på en overordnet node i feltet til venstre for at tilføje et underordnet element eller en attribut.

         Hvis du ikke har valgt en overordnet node, kan Nyt element ikke vælges.

      2. Klik på Nyt element.
      3. Vælg nodetypen i oversigten Nodetype under Oplysninger.

         Oversigten Nodetype viser kun de nodetyper, der er gyldige i denne fase af konverteringen, dvs. Element eller Attribut.

      4. Klik på Tilføj for at tilføje den ny node. Du kan senere ændre en node ved at klikke på den i feltet til venstre og redigere alle felter under Oplysninger. Klik på Revidér for at opdatere elementet.
      5. Sådan konverterer du indholdet af et element eller en attributnode til en relationel tabel:
         1. Angiv en tekstnode.
            1. Klik på den overordnede node.
            2. Klik på Nyt element.
            3. Vælg Tekst i feltet Nodetype.
            4. Vælg Tilføj for at tilføje noden.
         2. Tilføj en tabelnode.
            1. Vælg den tekstnode, du har oprettet, og klik på Nyt element.
            2. Vælg Tabel i feltet Nodetype, og angiv tabelnavn for elementet.
            3. Klik på Tilføj for at tilføje noden.
         3. Tilføj en kolonnenode.
            1. Vælg tekstnoden igen, og klik på Nyt element.
            2. Vælg Kolonne i feltet Nodetype, og angiv kolonnenavn for elementet.
            3. Angiv basistypen for kolonnen i feltet Type for at angive, hvilken type kolonnen skal være for at lagre uformaterede data.
            4. Klik på Tilføj for at tilføje noden.

            Bemærk: Nye kolonner kan ikke oprettes vha. administrationsguiden. Hvis du angiver Kolonne som nodetype, kan du kun vælge en kolonne, der allerede findes i DB2-databasen.

         4. Tilføj evt. en betingelse for kolonnen.
            1. Vælg tekstnoden igen, og klik på Nyt element.
            2. Vælg Betingelse i feltet Nodetype, og betingelsen med syntaksen:

                   operator LIKE|<|>|= værdi

            3. Klik på Tilføj for at tilføje noden.
      6. Forsæt med at redigere RDB-nodekonverteringen, eller klik på Næste for at åbne vinduet Angiv DAD.
  11. Sådan fjerner du en node:
      1. Klik på en node i feltet til venstre.
      2. Vælg Fjern.
      3. Forsæt med at redigere RDB-nodekonverteringen, eller klik på Næste for at åbne vinduet Angiv DAD.
  12. Skriv navnet på outputfilen for den ændrede DAD i feltet Filnavn i vinduet Angiv DAD.
  13. Klik på Afslut for at fjerne noden og vende tilbage til ikonbåndet.

  # Arbejd med XML-kolonner

  Fra guiden kan du tilføje, aktivere eller deaktivere XML-kolonner til XML Extender.

  ## Vindueselementer

  ### Vælg opgave (kolonner)

  Tilføj XML-kolonne
    Vælg Tilføj XML-kolonne for at åbne vinduet Tilføj XML-kolonne, hvor du kan tilføje en kolonne til tabellen. Kolonnen skal indeholde et intakt XML-dokument. Du kan kun anvende funktionen, hvis databasen er aktiveret.

  |Aktivér XML-kolonne
    Vælg Aktivér XML-kolonne for at åbne |vinduet Aktivér XML-kolonne, hvor du kan oprette forbindelse til en database og aktivere en XML-kolonne, så den kan indeholde brugerdefinerede typer til XML Extender. Du kan kun anvende funktionen, hvis databasen er aktiveret, og der er oprettet kolonner til XML-dokumenter.

  |Deaktivér XML-kolonne
    Vælg Deaktivér kolonne for at åbne |vinduet Deaktivér XML-kolonne, hvor du kan deaktivere en kolonne. Du kan ikke vælge funktionen, hvis databasen ikke er aktiveret, eller der ikke findes en aktiveret XML-kolonne. En deaktiveret kolonne kan ikke længere indeholde XML-dokumenter. Du skal deaktivere en XML-kolonne, før du sletter en XML-tabel. Hvis en tabel er slettet, og XML-kolonnen ikke er deaktiveret, bevares de sidetabellerne, der er oprettet i XML Extender, og XML-kolonneangivelserne i XML USAGE-tabellen.

  Næste
    Det vindue, du har valgt, åbnes, så du kan tilføje, aktivere eller deaktivere en XML-kolonne.

  Afslut
    Kan vælges, når du har afsluttet arbejdet med kolonnen.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Tilføj XML-kolonne

  Tabelnavn
    Skriv tabelnavnet, eller vælg navnet i oversigten over tabeller. Tabellen skal være defineret, før du kan tilføje en XML-kolonne. F.eks.:

        SALG_DB

  Kolonnenavn
    Skriv navnet på XML-kolonnen. F.eks.:

        ORDRE

  |Datatype
    Vælg en datatypen på oversigten over tilgængelige typer, f.eks. XMLCLOB, XMLVARCHAR eller XMLFILE. F.eks.:

        XMLVARCHAR

  Forrige
    Vinduet Vælg opgave, som du anvendte til arbejdet med XML-kolonner, åbnes.

  Afslut
    XML-kolonnen tilføjes, og du vender tilbage til ikonbåndet.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Aktivér XM-kolonne

  Tabelnavn
    Angiv navnet på den tabel, der indeholder en XML-kolonne, eller vælg navnet i oversigten over tilgængelige tabeller. Eksempel:

        SALG_TAB

  Kolonnenavn
    Skriv navnet på en XML-kolonne i tabellen, eller vælg navnet i oversigten over tilgængelige kolonner. F.eks.:

        ORDRE

  DAD-filnavn
    Angiv placeringen af DAD'en, der konverterer XML-dokumenter til XML-kolonner og sidetabeller, eller klik på ... for at søge efter en DAD-fil. F.eks.:

        c:\dxx\eksempler\dad\getstart.dad

  Tablespace
    Valgfrit: Skriv navnet på et tidligere oprettet tablespace til sidetabeller, der er knyttet til XML-kolonnen. Hvis tablespacet ikke er angivet, anvendes et standardtablespace.

  Standardudpluk
    Valgfrit: Skriv navnet på et standardudpluk, der sammenkæder XML-tabeller og alle beslægtede sidetabeller.

  |Root-id
    Anbefales, men er valgfrit: Skriv kolonnenavnet for den primære nøgle i tabellen for at knytte alle sidetabeller til applikationstabellen. Hvis du ikke angiver en hovednode-id, tilføjes kolonnen DXXROOT_ID til tabellen, og der genereres en id.

  Forrige
    Vinduet Vælg opgave, som du anvendte til arbejdet med XML-kolonner, åbnes.

  Afslut
    XML-kolonnen aktiveres, og du vender tilbage til ikonbåndet. XML Extender undersøger, om XML-tabellen har en primærnøgle, opretter de sidetabeller, der er angivet i DAD-filen, og opretter et standardudpluk for XML-tabeller og sidetabeller for at aktivere kolonnen.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Deaktivér XML-kolonne

  Tabelnavn
    Angiv navnet på den tabel, der indeholder XML-kolonnen, eller vælg navnet i oversigten over tilgængelige tabeller.

  Kolonnenavn
    Skriv navnet på en XML-kolonne i tabellen, eller vælg navnet i oversigten over tilgængelige kolonner.

  Forrige
    Vinduet Vælg opgave, som du anvendte til arbejdet med XML-kolonner, åbnes.

  Afslut
    XML-kolonnen deaktiveres, og du vender tilbage til ikonbåndet. En deaktiveret XML-kolonne kan ikke længere indeholde XML-dokumenter.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ## Opgaver

  ### Tilføj XML-kolonne

  1. Klik på Arbejd med XML-kolonner på ikonbåndet. Vinduet Vælg opgave åbnes.
  2. Klik på Tilføj XML-kolonne. Vinduet Tilføj XML-kolonne åbnes.
  3. Vælg navnet på tabellen i oversigten Tabelnavn, eller skriv navnet på den tabel, du vil ændre.
  4. Skriv navnet på den kolonne, der skal tilføjes, i feltet Kolonnenavn.
  5. Vælg den brugerdefinere type for kolonne i oversigten |Datatype.
  6. Klik på Afslut for at tilføje XML-kolonnetypen.

  ### Aktivér XML-kolonne

  1. Klik på Arbejd med XML-kolonner på ikonbåndet for at få vist andre opgaver for kolonner i XML Extender. Vinduet Vælg opgave åbnes.
  2. Klik på |Aktivér XML-kolonne og Næste for at aktivere en eksisterende tabelkolonne i databasen.
  3. Vælg den tabel, der indeholder XML-kolonnen, i feltet Tabelnavn.
  4. Vælg den kolonne, der skal aktiveres, i feltet Kolonnenavn. Kolonnen skal findes og være en XML-type.
  5. Skriv stien til DAD-filen og dens navn i feltet DAD-filnavn, eller klik på ... for at søge efter en DAD-fil.
  6. Valgfrit: Skriv navnet på et tablespace i feltet Tablespace.

     Tablespacet indeholder sidetabeller, som XML Extender har oprettet. Hvis du angiver et tablespace, oprettes sidetabellerne i det angivne tablespace. Hvis du ikke angiver et tablespace, oprettes sidetabellerne i standardtablespacet.

  7. Valgfrit: Skriv navnet på et standardudpluk i feltet Standardudpluk.

     Når det er angivet, oprettes standardudplukket automatisk, når kolonnen aktiveres, Udplukket sammenkæder XML-tabellen med alle tilhørende sidetabeller.

  8. Valgfrit: Skriv kolonnenavnet for den primære nøgle i applikationstabellen i feltet Hovednode-id. Anbefales.

     XML Extender anvender værdien for hovednode-id som en entydig id til at knytte alle sidetabeller til applikationstabellen. Hvis du ikke angiver en hovednode-id, tilføjes kolonnen DXXROOT_ID til tabellen, og der genereres en id.

  9. Klik på Afslut for at aktivere XML-kolonnen, oprette sidetabeller og vende tilbage til ikonbåndet.
     - Hvis kolonnen aktiveres, får du vist en meddelelse om, at `kolonnen er aktiveret`.
     - Hvis kolonnen ikke kan aktiveres, vises en fejlmeddelelse. Ret værdierne i felterne, til kolonnen kan aktiveres.

  ### Deaktivér XML-kolonne

  1. Klik på Arbejd med XML-kolonner på ikonbåndet for at få vist andre opgaver for kolonner i XML Extender. Vinduet Vælg opgave åbnes.
  2. Klik på |Deaktivér XML-kolonne og Næste i vinduet Vælg opgave for at deaktivere tabelkolonnen i databasen.
  3. Vælg den tabel, der indeholder XML-kolonnen, i feltet Tabelnavn.
  4. Vælg den kolonne, der skal deaktiveres, i feltet Kolonnenavn.
  5. Klik på Afslut.
     - Hvis kolonnen kan deaktiveres, får du vist en meddelelse om, at `kolonnen er deaktiveret`.
     - Hvis kolonnen ikke er deaktiveret, får du vist en fejlmeddelelse. Ret værdierne i felterne, til kolonnen er deaktiveret.

  # Arbejd med XML-grupper

  Vha. denne guide kan du aktivere eller deaktivere XML-grupper.

  ## Vindueselementer

  ### Vælg opgave (grupper)

  Aktivér XML-gruppe
    Vælg Aktivér XML-gruppe for at åbne vinduet Aktivér XML-gruppe. Når du aktiverer en XML-gruppe, analyseres (parse) DAD-filen for at finde tabeller og kolonner, der er knyttet til XML-dokumenter, og kontroloplysninger om records. Du kan kun anvende funktionen, hvis databasen er aktiveret, og der findes en DAD-fil.

  Deaktivér XML-gruppe
    Vælg Deaktivér XML-gruppe for at åbne vinduet Deaktivér XML-gruppe, hvor du kan fjerne markeringer, der angiver tabeller og kolonner som en del af en XML-gruppe. Du kan ikke vælge funktionen, hvis gruppen ikke er aktiveret.

  Næste
    Det vindue, du har valgt, åbnes, så du kan aktivere eller deaktivere en XML-gruppe.

  Afslut
    Kan vælges, når du har afsluttet arbejdet med gruppen.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Aktivér XML-gruppe

  Navn på gruppe
    Skriv navnet på den XML-gruppe, du vil aktivere.

  DAD-filnavn
    Skriv navnet på den DAD, der konverterer strukturen i XML-dokumentet til DB2-tabeller, som du kan anvende til at sammensætte eller opløse et dokument, eller klik på ... for at søge efter en DAD-fil.

  ...
    Vinduet Søg åbnes, hvor du kan vælge en DAD.

  Tablespace
    Skriv navnet på et tidligere oprettet tablespace, hvis det findes. Tablespacet indeholder nye DB2-tabeller, der er genereret til sammensætning og opløsning.

  Forrige
    Vinduet Vælg opgave, som du anvendte til arbejdet med XML-grupper, åbnes.

  Afslut
    XML-gruppen aktiveres, og du vender tilbage til ikonbåndet. XML Extender anvender DAD-filen til at finde XML-dokumentets tabeller og kolonner og kontroloplysninger om records i tabellen XML_USAGE for at aktivere gruppen.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ### Deaktivér XML-gruppe

  Navn på gruppe
    Skriv navnet på den XML-gruppe, du vil deaktivere i oversigten over grupper.

  Forrige
    Vinduet Vælg opgave, som du anvendte til arbejdet med XML-grupper, åbnes.

  Afslut
    XML-gruppen deaktiveres, og du vender tilbage til ikonbåndet. De markeringer, der angiver tabeller og kolonner som en del af en XML-gruppe, fjernes for at deaktivere gruppen.

  Annullér
    Guiden annulleres, og du får vist ikonbåndet igen.

  ## Opgaver

  ### Aktivér XML-gruppe

  1. Klik på Arbejd med XML-grupper på ikonbåndet. Vinduet Vælg opgave åbnes.
  2. Klik på |Aktivér XML-gruppe og Næste. Vinduet Aktivér gruppe åbnes.
  3. Skriv navnet på den gruppe, du vil aktivere, i feltet Gruppenavn, eller vælg en gruppe i oversigten.
  4. Angiv en DAD i feltet DAD-filnavn, eller klik på ... for at søge efter en DAD.
  5. Valgfrit: Skriv navnet på et tablespace i feltet Tablespace.

     Tablespacet indeholder nye DB2-tabeller, der er genereret til opløsning.

  6. Klik på Afslut for at aktivere gruppen og vende tilbage til ikonbåndet.
     - Hvis gruppen aktiveres, får du vist en meddelelse om, at `gruppen er aktiveret`.
     - Hvis gruppen ikke kan aktiveres, vises en fejlmeddelelse. Ret værdierne i felterne, til gruppen er aktiveret.

  ### Deaktivér XML-gruppe

  1. Klik på Arbejd med XML-grupper på ikonbåndet for at få vist andre opgaver for grupper i XML Extender. Vinduet Vælg opgave åbnes.
  2. Klik på Deaktivér XML-gruppe og derefter på Næste for at deaktivere en XML-gruppe. Vinduet Deaktivér gruppe åbnes.
  3. Skriv navnet på den gruppe, du vil deaktivere, i feltet Gruppenavn.
  4. Klik på Afslut for at deaktivere gruppen og vende tilbage til ikonbåndet.
     - Hvis gruppen deaktiveres, får du vist en meddelelse om, at `gruppen er deaktiveret`.
     - Hvis gruppen ikke kan deaktiveres, vises en fejlmeddelelse. Ret værdierne i felterne, til gruppen er deaktiveret.