# Hjälp för guiden Administrera XML Extender

# Innehåll

Ansluta till en databas

- Fält och kontroller
- Åtgärder
- Ansluta till en databas
- Växla till en annan databas

  Använda startguiden Administrera XML Extender

- Fält och kontroller
- Åtgärder

  Aktivera och avaktivera en databas

- Åtgärd: Aktivera en databas
- Åtgärd: Avaktivera en databas

  Importera DTD

- Fält och kontroller
- Åtgärd: Importera DTD

  Arbeta med DAD-filer

- Fält och kontroller
- Ange DAD: första steget för samtliga typer
- Välj validering: steg 2 för samtliga typer
- Hantera sidotabeller: steg 3 för kolumntypen XML
- Ange text: steg 3 för typerna SQL-avbildning och RDB-nodavbildning
- Ange SQL-sats: steg 4 för typen SQL-avbildning
- Avbilda SQL: steg 5 för typen SQL-avbildning
- Avbilda RDB-noder: steg 4 för typen RDB-nodavbildning
- Spara DAD: sista steget för samtliga typer
- Åtgärder
- Skapa och redigera DAD för XML-kolumner
- Skapa och redigera DAD för XML-samlingar

  Arbeta med XML-kolumner

- Fält och kontroller
- Välj åtgärd (för kolumner)
- Lägg till XML-kolumn
- Aktivera XML-kolumn
- Avaktivera XML-kolumn
- Åtgärder
- Lägga till XML-kolumn
- Aktivera XML-kolumn
- Avaktivera XML-kolumn

  Arbeta med XML-samlingar

