# Hjelp til veiviser for XML Extender Administration

# Innhold

Tilkobling til en database

- Felt og kontroller
- Oppgaver
- Tilkobling til databasen
- Bytte til en annen database

  Bruke startpanelet til XML Extender Administration

- Felt og kontroller
- Oppgaver

  Aktivere eller deaktivere en database

- Oppgave: Aktivere en database
- Oppgave: Deaktivere en database

  Importere DTDer

- Felt og kontroller
- Oppgave: Importere en DTD

  Arbeide med DAD-filer

- Felt og kontroller
- Oppgi en DAD - første trinn for alle typer
- Velg validering - trinn 2 for alle typer
- Tilleggstabeller - trinn 3 for XML-kolonnetype
- Spesifiser tekst - trinn 2 for SQL-tilordningstype eller RDB-nodetilordningstype
- Spesifiser SQL-setning - trinn 4 for SQL-tilordningstype
- SQL-tilordning - trinn 5 for SQL-tilordningstype
- RDB-nodetilordning - trinn 4 for RDB-nodetilordningstype
- Lagre en DAD - siste trinn for alle typer
- Oppgaver
- Opprette eller redigere en DAD for XML-kolonner
- Opprette eller redigere en DAD for XML-samlinger

  Arbeide med XML-kolonner

- Felt og kontroller
- Velg en oppgave (for kolonner)
- Tilføy en XML-kolonne
- Aktiver en XML-kolonne
- Deaktiver en XML-kolonne
- Oppgaver
- Tilføy en XML-kolonne
- Aktiver en XML-kolonne
- Deaktiver en XML-kolonne

  Arbeide med XML-samlinger