- Fält och kontroller
- Välj åtgärd (för samlingar)
- Aktivera XML-samling
- Avaktivera XML-samling
- Åtgärder
- Aktivera XML-samling
- Avaktivera XML-samling

  # Ansluta till en databas

  I den här guiden kan du ansluta till den databas som innehåller eller ska innehålla XML-data.

  ## Fält och kontroller

  Adress
    Ange namnet på den JDBC-databas du vill ansluta till eller välj en adress i listan. Guiden utför realtidsåtgärder i den databasen. Om du väljer en databas i listan visas det användar-ID och den JDBC-drivrutin som senast användes med adressen i följande fält. Fältet är obligatoriskt. Adressen har följande syntax:

    |För fristående konfigurationer (rekommenderas):

        jdbc:db2:databasnamn

    där:

    databasnamn
      är databasen du ansluter till och lagrar XML-dokument i.

    Exempel:

        jdbc:db2:sales_db

    För nätverkskonfigurationer:

        jdbc:db2://|värdnamn:portnummer/databasnamn

    där:

    |värdnamn
      |är namnet på den server där XML Extender finns.

    portnummer
      är portnumret som används till att ansluta till servern. Du kan ta reda på portnumret genom att ange följande kommando på DB2-kommandoraden på servermaskinen:

          db2jstrt port#

    databasnamn
      är databasen du ansluter till och lagrar XML-dokument i.

    Exempel:

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

  Användar-ID
    Ange eller bekräfta det användar-ID du använder för åtkomst till databasen. Fältet är obligatoriskt.

  Lösenord
    Ange lösenordet du använder för åtkomst till databasen. Fältet är obligatoriskt.

  JDBC-drivrutin
    Ange eller bekräfta placeringen av databasens drivrutin. Fältet är obligatoriskt. Drivrutinen bör ha följande värden:

    |För fristående konfigurationer (standardalternativ):

        COM.ibm.db2.jdbc.app.DB2Driver

    För nätverkskonfigurationer:

        COM.ibm.db2.jdbc.net.DB2Driver

  Slutför
    Med den här knappen slutför du processen att logga på en databas och öppnar startguiden.

  Avbryt
    Med den här knappen avslutar du guiden.

  ## Åtgärder

  ### Ansluta till en databas

  När du startar guiden Administrera XML Extender ansluter du först till en databas.

  1. I fältet Adress anger du den fullständiga JDBC-adressen till den IBM DB2 UDB-datakälla du ansluter till.
  2. I fälten Användar-ID och Lösenord anger du eller bekräftar användar-ID och lösenord för databasen du ansluter till.
  3. I fältet JDBC-drivrutin anger du eller bekräftar namnet på JDBC-drivrutinen för den angivna.
  4. Klicka på Slutför när du vill ansluta till databasen och fortsätta med startguiden.

  ### Växla till en annan databas

  1. I startguiden klickar du på Växla databas.
  2. I fältet Adress anger du den fullständiga JDBC-adressen till den IBM DB2 UDB-datakälla du ansluter till.
  3. I fälten Användar-ID och Lösenord anger du eller bekräftar användar-ID och lösenord för databasen du ansluter till.
  4. I fältet JDBC-drivrutin anger du eller bekräftar namnet på JDBC-drivrutinen för den angivna.
  5. Klicka på Slutför när du vill ansluta till den nya databasen och fortsätta med startguiden. Du kopplas då ned från den första databasen och ansluts till den nya.

  # Använda startguiden Administrera XML Extender

  Startguiden Administrera XML Extender (Startguiden) ger tillgång till guider du kan använda till att utföra administrationsåtgärder som att aktivera databaser för XML, redigera DAD-filer (Data Access Definition) samt aktivera XML-kolumner och -samlingar. Välj en åtgärd så att guiden för den visas.

  ## Fält och kontroller

  Växla databas
    Med den här knappen öppnar du en dialogruta där du kan logga på en specifik databas. Om du vill spara eller öppna XML-dokument måste du vara ansluten till en databas. När du har loggat in i en databas kan du växla till en annan databas från startguiden.

  Aktivera databas för XML och avaktivera XML i databas
    Med den här knappen aktiverar du och avaktiverar en databas för XML Extender. Knappen är en på/av-knapp som ändrar utseende beroende på om databasen är aktiverad för XML eller inte. Vid aktivering av databasen för XML skapas användardefinierade typer (ADT), användardefinierade funktioner (ADF), en DTD-referenstabell för lagring av DTDer och tillhörande information samt en USAGE-tabell för lagring av gemensam information för varje aktiverad kolumn. När XML avaktiveras i en databas tas ADTer, ADFer, DTD-referenstabellen och USAGE-tabellen för XML bort av XML Extender. Du måste avaktivera alla XML-kolumner och -samlingar innan du försöker avaktivera XML i en databas.

  Importera DTD
    Med den här knappen öppnar du fönstret Importera DTD för import av befintliga DTD-filer (Document TypeDefinition) till DTD-förvaringsplatsen för den aktuella databasen. DTD gör det möjligt att validera XML-data i XML-kolumner och XML-samlingar. Det är valfritt för XML-kolumndata men obligatoriskt för XML-samlingsdata. |

  |Redigera DAD
    |Med den här knappen öppnar du fönstret Ange DAD för redigering av befintliga DAD-filer (Document Access |Definition) och skapandet av nya DAD. I DAD-filen definieras hur XML-|data samlas och sparas i DB2. Den gör det möjligt att definiera |attribut och nyckelelement i dina data så att det går att söka i dem. |Med DAD-filen för XML-kolumner avbildas XML-kolumner till sidotabeller för indexering. Med DAD-filen för |XML-samlingar avbildas DB2-data till dokumentstrukturen för XML.

  Arbeta med XML-kolumner
    |Med den här knappen öppnar du ett fönster där du kan lägga till, aktivera eller |avaktivera XML-kolumner i en tabell. Du lagrar och accessar XML-data genom att |aktivera en DB2-kolumn för XML-datatyper.

  Arbeta med XML-samlingar
    Med den här knappen öppnar du ett fönster där du kan aktivera och avaktivera en XML-samling i en databas. I en samling lagrar och öppnar du XML-data med en uppsättning relationstabeller.

  ## Åtgärder

  I startguiden kan du utföra följande XML Extender-åtgärder:

  - Logga in i databaser eller växla till andra databaser
  - Aktivera databas för XML och avaktivera XML i databas
  - Importera DTD
  - |Redigera DAD
  - Arbeta med XML-kolumner
  - Arbeta med XML-samlingar

  # Aktivera databas för XML och avaktivera XML i databas

  I den här guiden kan du aktiverar databaser för XML och avaktiverar XML i databaser. När du aktiverar en databas för XML skapas de ADTer, ADFer, lagrade procedurer och stödtabeller för administration som krävs när du använder XML Extender. Du måste aktivera databasen för XML om du ska kunna lagra, kompilera och dekompilera XML-dokument i den. När du avaktiverar XML i en databas tas ADTer, ADFer, lagrade procedurer och stödtabeller för administration bort.

  ## Åtgärd: Aktivera databas för XML

  Klicka på Aktivera databas för XML i startguiden när du vill aktivera den aktuella databasen. Om en databas redan är aktiverad är alternativet Avaktivera XML i databas tillgängligt.

  När databasen aktiverats för XML återgår du till startguiden.

  ## Åtgärd: Avaktivera XML i databas

  Klicka på Avaktivera XML i databas i startguiden när du vill avaktivera XML i den aktuella databasen. Om en databas inte är aktiverad för XML är alternativet Aktivera databas för XML tillgängligt.

  När databasen avaktiverats återgår du till startguiden.

  # Importera DTD

  I den här guiden kan du importera en DTD för validering av XML-dokument som lagras i XML-kolumner eller kompileras av DB2-data i XML-samlingar.

  ## Fält och kontroller

  DTD-filnamn
    Ange DTD-filnamnet eller klicka på ... om du vill bläddra i en lista med tillgängliga DTDer. Fältet är obligatoriskt.

  DTD-ID
    Ange namnet på DTD-IDt. IDt associerar DTDn med DAD-filen för XML-dokumentet och definierar placeringen för den. DTD-IDt identifierar DTDn och kan vara sökvägen som definierar var DTDn finns i det lokala systemet. DTD-IDt måste motsvara det värde som angetts i DAD-filen för <DTDID>-elementet. Fältet är obligatoriskt.

  Skapad av
    Ange namnet på den som skrivit DTD-filen. Namnet visas automatiskt om det angetts i DTD-förvaringsplatsen. Fältet är valfritt.

  Slutför
    Med den här knappen infogar du DTDn i DTD-förvaringsplatsen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ## Åtgärd: Importera DTD

  1. Klicka på Importera DTD i startguiden när du vill importera en befintlig DTD-fil till DTD-förvaringsplatsen i den aktuella databasen. Guiden Importera DTD visas.
  2. Ange DTD-filnamnet i fältet DTD-filnamn eller klicka på ... om du vill bläddra efter befintliga DTD-filer.
  3. Ange DTD-ID i fältet DTD-ID.
  4. Om du vill kan du ange namnet på den som skapat DTDn i fältet Skapad av.

     I XML Extender visas namnet på den person som skapat DTDn automatiskt om det angetts i DTDn.

  5. Klicka på Slutför när du vill infoga DTDn i DTD-förvaringsplatstabellen DB2XML.DTD_REF och återgå till startguiden.

  # Arbeta med DAD-filer

  I den här guiden kan du skapa och redigera DAD-filer och definiera hur XML-dokument används med DB2. DAD-filer används till följande:

  - Lagra XML-dokument i kolumner och definiera sidotabeller som är indexerade för snabb strukturell sökning.
  - Skapa XML-dokument av en eller flera DB2-tabeller som definieras i en XML-samling.
  - Dekompilera XML-dokument till en eller flera DB2-tabeller som definieras i en XML-samling.

  Om du vill veta mer om de här metoderna läser du i DB2 XML Extender Administration and Programming.

  ## Fält och kontroller

  ### Ange DAD: första steget för samtliga typer

  Filnamn
    Ange ett befintligt DAD-filnamn eller klicka på ... om du vill bläddra efter ett befintlig DAD-filnamn. Om du skapar en ny DAD lämnar du fältet tomt. Om DAD-filen finns visas typen av DAD-fil i Typ och knappen Nästa går att använda.

  Typ
    Om du skapar en ny DAD väljer du en av följande typer av DAD-filer:
    - XML-kolumn om du vill ange hur dokument lagrade i en kolumn ska indexeras
    - SQL-avbildningar för XML-samlingar om du vill ha avbildningar mellan relationsdata och XML-dokument med en enda SQL-sats
    - RDB-nodavbildningar för XML-samlingar om du vill ha noddefinitioner för tabeller, kolumner och villkor för definition av hur XML-data lagras

  Nästa
    Med den här knappen fortsätter du till nästa steg (Välj validering).

  Slutför
    Den här knappen aktiveras när du är klar med att skapa eller ändra en DAD-fil. Med den här knappen slutför du processen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Välj validering: steg 2 för samtliga typer

  Validera XML-dokument med DTD
    Välj det här alternativet om du vill validera XML-dokumenten. För giltiga dokument kan du genomföra strukturerade sökningar av dina data. Dokumenten valideras mot DTDn som angetts i DAD-filen. Du bör validera XML-data innan du infogar dem i DB2 då du inte kan validera data i DB2.

  DTD-ID
    Ange DTD-namnet eller välj namnet i listan över befintliga DTDer. Om du inte har importerat några DTDer till DTD-förvaringsplatsen för databasen kan du inte validera XML-dokument.

  |Validera inte
    Välj det här alternativet om du vill fortsätta utan att validera XML-dokumenten.

  Föregående
    Med den här knappen återgår du till föregående steg (Ange DAD).

  Nästa
    Med den här knappen fortsätter du till nästa steg. (Fönstret Hantera sidotabeller om du arbetar med XML-kolumner, Ange SQL-sats om du arbetar med XML-samlingar med SQL-avbildningar eller Ange text om du arbetar med XML-samlingar med RDB-nodavbildningar.)

  Slutför
    Den här knappen aktiveras när du är klar med att skapa eller ändra en DAD-fil. Med den här knappen slutför du processen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Hantera sidotabeller: steg 3 för kolumntypen XML

  |Lista över befintliga tabeller och kolumner
    |Den här tabellen innehåller en lista över de sidotabeller som ska skapas när en |XML-kolumn där den här DAD-filen används skapas. Du kan antingen välja |namn på befintliga tabeller och kolumner som du vill ändra eller ta bort eller också |ange nya namn i följande fält.

  Tabellnamn
    Ange namnet på en ny sidotabell som innehåller kolumnen. Om du valt en kolumn från listan visas tabellnamnet för den så att du kan ändra det om du vill. Fältet är obligatoriskt. Exempel:

        ORDER_SIDE_TAB

  Kolumnnamn
    Ange kolumnnamnet. Om du valt ett namn i kolumnlistan visas kolumnnamnet så att du kan ändra det om du vill. Fältet är obligatoriskt. Exempel:

        CUSTOMER_NAME

  Typ
    Välj eller ändra kolumntyp, t ex DATE, CHAR, INTEGER och VARCHAR. Fältet är obligatoriskt.

  Längd
    Om du valt VARCHAR anger du eller ändrar maximalt antal tecken för kolumnlängd. Fältet är endast aktiverat om typen är VARCHAR. Exempel:

        30

  Sökväg
    Ange eller ändra sökvägen för ett element eller attribut. Fältet är obligatoriskt. Exempel:

        /ORDER/CUSTOMER/NAME

  Flera förekomster
    Markera den här kryssrutan om du vill att elementet eller kolumnen ska kunna användas mer än en gång i ett dokument. Markera rutan för flera förekomster och lämna den tom om endast en förekomst ska vara tillåten.

  Lägg till
    Med den här knappen sparar du tabellen eller kolumnen med de uppgifter du angett och gör det möjligt att fortsätta lägga till, ändra samt ta bort tabeller och kolumner.

  Ändra
    Med den här knappen sparar du de ändringar du gör in fälten Tabellnamn, Kolumnnamn, Typ, Längd, Sökväg och Flera förekomster. När du ändrar namnet på en tabell eller kolumn tas det gamla objektet bort från listan och det nya läggs till.

  Ta bort
    Med den här knappen tar du bort markerade objekt från listan.

  Föregående
    Med den här knappen återgår du till föregående steg (Välj validering).

  Nästa
    Med den här knappen fortsätter du till nästa steg (Spara DAD).

  Slutför
    Den här knappen aktiveras när du är klar med att skapa eller ändra en DAD-fil. Med den här knappen slutför du processen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Ange text: steg 3 för typerna SQL-avbildning och RDB-nodavbildning

  Prolog
    Ange ett prolognamn. Om du redigerar en befintlig DAD visas namnet automatiskt. Namnet bör ha formatet

        <?xml version="1.0" ?>

    Fältet är obligatoriskt.

  Dokumenttyp
    Ange XML-dokumenttyp. Om du redigerar en befintlig DAD visas dokumenttypen automatiskt. Fältet är obligatoriskt. Exempel:

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

  Föregående
    Med den här knappen återgår du till föregående steg (Välj validering).

  Nästa
    Med den här knappen fortsätter du till nästa steg (Avbilda RDB-noder om typen är RDB-nodavbildning eller Ange SQL-sats om typen är SQL-avbildning).

  Slutför
    Den här knappen aktiveras när du är klar med att skapa eller ändra en DAD-fil. Med den här knappen slutför du processen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Ange SQL-sats: steg 4 för typen SQL-avbildning

  SQL-sats
    Ange en SQL SELECT-sats. Om du redigerar en befintlig DAD-fil visas SQL-satsen automatiskt. Med satsen avbildas kolumnerna i SELECT-delsatsen till XML-element eller -attribut i XML-dokumentet. Med FROM-delsatsen definieras tabellerna som innehåller data. Med WHERE-delsatsen anges hopkopplings- och sökvillkor. Alla tabeller i samlingen måste gå att koppla ihop med en SELECT-sats. Fältet är obligatoriskt. Exempel:

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

    För SQL-satsen gäller följande riktlinjer:

    - Kolumner anges uppifrån och ned i enlighet med hierarkin i XML-dokumentstrukturen.
    - Kolumnerna för en enhet grupperas tillsammans och varje grupp har en kolumn med objekt-IDn.
    - Kolumnen med objekt-IDn är den första kolumnen i varje grupp.
    - För tabeller som inte använder en villkorskolumn för en enskild nyckel använder du den inbyggda funktionen generate_unique och genererar kolumnen.
    - Kolumnerna med objekt-IDn visas sedan uppifrån och ned i ORDER BY-satser. Kolumnerna i ORDER BY bör inte ha schema och tabellnamn som namnled och bör motsvara kolumnnamnen i SELECT-delsatsen.

  Testa SQL
    Med den här knappen testar du SQL-satsens giltighet. Om SQL-satsen är giltig visas exempel på resultat i fältet Exempelresultat. Om satsen är ogiltig uppmanas du att korrigera satsen och försöka igen.

  Exempelresultat
    I det här fältet visas exempel på de resultat du kan få när du testar SQL-satser om satsen är giltig. Fältinnehållet kan inte redigeras.

  Föregående
    Med den här knappen återgår du till föregående steg (Välj validering).

  Nästa
    Med den här knappen fortsätter du till nästa steg (Avbilda SQL).

  Slutför
    Den här knappen aktiveras när du är klar med att skapa eller ändra en DAD-fil. Med den här knappen slutför du processen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Avbilda SQL: steg 5 för typen SQL-avbildning

  DAD-avbildning
    Välj en nod att avbilda från i DAD-avbildningen som visas. Du kan avbilda element och attribut i XML-dokumentet till element- och attributnoder som motsvarar DB2-data. Noderna ger sökvägen från XML-data till DB2-data. Välj en nod om du vill aktivera Nytt element. När du markerar en nod visas lämpliga fält i grupprutan Detaljer.

  Nodtyp
    Välj en nodtyp i listan med typer som är giltiga så här långt i avbildningen. Beroende på vilken nodtyp du väljer visas olika fält i grupprutan Detaljer. Fältet är obligatoriskt.

    Element
      Det XML-element som definierats i den DTD som associerats med XML-dokumentet och som används till att associera XML-elementet med en kolumn i en DB2-tabell. En elementnod kan ha attributnoder, underordnade elementnoder och textnoder. En nod på lägsta nivån är associerad med en textnod och ett kolumnnamn i trädvyn.

    Attribut
      Det XML-attribut som definierats i den DTD som associerats med XML-dokumentet och som används till att associera XML-attributet med en kolumn i en DB2-tabell. En attributnod kan ha en textnod och vara associerad med ett kolumnnamn i trädvyn.

    Text
      Textinnehållet för en elementnod. En textnod associeras med ett kolumnnamn i trädvyn.

  Nodnamn
    Ange nodnamnet. Fältet är obligatoriskt. Exempel:

        Order

  Kolumn
    Om du valt Attribut eller Text som nodtyp väljer du ett kolumnnamn. Fältet är obligatoriskt. Om du anger Kolumn som nodtyp kan du endast välja en kolumn som redan finns i DB2-databasen. Exempel:

        Customer_Name

  Lägg till
    Med den här knappen lägger du till lämplig etikett för det tomma element som läggs till i trädstrukturen.

  Ändra
    Med den här knappen gör du ändringar i den markerade noden. Du kan markera noder flera gånger och göra fler ändringar.

  Ta bort
    Med den här knappen tar du bort det markerade elementet eller attributet.

  Nytt element
    Med den här knappen skapar du en ny nod genom att rensa fälten i grupprutan Detaljer, lägga till ett tomt element nedanför det markerade elementet i trädstrukturen och markera det nya tomma elementet.

  Föregående
    Med den här knappen återgår du till föregående steg (Ange SQL-sats).

  Nästa
    Med den här knappen fortsätter du till nästa steg (Spara DAD).

  Slutför
    Den här knappen aktiveras när du är klar med att skapa eller ändra en DAD-fil. Med den här knappen slutför du processen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Avbilda RDB-noder: steg 4 för typen RDB-nodavbildning

  DAD-avbildning
    Välj en nod att avbilda från i DAD-avbildningen som visas. Du avbildar element och attribut i XML-dokumentet till element- och attributnoder som motsvarar DB2-data. Noderna ger sökvägen från XML-data till DB2-data. De anger vilken tabell och vilka kolumner som innehåller dessa data och enligt vilka villkor du kan hämta dem. Välj en nod om du vill aktivera Nytt element. När du markerar en nod visas lämpliga fält i grupprutan Detaljer.

  Nodtyp
    Välj en nodtyp i listan med typer som är giltiga på den här punkten i avbildningen. Beroende på vilken nodtyp du väljer visas olika fält i grupprutan Detaljer. Fälten kan vara Element, Attribut, Text, Tabell, Kolumn eller Villkor, beroende på vad du valde i DAD-avbildningen. Fältet är obligatoriskt.

    Element
      Det XML-element som definierats i den DTD som associerats med XML-dokumentet och som används till att associera XML-elementet med en kolumn i en DB2-tabell. En elementnod kan ha attributnoder, underordnade elementnoder, textnoder, tabellnoder eller villkorsnoder. Ett rotelement har tabellnoder som anger alla tabeller som används till att generera XML-dokument och en villkorsnod som används till att ansluta tabellerna. Fältet är obligatoriskt. Exempel:

          element_node name="Order"

    Attribut
      Den XML-attributnod som definieras i den DTD som associerats med XML-dokumentet och som används till att associera XML-attributet med en kolumn i en DB2-tabell. En attributnod kan ha en textnod och har ett kolumnnamn associerat till sig i DAD-avbildningen. Data finns i attributnoden och textnoden för varje element. Fältet är obligatoriskt. Exempel:

          attribute_node name="key"

      |

    |Tabell
      |Tabellen som associerats med textnoden eller innehållet i |attributnoden. Här anges namnet på den DB2-tabell där innehållet i |text- eller attributnoden lagras eller hämtas |från. Exempel:

          |table_node name=order_tab

      |

    |Kolumn
      |Kolumnen med innehållet i text- eller |attributnoden. Här anges namnet på den kolumn i en DB2-tabell där innehållet i |text- eller attributnoden lagras eller hämtas |från. Exempel:

          |column name="order_key"

  Nodnamn
    Ange namnet på ett element eller attribut. Fältet är obligatoriskt. Exempel:

        element_node name="Price"

  Text
    Textinnehållet i ett element och kolumndata i en relationstabell för element på den lägsta nivån. Här finns ett tabellelement, kolumnelement och ett villkorselement för rotnoden.

  Tabellnamn
    Namnet på den tabell som innehåller kolumnen. Exempel:

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

  Tabellnyckel
    Den primära nyckeln för en tabell, bestående av en enda kolumn eller flera kolumner (sammansatt nyckel). Nyckeln används till att binda samman tabeller i en samling. Exempel på sammansatta nycklar:

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

  Kolumn
    Namnet på den kolumn som innehåller data för elementtexten och där elementet och attributet avbildas. Exempel:

        column name="order_key" type="integer"

  Villkor
    I rotelement anger det här fältet hur XML-samlingstabeller hopkopplas. I element på lägre nivåer anges i det här fältet villkoren för urval av XML-data med värdena =, <, > eller LIKE. Exempel på villkor för rotl-element:

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

    Exempel på villkor för urval av XML-data:

        price > 2500.00

  Lägg till
    Med den här knappen lägger du till lämplig etikett för det tomma element som läggs till i trädstrukturen.

  Ändra
    Med den här knappen gör du ändringar i den markerade noden. Du kan markera noder flera gånger och göra fler ändringar.

  Ta bort
    Med den här knappen tar du bort det markerade elementet.

  Nytt element
    Med den här knappen skapar du en ny nod genom att rensa fälten i grupprutan Detaljer, lägga till ett tomt element nedanför det markerade elementet i trädstrukturen och markera det nya tomma elementet.

  Föregående
    Med den här knappen återgår du till föregående steg (Ange text).

  Nästa
    Med den här knappen fortsätter du till nästa steg (Spara DAD).

  Slutför
    Den här knappen aktiveras när du är klar med att skapa eller ändra en DAD-fil. Med den här knappen slutför du processen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Spara DAD: sista steget för samtliga typer

  Filnamn
    Ange filnamnet för den nya eller ändrade DAD du vill spara eller klicka på ... om du vill öppna den lokala dialogrutan för filbläddring och ange var DAD-filen ska sparas. Fältet är obligatoriskt.

  Föregående
    Med den här knappen återgår du till föregående steg.

  Slutför
    med den här knappen sparar du DAD-filen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ## Åtgärder

  ### Skapa och redigera DAD för XML-kolumner

  När du skapar en DAD för en XML-kolumn anger du datatypen för XML-dokumentet och definierar sidotabeller som används för indexering.

  1. |Klicka på Redigera DAD i startguiden om du vill redigera eller skapa en |XML DAD-fil. Guiden Arbeta med DAD-filer startas med fönstret |Ange DAD först.
  2. Välj om du vill redigera en befintlig DAD-fil eller skapa en ny DAD-fil.
     - Så här redigerar du en befintlig DAD:
       1. Klicka på ... om du vill bläddra efter en befintlig DAD-fil i listan, eller ange DAD-filens namn i fältet Filnamn.
       2. Kontrollera att guiden hittar den angivna DAD-filen.
          - Om guiden identifierar den angivna DAD-filen går det att välja Nästa och XML-kolumnen visas i fältet Typ.
          - Om guiden inte identifierar den angivna DAD-filen går det inte att välja Nästa. Antingen anger du DAD-filnamnet på nytt i fältet Filnamn, eller så klickar du på ... och bläddrar en gång till efter en befintlig DAD-fil. Fortsätt tills Nästa går att välja.
       3. Klicka på Nästa.
     - Så här skapar du en ny DAD:
       1. Lämna fältet Filnamn tomt.
       2. I listan Typ klickar du på XML-kolumn.
       3. Klicka på Nästa.
  3. Välj om du vill validera XML-dokumenten med en DTD i fönstret Välj validering.
     - Så här validerar du:
       1. Klicka på Validera XML-dokument med DTD.
       2. Markera den DTD du vill använda för validering i listan med DTD-IDn.

       Du kan inte validera XML-dokumenten om du inte har importerat några DTDer till DTD-förvaringsplatsen för databasen.

     - Klicka på |Validera inte om du vill fortsätta utan att validera XML-dokumenten.
  4. Klicka på Nästa.
  5. Välj om du vill lägga till en ny sidotabell, redigera en befintlig sidotabell eller ta bort en befintlig sidotabell i fönstret Sidotabeller.
     - Så här lägger du till en ny sidotabell eller sidotabellskolumn:

       När du vill lägga till en ny sidotabell definierar du kolumnerna i tabellen. Utför följande steg för varje kolumn i en sidotabell.

       1. Fyll i fälten i rutan Detaljer i fönstret Sidotabeller.
          1. Tabellnamn: Ange namnet på tabellen som innehåller kolumnen.
          2. Kolumnnamn: Ange kolumnens namn.
          3. Typ: Välj kolumntyp i listan.
          4. Längd (endast typen VARCHAR): Ange maximalt antal VARCHAR-tecken.
          5. Sökväg: Ange placeringen för elementet eller attributet.
          6. Flera förekomster: Välj Nej eller Ja i listan.

             Visar om elementet eller attributet går att använda mer än en gång i ett dokument. Viktigt Om du anger flera förekomster för en kolumn kan du endast definiera en kolumn i sidotabellen kolumnen finns i.

       2. Klicka på Lägg till om du vill lägga till en kolumn.
       3. Fortsätt att lägga till, redigera, och ta bort kolumner för sidotabellen, eller klicka på Nästa.
     - Så här redigerar du en befintlig sidotabellskolumn:

       Du kan uppdatera en sidotabell genom att ändra definitionerna för de befintliga kolumnerna.

       1. Klicka på den sidotabell och det kolumnnamn du vill redigera.
       2. Redigera fälten i rutan Detaljer.
       3. Klicka på Ändra när du vill spara ändringar.
       4. Fortsätt att lägga till, redigera, och ta bort kolumner för sidotabeller, eller klicka på Nästa.
     - Så här redigerar du en befintlig sidotabell:
       1. Klicka på den sidotabell och kolumn du vill ta bort.
       2. Klicka på Ta bort.
       3. Fortsätt att lägga till, redigera, och ta bort kolumner i sidotabeller, eller klicka på Nästa.
     - Så här tar du bort en befintlig sidotabell:

       Ta bort varje kolumn i sidotabellen så att den tas bort.

       1. Klicka på alla sidotabellskolumner för den tabell du vill ta bort.
       2. Klicka på Ta bort.
       3. Fortsätt att lägga till, redigera, och ta bort kolumner i sidotabeller, eller klicka på Nästa.
  6. Ange ett utdatafilnamn för den ändrade DAD-filen i fältet Filnamn i fönstret Ange DAD.
  7. Klicka på Slutför om du vill spara DAD-filen och återgå till startguiden.

  ### Skapa och redigera DAD för XML-samlingar

  När du skapar DAD för XML-samlingen avbildar du XML-dokumentet till DB2-datakällan med en av följande metoder:

  - Skapa en XML-fil med hjälp av SQL-avbildning
  - Skapa en XML-fil med hjälp av RDB-nodavbildning
  - Dekompilera en XML-fil med hjälp av RDB-nodavbildning

  #### Skapa med SQL-avbildning

  1. Klicka på |Redigera DAD i startguiden. Fönstret Ange DAD visas.
  2. Välj om du vill redigera en befintlig DAD-fil eller skapa en ny DAD-fil.

     Så här skapar du en ny DAD-fil:

     1. Lämna fältet Filnamn tomt.
     2. I listan Typ väljer du XML-samling med SQL-avbildning.
     3. Öppna fönstret Välj validering genom att klicka på Nästa.

     Så här redigerar du en befintlig DAD-fil:

     1. Ange DAD-filnamnet i fältet Filnamn eller klicka på ... om du vill bläddra efter en befintlig DAD-fil.
     2. Kontrollera att guiden hittar den angivna DAD-filen.
        - Om guiden identifierar den angivna DAD-filen går det att välja Nästa och XML-samling med SQL-avbildning visas i fältet Typ.
        - Om guiden inte identifierar den angivna DAD-filen går det inte att välja Nästa. Antingen anger du DAD-filnamnet på nytt, eller så klickar du på ... och bläddrar en gång till efter en befintlig DAD-fil. Upprepa föregående steg tills Nästa går att välja.
     3. Öppna fönstret Välj validering genom att klicka på Nästa.
  3. I fönstret Välj validering anger du om du vill validera XML-dokumenten med en DTD.
     - Så här validerar du:
       1. Klicka på Validera XML-dokument med DTD.
       2. Markera den DTD du vill använda för validering i listan med DTD-IDn.

       Du kan inte validera XML-dokumenten om du inte har importerat några DTDer till DTD-förvaringsplatsen för databasen.

     - Klicka på |Validera inte om du vill fortsätta utan att validera XML-dokumenten.
  4. Öppna fönstret Ange text genom att klicka på Nästa.
  5. Definiera prologen för XML-dokumentet du skapar genom att ange prolognamnet i fältet Prolog.

         <?xml version="1.0"?>

     Om du redigerar en befintlig DAD visas prologen automatiskt i fältet Prolog.

  6. Ange dokumenttypen för XML-dokumentet i fältet Dokumenttyp i fönstret Ange text så att den pekar på DTDn för XML-dokumentet. Exempel:

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

     Om du redigerar en befintlig DAD visas dokumenttypen automatiskt i fältet Dokumenttyp.

  7. Öppna fönstret Ange SQL-sats genom att klicka på Nästa.
  8. Ange en giltig SQL SELECT-sats i fältet SQL-sats.

     Om du redigerar en befintlig DAD visas SQL-satsen automatiskt i fältet SQL-sats.

  9. Klicka på Testa SQL om du vill testa SQL-satsens giltighet.
     - Om SQL-satsen är giltig visas exempel på resultat i fältet Exempelresultat.
     - Om SQL-satsen är ogiltig visas ett felmeddelande i fältet Exempelresultat. I felmeddelandet instrueras du att korrigera SQL SELECT-satsen och försöka igen.
  10. |Öppna fönstret Avbilda SQL genom att klicka på Nästa.
  11. Välj en element- eller attributnod att avbilda ifrån genom att klicka på den i fältet till vänster i fönstret |Avbilda SQL.

      Avbilda element och attribut i XML-dokumentet till element- och attributnoder som motsvarar DB2-data. De noderna ger sökvägen från XML-data till DB2-data.

      - Så här lägger du till rotnoden:
        1. Välj ikonen Rot.
        2. Klicka på Nytt element när du vill definiera en ny nod.
        3. I rutan Detaljer anger du Nodtyp som Element.
        4. Ange namnet på rotnoden i fältet Nodnamn.
        5. Klicka på Lägg till om du vill skapa den nya noden.

           Du har skapat rotnivånoden eller -elementet, som är överordnat alla andra element- och attributnoder i avbilden. Nu kan du lägga till underordnade element och attribut i noden.

      - Så här lägger du till en underordnad element- eller attributnod:
        1. Klicka på en överordnad nod i fältet till vänster om du vill lägga till ett underordnat element eller attribut.

           Om du inte har markerat en överordnad nod går inte Nytt element att välja.

        2. Klicka på Nytt element.
        3. Välj nodtyp i listan Nodtyp i rutan Detaljer.

           I listan Nodtyp visas bara de nodtyper som är giltiga på den här punkten i avbildningen.

        4. Ange nodnamnet i fältet Nodnamn i rutan Detaljer.
        5. Om du angett Attribut, Element eller Text som Nodtyp för ett element på lägsta nivån väljer du en kolumn i fältet Kolumn i rutan Detaljer.

           Begränsning: Det går inte att skapa nya kolumner med administrationsguiden. Om du anger Kolumn som nodtyp kan du endast välja en kolumn som redan finns i DB2-databasen.

        6. Klicka på Lägg till om du vill lägga till den nya noden.

           Du kan ändra en nod senare genom att klicka på den i fältet till vänster och göra ändringarna i rutan Detaljer. Klicka på Ändra när du vill uppdatera elementet.

           Du kan också lägga till underordnade element och attribut i noden genom att markera noden och upprepa tilläggsprocessen.

        7. Fortsätt att redigera SQL-avbildningen eller klicka på Nästa om du vill öppna fönstret Ange DAD.
      - Så här tar du bort en nod:
        1. Klicka på en nod i fältet till vänster.
        2. Klicka på Ta bort.
        3. Fortsätt att redigera SQL-avbildningen eller klicka på Nästa om du vill öppna fönstret Ange DAD.

        Observera att om du tar bort en nod på lägsta nivån, så blir ett annat element noden på lägsta nivån, vilket kan innebära att ett kolumnnamn behöver definieras för det.

  12. Ange ett utdatafilnamn för den ändrade DAD-filen i fältet Filnamn i fönstret Ange DAD.
  13. Klicka på Slutför om du vill återgå till startguiden.

  #### Skapa med RDB-nodavbildning

  1. Klicka på |Redigera DAD i startguiden. Fönstret Ange DAD visas.
  2. Välj om du vill redigera en befintlig DAD-fil eller skapa en ny DAD-fil.

     Så här redigerar du en befintlig DAD:

     1. Ange DAD-filnamnet i fältet Filnamn eller klicka på ... om du vill bläddra efter en befintlig DAD-fil.
     2. Kontrollera att guiden hittar den angivna DAD-filen.
        - Om guiden identifierar den angivna DAD-filen går det att välja Nästa och XML-samling med RDB-nodavbildning visas i fältet Typ.
        - Om guiden inte identifierar den angivna DAD-filen går det inte att välja Nästa. Antingen anger du DAD-filnamnet på nytt i fältet Filnamn, eller så klickar du på ... och bläddrar en gång till efter en befintlig DAD-fil. Upprepa de här stegen tills Nästa går att välja.
     3. Öppna fönstret Välj validering genom att klicka på Nästa.

     Så här skapar du en ny DAD:

     1. Lämna fältet Filnamn tomt.
     2. Välj XML-samling med RDB-nodavbildning i listan Typ.
     3. Öppna fönstret Välj validering genom att klicka på Nästa.
  3. I fönstret Välj validering anger du om du vill validera XML-dokumenten med en DTD.
     - Så här validerar du:
       1. Klicka på Validera XML-dokument med DTD.
       2. Markera den DTD du vill använda för validering i listan med DTD-IDn.

       Du kan inte validera XML-dokumenten om du inte har importerat några DTDer till DTD-förvaringsplatsen för databasen.

     - Klicka på |Validera inte om du vill fortsätta utan att validera XML-dokumenten.
  4. Öppna fönstret Ange text genom att klicka på Nästa.
  5. Ange prolognamnet i fältet Prolog i fönstret Ange text.

         <?xml version="1.0"?>

     Om du redigerar en befintlig DAD visas prologen automatiskt i fältet Prolog.

  6. Ange XML-dokumentets dokumenttyp i fältet Dokumenttyp. Exempel:

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

     Om du redigerar en befintlig DAD visas dokumenttypen automatiskt i fältet Dokumenttyp.

  7. |Öppna fönstret Avbilda RDB-noder genom att klicka på Nästa.
  8. Välj en element- eller attributnod att avbilda ifrån genom att klicka på den i fältet till vänster i fönstret |Avbilda RDB-noder.

     Avbilda element och attribut i XML-dokumentet till element- och attributnoder som motsvarar DB2-data. De noderna ger sökvägen från XML-data till DB2-data.

  9. Så här lägger du till rotnoden:
     1. Välj ikonen Rot.
     2. Klicka på Nytt element när du vill definiera en ny nod.
     3. I rutan Detaljer anger du Nodtyp som Element.
     4. Ange namnet på rotnoden i fältet Nodnamn.
     5. Klicka på Lägg till om du vill skapa den nya noden.

        Du har skapat rotnivånoden eller -elementet, som är överordnat alla andra element- och attributnoder i avbilden. Rotnoden har underordnade tabellelement och ett hopkopplingsvillkor.

        Lägg till tabellnoder för varje tabell som är del av samlingen.

        1. Markera rotnodsnamnet och välj Nytt element.
        2. I rutan Detaljer anger du Nodtyp som Element.
        3. Markera namnet på tabellen i Tabellnamn. Tabellen måste redan finnas.
        4. Klicka på Lägg till så att tabellnoden läggs till.
        5. Upprepa stegen för varje tabell.

        Lägg till ett hopkopplingsvillkor för tabellnoderna.

        1. Markera rotnodsnamnet och välj Nytt element.
        2. I rutan Detaljer anger du Nodtyp som Tabell.
        3. I fältet Villkor anger du hopkopplingsvillkoret med följande syntax:

               tabellnamn.tabellkolumn = tabellnamn.tabellkolumn AND
               tabellnamn.tabellkolumn = tabellnamn.tabellkolumn ...

           Ta med så många villkor, sammankopplade med AND, som krävs för att skapa hopkopplingsvillkoret.

        4. Klicka på Lägg till så att villkoret läggs till.

     Nu kan du lägga till underordnade element och attribut i noden.

  10. Så här lägger du till en underordnad element- eller attributnod:
      1. Klicka på en överordnad nod i fältet till vänster om du vill lägga till ett underordnat element eller attribut.
      2. Klicka på Nytt element. Om du inte har markerat en överordnad nod går inte Nytt element att välja.
      3. Välj nodtyp i listan Nodtyp i rutan Detaljer.

         I listan Nodtyp visas endast de nodtyper som är giltiga på den punkten i avbilden, antingen Element eller Attribut.

      4. Ange namnet på elementet eller attributet i fältet Nodnamn.
      5. Om du angett Attribut som Nodtyp, eller Element för ett element på lägsta nivån väljer du en kolumn i fältet Kolumn i rutan Detaljer.

         Begränsning: Det går inte att skapa nya kolumner med administrationsguiden. Om du anger Kolumn som nodtyp kan du endast välja en kolumn som redan finns i DB2-databasen.

      6. Klicka på Lägg till om du vill lägga till den nya noden.

         Du kan ändra en nod senare genom att klicka på den i fältet till vänster och göra ändringarna i rutan Detaljer. Klicka på Ändra när du vill uppdatera elementet.

         Du kan också lägga till underordnade element och attribut i noden genom att markera noden och upprepa tilläggsprocessen.

      7. Så här avbildar du innehållet i en element- eller attributnod i en relationstabell:
         1. Ange en textnod.
            1. Klicka på den överordnade noden.
            2. Klicka på Nytt element.
            3. I fältet Nodtyp väljer du Text.
            4. Klicka på Lägg till så att noden läggs till.
         2. Lägg till en tabellnod.
            1. Välj den textnod du just har skapat och klicka på Nytt element.
            2. I fältet Nodtyp väljer du Tabell och anger ett tabellnamn för elementet.
            3. Klicka på Lägg till så att noden läggs till.
         3. Lägg till en kolumnnod.
            1. Välj textnoden igen och klicka på Nytt element.
            2. I fältet Nodtyp väljer du Kolumn och anger ett tabellnamn för elementet.
            3. Klicka på Lägg till så att noden läggs till.

            Begränsning: Det går inte att skapa nya kolumner med administrationsguiden. Om du anger Kolumn som nodtyp kan du endast välja en kolumn som redan finns i DB2-databasen.

         4. Om du vill kan du lägga till ett villkor för kolumnen.
            1. Välj textnoden igen och klicka på Nytt element.
            2. I fältet Nodtyp väljer du Villkor och anger ett villkor med följande syntax:

                   operator LIKE|<|>|= värde

            3. Klicka på Lägg till så att noden läggs till.
      8. Fortsätt att redigera RDB-nodavbildningen eller klicka på Nästa om du vill öppna fönstret Ange DAD.
  11. Så här tar du bort en nod:
      1. Klicka på en nod i fältet till vänster.
      2. Klicka på Ta bort.
      3. Fortsätt att redigera RDB-nodavbildningen eller klicka på Nästa om du vill öppna fönstret Ange DAD.
  12. Ange ett utdatafilnamn för den ändrade DAD-filen i fältet Filnamn i fönstret Ange DAD.
  13. Klicka på Slutför om du vill ta bort noden och återgå till startguiden.

  #### Dekompilera med RDB-nodavbildning

  1. Klicka på |Redigera DAD i startguiden. Fönstret Ange DAD visas.
  2. Välj om du vill redigera en befintlig DAD-fil eller skapa en ny DAD-fil.

     Så här redigerar du en befintlig DAD:

     1. Ange DAD-filnamnet i fältet Filnamn eller klicka på ... om du vill bläddra efter en befintlig DAD-fil.
     2. Kontrollera att guiden hittar den angivna DAD-filen.
        - Om guiden identifierar den angivna DAD-filen går det att välja Nästa och XML-samling med RDB-nodavbildning visas i fältet Typ.
        - Om guiden inte identifierar den angivna DAD-filen går det inte att välja Nästa. Antingen anger du DAD-filnamnet på nytt i fältet Filnamn, eller så klickar du på ... och bläddrar en gång till efter en befintlig DAD-fil. Upprepa de här stegen tills Nästa går att välja.
     3. Öppna fönstret Välj validering genom att klicka på Nästa.

     Så här skapar du en ny DAD:

     1. Lämna fältet Filnamn tomt.
     2. Välj XML-samling med RDB-nodavbildning i listan Typ.
     3. Öppna fönstret Välj validering genom att klicka på Nästa.
  3. I fönstret Välj validering anger du om du vill validera XML-dokumenten med en DTD.
     - Så här validerar du:
       1. Klicka på Validera XML-dokument med DTD.
       2. Markera den DTD du vill använda för validering i listan med DTD-IDn.

       Du kan inte validera XML-dokumenten om du inte har importerat några DTDer till DTD-förvaringsplatsen för databasen.

     - Klicka på |Validera inte om du vill fortsätta utan att validera XML-dokumenten.
  4. Öppna fönstret Ange text genom att klicka på Nästa.
  5. Om du endast dekompilerar ett XML-dokument ignorerar du fältet Prolog. Om du använder DAD-filen till att skapa och dekompilera anger du prolognamnet i fältet Prolog i fönstret Ange text. Prologen krävs inte om du dekompilerar XML-dokument till DB2-data.

         <?xml version="1.0"?>

     Om du redigerar en befintlig DAD visas prologen automatiskt i fältet Prolog.

  6. Om du endast dekompilerar ett XML-dokument ignorerar du fältet Dokumenttyp. Om du använder DAD-filen till att skapa och dekompilera anger du XML-dokumentets dokumenttyp i fältet Dokumenttyp.

     Om du redigerar en befintlig DAD visas dokumenttypen automatiskt i fältet Dokumenttyp. Exempel:

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

  7. Öppna fönstret RDB-avbildning genom att klicka på Nästa.
  8. Välj en element- eller attributnod att avbilda ifrån genom att klicka på den i fältet till vänster i fönstret RDB-avbildning.

     Avbilda element och attribut i XML-dokumentet till element- och attributnoder som motsvarar DB2-data. De noderna ger sökvägen från XML-data till DB2-data.

  9. Så här lägger du till rotnoden:
     1. Välj ikonen Rot.
     2. Klicka på Nytt element när du vill definiera en ny nod.
     3. I rutan Detaljer anger du Nodtyp som Element.
     4. Ange namnet på rotnoden i fältet Nodnamn.
     5. Klicka på Lägg till om du vill skapa den nya noden.

        Du har skapat rotnivånoden eller -elementet, som är överordnat alla andra element- och attributnoder i avbilden. Rotnoden har underordnade tabellelement och ett hopkopplingsvillkor.

        Lägg till tabellnoder för varje tabell som är del av samlingen.

        1. Markera rotnodsnamnet och välj Nytt element.
        2. I rutan Detaljer anger du Nodtyp som Element.
        3. Markera namnet på tabellen i Tabellnamn. Tabellen måste redan finnas.
        4. Ange en kolumn för tabellen i fältet Tabellnyckel.
        5. Klicka på Lägg till så att tabellnoden läggs till.
        6. Upprepa stegen för varje tabell.

        Lägg till ett hopkopplingsvillkor för tabellnoderna.

        1. Markera rotnodsnamnet och välj Nytt element.
        2. I rutan Detaljer anger du Nodtyp som Tabell.
        3. I fältet Villkor anger du hopkopplingsvillkoret med följande syntax:

               tabellnamn.tabellkolumn = tabellnamn.tabellkolumn AND
               tabellnamn.tabellkolumn = tabellnamn.tabellkolumn ...

        4. Klicka på Lägg till så att villkoret läggs till.

     Nu kan du lägga till underordnade element och attribut i noden.

  10. Så här lägger du till en underordnad element- eller attributnod:
      1. Klicka på en överordnad nod i fältet till vänster om du vill lägga till ett underordnat element eller attribut.

         Om du inte har markerat en överordnad nod går inte Nytt att välja.

      2. Klicka på Nytt element.
      3. Välj nodtyp i listan Nodtyp i rutan Detaljer.

         I listan Nodtyp visas endast de nodtyper som är giltiga på den punkten i avbilden, antingen Element eller Attribut.

      4. Klicka på Lägg till om du vill lägga till den nya noden. Du kan ändra en nod senare genom att klicka på den i fältet till vänster och göra ändringarna i rutan Detaljer. Klicka på Ändra när du vill uppdatera elementet.
      5. Så här avbildar du innehållet i en element- eller attributnod i en relationstabell:
         1. Ange en textnod.
            1. Klicka på den överordnade noden.
            2. Klicka på Nytt element.
            3. I fältet Nodtyp väljer du Text.
            4. Klicka på Lägg till så att noden läggs till.
         2. Lägg till en tabellnod.
            1. Välj den textnod du just har skapat och klicka på Nytt element.
            2. I fältet Nodtyp väljer du Tabell och anger ett tabellnamn för elementet.
            3. Klicka på Lägg till så att noden läggs till.
         3. Lägg till en kolumnnod.
            1. Välj textnoden igen och klicka på Nytt element.
            2. I fältet Nodtyp väljer du Kolumn och anger ett tabellnamn för elementet.
            3. Ange basdatatypen för kolumnen i fältet Typ, så att du anger vilken typ kolumnen måste vara när data utan märkord ska lagras i den.
            4. Klicka på Lägg till så att noden läggs till.

            Begränsning: Det går inte att skapa nya kolumner med administrationsguiden. Om du anger Kolumn som nodtyp kan du endast välja en kolumn som redan finns i DB2-databasen.

         4. Om du vill kan du lägga till ett villkor för kolumnen.
            1. Välj textnoden igen och klicka på Nytt element.
            2. I fältet Nodtyp väljer du Villkor och anger ett villkor med följande syntax:

                   operator LIKE|<|>|= värde

            3. Klicka på Lägg till så att noden läggs till.
      6. Fortsätt att redigera RDB-nodavbildningen eller klicka på Nästa om du vill öppna fönstret Ange DAD.
  11. Så här tar du bort en nod:
      1. Klicka på en nod i fältet till vänster.
      2. Klicka på Ta bort.
      3. Fortsätt att redigera RDB-nodavbildningen eller klicka på Nästa om du vill öppna fönstret Ange DAD.
  12. Ange ett utdatafilnamn för den ändrade DAD-filen i fältet Filnamn i fönstret Ange DAD.
  13. Klicka på Slutför om du vill ta bort noden och återgå till startguiden.

  # Arbeta med XML-kolumner

  Med hjälp av den här guiden kan du lägga till, aktivera och avaktivera XML-kolumner för XML Extender.

  ## Fält och kontroller

  ### Välj åtgärd (för kolumner)

  Lägg till XML-kolumn
    Välj alternativet om du vill öppna fönstret Lägg till XML-kolumn och lägga till en kolumn i en tabell. Kolumnen kommer att innehålla ett fullständigt XML-dokument. Alternativet är bara tillgängligt om databasen är aktiverad.

  |Aktivera XML-kolumn
    Välj alternativet om du vill öppna fönstret |Aktivera XML-kolumn där du kan ansluta till en databas och aktivera en XML-kolumn så att den kan innehålla användardefinierade typer (ADTer) för XML Extender. Alternativet är bara tillgängligt om databasen är aktiverad och kolumner skapas för XML-dokument.

  |Avaktivera XML-kolumn
    Välj alternativet om du vill öppna fönstret |Avaktivera XML-kolumn och avaktivera en befintlig kolumn. Om databasen inte är aktiverad, eller det saknas en aktiverad XML-kolumn, är alternativet inte tillgängligt. En avaktiverad kolumn kan inte innehålla XML-dokument. Du måste avaktivera en XML-kolumn innan du tar bort en XML-tabell. Om en tabell tas bort utan att XML-kolumnen avaktiverats behålls de sidotabeller den skapat, liksom XML-kolumnposten i USAGE-tabellen för XML, av XML Extender.

  Nästa
    Med den här knappen öppnar du fönstret du valt, så att du kan lägga till, aktivera eller avaktivera en XML-kolumn.

  Slutför
    Den här knappen är tillgänglig när du avslutat arbetet med kolumnen.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Lägg till XML-kolumn

  Tabellnamn
    Ange tabellnamnet eller välj namnet i listan över befintliga tabeller. Tabellen måste vara definierad om du vill lägga till en XML-kolumn. Exempel:

        SALES_DB

  Kolumnnamn
    Ange det namn du vill använda för XML-kolumnen. Exempel:

        ORDER

  |Datatyp
    Välj datatyp i listan över tillgängliga typer, som XMLCLOB, XMLVARCHAR eller XMLFILE. Exempel:

        XMLVARCHAR

  Föregående
    Med den här knappen öppnar du fönstret Välj åtgärd som du använde när du arbetade med XML-kolumner.

  Slutför
    Med den här knappen lägger du till XML-kolumnen och återgår till startguiden.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Aktivera XML-kolumn

  Tabellnamn
    Ange namnet på tabellen som har XML-kolumn eller välj namnet i listan över tillgängliga tabellnamn. Exempel

        SALES_TAB

  Kolumnnamn
    Ange namnet på en befintlig XML-kolumn i tabellen eller välj namnet i listan över tillgängliga kolumner. Exempel:

        ORDER

  DAD-filnamn
    Ange sökvägen för DAD-filen som avbildar XML-dokument till XML-kolumnen och sidotabellerna eller klicka på ... om du vill bläddra efter en befintlig DAD-fil. Exempel:

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

  Tabellutrymme
    Valfritt: Ange namnet på ett tidigare skapat tabellutrymme för sidotabeller associerade med XML-kolumnen. Om tabellutrymmet inte är definierat används ett standardtabellutrymme.

  Standardvy
    Valfritt: Ange namnet på en standardvy där XML-tabellen och alla relaterade sidotabeller sammankopplas.

  |Rot-ID
    Rekommenderas men är valfritt: Ange kolumnnamnet för primärnyckeln i tabellen om du vill associera alla sidotabeller med tillämpningstabellen. Om du inte anger ett rot-ID läggs kolumnen DXXROOT_ID till tabellen av XML Extender och ett ID genereras.

  Föregående
    Med den här knappen öppnar du fönstret Välj åtgärd som du använde när du arbetade med XML-kolumner.

  Slutför
    Med den här knappen aktiverar du XML-kolumnen och återgår till startguiden. Vid aktivering av kolumnen kontrollerar XML Extender om XML-tabellen har en primärnyckel, skapar sidotabeller som definieras i DAD-filen, samt skapar en standardvy för XML-tabellen och sidotabellerna.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Avaktivera XML-kolumn

  Tabellnamn
    Ange namnet på tabellen som innehåller XML-kolumnen eller välj namnet i listan över tillgängliga tabeller.

  Kolumnnamn
    Ange namnet på en befintlig kolumn i tabellen eller välj namnet i listan över kolumnnamn.

  Föregående
    Med den här knappen öppnar du fönstret Välj åtgärd som du använde när du arbetade med XML-kolumner.

  Slutför
    Med den här knappen avaktiverar du XML-kolumnen och återgår till startguiden. En avaktiverad XML-kolumn kan inte innehålla XML-dokument.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ## Åtgärder

  ### Lägga till XML-kolumn

  1. Klicka på Arbeta med XML-kolumner i startguiden. Fönstret Välj åtgärd öppnas.
  2. Klicka på Lägg till XML-kolumn. Fönstret Lägg till XML-kolumn öppnas.
  3. Välj namnet på tabellen i listan Tabellnamn eller ange namnet på tabellen du vill ändra.
  4. Ange namnet på kolumnen du vill lägga till tabellen i fältet Kolumnnamn.
  5. Välj användardefinierad typ (ADT) för kolumnen i listan |Datatyp.
  6. Klicka på Slutför om du vill lägga till kolumnen för XML-typ.

  ### Aktivera XML-kolumn

  1. Klicka på Arbeta med XML-kolumner i startguiden om du vill visa kolumnrelaterade åtgärder i XML Extender. Fönstret Välj åtgärd öppnas.
  2. Klicka på |Aktivera XML-kolumn och sedan på Nästa om du vill aktivera en befintlig tabellkolumn i databasen.
  3. Välj tabellen som innehåller XML-kolumnen från fältet Tabellnamn.
  4. Välj kolumnen som ska aktiveras i fältet Kolumnnamn. Kolumnen måste finnas redan och vara av typen XML.
  5. Ange sökväg och filnamn för DAD i fältet DAD-filnamn, eller klicka på ... om du vill bläddra efter en befintlig DAD-fil.
  6. Om du vill kan du ange namnet på ett befintligt tabellutrymme i fältet Tabellutrymme.

     Tabellutrymmet innehåller sidotabeller som skapats av XML Extender. Om du anger ett tabellutrymme skapas sidotabellerna i det angivna tabellutrymmet. Om du inte anger ett tabellutrymme skapas sidotabellerna i standardtabellutrymmet.

  7. Om du vill kan du ange namnet på standardvyn i fältet Standardvy.

     När det angetts skapas standardvyn automatiskt när när kolumnen aktiveras, och sedan sammankopplas XML-tabellen och alla relaterade sidotabeller.

  8. Om du vill kan du ange kolumnnamnet för primärnyckeln i tillämpningstabellen i fältet Rot-ID. Det rekommenderas att du gör det.

     XML Extender använder värdet för rot-IDt som unikt ID för att associera alla sidotabeller med tillämpningstabellen. Om det inte angetts läggs kolumnen DXXROOT_ID till tillämpningstabellen av XML Extender och ett ID genereras.

  9. Klicka på Slutför om du vill aktivera XML-kolumnen, skapa sidotabellerna och återgå till startguiden.
     - Om kolumnen skapas visas ett meddelande att kolumnen aktiverats.
     - Om det inte går att aktivera kolumnen visas ett felmeddelande. Korrigera värdena i inmatningsfälten tills kolumnen är aktiverad.

  ### Avaktivera XML-kolumn

  1. Klicka på Arbeta med XML-kolumner i startguiden om du vill visa kolumnrelaterade åtgärder i XML Extender. Fönstret Välj åtgärd öppnas.
  2. Klicka på |Avaktivera XML-kolumn och sedan på Nästa i fönstret Välj åtgärd om du vill avaktivera en befintlig tabellkolumn i databasen.
  3. Välj tabellen som innehåller XML-kolumnen från fältet Tabellnamn.
  4. Välj kolumnen som ska avaktiveras i fältet Kolumnnamn.
  5. Klicka på Slutför.
     - Om kolumnen avaktiveras visas ett meddelande att kolumnen avaktiverats.
     - Om det inte går att avaktivera kolumnen visas ett felmeddelande. Korrigera värdena i inmatningsfälten tills kolumnen är avaktiverad.

  # Arbeta med XML-samlingar

  I den här guiden kan du aktivera och avaktivera XML-samlingar.

  ## Fält och kontroller

  ### Välj åtgärd (för samlingar)

  Aktivera XML-samling
    Välj alternativet om du vill öppna fönstret Aktivera XML-samling. När du aktiverar en XML-samling analyseras DAD-filen, så att tabeller och kolumner relaterade till XML-dokument identifieras och styrinformation lagras. Alternativet är bara tillgängligt om databasen är aktiverad och det finns en DAD-fil.

  Avaktivera XML-samling
    Välj alternativet om du vill öppna fönstret Avaktivera samling och ta bort markeringar som identifierar tabeller och kolumner som del av en XML-samling. Om samlingen inte är aktiverad är alternativet inte tillgängligt.

  Nästa
    Med den här knappen öppnar du fönstret du valt så att du kan aktivera och avaktivera en XML-samling.

  Slutför
    Den här knappen är tillgänglig när du avslutat arbetet med samlingen.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Aktivera XML-samling

  Samlingsnamn
    Ange namnet på den XML-samling du vill aktivera.

  DAD-filnamn
    Ange namnet på den DAD-fil som avbildar strukturen för XML-dokumentet till DB2-tabellerna som du skapar och dekompilerar dokument med eller klicka på ... om du vill bläddra efter en befintlig DAD-fil.

  ...
    Med den här knappen öppnar du dialogrutan Sök där du kan välja ett befintligt DAD-filnamn.

  Tabellutrymme
    Ange namnet på ett tidigare skapat tabellutrymme om det finns något. Tabellutrymmet kommer att innehålla nya DB2-tabeller som genererats för att skapa och dekompilera.

  Föregående
    Med den här knappen öppnar du fönstret Välj åtgärd som du använde när du arbetade med XML-samlingar.

  Slutför
    Med den här knappen aktiverar du XML-samlingen och återgår till startguiden. Vid aktivering av samlingen används DAD-filen till att identifiera XML-dokumentets tabeller och kolumner och lagra styrinformation i tabellen XML_USAGE.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ### Avaktivera XML-samling

  Samlingsnamn
    Välj namnet på den XML-samling du vill avaktivera i listan över samlingar.

  Föregående
    Med den här knappen öppnar du fönstret Välj åtgärd som du använde när du arbetade med XML-samlingar.

  Slutför
    Med den här knappen avaktiverar du XML-samlingen och återgår till startguiden. Vid avaktivering av en samling tas markeringar som identifierar tabeller och kolumner som del aven XML-samling bort.

  Avbryt
    Med den här knappen avbryter du guiden och återgår till startguiden.

  ## Åtgärder

  ### Aktivera XML-samling

  1. Klicka på Arbeta med XML-samlingar i startguiden. Fönstret Välj åtgärd öppnas.
  2. Klicka på |Aktivera XML-samling och sedan på Nästa. Fönstret Aktivera samling öppnas.
  3. Välj namnet på den samling du vill aktivera i fältet Samlingsnamn i listan.
  4. Ange DAD-filnamnet i fältet DAD-filnamn eller klicka på ... om du vill bläddra efter en befintlig DAD-fil.
  5. Om du vill kan du ange namnet på ett tidigare skapat tabellutrymme i fältet Tabellutrymme.

     Tabellutrymmet kommer att innehålla nya DB2-tabeller som genererats för dekompilering.

  6. Klicka på Slutför om du vill aktivera samlingen och återgå till startguiden.
     - Om samlingen aktiverats visas ett meddelande att samlingen aktiverats.
     - Om det inte går att aktivera samlingen visas ett felmeddelande. Korrigera värdena i inmatningsfälten tills samlingen är aktiverad.

  ### Avaktivera XML-samling

  1. Klicka på Arbeta med XML-samlingar i startguiden om du vill visa samlingsrelaterade åtgärder i XML Extender. Fönstret Välj åtgärd öppnas.
  2. Klicka på Avaktivera XML-samling och sedan på Nästa om du vill avaktivera en XML-samling. Fönstret Avaktivera samling öppnas.
  3. Ange namnet på den samling du vill avaktivera i fältet Samlingsnamn.
  4. Klicka på Slutför om du vill avaktivera samlingen och återgå till startguiden.
     - Om samlingen avaktiverats visas ett meddelande att samlingen avaktiverats.
     - Om det inte går att avaktivera samlingen visas ett felmeddelande. Korrigera värdena i inmatningsfälten tills samlingen är avaktiverad.