- Felt og kontroller
- Velg en oppgave (for samlinger)
- Aktiver en XML-samling
- Deaktiver en XML-samling
- Oppgaver
- Aktivere en XML-samling
- Deaktivere en XML-samling

  # Tilkobling til en database

  Fra denne veiviseren kan du koble deg til databasen som inneholder eller skal inneholde XML-data.

  ## Felt og kontroller

  Adresse
    Oppgi navnet på JDBC-databasen du vil koble deg til, eller velg en adresse fra listen. Veiviseren utfører sanntidsoppgaver i den databasen. Hvis du velger fra listen, blir bruker-IDen og JDBC-styreprogrammet som sist var tilknyttet denne adressen, vist i feltene nedenfor. Dette feltet er obligatorisk. Adressen har denne syntaksen:

    For frittstående konfigurasjoner (anbefalt):

        jdbc:db2:databasenavn

    der

    databasenavn
      Databasen som du kobler deg til og lagrer XML-dokumenter på.

    Eksempel:

        jdbc:db2:sales_db

    For nettverkskonfigurasjoner:

        jdbc:db2://vert:portnummer/databasenavn

    der

    vert
      Er navnet på tjeneren der XML Extender finnes.

    portnummer
      Er portnummeret som brukes til å koble deg til tjeneren. Du finner portnummeret ved å oppgi denne kommandoen fra DB2-kommandolinjen på tjenermaskinen:

          db2jstrt port#

    databasenavn
      Databasen som du kobler deg til og lagrer XML-dokumenter på.

    Eksempel:

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

  Bruker-ID
    Oppgi eller bekreft bruker-IDen du bruker til å gå inn på databasen. Dette feltet er obligatorisk.

  Passord
    Oppgi passordet du bruker til å gå inn på databasen. Dette feltet er obligatorisk.

  JDBC-styreprogram
    Oppgi eller bekreft plasseringen av styreprogrammet til databasen. Dette feltet er obligatorisk. Styreprogrammet bør ha en av disse verdiene:

    For frittstående konfigurasjoner (standard):

        COM.ibm.db2.jdbc.app.DB2Driver

    For nettverkskonfigurasjoner:

        COM.ibm.db2.jdbc.net.DB2Driver

  Fullfør
    Fullfører påloggingen til en database og åpner startpanelet.

  Avbryt
    Avbryter veiviseren.

  ## Oppgaver

  ### Tilkobling til databasen

  Når du starter veiviseren for XML Extender Administration, åpnes påloggingsvinduet og du kobler deg til en database.

  1. I feltet Adresse oppgir du den fullstendige JDBC-adressen til IBM DB2 UDB-datakilden som du skal koble deg til.
  2. I feltene Bruker-ID og Passord oppgir du eller bekrefter bruker-IDen og passordet i DB2 for databasen du kobler deg til.
  3. I feltet JDBC-styreprogram oppgir eller bekrefter du navnet på JDBC-styreprogrammet for den oppgitte adressen.
  4. Klikk på Fullfør for å koble deg til databasen og gå til startpanelet.

  ### Bytte til en annen database

  1. Fra startpanelet klikker du på Bytt Database.
  2. I feltet Adresse oppgir du den fullstendige JDBC-adressen til IBM DB2 UDB-datakilden som du skal koble deg til.
  3. I feltene Bruker-ID og Passord oppgir du eller bekrefter bruker-IDen og passordet i DB2 for databasen du kobler deg til.
  4. I feltet JDBC-styreprogram oppgir eller bekrefter du navnet på JDBC-styreprogrammet for den oppgitte adressen.
  5. Klikk på Fullfør for å koble deg til den nye databasen og gå tilbake til startpanelet. XML Extender koble deg fra den opprinnelige databasen og kobler deg til den nye databasen.

  # Bruke startpanelet til XML Extender Administration

  Startpanelet til veiviseren for XML Extender Administration (startpanelet) gir deg tilgang til veivisere som hjelper deg å fullføre administrative oppgaver, for eksempel aktivere en database, redigere en DAD-fil (Data Access Definition) og aktivere XML-kolonner eller -samlinger. Velg et oppgavenavn som du vil starte veiviseren for.

  ## Felt og kontroller

  Bytt database
    Åpner et vindu for pålogging til en bestemt database. Hvis du skal lagre eller ha tilgang til XML-dokumenter, må du være tilkoblet en database. Etter at du har logget deg på en database, kan du bytte til en annen database fra startpanelet.

  Aktiver database/Deaktiver database
    Aktiverer eller deaktiverer en database for XML Extender. Denne knappen er en veksletast og endres avhengig av om databasen er aktivert eller ikke. XML Extender aktiverer databasen ved å opprette UDTer, en DTD-referansetabell for lagring av DTDer og informasjon om hver DTD, og en brukstabell for lagring av felles informasjon for hver aktivert kolonne. Når XML Extender skal deaktivere en database, sletter det UDTer, UDFer, DTD-referansetabellen og XML-brukstabellen. Du må deaktivere alle XML-kolonner og -samlinger før du forsøker å deaktivere en database.

  Importer en DTD
    Åpner vinduet Importer en DTD for import av en eksisterende DTD-fil (Document Type Definition) til DTD-lageret for den gjeldende databasen. DTDen lar deg validere XML-data i en XML-kolonne eller i en XML-samling. Det er valgfritt for XML-kolonnedata, men obligatorisk for XML-samlingsdata.

  Rediger DAD
    Åpner vinduet Oppgi en DAD for redigering av en eksisterende DAD-fil (Document Access Definition) eller oppretting av en ny DAD-fil. DAD-filen definerer hvordan XML-data skal samles inn og lagres i DB2. Den lar deg definere attributter og nøkkelelementer for dataene dine, slik at du kan søke i dem. DAD-filen for XML-kolonne tilordner XML-kolonnen til tilleggstabeller for indeksering. DAD-filen for XML-samling tilordner DB2-data til XML-dokumentstrukturen.

  Arbeid med XML-kolonner
    Åpner et vindu der du kan tilføye en XML-kolonne, aktivere en XML-kolonne eller deaktivere en XML-kolonne i en tabell. Du lagrer og går inn på XML-data ved å aktivere en DB2-kolonne for XML-datatyper.

  Arbeid med XML-samlinger
    Åpner et vindu der du kan aktivere eller deaktivere en XML-samling i en database. I en samling lagrer du og går inn på XML-data ved hjelp av et sett med relasjonstabeller.

  ## Oppgaver

  Fra startpanelet kan du fullføre disse XML Extender-oppgavene:

  - Logg deg på en database eller bytt til en annen database
  - Aktiver eller deaktiver database
  - Importer en DTD
  - Rediger DAD
  - Arbeid med XML-kolonner
  - Arbeid med XML-samlinger

  # Aktivere eller deaktivere en database

  Fra denne veiviseren kan du aktivere eller deaktivere en database. Når du aktiverer en database, opprettes UDTene, UDFene, lagrede prosedyrer og støttetabeller for administrering som kreves når du bruker XML Extender. Du må aktivere databasen for å lagre, sette sammen eller oppløse XML-dokumenter i databasen. Når du deaktiverer en database, slettes UDTene, UDFene, lagrede prosedyrer og støttetabeller for administrering.

  ## Oppgave: Aktivere en database

  Klikk på Aktiver Database fra startpanelet for å aktivere den gjeldende databasen. Hvis en database allerede er aktivert, er valget Deaktiver Database tilgjengelig.

  Når databasen er aktivert, kommer du tilbake til startpanelet.

  ## Oppgave: Deaktivere en database

  Klikk på Deaktiver Database fra startpanelet for å deaktivere den gjeldende databasen. Hvis en database allerede er deaktivert, er valget Aktiver Database tilgjengelig.

  Når databasen er deaktivert, kommer du tilbake til startpanelet.

  # Importere DTDer

  Fra denne veiviseren kan du importere en DTD for å validere et XML-dokument som er lagret i en XML-kolonne, eller som blir satt sammen av DB2-data i en XML-samling.

  ## Felt og kontroller

  DTD-filnavn
    Oppgi DTD-filnavnet eller klikk på ... for å bla gjennom en liste over tilgjengelige DTDer. Dette feltet er obligatorisk.

  DTD-ID
    Oppgi navnet på DTD-IDen. IDen knytter DTDen til DAD-filen for XML-dokumentet og oppgir plasseringen av den. DTD-IDen er en identifikator for DTDen og kan være banen som oppgir plasseringen av DTD-filen på det lokale systemet. DTD-IDen må stemme overens med verdien som er oppgitt i DAD-filen for <DTDID>-elementet. Dette feltet er obligatorisk.

  Forfatter
    Oppgi navnet på DTD-forfatteren. Navnet blir automatisk vist hvis det er oppgitt i DTD-lageret. Dette feltet er valgfritt.

  Fullfør
    Setter DTDen inn i DTD-lageret og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ## Oppgave: Importere en DTD

  1. Klikk på Importer en DTD fra startpanelet for å importere en eksisterende DTD-fil til DTD-lageret for den gjeldende databasen. Veiviseren Importer en DTD blir vist.
  2. Oppgi DTD-filnavnet i feltet DTD-filnavn eller klikk på ... for å bla gjennom en liste over eksisterende DTD-filer.
  3. Oppgi DTD-IDen i feltet DTD-ID.
  4. Du kan også velge å oppgi navnet på forfatteren av DTDen i feltet Forfatter.

     XML Extender viser automatisk forfatterens navn hvis det er oppgitt i DTD-filen.

  5. Klikk på Fullfør for å sette DTDen inn i DTD-lagertabellen DB2XML.DTD_REF og gå tilbake til startpanelet.

  # Arbeid med DAD-filer

  Fra denne veiviseren kan du opprette eller redigere DAD-filer for å definere hvordan XML-dokumenter skal brukes med DB2. DAD-filer brukes til dette:

  - Lagre XML-dokumenter i kolonner og definere tilleggstabeller som blir indeksert for struktursøk.
  - Sette sammen XML-dokumenter fra en eller flere DB2-tabeller, som blir definert i en XML-samling.
  - Oppløse XML-dokumenter i en eller flere DB2-tabeller, som blir definert i en XML-samling.

  Slå opp i DB2 XML Extender Administration and Programming for å lese mer om disse teknikkene.

  ## Felt og kontroller

  ### Oppgi en DAD - første trinn for alle typer

  Filnavn
    Oppgi en eksisterende DAD-fil eller klikk på ... for å bla deg frem til navnet på en eksisterende DAD-fil. Hvis du oppretter en ny DAD-fil, lar du feltet stå tomt. Hvis DAD-filen finnes, blir typen DAD-fil vist i Type og du kan velge Neste.

  Type
    Hvis du oppretter en ny DAD-fil, velger du en av disse typene DAD-fil:
    - XML-kolonne for å oppgi hvordan dokumenter som er lagret i en kolonne, skal indekseres
    - SQL-tilordning for XML-samling for å sørge for tilordning mellom relasjonsdata og XML-dokumenter gjennom en enkelt SQL-setning
    - RDB-nodetilordning for XML-samling for å sørge for nodedefinisjoner for tabeller, kolonner og betingelser som forteller hvordan XML-dataene skal lagres

  Neste
    Går til neste trinn: Velg validering.

  Fullfør
    Blir aktivert når du er ferdig med å opprette eller endre en DAD-fil. Fullfører behandlingen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Velg validering - trinn 2 for alle typer

  Valider XML-dokumenter med DTD-filen
    Velg dette alternativet for å validere XML-dokumentene. Med gyldige dokumenter kan du utføre struktursøk på dataene dine. Dokumentene blir validert mot DTD-filen som er oppgitt i DAD-filen. Du bør validere XML-data før du setter dem inn i DB2, for du ikke kan validere data som allerede er satt inn i DB2.

  DTD-ID
    Oppgi navnet på DTDen eller velg navnet fra listen over eksisterende DTDer. Hvis du ikke har importert noen DTDer til DTD-lageret for databasen din, kan du ikke validere XML-dokumentene.

  Ikke valider
    Velg dette alternativet for å fortsette uten å validere XML-dokumentene.

  Tilbake
    Går til forrige trinn: vinduet Oppgi en DAD.

  Neste
    Går til neste trinn. Åpner vinduet Administrere tilleggstabeller hvis du arbeider med XML-kolonner, vinduet Spesifiser SQL-setning hvis du arbeider med SQL-tilordning for XML-samling eller vinduet Spesifiser tekst hvis du arbeider med RDB-nodetilordning for XML-samling.

  Fullfør
    Blir aktivert når du er ferdig med å opprette eller endre en DAD-fil. Fullfører behandlingen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Tilleggstabeller - trinn 3 for XML-kolonnetype

  Liste over eksisterende tabeller og kolonner
    Denne tabellen inneholder en liste over tilleggstabell som skal opprettes når en XML-kolonne som bruker denne DAD-filen, blir opprettet. Du kan velge navnet på en eksisterende tabell og kolonne som du vil endre eller fjerner, eller oppgi et nytt navn i feltene nedenfor.

  Tabellnavn
    Oppgi navnet på en ny tilleggstabell som inneholder kolonnen. Hvis du valgte en kolonne fra listen, vises navnet på tabellen slik at du kan endre det. Dette feltet er obligatorisk. Eksempel:

        ORDER_SIDE_TAB

  Kolonnenavn
    Oppgi navnet på kolonnen. Hvis du valgte et navn fra listen over kolonner, blir kolonnenavnet vist slik at du kan endre det. Dette feltet er obligatorisk. Eksempel:

        CUSTOMER_NAME

  Type
    Velg eller endre typen kolonne, for eksempel DATE, CHAR, INTEGER eller VARCHAR. Dette feltet er obligatorisk.

  Lengde
    Hvis du valgte VARCHAR, oppgir eller endrer du maksimalt antall tegn for lengden på kolonnen. Dette feltet er bare aktivt for VARCHAR. Eksempel:

        30

  Bane
    Oppgi eller endre banen til et element eller attributt. Dette feltet er obligatorisk. Eksempel:

        /ORDER/CUSTOMER/NAME

  Flere forekomster
    Merk denne valgruten for å indikere om elementet eller kolonneattributtet kan brukes flere ganger eller bare en gang i et dokument. Merk ruten hvis du vil ha flere forekomster og opphev merkingen hvis du ikke vil ha flere forekomster.

  Tilføy
    Lagrer tabellen eller kolonnen med opplysningene du oppgav, og lar deg tilføye, endre eller slette en tabell eller kolonne.

  Endre
    Lagrer endringer du har gjort i feltene Tabellnavn, Kolonnenavn, Type, Lengde, Bane eller Flere forekomster. Når du endrer navnet på en tabell eller kolonne, blir det gamle objektet slettet fra listen og det nye tilføyd.

  Fjern
    Fjerne det uthevede elementet fra listen.

  Tilbake
    Går til forrige trinn: Velg validering.

  Neste
    Går til neste trinn: Lagre en DAD.

  Fullfør
    Blir aktivert når du er ferdig med å opprette eller endre en DAD-fil. Fullfører behandlingen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Spesifiser tekst - trinn 2 for SQL-tilordningstype eller RDB-nodetilordningstype

  Prolog
    Oppgi et prolognavn. Hvis du redigerer en eksisterende DAD, blir navnet vist. Navnet må ha formatet

        <?xml version="1.0" ?>

    Dette feltet er obligatorisk.

  Dokumenttype
    Oppgi typen XML-dokument. Hvis du redigerer en eksisterende DAD, blir dokumenttypen vist. Dette feltet er obligatorisk. Eksempel:

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

  Tilbake
    Går til forrige trinn: Velg validering.

  Neste
    Går til forrige trinn: RDB-nodetilordning hvis typen er RDB-nodetilordning eller Spesifiser SQL-setning hvis typen er SQL-tilordning.

  Fullfør
    Blir aktivert når du er ferdig med å opprette eller endre en DAD-fil. Fullfører behandlingen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Spesifiser SQL-setning - trinn 4 for SQL-tilordningstype

  SQL-setning
    Oppgi en SQL SELECT-setning. Hvis du redigerer en eksisterende DAD-fil, blir SQL-setningen vist. Setningen tilordner kolonnene til SELECT-setningen til XML-elementer eller -attributter i XML-dokumentet. FROM-leddet definerer tabellene som inneholder dataene. WHERE-leddet indikerer kombinerings- og søkebetingelsene. Alle tabellene i samlingen må kunne kombineres ved hjelp av en SELECT-setning. Dette feltet er obligatorisk. Eksempel:

        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
              Der   o.order_key = 1
                    p.price > 20000 and
                    p.order_key = o.order_key
                    s.part_key = p.part_key
              ORDER BY order_key, part_key, ship_id

    SQL-setningen bruker disse retningslinjene:

    - Kolonner blir spesifisert rekkefølge fra topp til bunn etter hierarkiet til XML-dokumentstrukturen.
    - Kolonnene til en hel mengde blir gruppert sammen, og hver gruppe har en kolonne med objekt-ID.
    - Kolonnen med objekt-ID er den første kolonnen i hver gruppe.
    - For tabeller som ikke bruker en betinget kolonnen med enkeltnøkkel, bruker du den innebygde DB2-funksjonen generate_unique til å generere kolonnen.
    - Kolonnene med objekt-ID blir vist i rekkefølge fra topp til bunn i ORDER BY-setninger. Kolonnene i ORDER BY skal ikke kvalifiseres av noe skjema- og tabellnavn og bør stemme overens med kolonnenavnene i SELECT-setningen.

  Test SQL
    Tester gyldigheten til SQL-setningen. Hvis setningen er gyldig, blir eksempelresultatene vist i feltet Eksempelresultater. Hvis setningen ikke er gyldig, får du en feilmelding der du blir bedt om å rette setningen og prøve igjen.

  Eksempelresultater
    Viser resultatene av testingen av SQL-setningen hvis setningen er gyldig. Dette felter er bare for lesing.

  Tilbake
    Går til forrige trinn: Velg validering.

  Neste
    Går til neste trinn: SQL-tilordning.

  Fullfør
    Blir aktivert når du er ferdig med å opprette eller endre en DAD-fil. Fullfører behandlingen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### SQL-tilordning - trinn 5 for SQL-tilordningstype

  DAD-tilordning
    Velg en node fra den viste DAD-tilordningen som du vil tilordne fra. Du kan tilordne elementene og attributtene i XML-dokumentet til element- og attributtnoder som tilsvarer DB2-data. Nodene gir banen fra XML-dataene til DB2-dataene. Velg en node for å aktivere Nytt element. Når du velger en node, fører det til at de riktige feltene blir vist i grupperuten Detaljerte opplysninger.

  Nodetype
    Velg en nodetype fra listen over typer som er gyldige på dette punktet i tilordningen. Avhengig av typen node du velger, blir ulike felt vist i grupperuten Detaljerte opplysninger. Dette feltet er obligatorisk.

    Element
      Viser til et XML-element som er definert i DTD-filen tilknyttet XML-dokumentet, og som brukes til å knytte XML-elementet til en kolonne i en DB2-tabell. En elementnode kan ha attributtnoder, underordnede elementnoder eller tekstnoder. En node på laveste nivå har en tekstnode og et kolonnenavn tilknyttet seg i treoversikt.

    Attributt
      Viser til et XML-attributt som er definert i DTD-filen tilknyttet XML-dokumentet, og som brukes til å knytte XML-attributtet til en kolonne i en DB2-tabell. En attributtnode kan ha en tekstnode og har et kolonnenavn tilknyttet seg i treoversikten.

    Tekst
      Spesifiserer tekstinnhold for en elementnode. En tekstnode har et kolonnenavn tilknyttet seg i treoversikten.

  Node
    Oppgi nodenavnet. Dette feltet er obligatorisk. Eksempel:

        Rekkefølge

  Kolonne
    Hvis du valgte Attributt, Element eller Tekst som nodetype, velger du et kolonnenavn. Dette feltet er obligatorisk. Hvis du oppgir Kolonne som nodetype, kan du bare velge en kolonne som allerede finnes i DB2-databasen din. Eksempel:

        Customer_Name

  Tilføy
    Tilføyer den riktige beskrivelsen til det tomme elementet som blir føyd til trestrukturen.

  Endre
    Foretar endringene på den uthevede noden. Du kan velge noden om igjen eller velge en annen node for å foreta flere endringer.

  Fjern
    Fjerner det uthevede elementet eller attributtet.

  Nytt element
    Oppretter en ny node ved å tømme feltene i grupperuten Detaljerte opplysninger, tilføye et tomt element under det som er uthevet i trestrukturen, og uthever det nye, tomme elementet.

  Tilbake
    Går til forrige trinn: Spesifiser SQL-setning.

  Neste
    Går til neste trinn: Lagre en DAD.

  Fullfør
    Blir aktivert når du er ferdig med å opprette eller endre en DAD-fil. Fullfører behandlingen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### RDB-nodetilordning - trinn 4 for RDB-nodetilordningstype

  DAD-tilordning
    Velg en node fra den viste DAD-tilordningen som du vil tilordne fra. Du tilordner elementene og attributtene i XML-dokumentet til element- og attributtnoder som tilsvarer DB2-data. Nodene gir banen fra XML-dataene til DB2-dataene. De indikerer hvilken tabell og hvilken kolonne som inneholder dataene, og under hvilke betingelser du kan hente dataene. Velg en node for å aktivere Nytt element. Når du velger en node, fører det til at de riktige feltene blir vist i grupperuten Detaljerte opplysninger.

  Nodetype
    Velg en nodetype fra listen over typer som er gyldige på dette punktet i tilordningen. Avhengig av typen node du velger, blir ulike felt vist i grupperuten Detaljerte opplysninger. Feltene kan være for Element, Attributt, Tekst, Tabell, Kolonne eller Betingelse, avhengig av hva du valgte i DAD-tilordningen. Dette feltet er obligatorisk.

    Element
      Viser til et XML-element som er definert i DTD-filen tilknyttet XML-dokumentet, og som brukes til å knytte XML-elementet til en kolonne i en DB2-tabell. En elementnode kan ha attributtnoder, underordnede elementnoder, tekstnoder, tabellnoder eller betingelsesnoder. Et rotelement inneholder tabellnoder som spesifiserer alle tabeller som brukes til å XML-dokumenter, og en betingelsesnode som brukes til å tilkoble tabellene. Dette feltet er obligatorisk. Eksempel:

          element_node name="Order"

    Attributt
      Viser til en XML-attributtnode som er definert i DTD-filen tilknyttet XML-dokumentet, og som brukes til å knytte XML-attributtet til en kolonne i en DB2-tabell. En attributtnode kan ha en tekstnode og har et kolonnenavn tilknyttet seg i DAD-tilordningen. Dataene ligger i attributtnoden og tekstnoden til hvert element. Dette feltet er obligatorisk. Eksempel:

          attribute_node name="key"

    Tabell
      Viser til tabellen som er tilknyttet innholdet i tekstnoden eller attributtnoden. Verdien spesifiserer navnet på en DB2-tabell der innholdet i tekstnoden eller attributtnoden vil bli lagret eller hentet fra. Eksempel:

          table_node name=order_tab

    Kolonne
      Viser til kolonnen med innholdet i tekstnoden eller attributtnoden. Verdien spesifiserer navnet på en DB2-tabellkolonne der innholdet i tekstnoden eller attributtnoden blir lagret eller hentet fra. Eksempel:

          column name="order_key"

  Node
    Oppgi navnet til et element eller attributt. Dette feltet er obligatorisk. Eksempel:

        element_node name="Price"

  Tekst
    Indikerer tekstinnholdet til et element og kolonnedataene i en relasjonstabell for elementnoder på laveste nivå. Inneholder et tabellelement, kolonneelement og for rotnoden, et betingelseselement.

  Tabellnavn
    Navnet på tabellen som inneholder kolonnen. Eksempel:

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

  Tabellnøkkel
    Primærnøkkelen til en tabell, bestående av en enkeltkolonne eller flere kolonner (sammensatt nøkkel). Nøkkelen brukes til å knytte sammen tabeller i en samling. Eksempel på en sammensatt nøkkel:

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

  Kolonne
    Navnet på kolonnen som inneholder dataene til elementteksten og som elementet og attributtet er tilordnet. Eksempel:

        column name="order_key" type="integer"

  Betingelse
    I rotelementer indikerer den måten XML-samlingstabeller skal kombineres på. I elementer på lavere nivå, indikerer den betingelsen for utvelging av XML-data med verdiene "=", "<", ">" eller "LIKE". Eksempel på betingelse for rotelement:

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

    Eksempel på kriterium for utvelging av XML-data:

        price > 2500.00

  Tilføy
    Tilføyer den riktige beskrivelsen til det tomme elementet som blir føyd til trestrukturen.

  Endre
    Foretar endringer på den uthevede noden. Du kan velge noden om igjen eller velge en annen node for å foreta flere endringer.

  Fjern
    Fjerner det uthevede elementet.

  Nytt element
    Oppretter en ny node ved å tømme feltene i grupperuten Detaljerte opplysninger, tilføye et tomt element under det som er uthevet i trestrukturen, og uthever det nye, tomme elementet.

  Tilbake
    Går til forrige trinn: Spesifiser tekst.

  Neste
    Går til neste vindu: Lagre en DAD.

  Fullfør
    Blir aktivert når du er ferdig med å opprette eller endre en DAD-fil. Fullfører behandlingen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Lagre en DAD - siste trinn for alle typer

  Filnavn
    Oppgi filnavnet for den endrede eller nye DAD-filen du vil lagre eller klikk på ... for å åpne det lokale filvinduet slik at du kan velge lagringsplassering for DAD-filen. Dette feltet er obligatorisk.

  Tilbake
    Går til forrige trinn.

  Fullfør
    Lagrer DAD-filen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ## Oppgaver

  ### Opprette eller redigere en DAD for XML-kolonner

  Når du oppretter en DAD-fil for en XML-kolonne, oppgir du datatypen til XML-dokumentet og definerer tilleggstabeller for indeksering.

  1. Klikk på Rediger DAD fra startpanelet for å redigere eller opprette en XML DAD-fil. Veiviseren Arbeid med DAD-filer blir åpnet og viser vinduet Oppgi en DAD.
  2. Velg om du vil redigere en eksisterende DAD-fil eller opprette en ny DAD-fil.
     - Slik redigerer du en eksisterende DAD-fil:
       1. Klikk på ... for å bla deg frem til en eksisterende DAD-fil på listen, eller oppgi DAD-filnavnet i feltet Filnavn.
       2. Kontroller at veiviseren gjenkjenner den oppgitte DAD-filen.
          - Hvis veiviseren gjenkjenner den oppgitte DAD-filen, blir Neste valgbar og XML-kolonne blir vist i feltet Type.
          - Hvis veiviseren ikke gjenkjenner den oppgitte DAD-filen, er Neste ikke valgbar. Skriv DAD-filnavnet på nytt i feltet Filnavn eller klikk på ... for å se etter en eksisterende DAD-fil. Fortsett til Neste er valgbar.
       3. Klikk på Neste.
     - Slik oppretter du en ny DAD-fil:
       1. La feltet Filnavn stå tomt.
       2. På listen Type klikker du på XML-kolonne.
       3. Klikk på Neste.
  3. Velg om du vil validere XML-dokumentene med en DTD, i vinduet Velg validering.
     - Slik validerer du:
       1. Klikk på Valider XML-dokumenter med DTD-filen.
       2. Velg DTD-filen som skal brukes til validering, fra listen DTD-ID.

       Hvis du ikke har importert noen DTDer til DTD-lageret for databasen din, kan du ikke validere XML-dokumentene.

     - Klikk på Ikke valider for å fortsette uten å validere XML-dokumentene.
  4. Klikk på Neste.
  5. Velg om du vil tilføye en ny tilleggstabell, redigere en eksisterende tilleggstabell eller fjerne en eksisterende tilleggstabell, i vinduet Tilleggstabeller.
     - Slik tilføyer du en ny tilleggstabell eller tilleggstabellkolonne:

       Du tilføyer en ny tilleggstabell ved å definere kolonnene i tabellen. Fullfør trinnene nedenfor for hver kolonne i en tilleggstabell.

       1. Fyll ut feltene i ruten Detaljerte opplysninger i vinduet Tilleggstabeller.
          1. Tabellnavn: Oppgi navnet på tabellen som inneholder kolonnen.
          2. Kolonnenavn: Oppgi navnet på kolonnen.
          3. Type: Velg typen kolonne fra listen.
          4. Lengde (bare VARCHAR): Oppgi største antall VARCHAR-tegn.
          5. Bane: Oppgi plasseringen av elementet eller attributtet.
          6. Flere forekomster: Velg Nei eller Ja fra listen.

             Indikerer om dette elementet eller attributtet kan brukes flere ganger i et dokument. Viktig Hvis du oppgir flere forekomster for en kolonne, kan du bare oppgi en kolonne i tilleggstabellen som inneholder kolonnen.

       2. Klikk på Tilføy for å tilføye kolonnen.
       3. Fortsett å tilføye, redigere eller fjerne kolonne for tilleggstabellen, eller klikk på Neste.
     - Slik redigerer du en eksisterende tilleggstabellkolonne:

       Du kan oppdatere en tilleggstabell ved å endre definisjonene til de eksisterende kolonnene.

       1. Klikk på tilleggstabellen og kolonnen du vil redigere.
       2. Rediger feltene i ruten Detaljerte opplysninger.
       3. Klikk på Endre for å lagre endringene.
       4. Fortsett å tilføye, redigere eller fjerne kolonne for hver tilleggstabell, eller klikk på Neste.
     - Slik fjerner du en eksisterende tilleggstabellkolonne:
       1. Klikk på tilleggstabellen og kolonnen du vil fjerne.
       2. Klikk på Fjern.
       3. Fortsett å tilføye, redigere eller fjerne tilleggstabellkolonner, eller klikk på Neste.
     - Slik fjerner du en eksisterende tilleggstabell:

       Slett hver kolonne i tilleggstabellen for å fjerne tabellen.

       1. Klikk på hver tilleggstabellkolonnen for tabellen du vil fjerne.
       2. Klikk på Fjern.
       3. Fortsett å tilføye, redigere eller fjerne tilleggstabellkolonner, eller klikk på Neste.
  6. Oppgi et utdatafilnavn for den endrede DAD-filen i feltet Filnavn i vinduet Oppgi en DAD.
  7. Klikk på Fullfør for å lagre DAD-filen og gå tilbake til startpanelet.

  ### Opprette eller redigere en DAD for XML-samlinger

  Når du oppretter DAD-filen for XML-samlingen, tilordner du XML-dokumentet til DB2-datakilden ved hjelp av en av disse teknikkene:

  - Sett sammen en XML-fil ved hjelp av SQL-tilordning
  - Sett sammen en XML-fil ved hjelp av RDB-nodetilordning
  - Oppløs en XML-fil ved hjelp av RDB-nodetilordning

  #### Sammensetning med SQL-tilordning

  1. Klikk på Rediger DAD fra startpanelet. Vinduet Oppgi en DAD blir vist.
  2. Velg om du vil redigere en eksisterende DAD-fil eller opprette en ny DAD-fil.

     Slik oppretter du en ny DAD-fil:

     1. La feltet Filnavn stå tomt.
     2. På listen Type velger du SQL-tilordning for XML-samling.
     3. Klikk på Neste for å åpne vinduet Velg validering.

     Slik redigerer du en eksisterende DAD-fil:

     1. Oppgi DAD-filnavnet i feltet Filnavn eller klikk på ... for å se etter en eksisterende DAD-fil.
     2. Kontroller at veiviseren gjenkjenner den oppgitte DAD-filen.
        - Hvis veiviseren gjenkjenner den oppgitte DAD-filen, blir Neste valgbar og SQL-tilordning for XML-samling blir vist i feltet Type.
        - Hvis veiviseren ikke gjenkjenner den oppgitte DAD-filen, er Neste ikke valgbar. Oppgi DAD-filnavnet på nytt eller klikk på ... for å se etter en eksisterende DAD-fil. Gjenta trinnene ovenfor til Neste blir valgbar.
     3. Klikk på Neste for å åpne vinduet Velg validering.
  3. I vinduet Velg validering velger du om du vil validere XML-dokumentene med en DTD.
     - Slik validerer du:
       1. Klikk på Valider XML-dokumenter med DTD-filen.
       2. Velg DTD-filen som skal brukes til validering, fra listen DTD-ID.

       Hvis du ikke har importert noen DTDer til DTD-lageret for databasen din, kan du ikke validere XML-dokumentene.

     - Klikk på Ikke valider for å fortsette uten å validere XML-dokumentene.
  4. Klikk på Neste for å åpne vinduet Spesifiser tekst.
  5. Oppgi prologen i feltet Prolog for å spesifisere prologen til XML-dokumentet som skal settes sammen.

         <?xml version="1.0"?>

     Hvis du redigerer en eksisterende DAD-fil, blir prologen automatisk vist i feltet Prolog.

  6. Oppgi dokumenttypen til XML-dokumentet i feltet Dokumenttype i vinduet Spesifiser tekst. Pek på DTDen til XML-dokumentet. Eksempel:

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

     Hvis du redigerer en eksisterende dokumenttype, blir prologen automatisk vist i feltet Dokumenttype.

  7. Klikk på Neste for å åpne vinduet Spesifiser SQL-setning.
  8. Oppgi en gyldig SQL SELECT-setning i feltet SQL-setning.

     Hvis du redigerer en eksisterende dokumenttype, blir SQL-setningen automatisk vist i feltet SQL-setning.

  9. Klikk på Test SQL for å teste gyldigheten til SQL-setningen.
     - Hvis SQL-setningen er gyldig, blir det vist eksempelresultater i feltet Eksempelresultater.
     - Hvis SQL-setningen ikke er gyldig, blir det vist en feilmelding i feltet Eksempelresultater. Feilmeldingen forteller deg at du må rette SQL SELECT-setningen og prøve igjen.
  10. Klikk på Neste for å åpne vinduet SQL-tilordning.
  11. Velg en element- eller attributtnode du vil tilordne, ved å klikke på den i feltet til venstre i vinduet SQL-tilordning.

      Du kan tilordne elementene og attributtene i XML-dokumentet til element- og attributtnoder som tilsvarer DB2-data. Disse nodene gir en bane fra XML-dataene til DB2-dataene.

      - Slik tilføyer du rotnoden:
        1. Velg ikonet Rot.
        2. Klikk på Nytt element for å definere en ny node.
        3. I ruten Detaljerte opplysninger oppgir du Nodetype som Element.
        4. Oppgi navnet på rotnoden i feltet Node.
        5. Klikk på Tilføy for å opprette den nye noden.

           Nå har du opprettet rotnoden eller -elementet, som er overordnet alle andre element- og attributtnoder i tilordningen. Nå kan du tilføye underordnede elementer og attributter til denne noden.

      - Slik tilføyer du et underordnet element eller en attributtnode:
        1. Klikk på en overordnet node i feltet til venstre for å tilføye et underordnet element eller attributt.

           Hvis du ikke har valgt en overordnet node, er Nytt element ikke valgbar.

        2. Klikk på Nytt element.
        3. Velg nodetypen fra listen Nodetype i ruten Detaljerte opplysninger.

           Listen Nodetype viser bare nodetypene som er gyldige på det punktet i tilordningen.

        4. Oppgi nodenavnet i feltet Nodenavn i ruten Detaljerte opplysninger.
        5. Hvis du oppgav Attributt, Element eller Tekst for et element på laveste nivå, som nodetype, velger du en kolonne fra feltet Kolonne i ruten Detaljerte opplysninger.

           Begrensning: Nye kolonner kan ikke opprettes ved hjelp av administrasjonsveiviseren. Hvis du oppgir Kolonne som nodetype, kan du bare velge en kolonne som allerede finnes i DB2-databasen din.

        6. Klikk på Tilføy for å tilføye den nye noden.

           Du kan endre en node senere ved å klikke på den i feltet til venstre og foreta eventuelle nødvendige endringer på den i ruten Detaljerte opplysninger. Klikk på Endre for å oppdatere elementet.

           Du kan også tilføye underordnede elementer eller attributter til noden ved å utheve noden og gjenta tilføyingsprosessen.

        7. Fortsett med å redigere SQL-tilordningen eller klikk på Neste for å åpne vinduet Oppgi en DAD.
      - Slik fjerner du en node:
        1. Klikk på en node i feltet til venstre.
        2. Klikk på Fjern.
        3. Fortsett med å redigere SQL-tilordningen eller klikk på Neste for å åpne vinduet Oppgi en DAD.

        Legg merke til at hvis du fjerner en node på laveste nivå, blir et annet element en node på laveste nivå og må kanskje få definert et kolonnenavn.

  12. Oppgi navnet på en utdatafil for den endrede DAD-filen i feltet Filnavn i vinduet Oppgi en DAD.
  13. Klikk på Fullfør for å gå tilbake til startpanelet.

  #### Sammensetning med RDB-nodetilordning

  1. Klikk på Rediger DAD fra startpanelet. Vinduet Oppgi en DAD blir vist.
  2. Velg om du vil redigere en eksisterende DAD-fil eller opprette en ny DAD-fil.

     Slik redigerer du en eksisterende DAD-fil:

     1. Oppgi DAD-filnavnet i feltet Filnavn eller klikk på ... for å se etter en eksisterende DAD-fil.
     2. Kontroller at veiviseren gjenkjenner den oppgitte DAD-filen.
        - Hvis veiviseren gjenkjenner den oppgitte DAD-filen, blir Neste valgbar og RDB-nodetilordning for XML-samling blir vist i feltet Type.
        - Hvis veiviseren ikke gjenkjenner den oppgitte DAD-filen, er Neste ikke valgbar. Skriv DAD-filnavnet på nytt i feltet Filnavn eller klikk på ... for å se etter en eksisterende DAD-fil. Fortsett med disse trinnene til Neste er valgbar.
     3. Klikk på Neste for å åpne vinduet Velg validering.

     Slik oppretter du en ny DAD-fil:

     1. La feltet Filnavn stå tomt.
     2. Velg RDB-nodetilordning for XML-samling fra listen Type.
     3. Klikk på Neste for å åpne vinduet Velg validering.
  3. I vinduet Velg validering velger du om du vil validere XML-dokumentene med en DTD.
     - Slik validerer du:
       1. Klikk på Valider XML-dokumenter med DTD-filen.
       2. Velg DTD-filen som skal brukes til validering, fra listen DTD-ID.

       Hvis du ikke har importert noen DTDer til DTD-lageret for databasen din, kan du ikke validere XML-dokumentene.

     - Klikk på Ikke valider for å fortsette uten å validere XML-dokumentene.
  4. Klikk på Neste for å åpne vinduet Spesifiser tekst.
  5. Oppgi prolognavnet i feltet Prolog i vinduet Spesifiser tekst.

         <?xml version="1.0"?>

     Hvis du redigerer en eksisterende DAD-fil, blir prologen automatisk vist i feltet Prolog.

  6. Oppgi typen XML-dokument i feltet Dokumenttype. Eksempel:

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

     Hvis du redigerer en eksisterende dokumenttype, blir prologen automatisk vist i feltet Dokumenttype.

  7. Klikk på Neste for å åpne vinduet RDB-nodetilordning.
  8. Velg en element- eller attributtnode du vil tilordne, ved å klikke på den i feltet til venstre i vinduet RDB-nodetilordning.

     Du kan tilordne elementene og attributtene i XML-dokumentet til element- og attributtnoder som tilsvarer DB2-data. Disse nodene gir en bane fra XML-dataene til DB2-dataene.

  9. Slik tilføyer du rotnoden:
     1. Velg ikonet Rot.
     2. Klikk på Nytt element for å definere en ny node.
     3. I ruten Detaljerte opplysninger oppgir du Nodetype som Element.
     4. Oppgi navnet på rotnoden i feltet Node.
     5. Klikk på Tilføy for å opprette den nye noden.

        Nå har du opprettet rotnoden eller -elementet, som er overordnet alle andre element- og attributtnoder i tilordningen. Rotnoden har underordnede tabellelementer og en kombinasjonsbetingelse.

        Tilføy tabellnoder for hver tabell som er en del av samlingen.

        1. Uthev rotnodenavnet og velg Nytt element.
        2. I ruten Detaljerte opplysninger oppgir du Nodetype som Tabell.
        3. Velg navnet på tabellen fra Tabellnavn. Tabellen må finnes fra før.
        4. Klikk på Tilføy for å tilføye tabellnoden.
        5. Gjenta disse trinnene for hver tabell.

        Tilføy en kombinasjonsbetingelse for tabellnodene.

        1. Uthev rotnodenavnet og velg Nytt element.
        2. I ruten Detaljerte opplysninger oppgir du Nodetype som Betingelse.
        3. I feltet Betingelse oppgir du kombinasjonsbetingelsen ved hjelp av denne syntaksen:

               tabellnavn.tabellkolonne = tabellnavn.tabellkolonne AND
               tabellnavn.tabellkolonne = tabellnavn.tabellkolonne ...

           Ta med så mange betingelser som nødvendig, koblet sammen med AND, for å opprette kombinasjonsbetingelsen.

        4. Klikk på Tilføy for å tilføye betingelsen.

     Nå kan du tilføye underordnede elementer og attributter til denne noden.

  10. Slik tilføyer du et underordnet element eller en attributtnode:
      1. Klikk på en overordnet node i feltet til venstre for å tilføye et underordnet element eller attributt.
      2. Klikk på Nytt element. Hvis du ikke har valgt en overordnet node, er Nytt element ikke valgbar.
      3. Velg en nodetype fra listen Nodetype i ruten Detaljerte opplysninger.

         Listen Nodetype viser bare nodetypene som er gyldige på det punktet i tilordningen, som er enten Element eller Attributt.

      4. Oppgi navnet på elementet eller attributtet i feltet Node.
      5. Hvis du oppgav Attributt som nodetype eller Element for et element på laveste nivå, velger du en kolonne fra feltet Kolonne i ruten Detaljerte opplysninger.

         Begrensning: Nye kolonner kan ikke opprettes ved hjelp av administrasjonsveiviseren. Hvis du oppgir Kolonne som nodetype, kan du bare velge en kolonne som allerede finnes i DB2-databasen din.

      6. Klikk på Tilføy for å tilføye den nye noden.

         Du kan endre en node senere ved å klikke på den i feltet til venstre og foreta eventuelle nødvendige endringer på den i ruten Detaljerte opplysninger. Klikk på Endre for å oppdatere elementet.

         Du kan også tilføye underordnede elementer eller attributter til noden ved å utheve noden og gjenta tilføyingsprosessen.

      7. Slik tilordner du innholdet av en element- eller attributtnode til en relasjonstabell:
         1. Oppgi en tekstnode.
            1. Klikk på den overordnede noden.
            2. Klikk på Nytt element.
            3. I feltet Nodetype velger du Tekst.
            4. Velg Tilføy for å tilføye noden.
         2. Tilføy en tabellnode.
            1. Velg tekstnoden du nettopp opprettet, og klikk på Nytt element.
            2. I feltet Nodetype velger du Tabell og oppgir et tabellnavn for elementet.
            3. Klikk på Tilføy for å tilføye noden.
         3. Tilføy en kolonnenode.
            1. Velg tekstnoden om igjen og klikk på Nytt element.
            2. I feltet Nodetype velger du Kolonne og oppgir et kolonnenavn for elementet.
            3. Klikk på Tilføy for å tilføye noden.

            Begrensning: Nye kolonner kan ikke opprettes ved hjelp av administrasjonsveiviseren. Hvis du oppgir Kolonne som nodetype, kan du bare velge en kolonne som allerede finnes i DB2-databasen din.

         4. Du kan også velge å tilføye en betingelse for kolonnen.
            1. Velg tekstnoden om igjen og klikk på Nytt element.
            2. I feltet Nodetype velger du Betingelse og betingelsen med syntaksen:

                   operator LIKE|<|>|= verdi

            3. Klikk på Tilføy for å tilføye noden.
      8. Fortsett med å redigere RDB-tilordningen eller klikk på Neste for å åpne vinduet Oppgi en DAD.
  11. Slik fjerner du en node:
      1. Klikk på en node i feltet til venstre.
      2. Klikk på Fjern.
      3. Fortsett med å redigere RDB-tilordningen eller klikk på Neste for å åpne vinduet Oppgi en DAD.
  12. Oppgi et utdatafilnavn for den endrede DAD-filen i feltet Filnavn i vinduet Oppgi en DAD.
  13. Klikk på Fullfør for å fjerne noden og gå tilbake til startpanelet.

  #### Oppløsning med RDB-nodetilordning

  1. Klikk på Rediger DAD fra startpanelet. Vinduet Oppgi en DAD blir vist.
  2. Velg om du vil redigere en eksisterende DAD-fil eller opprette en ny DAD-fil.

     Slik redigerer du en eksisterende DAD-fil:

     1. Oppgi DAD-filnavnet i feltet Filnavn eller klikk på ... for å se etter en eksisterende DAD-fil.
     2. Kontroller at veiviseren gjenkjenner den oppgitte DAD-filen.
        - Hvis veiviseren gjenkjenner den oppgitte DAD-filen, blir Neste valgbar og RDB-nodetilordning for XML-samling blir vist i feltet Type.
        - Hvis veiviseren ikke gjenkjenner den oppgitte DAD-filen, er Neste ikke valgbar. Skriv DAD-filnavnet på nytt i feltet Filnavn eller klikk på ... for å se etter en eksisterende DAD-fil. Fortsett med disse trinnene til Neste er valgbar.
     3. Klikk på Neste for å åpne vinduet Velg validering.

     Slik oppretter du en ny DAD-fil:

     1. La feltet Filnavn stå tomt.
     2. Velg RDB-nodetilordning for XML-samling fra listen Type.
     3. Klikk på Neste for å åpne vinduet Velg validering.
  3. I vinduet Velg validering velger du om du vil validere XML-dokumentene med en DTD.
     - Slik validerer du:
       1. Klikk på Valider XML-dokumenter med DTD-filen.
       2. Velg DTD-filen som skal brukes til validering, fra listen DTD-ID.

       Hvis du ikke har importert noen DTDer til DTD-lageret for databasen din, kan du ikke validere XML-dokumentene.

     - Klikk på Ikke valider for å fortsette uten å validere XML-dokumentene.
  4. Klikk på Neste for å åpne vinduet Spesifiser tekst.
  5. Hvis du bare oppløser et XML-dokument, overser du feltet Prolog. Hvis du bruker DAD-filen både til sammensetning og oppløsning, oppgir du prolognavnet i feltet Prolog i vinduet Spesifiser tekst. Prologen er obligatorisk hvis du oppløser XML-dokumenter til DB2-data.

         <?xml version="1.0"?>

     Hvis du redigerer en eksisterende DAD-fil, blir prologen automatisk vist i feltet Prolog.

  6. Hvis du bare oppløser et XML-dokument, overser du feltet Dokumenttype. Hvis du bruker DAD-filen til både sammensetning og oppløsning, oppgir du typen XML-dokument i feltet Dokumenttype.

     Hvis du redigerer en eksisterende dokumenttype, blir prologen automatisk vist i feltet Dokumenttype. Eksempel:

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

  7. Klikk på Neste for å åpne vinduet RDB-tilordning.
  8. Velg en element- eller attributtnode du vil tilordne, ved å klikke på den i feltet til venstre i vinduet RDB-tilordning.

     Du kan tilordne elementene og attributtene i XML-dokumentet til element- og attributtnoder som tilsvarer DB2-data. Disse nodene gir en bane fra XML-dataene til DB2-dataene.

  9. Slik tilføyer du rotnoden:
     1. Velg ikonet Rot.
     2. Klikk på Nytt element for å definere en ny node.
     3. I ruten Detaljerte opplysninger oppgir du Nodetype som Element.
     4. Oppgi navnet på rotnoden i feltet Node.
     5. Klikk på Tilføy for å opprette den nye noden.

        Nå har du opprettet rotnoden eller -elementet, som er overordnet alle andre element- og attributtnoder i tilordningen. Rotnoden har underordnede tabellelementer og en kombinasjonsbetingelse.

        Tilføy tabellnoder for hver tabell som er en del av samlingen.

        1. Uthev rotnodenavnet og velg Nytt element.
        2. I ruten Detaljerte opplysninger oppgir du Nodetype som Tabell.
        3. Velg navnet på tabellen fra Tabellnavn. Tabellen må finnes fra før.
        4. Oppgi en nøkkelkolonne for tabellen i feltet Tabellnøkkel.
        5. Klikk på Tilføy for å tilføye tabellnoden.
        6. Gjenta disse trinnene for hver tabell.

        Tilføy en kombinasjonsbetingelse for tabellnodene.

        1. Uthev rotnodenavnet og velg Nytt element.
        2. I ruten Detaljerte opplysninger oppgir du Nodetype som Betingelse.
        3. I feltet Betingelse oppgir du kombinasjonsbetingelsen ved hjelp av denne syntaksen:

               tabellnavn.tabellkolonne = tabellnavn.tabellkolonne AND
               tabellnavn.tabellkolonne = tabellnavn.tabellkolonne ...

        4. Klikk på Tilføy for å tilføye betingelsen.

     Nå kan du tilføye underordnede elementer og attributter til denne noden.

  10. Slik tilføyer du et underordnet element eller en attributtnode:
      1. Klikk på en overordnet node i feltet til venstre for å tilføye et underordnet element eller attributt.

         Hvis du ikke har valgt en overordnet node, er Nytt element ikke valgbar.

      2. Klikk på Nytt element.
      3. Velg en nodetype fra listen Nodetype i ruten Detaljerte opplysninger.

         Listen Nodetype viser bare nodetypene som er gyldige på det punktet i tilordningen, som er enten Element eller Attributt.

      4. Klikk på Tilføy for å tilføye den nye noden. Du kan endre en node senere ved å klikke på den i feltet til venstre og foreta eventuelle nødvendige endringer i ruten Detaljerte opplysninger. Klikk på Endre for å oppdatere elementet.
      5. Slik tilordner du innholdet av en element- eller attributtnode til en relasjonstabell:
         1. Oppgi en tekstnode.
            1. Klikk på den overordnede noden.
            2. Klikk på Nytt element.
            3. I feltet Nodetype velger du Tekst.
            4. Velg Tilføy for å tilføye noden.
         2. Tilføy en tabellnode.
            1. Velg tekstnoden du nettopp opprettet, og klikk på Nytt element.
            2. I feltet Nodetype velger du Tabell og oppgir et tabellnavn for elementet.
            3. Klikk på Tilføy for å tilføye noden.
         3. Tilføy en kolonnenode.
            1. Velg tekstnoden om igjen og klikk på Nytt element.
            2. I feltet Nodetype velger du Kolonne og oppgir et kolonnenavn for elementet.
            3. Oppgi en basisdatatype for kolonnen i feltet Type. Feltet definerer hva slags type kolonnen må være for at den skal kunne lagre ikke-kodede data.
            4. Klikk på Tilføy for å tilføye noden.

            Begrensning: Nye kolonner kan ikke opprettes ved hjelp av administrasjonsveiviseren. Hvis du oppgir Kolonne som nodetype, kan du bare velge en kolonne som allerede finnes i DB2-databasen din.

         4. Du kan også velge å tilføye en betingelse for kolonnen.
            1. Velg tekstnoden om igjen og klikk på Nytt element.
            2. I feltet Nodetype velger du Betingelse og betingelsen med syntaksen:

                   operator LIKE|<|>|= verdi

            3. Klikk på Tilføy for å tilføye noden.
      6. Fortsett med å redigere RDB-tilordningen eller klikk på Neste for å åpne vinduet Oppgi en DAD.
  11. Slik fjerner du en node:
      1. Klikk på en node i feltet til venstre.
      2. Klikk på Fjern.
      3. Fortsett med å redigere RDB-tilordningen eller klikk på Neste for å åpne vinduet Oppgi en DAD.
  12. Oppgi et utdatafilnavn for den endrede DAD-filen i feltet Filnavn i vinduet Oppgi en DAD.
  13. Klikk på Fullfør for å fjerne noden og gå tilbake til startpanelet.

  # Arbeide med XML-kolonner

  I denne veiviseren kan du tilføye, aktivere eller deaktivere XML-kolonner for XML Extender.

  ## Felt og kontroller

  ### Velg en oppgave (for kolonner)

  Tilføy en XML-kolonne
    Velg dette alternativet for å åpne vinduet Tilføy en XML-kolonne for å tilføye en kolonne til en tabell. Denne kolonnen vil inneholde et intakt XML-dokument. Dette valget er bare tilgjengelig hvis databasen er aktivert.

  Aktiver en XML-kolonne
    Velg dette alternativet for å åpne vinduet Aktiver en XML-kolonne for å koble deg til en database og aktivere en XML-kolonne slik at den kan inneholde UDTer for XML Extender. Dette valget er bare tilgjengelig hvis databasen er aktivert og det er opprettet kolonner for XML-dokumenter.

  Deaktiver en XML-kolonne
    Velg dette alternativet for å åpne vinduet Deaktiver en XML-kolonne for å deaktivere en eksisterende kolonne. Hvis databasen ikke er aktivert eller det ikke finnes noen aktivert XML-kolonne, er dette valget ikke tilgjengelig. En deaktivert kolonne kan ikke lenger inneholde XML-dokumenter. Du må deaktivere en XML-kolonne før du sletter en XML-tabell. Hvis en tabell blir slettet, og den tilhørende XML-kolonnen ikke er deaktivert, beholder XML Extender tilleggstabellene det opprettet, og XML-kolonneposten i XML-brukstabellen.

  Neste
    Åpner vinduet du valgte, der du kan tilføye, aktivere eller deaktivere en XML-kolonne.

  Fullfør
    Tilgjengelig når du er ferdig med å arbeide med en kolonne.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Tilføy en XML-kolonne

  Tabellnavn
    Oppgi tabellnavnet eller velg navnet fra listen over tilgjengelige tabeller. Tabellen må være definert for at du skal kunne tilføye en XML-kolonne. Eksempel:

        SALES_DB

  Kolonnenavn
    Oppgi navnet du vil bruke på XML-kolonnen. Eksempel:

        ORDER

  Datatype
    Velg datatypen fra listen over tilgjengelige typer, for eksempel XMLCLOB, XMLVARCHAR eller XMLFILE. Eksempel:

        XMLVARCHAR

  Tilbake
    Åpner vinduet Velg en oppgave, som du brukte da du arbeidet med XML-kolonner.

  Fullfør
    Tilføyer XML-kolonnen og tar deg tilbake til startpanelet.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Aktiver en XML-kolonne

  Tabellnavn
    Oppgi navnet på tabellen som har en XML-kolonne, eller velg navnet fra listen over tilgjengelige tabeller. Eksempel

        SALES_TAB

  Kolonnenavn
    Oppgi navnet på en eksisterende XML-kolonne på tabellen, eller velg navnet fra listen over tilgjengelige kolonner. Eksempel:

        ORDER

  DAD-filnavn
    Oppgi plasseringen av DAD-filen som tilordner XML-dokumentet til XML-kolonnen og tilleggstabellene eller klikk på ... for å se etter en eksisterende DAD-fil. Eksempel:

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

  Tabellplass
    Valgfritt: Oppgi navnet på en tabellplass som ble opprettet tidligere for tilleggstabeller tilknyttet XML-kolonnen. Hvis tabellplassen ikke blir spesifisert, brukes en standard tabellplass.

  Standardutsnitt
    Valgfritt: Oppgi navnet på et standardutsnitt som kombinerer XML-tabellen og alle relaterte tilleggstabeller.

  Rot-ID
    Anbefalt, men valgfritt: Oppgi kolonnenavnet for primærnøkkelen i tabellen for å knytte alle tilleggstabellene til applikasjonstabellen. Hvis du ikke oppgir en ROOT ID, tilføyer XML Extender en DXXROOT_ID-kolonne til tabellen og genererer en identifikator.

  Tilbake
    Åpner vinduet Velg en oppgave, som du brukte da du arbeidet med XML-kolonner.

  Fullfør
    Aktiverer XML-kolonnen og tar deg tilbake til startpanelet. Når XML Extender skal aktivere kolonnen, finner det ut om XML-tabellen har en primærnøkkel, oppretter tilleggstabeller som er spesifisert i DAD-filen, og oppretter et standardutsnitt for XML-tabellen og tilleggstabellene.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Deaktiver en XML-kolonne

  Tabellnavn
    Oppgi navnet på tabellen som inneholder XML-kolonnen, eller velg navnet fra listen over tilgjengelige tabeller.

  Kolonnenavn
    Oppgi navnet på en eksisterende kolonne på tabellen, eller velg navnet fra listen over kolonner.

  Tilbake
    Åpner vinduet Velg en oppgave, som du brukte da du arbeidet med XML-kolonner.

  Fullfør
    Deaktiverer XML-kolonnen og tar deg tilbake til startpanelet. En deaktivert XML-kolonne kan ikke lenger inneholde XML-dokumenter.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ## Oppgaver

  ### Tilføy en XML-kolonne

  1. Klikk på Arbeid med XML-kolonner fra startpanelet. Vinduet Velg en oppgave blir åpnet.
  2. Klikk på Tilføy en XML-kolonne. Vinduet Tilføy en XML-kolonne blir vist.
  3. Velg navnet på tabellen fra listen Tabellnavn eller oppgi navnet på tabellen du vil endre.
  4. Oppgi navnet på kolonnen som skal tilføyes til tabellen, i feltet Kolonnenavn.
  5. Velg UDTen for kolonnen fra listen Datatype.
  6. Klikk på Fullfør for å tilføye kolonnen av XML-type.

  ### Aktiver en XML-kolonne

  1. Klikk på Arbeid med XML-kolonner fra startpanelet for å se på kolonnerelaterte oppgaver i XML Extender. Vinduet Velg en oppgave blir åpnet.
  2. Klikk på Aktiver en XML-kolonne og deretter på Neste for å aktivere en eksisterende kolonne i databasen.
  3. Velg tabellen som inneholder XML-kolonnen, fra feltet Tabellnavn.
  4. Velg kolonnen som skal aktiveres, fra feltet Kolonnenavn. Kolonnen må finnes og være av typen XML.
  5. Oppgi bane og navn på DAD-filen i feltet DAD-filnavn eller klikk på ... for å se etter en eksisterende DAD-fil.
  6. Du kan oppgi navnet på en eksisterende tabellplass i feltet Tabellplass.

     Tabellplassen inneholder tilleggstabeller som XML Extender har opprettet. Hvis du oppgir en tabellplass, blir tilleggstabellene opprettet i den oppgitte tabellplassen. Hvis du ikke oppgir en tabellplass, blir tilleggstabellene opprettet i standard tabellplass.

  7. Du kan oppgi navnet på standardutsnittet i feltet Standardutsnitt.

     Når du oppgir navn på standardutsnitt, blir det automatisk opprettet når kolonnen blir aktivert, og kombinert med XML-tabellen og alle de relaterte tilleggstabellene.

  8. Du kan oppgi kolonnenavnet for primærnøkkelen i applikasjonstabellen i feltet Rot-ID. Det anbefales.

     XML Extender bruker verdien i rot-IDen som en entydig identifikator for å knytte alle tilleggstabeller til applikasjonstabellen. Hvis du ikke oppgir denne verdien, tilføyer XML Extender DXXROOT_ID-kolonnen til applikasjonstabellen og genererer en identifikator.

  9. Klikk på Fullfør for å aktivere XML-kolonnen, opprette tilleggstabellene og gå tilbake til startpanelet.
     - Hvis kolonnen blir aktivert på riktig måte, får du melding om det.
     - Hvis kolonnen ikke blir aktivert på riktig måte, får du en feilmelding. Rett verdiene i skrivefeltene til kolonnen blir aktivert på riktig måte.

  ### Deaktiver en XML-kolonne

  1. Klikk på Arbeid med XML-kolonner fra startpanelet for å se på kolonnerelaterte oppgaver i XML Extender. Vinduet Velg en oppgave blir åpnet.
  2. Klikk på Deaktiver en XML-kolonne og deretter på Neste i vinduet Velg en oppgave hvis du skal deaktivere en eksisterende tabellkolonne i databasen.
  3. Velg tabellen som inneholder XML-kolonnen, fra feltet Tabellnavn.
  4. Velg kolonnen som skal deaktiveres, fra feltet Kolonnenavn.
  5. Klikk på Fullfør.
     - Hvis kolonnen blir deaktivert på riktig måte, får du melding om det.
     - Hvis kolonnen ikke blir deaktivert på riktig måte, får du en feilmelding. Rett verdiene i skrivefeltene til kolonnen blir deaktivert på riktig måte.

  # Arbeide med XML-samlinger

  Fra denne veiviseren kan du aktivere eller deaktivere XML-samlinger.

  ## Felt og kontroller

  ### Velg en oppgave (for samlinger)

  Aktiver en XML-samling
    Velg dette alternativet for å åpne vinduet Aktiver en XML-samling. Når du aktiverer en XML-samling, analyseres DAD-filen for å identifisere tabeller og kolonner som er knyttet til XML-dokumenter, og kontrollinformasjon blir registrert. Dette valget er bare tilgjengelig hvis databasen er aktivert og det finnes en DAD-fil.

  Deaktiver en XML-samling
    Velg dette alternativet for å åpne vinduet Deaktiver en samling for å fjerne indikatorer som identifiserer tabeller og kolonner som en del av en XML-samling. Hvis samlingen ikke er aktivert, er dette valget ikke tilgjengelig.

  Neste
    Åpner vinduet du valgte, slik at du kan aktivere eller deaktivere en XML-samling.

  Fullfør
    Tilgjengelig når du er ferdig med å arbeide med samlingen.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Aktiver en XML-samling

  Samlingsnavn
    Oppgi navnet på XML-samlingen du vil aktivere.

  DAD-filnavn
    Oppgi navnet på DAD-filen som tilordner strukturen til XML-dokumentet til DB2-tabellene som du bruker til å sette sammen eller oppløse et dokument eller klikke på ... for å se etter en eksisterende DAD-fil.

  ...
    Åpner et vindu der du kan velge navnet på en eksisterende DAD-fil.

  Tabellplass
    Oppgi navnet på en tidligere opprettet tabellplass, hvis det finnes. Tabellplassen vil inneholde nye DB2-tabeller generert for sammensetning eller oppløsning.

  Tilbake
    Åpner vinduet Velg en oppgave, som du brukte da du arbeidet med XML-samlinger.

  Fullfør
    Aktiverer XML-samlingen og tar deg tilbake til startpanelet. Når XML Extender skal aktivere samlingen, bruker det DAD-filen til å identifisere XML-dokumentets tabeller og kolonner og registrerer kontrollinformasjon i tabellen XML_USAGE.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ### Deaktiver en XML-samling

  Samlingsnavn
    Velg navnet på XML-samlingen som du vil deaktivere, fra listen over samlinger.

  Tilbake
    Åpner vinduet Velg en oppgave, som du brukte da du arbeidet med XML-samlinger.

  Fullfør
    Deaktiverer XML-samlingen og tar deg tilbake til startpanelet. Når XML Extender skal deaktivere en samling, fjerner det indikatorer som identifiserer tabeller og kolonner som del av en XML-samling.

  Avbryt
    Avbryter veiviseren og tar deg tilbake til startpanelet.

  ## Oppgaver

  ### Aktivere en XML-samling

  1. Klikk på Arbeid med XML-samlinger fra startpanelet. Vinduet Velg en oppgave blir åpnet.
  2. Klikk på Aktiver en XML-samling og deretter på Neste. Vinduet Aktiver en samling blir vist.
  3. Oppgi navnet på samlingen du vil aktivere, i feltet Samlingsnavn.
  4. Oppgi DAD-filnavnet i feltet DAD-filnavn eller klikk på ... for å se etter en eksisterende DAD-fil.
  5. Du kan oppgi navnet på en tidligere opprettet tabellplass i feltet Tabellplass.

     Tabellplassen vil inneholde nye DB2-tabeller generert for oppløsning.

  6. Klikk på Fullfør for å aktivere samlingen og gå tilbake til startpanelet.
     - Hvis samlingen blir aktivert på riktig måte, får du melding om det.
     - Hvis samlingen ikke blir aktivert på riktig måte, får du en feilmelding. Rett verdiene i skrivefeltene til samlingen blir aktivert på riktig måte.

  ### Deaktivere en XML-samling

  1. Klikk på Arbeid med XML-samlinger fra startpanelet for å se på samlingsrelaterte oppgaver i XML Extender. Vinduet Velg en oppgave blir åpnet.
  2. Klikk på Deaktiver en XML-samling og deretter på Neste for å deaktivere en XML-samling. Vinduet Deaktiver en samling blir vist.
  3. Oppgi navnet på samlingen du vil deaktivere, i feltet Samlingsnavn.
  4. Klikk på Fullfør for å deaktivere samlingen og gå tilbake til startpanelet.
     - Hvis samlingen blir deaktivert på riktig måte, får du melding om det.
     - Hvis samlingen ikke blir deaktivert på riktig måte, får du en feilmelding. Rett verdiene i skrivefeltene til samlingen blir deaktivert på riktig måte.