# Auxílio do assistente de administração do XML Extender

# Conteúdo

Conectando-se ao banco de dados

- Campos e controles
- Tarefas
- Conectando-se ao banco de dados
- Mudando de banco de dados

  Usando a Barra de Lançamento da Administração do XML Extender

- Campos e controles
- Tarefas

  Ativando ou desativando um banco de dados

- Tarefa: Habilitando um banco de dados
- Tarefa: Desabilitando um banco de dados

  Importando os DTDs

- Campos e controles
- Tarefa: Importando um DTD

  Trabalhando com arquivos DAD

- Campos e controles
- Especificar um DAD - primeira etapa para todos os tipos
- Selecionar validação - etapa 2 para todos os tipos
- Tabelas laterais- etapa 3 para a coluna do tipo XML
- Especificar o texto - etapa 3 para o mapeamento SQL ou para o tipo de mapeamento de nó RDB
- Especificar a instrução SQL - etapa 4 para o tipo de mapeamento SQL
- Mapear SQL - etapa 5 para o tipo de mapeamento SQL
- Mapear nós RDB - etapa 4 para o tipo de mapeamento de nó RDB
- Salvar um DAD - última etapa para todos os tipos
- Tarefas
- Criando ou editando um DAD para colunas XML
- Criando ou editando um DAD para coleções XML

  Trabalhando com colunas XML

- Campos e controles
- Selecionar uma tarefa (para colunas)
- Incluir uma coluna XML
- Habilitar uma coluna XML
- Desabilitar uma coluna XML
- Tarefas
- Incluindo uma coluna XML
- Habilitando uma coluna XML
- Desabilitando uma coluna XML

  Trabalhando com coleções XML

- Campos e controles
- Selecionar uma tarefa (para coleções)
- Habilitar uma coleção XML
- Desabilitar uma coleção XML
- Tarefas
- Ativando uma coleção XML
- Desativando uma coleção XML

  # Conectando-se ao banco de dados

  Com este assistente, é possível conectar-se com o banco de dados que contém ou vai conter dados XML.

  ## Campos e controles

  Endereço
    Digite o nome do banco de dados JDBC a ser conectado ou selecione um endereço da lista. O assistente executa tarefas em tempo real nesse banco de dados. Quando se seleciona um endereço da lista, são exibidas a ID de usuário e o último controlador JDBC associado a ele. Este campo é obrigatório. O endereço possui a seguinte sintaxe:

    |Para configurações independentes (recomendado):

        jdbc:db2:nome_banco_de_dados

    Onde:

    nome_banco_de_dados
      Banco de dados com o qual os documentos XML serão conectados e armazenados.

    Exemplo:

        jdbc:db2:sales_db

    Para configurações da rede:

        jdbc:db2://|servidor:número_da_porta/nome_do_banco_de_dados

    Onde:

    |servidor
      |É o nome do servidor onde o XML Extender está situado.

    número_porta
      O número da porta usado para conectar-se com o servidor. Para determinar o número da porta, digite o seguinte comando a partir da linha de comando do DB2 na máquina do servidor:

          db2jstrt port#

    nome_banco_de_dados
      Banco de dados com o qual os documentos XML serão conectados e armazenados.

    Exemplo:

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

  ID de Usuário
    Digite ou confirme a ID de usuário utilizada para acessar o banco de dados. Este campo é obrigatório.

  Senha
    Digite sua senha para acessar o banco de dados. Este campo é obrigatório.

  Controlador JDBC
    Digite ou verifique a localização do controlador para o banco de dados. Este campo é obrigatório. O controlador deve ter um dos valores a seguir:

    |Para configurações independentes (padrão):

        COM.ibm.db2.jdbc.app.DB2Driver

    Para configurações da rede:

        COM.ibm.db2.jdbc.net.DB2Driver

  Encerrar
    Completa o processo de efetuar logon num banco de dados e abre a Barra de lançamento.

  Cancelar
    Cancela o assistente.

  ## Tarefas

  ### Conectando-se ao banco de dados

  Quando o Assistente de Administração do XML Extender é iniciado, a janela Logon é aberta e você se conecta com um banco de dados.

  1. No campo Endereço, digite o endereço JDBC completo da origem de dados do IBM DB2 UDB com a qual a conexão está sendo estabelecida.
  2. Nos campos ID de Usuário e Senha, digite ou confirme a ID de usuário e senha do DB2 relativas ao banco de dados com o qual a conexão está sendo estabelecida.
  3. No campo Controlador JDBC, digite ou confirme o nome do controlador JDBC relativo ao endereço especificado.
  4. Clique em Finalizar para conectar-se ao banco de dados e avançar para a Barra de Lançamento.

  ### Mudando de banco de dados

  1. Na Barra de Lançamento, clique em Alternar Banco de Dados.
  2. No campo Endereço, digite o endereço JDBC completo da origem de dados do IBM DB2 UDB com a qual a conexão está sendo estabelecida.
  3. Nos campos ID de Usuário e Senha, digite ou confirme a ID de usuário e senha do DB2 relativas ao banco de dados com o qual a conexão está sendo estabelecida.
  4. No campo Controlador JDBC, digite ou confirme o nome do controlador JDBC relativo ao endereço especificado.
  5. Clique em Finalizar para conectar-se ao novo banco de dados e voltar para a Barra de Lançamento. O XML Extender vai desconectá-lo do banco de dados original e conectá-lo com o novo banco de dados.

  # Usando a Barra de Lançamento da Administração do XML Extender

  A Barra de Lançamento do Assistente de Administração do XML Extender (a Barra de Lançamento), oferece acesso aos assistentes que auxiliam na conclusão de tarefas administrativas, como ativar um banco de dados, editar um arquivo de definição de acesso de dados (DAD) e ativar colunas ou coleções XML. Selecione o nome da tarefa para lançar o assistente correspondente a ela.

  ## Campos e controles

  Alternar Banco de Dados
    Abre a janela onde se efetua o logon num banco de dados específico. Para armazenar ou acessar documentos XML, é preciso estar conectado a um banco de dados. Após efetuar logon em um banco de dados, você pode alternar para outro banco de dados na Barra de Lançamento.

  Habilitar/Desabilitar Banco de Dados
    Habilita ou desabilita banco de dados do XML Extender. Trata-se de um botão comutador, que muda em função de o banco de dados estar ou não habilitado. Para habilitar o banco de dados, o XML Extender cria UDTs e UDFs do XML Extender, uma tabela de referência DTD para armazenar DTDs e informações de cada DTD, além de uma tabela de utilização para armazenar informações comuns de cada coluna habilitada. Para desabilitar um banco de dados, o XML Extender elimina UDTs, UDFs, a tabela de referência DTD e a tabela de utilização do XML. É preciso desabilitar todas as colunas e coleções do XML antes de tentar desabilitar um banco de dados.

  Importar um DTD
    Abre a janela Importar DTD para importar um arquivo de Definição de Tipo de Documento (Document Type Definition - DTD) que já exista para o repositório DTD do atual banco de dados. O DTD permite validar dados XML de uma coluna ou coleção XML. É opcional para dados de coluna XML, mas obrigatório para dados de coleção XML. |

  |Editar DAD
    |Abre a janela Especificar um DAD para editar um Acesso a Documento existente. |Arquivo de definição (DAD) ou criação de um novo DAD. O DAD define como dados |XML são coletados e armazenados no DB2; ele permite definir os |atributos e elementos chave de seus dados para que possam ser pesquisados. |O DAD de coluna XML mapeia a coluna XML nas tabelas laterais para indexação. O |DAD de coleção XML mapeia dados DB2 na estrutura do documento XML.

  Trabalhar com Colunas XML
    |Abre uma janela para incluir uma coluna XML, ativando uma coluna XML, ou |desativando uma coluna XML em uma tabela. Para ativar e acessar dados XML,|ativar uma coluna DB2 para tipos de dados XML.

  Trabalhar com Coleções XML
    Abre uma janela que permite habilitar ou desabilitar uma coleção XML num banco de dados. Na coleção, para armazenar e acessar dados XML, usa-se um conjunto de tabelas relacionais.

  ## Tarefas

  A partir da Barra de Lançamento, é possível completar as seguintes tarefas do XML Extender:

  - Efetuar logon em um banco de dados ou alternar para um banco de dados diferente
  - Habilitar ou desabilitar banco de dados
  - Importar um DTD
  - |Editar DAD
  - Trabalhar com colunas XML
  - Trabalhar com coleções XML

  # Ativando ou desativando um banco de dados

  Com este assistente, é possível habilitar ou desabilitar um banco de dados. Habilitar um banco de dados cria UDTs, UDFs, procedimentos armazenados e tabelas de suporte para a administração, necessários quando o XML Extender é utilizado. É preciso habilitar o banco de dados para armazenar, compor ou decompor documentos XML no banco de dados. Desabilitar o banco de dados elimina os UDTs, UDFs, procedimentos armazenados e tabelas de suporte para a administração.

  ## Tarefa: Habilitando um banco de dados

  Clique em Ativar banco de dados na Barra de Lançamento para ativar o banco de dados atual. Se um banco de dados já estiver ativado, Desativar Banco de Dados estará disponível.

  Depois de ativar o banco de dados, retorna-se para a Barra de Lançamento.

  ## Tarefa: Desabilitando um banco de dados

  Clique em Desativar banco de dados na Barra de Lançamento para desativar o banco de dados atual. Se um banco de dados não estiver ativado, Ativar Banco de Dados estará disponível.

  Depois de desativar o banco de dados, retorna-se para a Barra de Lançamento.

  # Importando os DTDs

  Neste assistente, é possível importar um DTD para validar um documento XML que está armazenado numa coluna XML ou que esteja sendo composto a partir de dados do DB2 numa coleção XML.

  ## Campos e controles

  Nome do arquivo DTD
    Digite o nome do arquivo DTD ou clique em ... para navegar por uma lista de DTDs disponíveis. Este campo é obrigatório.

  ID do DTD
    Digite o nome da ID do DTD. A ID associa o DTD ao DAD do documento XML e especifica sua localização. A ID do DTD é um identificador do DTD e pode ser o caminho que especifica a localização do DTD no sistema local. A ID do DTD deve corresponder ao valor especificado no arquivo DAD para o elemento <DTDID>. Este campo é obrigatório.

  Autor
    Digite o nome do autor do DTD. O nome aparece automaticamente se estiver especificado no repositório do DTD. Este campo é opcional.

  Encerrar
    Insere o DTD no repositório do DTD e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ## Tarefa: Importando um DTD

  1. Clique em Importar um DTD a partir da Barra de Lançamento para importar um arquivo DTD existente para o repositório do DTD do banco de dados atual. Aparece o assistente Importar um DTD.
  2. Digite o nome do arquivo DTD no campo Nome do arquivo DTD ou clique em ... para procurar um arquivo DTD que já exista.
  3. Digite a ID do DTD no campo ID do DTD.
  4. Opcionalmente, digite o nome do autor do DTD no campo Autor.

     O XML Extender exibe automaticamente o nome do autor se ele estiver especificado no DTD.

  5. Clique em Encerrar para inserir o DTD na tabela de repositório do DTD, DB2XML.DTD_REF, e retornar para a Barra de Lançamento.

  # Trabalhando com arquivos DAD

  Com este assistente, é possível criar ou editar arquivos DAD para definir como os documentos XML são usados com o DB2. Arquivos DAD são usados para:

  - Armazenar os documentos XML em colunas e definir tabelas laterais, que são indexadas para favorecer uma pesquisa estrutural rápida.
  - Compor documentos XML a partir de uma ou mais tabelas DB2 definidas numa coleção XML.
  - Decompor documentos XML em uma ou mais tabelas do DB2 definidas numa coleção XML.

  Consulte o DB2 XML Extender Administration and Programming para saber mais sobre estas técnicas.

  ## Campos e controles

  ### Especificar um DAD - primeira etapa para todos os tipos

  Nome do arquivo
    Digite o nome de um arquivo DAD que já exista ou clique em ... para procurá-lo. Ao criar um DAD novo, deixe o campo em branco. Se o arquivo DAD existir, seu tipo será exibido em Tipo, e Próximo estará selecionável.

  Tipo
    Se você está criando um novo DAD, selecione um dos seguintes tipos de arquivos DAD:
    - Coluna XML para especificar como os documentos armazenados numa coluna deverão ser indexados
    - Mapeamento SQL de coleção XML para fazer mapeamento entre dados relacionais e documentos XML através de uma única instrução SQL
    - Mapeamento RDB_node de coleção XML para fornecer definições de nós para tabelas, colunas e condições que definem como os dados XML são armazenados

  Próximo
    Vai para a etapa seguinte: Selecione a validação.

  Encerrar
    Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui o processo e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Selecionar validação - etapa 2 para todos os tipos

  Validar documentos XML com o DTD
    Selecione para validar os documentos XML. Com documentos válidos, podem ser feitas pesquisas estruturadas nos seus dados. Seus documentos são validados contra o DTD especificado no arquivo DAD. É preciso validar os dados XML antes de inserir dados no DB2, porque não é possível validar dados já inseridos no DB2.

  ID do DTD
    Digite o nome do DTD ou selecione-o na lista de DTDs que já existem. Quem não importou DTDs para o repositório DTD relativo ao seu banco de dados não poderá validar seus documentos XML.

  |NÃO validar
    Selecione para continuar sem validar seus documentos XML.

  Voltar
    Vai para etapa anterior: Especificar uma janela DAD.

  Próximo
    Vai para a próxima etapa. Abre a janela Gerenciar tabelas laterais quando estiver trabalhando com colunas XML, a janela Especificar instrução SQL quando estiver trabalhando com mapeamento SQL de coleção XML ou a janela Especificar texto quando estiver trabalhando com mapeamento RDB_node de coleção XML.

  Encerrar
    Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui o processo e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Tabelas laterais- etapa 3 para a coluna do tipo XML

  |Lista de tabelas e colunas existentes
    |Esta tabela contém uma lista de tabelas laterais que devem ser criadas quando uma |coluna XML que usa este arquivo DAD for criada.. É possível selecionar o |nome de uma tabela ou coluna existente que deseja alterar ou |digitar um novo nome nos campos abaixo.

  Nome da tabela
    Digite o nome de uma tabela lateral nova que contenha a coluna. Se a coluna tiver sido selecionada na lista, aparecerá o nome de sua tabela para ser modificado. Este campo é obrigatório. Exemplo:

        ORDER_SIDE_TAB

  Nome da coluna
    Digite o nome da coluna. Se você selecionou um nome a partir da lista de colunas, o nome da coluna aparece para você modificar. Este campo é obrigatório. Exemplo:

        CUSTOMER_NAME

  Tipo
    Selecione ou altere o tipo da coluna, tais como DATE, CHAR, INTEGER ou VARCHAR. Este campo é obrigatório.

  Comprimento
    Se tiver sido selecionado VARCHAR, digite ou mude o número máximo de caracteres relativo ao comprimento da coluna. Este campo só fica habilitado quando o tipo é VARCHAR. Exemplo:

        30

  Caminho
    Digite ou altere o caminho de localização de um elemento ou atributo. Este campo é obrigatório. Exemplo:

        /ORDER/CUSTOMER/NAME

  Ocorrência múltipla
    Selecione esta caixa de seleção para indicar se o elemento ou atributo da coluna pode ser usado mais de uma vez ou apenas uma vez em um documento. Selecione a caixa correspondente para a ocorrência múltipla; não a selecione se quiser indicar o contrário.

  Incluir
    Salva a tabela ou a coluna com os detalhes especificados e permite continuar a incluir, modificar ou excluir uma tabela ou coluna.

  Alterar
    Salva as alterações efetuadas nos campos Nome da tabela, Nome da coluna, Tipo, Comprimento, Caminho ou Ocorrência múltipla. Quando você muda o nome de uma tabela ou coluna, o objeto antigo é eliminado da lista e o novo é nela incluído.

  Remover
    Remove da lista o item em destaque.

  Voltar
    Vai para a etapa anterior: Selecionar Validação.

  Próximo
    Vai para próxima etapa: Salvar um DAD.

  Encerrar
    Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui o processo e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Especificar o texto - etapa 3 para o mapeamento SQL ou para o tipo de mapeamento de nó RDB

  Prólogo
    Digite o nome de um prólogo. Quando se edita um DAD que já existe, o nome é exibido. O nome deve estar no formato

        <?xml versão="1.0" ?>

    Este campo é obrigatório.

  Tipodoc
    Digite o tipo de documento XML. Se estiver editando um DAD existente, o tipo do documento é exibido. Este campo é obrigatório. Exemplo:

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

  Voltar
    Vai para a etapa anterior: Selecionar Validação.

  Próximo
    Vai para a etapa seguinte: Mapear nós RDB, se o tipo for mapeamento de nós RDB, ou para Especificar instrução SQL, se o tipo for mapeamento SQL

  Encerrar
    Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui o processo e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Especificar a instrução SQL- etapa 4 para o tipo de mapeamento SQL

  Instrução SQL
    Digite uma instrução SQL SELECT. Quando um DAD existente é editado, a instrução SQL será exibida. A instrução mapeia as colunas da cláusula SELECT para os elementos ou atributos XML do documento XML. A cláusula FROM define as tabelas que contêm os dados. A cláusula WHERE indica as condições da união e da pesquisa. Todas as tabelas da coleção têm que ser unidas por uma instrução SELECT. Este campo é obrigatório. Exemplo:

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

    A instrução SQL usa as seguintes diretrizes:

    - Colunas são especificadas em ordem descendente, pela hierarquia da estrutura do documento XML.
    - As colunas para uma entidade são agrupadas, e cada grupo possui uma coluna para a ID de objeto.
    - A coluna de ID de objeto é a primeira coluna em cada grupo.
    - Para tabelas que não usam uma coluna condicional de chave individual, use a função incorporada do DB2 generate_unique para gerar a coluna.
    - As colunas de ID de objeto são então listadas em ordem descendente nas instruções ORDER BY. As colunas em ORDER BY não devem ser qualificadas por qualquer esquema e nome de tabela e não devem relacionar os nomes de coluna na cláusula SELECT.

  Testar SQL
    Testa a validade da instrução SQL. Se a instrução for válida, amostras de resultados serão mostradas no campo Amostras de resultados. Se não for, uma mensagem de erro pedirá que a instrução seja corrigida e que o processo seja repetido.

  Resultados de amostra
    Mostra os resultados obtidos quando a instrução SQL é testada e sua validade é comprovada. Este campo é somente para leitura.

  Voltar
    Vai para a etapa anterior: Selecionar validação.

  Próximo
    Vá para a próxima etapa: Mapa do SQL.

  Encerrar
    Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui o processo e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Mapa SQL- etapa 5 para o tipo de mapeamento SQL

  Mapa DAD
    Selecione um nó do mapa DAD exibido para que a partir dele seja feito o mapeamento. Podem ser mapeados os elementos e atributos do documento XML para nós de elemento e de atributo que correspondam a dados do DB2. Os nós fornecem o caminho entre os dados do XML e os dados do DB2. Selecione um nó para ativar Novo Elemento. Selecionar um nó provoca o aparecimento dos campos pertinentes na caixa de grupo Detalhes.

  Tipo do nó
    Selecione um tipo de nó na lista de tipos válidos neste ponto do mapa. Dependendo do tipo de nó selecionado, são exibidos diferentes campos na caixa de grupo Detalhes. Este campo é obrigatório.

    Elemento
      Representa um elemento XML definido no DTD associado ao documento XML e usado para associar o elemento XML a uma coluna em uma tabela DB2. Um nó de elemento pode ter nós de atributo, nós de elementos filhos ou nós de texto. Um nó de nível inferior possui um nó de texto e um nome de coluna associados a ele na exibição de árvore.

    Atributo
      Representa um atributo XML definido no DTD associado ao documento XML e usado para associar o atributo do XML a uma coluna em uma tabela DB2. Um nó de atributo pode ter um nó de texto e um nome de coluna associados a ele na exibição de árvore.

    Texto
      Especifica o conteúdo de texto do nó de elemento. Um nó de texto possui um nome de coluna associado a ele na exibição de árvore.

  Nome do nó
    Digite o nome do nó. Este campo é obrigatório. Exemplo:

        Order

  Coluna
    Se tiver selecionado Atributo, Elemento, ou Texto como o tipo de nó, selecione um nome de coluna. Este campo é obrigatório. Se você especificar Coluna como o tipo de nó, você pode selecionar somente uma coluna que já exista no seu banco de dados DB2. Exemplo:

        Customer_Name

  Incluir
    Inclui o devido rótulo no elemento vazio que estiver sendo incluído na estrutura de árvore.

  Alterar
    Faz as alterações no nó em destaque. Pode-se selecionar o mesmo nó novamente ou outro nó e fazer outras modificações.

  Remover
    Remove o elemento ou atributo em destaque.

  Novo Elemento
    Cria um novo nó limpando os campos na caixa de grupo Detalhes, anexa um elemento vazio abaixo do que está destacado na estrutura em formato de árvore, e destaca o novo elemento vazio.

  Voltar
    Vai para a etapa anterior: Especifique a instrução SQL.

  Próximo
    Vai para próxima etapa: Salvar um DAD.

  Encerrar
    Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui o processo e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Nós do Mapa RDB - etapa 4 para o tipo de mapeamento de nó RDB

  Mapa DAD
    Selecione um nó do mapa DAD exibido para que a partir dele seja feito o mapeamento. Os elementos e atributos no documento XML são mapeados em nós de elemento e de atributo correspondentes a dados DB2. Os nós fornecem o caminho entre os dados do XML e os dados do DB2. Eles indicam quais tabelas e quais colunas possuem os dados e sob que condições é possível obter os dados. Selecione um nó para ativar Novo Elemento. Selecionar um nó provoca o aparecimento dos campos pertinentes na caixa de grupo Detalhes.

  Tipo do nó
    Selecione um tipo de nó na lista de tipos válidos neste ponto do mapa. Dependendo do tipo de nó selecionado, são exibidos diferentes campos na caixa de grupo Detalhes. Os campos podem ser para Elemento, Atributo, Texto, Tabela, Coluna ou Condição, dependendo do que foi selecionado no mapa DAD. Este campo é obrigatório.

    Elemento
      Representa um elemento XML definido no DTD associado ao documento XML e usado para associar o elemento XML a uma coluna em uma tabela DB2. Um nó de elemento pode possuir nós de atributo, nós de elemento filhos, nós de texto, nós de tabela ou nós de condição. Um elemento raiz possui nós de tabela para especificar todas as tabelas usadas para gerar documentos XML e um nó de condição usado para conectar as tabelas. Este campo é obrigatório. Exemplo:

          nome do nó_elemento="Order"

    Atributo
      Representa um nó de atributo XML definido no DTD associado ao documento XML e usado para associar o atributo XML a uma coluna em uma tabela DB2. Um nó de atributo pode possuir um nó de texto e possui um nome de coluna associado a ele no mapa DAD. Dados estão localizados no nó de atributo e no nó de texto de cada elemento. Este campo é obrigatório. Exemplo:

          nome do nó_atributo="key"

      |

    |Tabela
      |Representa a tabela associada ao conteúdo do nó de texto |ou do nó de atributo. Especifica o nome de uma tabela DB2 na qual o conteúdo |do nó de texto ou do nó de atributo será armazenado ou a partir da qual será |recuperado. Exemplo:

          |nome do nó_tabela=order_tab

      |

    |Coluna
      |Representa a coluna que contém o conteúdo do nó de texto ou do |nó de atributo. Especifica o nome de uma coluna da tabela DB2 na qual |o conteúdo do nó de texto ou do nó de atributo será armazenado ou |da qual será recuperado. Exemplo:

          |nome da coluna="order_key"

  Nome do nó
    Digite o nome de um elemento ou atributo. Este campo é obrigatório. Exemplo:

        nome do nó_elemento="Price"

  Texto
    Indica o conteúdo de texto de um elemento e os dados de coluna em uma tabela relacional para os nós de elemento do nível inferior. Contém um elemento de tabela, um elemento de coluna e, para o nó raiz, um elemento de condição.

  Nome da tabela
    O nome da tabela que contém a coluna. Exemplo:

        nome da tabela="order_tab"
        nome da tabela="part_tab"
        Nome da tabela="ship_tab"

  Chave da tabela
    A chave primária para uma tabela, constituída de uma coluna individual ou de múltiplas colunas (chave composta). A chave é usada para ligar tabelas em uma coleção. Exemplo de chave composta:

        nome de tabela="part_tab" chave="part_key, price"

  Coluna
    Nome da coluna que contém os dados para o texto do elemento e na qual o elemento e o atributo são mapeados. Exemplo:

        nome de coluna="order_key" tipo="integer"

  Condição
    Em elementos raiz, indica o modo de unir tabelas de coleção XML. Em elementos de nível inferior, indica os critérios para selecionar dados XML com valores "=", "<", ">" ou "LIKE". Exemplo de condição para o elemento raiz:

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

    Exemplo de critérios para selecionar dados XML:

        preço > 2500.00

  Incluir
    Inclui o rótulo apropriado no elemento vazio que estiver sendo incluído na estrutura de árvore.

  Alterar
    Efetua alterações no nó destacado. Pode-se selecionar o mesmo nó novamente ou outro nó e fazer outras modificações.

  Remover
    Remove o elemento em destaque.

  Novo Elemento
    Cria um novo nó limpando os campos na caixa de grupo Detalhes, anexa um elemento vazio abaixo do que está destacado na estrutura em formato de árvore e destaca o novo elemento vazio.

  Voltar
    Vai para a etapa anterior: Especifique o texto.

  Próximo
    Vai para a próxima janela: Salvar um DAD.

  Encerrar
    Habilitado no final da criação ou da modificação de um arquivo DAD. Conclui o processo e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Salvar um DAD - última etapa para todos os tipos

  Nome do arquivo
    Digite o nome do arquivo para o DAD modificado ou novo que deseja salvar ou clique em ... para abrir a janela do navegador de arquivo local e selecionar a localização onde o DAD deve ser salvo. Este campo é obrigatório.

  Voltar
    Vai para a etapa anterior.

  Encerrar
    Salva o arquivo DAD e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ## Tarefas

  ### Criando ou editando um DAD para colunas XML

  Quando um DAD para uma coluna XML é criada, especifica-se o tipo de dados do documento XML e definem-se tabelas laterais, usadas para fazer indexação.

  1. |Clique em Editar DAD na Barra de Lançamento para editar ou criar um |arquivo DAD XML. O assistente Trabalhar com arquivos DAD é aberto e exibe a |janela Especifique um DAD.
  2. Escolha se deseja editar um arquivo DAD que já existe ou criar um arquivo DAD novo.
     - Para editar um DAD existente:
       1. Clique em ... para navegar num arquivo DAD que já existe na lista ou digite o nome do arquivo DAD no campo Nome do arquivo.
       2. Veja se o assistente reconhece o arquivo DAD especificado.
          - Se reconhecer, a opção Próximo estará selecionável e no campo Tipo aparecerá Coluna XML.
          - Se o assistente não reconhecer o arquivo DAD especificado, a opção Próximo não estará selecionável. Digite novamente o nome do arquivo DAD no campo Nome do arquivo ou clique em ... para navegar novamente até um arquivo DAD existente. Continue até Próximo estar selecionável.
       3. Clique em Próximo.
     - Para criar um novo DAD:
       1. Deixe o campo Nome do arquivo em branco.
       2. A partir da lista Tipo, clique na Coluna XML.
       3. Clique em Próximo.
  3. Escolha na janela Selecionar Validação se quer validar seus documentos XML com um DTD.
     - Para validar:
       1. Clique em Validar documentos XML com o DTD.
       2. Selecione na lista ID do DTD o DTD a ser usado para a validação.

       Quem não importou DTDs para o repositório DTD relativo ao seu banco de dados não poderá validar seus documentos XML.

     - Clique em |NÃO validar para continuar sem validar seus documentos XML.
  4. Clique em Próximo.
  5. Escolha se deseja incluir uma tabela lateral nova, editar uma que já exista ou excluir uma tabela lateral existente da janela Tabelas laterais.
     - Para incluir uma tabela lateral ou uma coluna de tabela lateral nova:

       Para incluir uma tabela lateral nova, definem-se as colunas da tabela. Execute os passos abaixo para cada coluna da tabela lateral.

       1. Complete os campos da caixa Detalhes da janela Tabelas laterais.
          1. Nome da tabela: Digite o nome da tabela que contém a coluna.
          2. Nome da coluna: Digite o nome da coluna.
          3. Tipo: Selecione o tipo de coluna a partir da lista.
          4. Comprimento (apenas tipo VARCHAR): Digite o número máximo de caracteres VARCHAR.
          5. Caminho: Digite a localização do elemento ou atributo.
          6. Ocorrência múltipla: Selecione na lista Não ou Sim.

             Indica se o elemento ou atributo pode ser usado mais de uma vez num documento. Importante Se for especificada uma ocorrência múltipla para uma coluna, só é possível especificar uma coluna na tabela lateral que contém a coluna.

       2. Clique em Incluir para incluir uma coluna.
       3. Continue incluindo, editando ou removendo colunas da tabela lateral ou clique em Próximo.
     - Para editar uma coluna de tabela lateral que já existe:

       Pode-se atualizar uma tabela lateral alterando as definições das colunas existentes.

       1. Clique na tabela lateral e no nome da coluna a ser editada.
       2. Edite os campos da caixa Detalhes.
       3. Clique em Alterar para salvar alterações.
       4. Continue incluindo, editando ou removendo colunas da tabela lateral, ou então clique em Próximo.
     - Para remover uma coluna de tabela lateral existente:
       1. Clique na tabela lateral e na coluna a ser removida.
       2. Clique em Remover.
       3. Continue a incluir, editar ou remover colunas de tabela lateral, ou clique em Próximo.
     - Para remover uma tabela lateral que já existe:

       Exclua cada coluna na tabela lateral para remover a tabela.

       1. Clique em cada coluna da tabela lateral correspondente para a tabela que deve ser removida.
       2. Clique em Remover.
       3. Continue incluindo, editando ou removendo colunas da tabela lateral, ou então clique em Próximo.
  6. Digite um nome de arquivo de saída para o arquivo DAD modificado no campo Nome do arquivo da janela Especificar um DAD.
  7. Clique em Finalizar para salvar o arquivo DAD e retornar para a Barra de Lançamento.

  ### Criando ou editando um DAD para coleções XML

  Quando se cria o DAD da coleção XML, mapeia-se o documento para a origem de dados do DB2, usando para isso uma destas técnicas:

  - Compor arquivo XML usando mapeamento SQL
  - Compor arquivo XML usando mapeamento de nós RDB
  - Decompor arquivo XML usando mapeamento de nós RDB

  #### Composição com mapeamento SQL

  1. Clique em |Editar DAD na Barra de Lançamento. A janela Especificar um DAD é exibida.
  2. Escolha se deseja editar um arquivo DAD que já existe ou criar um arquivo DAD novo.

     Para criar um novo arquivo DAD:

     1. Deixe o campo Nome do arquivo em branco.
     2. Na lista Tipo, selecione Mapeamento SQL de coleção XML.
     3. Clique em Próximo para abrir a janela Selecionar Validação.

     Para editar um arquivo DAD existente:

     1. Digite o nome do arquivo DAD dentro do campo Nome do arquivo ou clique em ... para navegar para um arquivo DAD existente.
     2. Veja se o assistente reconhece o arquivo DAD especificado.
        - Se reconhecer, a opção Próximo estará selecionável e o mapeamento SQL de coleção XML será exibido no campo Tipo.
        - Se o assistente não reconhecer o arquivo DAD especificado, a opção Próximo não estará selecionável. Digite novamente o nome do arquivo DAD ou clique em ... para navegar novamente para um arquivo DAD que já exista. Repita os passos até que Próximo fique selecionável.
     3. Clique em Próximo para abrir a janela Selecionar Validação.
  3. Na janela Selecionar Validação, escolha se quer validar seus documentos XML com um DTD.
     - Para validar:
       1. Clique em Validar documentos XML com o DTD.
       2. Selecione na lista ID do DTD o DTD a ser usado para a validação.

       Quem não importou DTDs para o repositório DTD relativo ao seu banco de dados não poderá validar seus documentos XML.

     - Clique em |NÃO validar para continuar sem validar seus documentos XML.
  4. Clique em Próximo para abrir a janela Especificar Texto.
  5. Digite o prólogo no campo Prólogo, para especificar o prólogo do documento XML a ser composto.

         <?xml version="1.0"?>

     Quando se edita um DAD que já existe, o prólogo é automaticamente exibido no campo Prólogo.

  6. Digite o tipo de documento XML no campo Tipodoc da janela Especificar Texto, apontando para o DTD relativo ao documento XML. Exemplo:

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

     Quando se edita um DAD que já existe, o tipo do documento aparece automaticamente no campo Tipodoc.

  7. Clique em Próximo para abrir a janela Especificar Instrução SQL.
  8. Digite uma instrução SQL SELECT válida no campo Instrução SQL.

     Se estiver editando um DAD existente, a instrução SQL será exibida automaticamente no campo Instrução SQL.

  9. Clique em Testar SQL para testar a validade da instrução SQL.
     - Se sua instrução SQL for válida, os resultados de amostra serão exibidos no campo Resultados de amostra.
     - Se não for, será dada uma mensagem de erro no campo Resultados de amostra. A mensagem de erro ensina a corrigir a instrução SQL SELECT e a tentar de novo.
  10. |Clique em Próximo para abrir a janela Mapear SQL.
  11. Selecione um nó de elemento ou atributo a partir do qual o mapeamento será feito, clicando nele no campo a esquerda da janela |Mapear SQL.

      Mapeie os elementos e atributos do documento XML para os nós de elemento e atributo que correspondem a dados do DB2. Esses nós fornecem o caminho entre os dados do XML e os dados do DB2.

      - Para incluir um nó raiz:
        1. Selecione o ícone Raiz.
        2. Clique em Novo Elemento para definir um novo nó.
        3. Na caixa Detalhes, especifique o Tipo de nó como Elemento.
        4. Digite o nome do nó raiz no campo Nome do nó.
        5. Clique em Incluir para criar o novo nó.

           Foi criado o nó ou elemento raiz, que é o pai de todos os outros nós de elemento e atributo do mapa. Podem ser incluídos agora os elementos e atributos filhos desse nó.

      - Para incluir um elemento filho ou um nó de atributo:
        1. Clique num nó pai no campo da esquerda e inclua um elemento ou atributo filho.

           Se não foi selecionado o nó pai, a opção Novo Elemento não estará selecionável.

        2. Clique em Novo Elemento.
        3. Selecione o tipo de nó a partir da lista Tipo de nó na caixa Detalhes.

           A lista Tipo de nó exibe apenas os tipos de nós válidos naquele ponto do mapa.

        4. Digite o nome do nó no campo Nome do nó na caixa Detalhes.
        5. Se for especificado o Atributo, o Elemento ou o Texto para um elemento de nível inferior como o Tipo de nó, selecione uma coluna no campo Coluna na caixa Detalhes.

           Restrição: Não podem ser criadas novas colunas com o assistente de administração. Se você especificar Coluna como o tipo de nó, você pode selecionar somente uma coluna que já exista no seu banco de dados DB2.

        6. Clique em Incluir para incluir o novo nó.

           Para modificar um nó mais tarde, clique sobre ele no campo da esquerda e faça as modificações necessárias na caixa Detalhes. Clique em Alterar para atualizar o elemento.

           Também é possível incluir elementos ou atributos filho no nó; para isso basta colocá-lo em destaque e repetir o processo de inclusão.

        7. Continue editando o mapa SQL ou clique em Próximo para abrir a janela Especificar um DAD.
      - Para remover um nó:
        1. Clique num nó do campo da esquerda.
        2. Clique em Remover.
        3. Continue editando o mapa SQL ou clique em Próximo para abrir a janela Especificar um DAD.

        Note que quando se remove um nó de nível inferior, outro elemento ocupa seu lugar e pode precisar da definição para si de um nome de coluna.

  12. Digite o nome de um arquivo de saída para o arquivo DAD modificado no campo Nome do arquivo da janela Especificar um DAD.
  13. Clique em Finalizar para retornar até a Barra de Lançamento.

  #### Composição com mapeamento RDB_node

  1. Clique em |Editar DAD na Barra de Lançamento. A janela Especificar um DAD é exibida.
  2. Escolha se deseja editar um arquivo DAD que já existe ou criar um DAD novo.

     Para editar um DAD existente:

     1. Digite o nome do arquivo DAD dentro do campo Nome do arquivo ou clique em ... para navegar até um DAD existente.
     2. Veja se o assistente reconhece o arquivo DAD especificado.
        - Se reconhecer, a opção Próximo estará selecionável e será exibido no campo Tipo o mapeamento RDB_node de coleção XML.
        - Se o assistente não reconhecer o arquivo DAD especificado, a opção Próximo não estará selecionável. Digite novamente o nome do arquivo DAD no campo Nome do arquivo ou clique em ... para navegar novamente para um arquivo DAD que já exista. Continue executando os passos até Próximo estar selecionável.
     3. Clique em Próximo para abrir a janela Selecionar Validação.

     Para criar um novo DAD:

     1. Deixe o campo Nome do arquivo em branco.
     2. Selecione Mapeamento do nó RDB da coleção XML na lista Tipo.
     3. Clique em Próximo para abrir a janela Selecionar Validação.
  3. Na janela Selecionar Validação, escolha se quer validar seus documentos XML com um DTD.
     - Para validar:
       1. Clique em Validar documentos XML com o DTD.
       2. Selecione na lista ID do DTD o DTD a ser usado para a validação.

       Quem não importou DTDs para o repositório DTD relativo ao seu banco de dados não poderá validar seus documentos XML.

     - Clique em |NÃO validar para continuar sem validar seus documentos XML.
  4. Clique em Próximo para abrir a janela Especificar Texto.
  5. Digite o nome do prólogo no campo Prólogo da janela Especificar Texto.

         <?xml versão="1.0"?>

     Quando se edita um DAD que já existe, o prólogo é automaticamente exibido no campo Prólogo.

  6. Digite o tipo de documento XML no campo Tipodoc. Exemplo:

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

     Quando se edita um DAD que já existe, o tipo do documento aparece automaticamente no campo Tipodoc.

  7. |Clique em Próximo para abrir a janela Mapear nós RDB.
  8. Selecione um nó de elemento ou atributo a partir do qual o mapeamento será feito, clicando nele no campo a esquerda da janela |Mapear nós RDB.

     Mapeie os elementos e atributos do documento XML para os nós de elemento e atributo que correspondem a dados do DB2. Esses nós fornecem o caminho entre os dados do XML e os dados do DB2.

  9. Para incluir o nó raiz:
     1. Selecione o ícone Raiz.
     2. Clique em Novo Elemento para definir um novo nó.
     3. Na caixa Detalhes, especifique o Tipo de nó como Elemento.
     4. Digite o nome do nó raiz no campo Nome do nó.
     5. Clique em Incluir para criar o novo nó.

        Foi criado o nó ou elemento raiz, que é o pai de todos os outros nós de elemento e atributo do mapa. O nó raiz possui elementos da tabela filho e uma condição de união.

        Inclua nós de tabela para cada tabela que seja parte da coleção.

        1. Destaque o nome do nó raiz e selecione Novo Elemento.
        2. Na caixa Detalhes, especifique o Tipo de nó como Tabela.
        3. Selecione o nome da tabela a partir de Nome da tabela. A tabela precisa existir.
        4. Clique em Incluir para incluir o nó de tabela.
        5. Repita estas etapas para cada tabela.

        Inclua uma condição de união para os nós de tabela.

        1. Destaque o nome do nó raiz e selecione Novo Elemento.
        2. Na caixa Detalhes, especifique o Tipo de nó como Condição.
        3. No campo Condição, digite a condição de união usando a seguinte sintaxe:

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

           Inclua tantas condições, unidas por AND, quantas forem necessárias para criar a condição de união.

        4. Clique em Incluir para incluir a condição.

     Podem ser incluídos agora os elementos e atributos filhos desse nó.

  10. Para incluir um elemento filho ou um nó de atributo:
      1. Clique num nó pai no campo da esquerda e inclua um elemento ou atributo filho.
      2. Clique em Novo Elemento. Se não foi selecionado o nó pai, a opção Novo Elemento não estará selecionável.
      3. Selecione um tipo de nó a partir da lista Tipo de nó na caixa Detalhes.

         A lista Tipo do nó exibe apenas os tipos de nó válidos naquele ponto do mapa, que são Elemento ou Atributo.

      4. Digite o nome do elemento ou atributo no campo Nome do nó.
      5. Se for especificado como Tipo do nó, Atributo, ou como elemento de nível inferior, Elemento, selecione uma coluna no campo Coluna na caixa Detalhes.

         Restrição: Não podem ser criadas novas colunas com o assistente de administração. Se você especificar Coluna como o tipo de nó, você pode selecionar somente uma coluna que já exista no seu banco de dados DB2.

      6. Clique em Incluir para incluir o novo nó.

         Para modificar um nó mais tarde, clique sobre ele no campo da esquerda e faça as modificações necessárias na caixa Detalhes. Clique em Alterar para atualizar o elemento.

         Também é possível incluir elementos ou atributos filho no nó; para isso basta colocá-lo em destaque e repetir o processo de inclusão.

      7. Para mapear o conteúdo de um nó de elemento ou de atributo em uma tabela relacional:
         1. Especifique um nó de texto.
            1. Clique no nó pai.
            2. Clique em Novo Elemento.
            3. No campo Tipo de nó, selecione Texto.
            4. Selecione Incluir para incluir o nó.
         2. Inclua um nó de tabela.
            1. Selecione o nó de texto que acabou de ser criado e clique em Novo Elemento.
            2. No campo Tipo de nó, selecione Tabela e especifique um nome de tabela para o elemento.
            3. Clique em Incluir para incluir o nó.
         3. Inclua um nó de coluna.
            1. Selecione o nó de texto novamente e clique em Novo Elemento.
            2. No campo Tipo de nó, selecione Coluna e especifique um nome de coluna para o elemento.
            3. Clique em Incluir para incluir o nó.

            Restrição: Não podem ser criadas novas colunas com o assistente de administração. Se você especificar Coluna como o tipo de nó, você pode selecionar somente uma coluna que já exista no seu banco de dados DB2.

         4. Inclua opcionalmente uma condição para a coluna.
            1. Selecione o nó de texto novamente e clique em Novo Elemento.
            2. No campo Tipo de nó, selecione Condição e a condição com a sintaxe:

                   operador LIKE|<|>|= valor

            3. Clique em Incluir para incluir o nó.
      8. Continue editando o mapa RDB_node ou clique em Próximo para abrir a janela Especificar um DAD.
  11. Para remover um nó:
      1. Clique num nó do campo da esquerda.
      2. Clique em Remover.
      3. Continue editando o mapa RDB_node ou clique em Próximo para abrir a janela Especificar um DAD.
  12. Digite em um nome de arquivo de saída para o DAD modificado no campo Nome do arquivo da janela Especificar um DAD.
  13. Clique em Finalizar para remover o nó e retornar para a Barra de Lançamento.

  #### Decomposição com mapeamento RDB_node

  1. Clique em |Editar DAD na Barra de Lançamento. A janela Especificar um DAD é exibida.
  2. Escolha se deseja editar um arquivo DAD que já existe ou criar um DAD novo.

     Para editar um DAD existente:

     1. Digite o nome do arquivo DAD dentro do campo Nome do arquivo ou clique em ... para navegar até um DAD existente.
     2. Veja se o assistente reconhece o arquivo DAD especificado.
        - Se reconhecer, a opção Próximo estará selecionável e será exibido no campo Tipo o mapeamento RDB_node de coleção XML.
        - Se o assistente não reconhecer o arquivo DAD especificado, a opção Próximo não estará selecionável. Digite novamente o nome do arquivo DAD no campo Nome do arquivo ou clique em ... para navegar novamente para um arquivo DAD que já exista. Continue executando os passos até Próximo estar selecionável.
     3. Clique em Próximo para abrir a janela Selecionar Validação.

     Para criar um novo DAD:

     1. Deixe o campo Nome do arquivo em branco.
     2. Selecione Mapeamento RDB_node de coleção XML na lista Tipo.
     3. Clique em Próximo para abrir a janela Selecionar Validação.
  3. Na janela Selecionar Validação, escolha se quer validar seus documentos XML com um DTD.
     - Para validar:
       1. Clique em Validar documentos XML com o DTD.
       2. Selecione na lista ID do DTD o DTD a ser usado para a validação.

       Quem não importou DTDs para o repositório DTD relativo ao seu banco de dados não poderá validar seus documentos XML.

     - Clique em |NÃO validar para continuar sem validar seus documentos XML.
  4. Clique em Próximo para abrir a janela Especificar Texto.
  5. Ao decompor apenas um documento XML, ignore o campo Prólogo. Ao usar o arquivo DAD tanto para composição quanto decomposição, digite o nome do prólogo no campo Prólogo da janela Especificar Texto. O prólogo não é necessário quando se decompõem documentos XML em dados do DB2.

         <?xml versão="1.0"?>

     Quando se edita um DAD que já existe, o prólogo é automaticamente exibido no campo Prólogo.

  6. Ao decompor apenas um documento XML, ignore o campo Tipodoc. Se estiver usando o arquivo DAD tanto para composição quanto para decomposição, digite o tipo do documento XML no campo Tipodoc

     Quando se edita um DAD que já existe, o tipo do documento aparece automaticamente no campo Tipodoc. Exemplo:

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

  7. Clique em Próximo para abrir a janela Mapeamento RDB.
  8. Selecione um nó de elemento ou de atributo a partir do qual o mapeamento será feito, clicando sobre ele no campo à esquerda da janela Mapeamento RDB.

     Mapeie os elementos e atributos do documento XML para os nós de elemento e de atributo que correspondem a dados do DB2. Esses nós fornecem o caminho entre os dados do XML e os dados do DB2.

  9. Para incluir o nó raiz:
     1. Selecione o ícone Raiz.
     2. Clique em Novo Elemento para definir um novo nó.
     3. Na caixa Detalhes, especifique o Tipo de nó como Elemento.
     4. Digite o nome do nó raiz no campo Nome do nó.
     5. Clique em Incluir para criar o novo nó.

        Foi criado o nó ou elemento raiz, que é o pai de todos os outros nós de elemento e atributo do mapa. O nó raiz possui elementos de tabela filhos e uma condição de união.

        Inclua nós de tabela para cada tabela que seja parte da coleção.

        1. Destaque o nome do nó raiz e selecione Novo Elemento.
        2. Na caixa Detalhes, especifique o Tipo de nó como Tabela.
        3. Selecione o nome da tabela a partir de Nome da tabela. A tabela precisa existir.
        4. Especifique uma coluna-chave para a tabela no campo Chave de tabela.
        5. Clique em Incluir para incluir o nó de tabela.
        6. Repita estas etapas para cada tabela.

        Inclua uma condição de união para os nós de tabela.

        1. Destaque o nome do nó raiz e selecione Novo Elemento.
        2. Na caixa Detalhes, especifique o Tipo de nó como Condição.
        3. No campo Condição, digite a condição de união usando a seguinte sintaxe:.

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

        4. Clique em Incluir para incluir a condição.

     Podem ser incluídos agora os elementos e atributos filhos desse nó.

  10. Para incluir um elemento filho ou um nó de atributo:
      1. Clique num nó pai no campo da esquerda e inclua um elemento ou atributo filho.

         Se não foi selecionado o nó pai, a opção Novo não estará selecionável.

      2. Clique em Novo Elemento.
      3. Selecione um tipo de nó a partir da lista Tipo de nó na caixa Detalhes.

         A lista Tipo do nó exibe apenas os tipos de nó válidos naquele ponto do mapa, que são Elemento ou Atributo.

      4. Clique em Incluir para incluir o novo nó. É possível modificar posteriormente um nó ao clicar nele no campo à esquerda e efetuar as modificações necessárias na caixa Detalhes. Clique em Alterar para atualizar o elemento.
      5. Para mapear o conteúdo de um nó de elemento ou de atributo em uma tabela relacional:
         1. Especifique um nó de texto.
            1. Clique no nó pai.
            2. Clique em Novo Elemento.
            3. No campo Tipo de nó, selecione Texto.
            4. Selecione Incluir para incluir o nó.
         2. Inclua um nó de tabela.
            1. Selecione o nó de texto que acabou de ser criado e clique em Novo Elemento.
            2. No campo Tipo de nó, selecione Tabela e especifique um nome de tabela para o elemento.
            3. Clique em Incluir para incluir o nó.
         3. Inclua um nó de coluna.
            1. Selecione o nó de texto novamente e clique em Novo Elemento.
            2. No campo Tipo de nó, selecione Coluna e especifique um nome de coluna para o elemento.
            3. Especifique um dos tipos de dados base para a coluna no campo Tipo, para especificar qual tipo de coluna deve ser usado para armazenar os dados não marcados.
            4. Clique em Incluir para incluir o nó.

            Restrição: Não podem ser criadas novas colunas com o assistente de administração. Se você especificar Coluna como o tipo de nó, você pode selecionar somente uma coluna que já exista no seu banco de dados DB2.

         4. Inclua opcionalmente uma condição para a coluna.
            1. Selecione o nó de texto novamente e clique em Novo Elemento.
            2. No campo Tipo de nó, selecione Condição e a condição com a sintaxe:

                   operador LIKE|<|>|= valor

            3. Clique em Incluir para incluir o nó.
      6. Continue editando o mapa RDB_node ou clique em Próximo para abrir a janela Especificar um DAD.
  11. Para remover um nó:
      1. Clique num nó do campo da esquerda.
      2. Clique em Remover.
      3. Continue editando o mapa RDB_node ou clique em Próximo para abrir a janela Especificar um DAD.
  12. Digite em um nome de arquivo de saída para o DAD modificado no campo Nome do arquivo da janela Especificar um DAD.
  13. Clique em Finalizar para remover o nó e retornar para a Barra de Lançamento.

  # Trabalhando com colunas XML

  Com este assistente é possível incluir, habilitar ou desabilitar colunas XML do XML Extender.

  ## Campos e controles

  ### Selecionar uma tarefa (para colunas)

  Incluir uma Coluna XML
    Selecione para abrir a janela Incluir uma coluna XML para incluir uma coluna numa tabela. Esta coluna conterá um documento XML intacto. Essa opção estará disponível somente se o banco de dados estiver habilitado.

  |Ativar uma coluna XML
    Selecione para abrir a |janela Ativar uma coluna XML para se conectar em um banco de dados e ativar uma coluna XML para que esta possa conter UDTs do XML Extender. Esta opção estará disponível somente se o banco de dados for habilitado e as colunas estiverem criadas para documentos XML.

  |Desativar uma coluna XML
    Selecione para abrir a |janela Desativar coluna XML para desativar uma coluna existente. Se o banco de dados não estiver habilitado ou uma coluna XML habilitada não existir, esta opção não estará disponível. Uma coluna desabilitada não pode mais conter documentos XML. É preciso desabilitar a coluna XML antes de eliminar uma tabela XML. Se uma tabela for eliminada e sua coluna XML não for desabilitada, o XML Extender conservará as tabelas laterais criadas e a entrada da coluna XML na tabela de utilização XML.

  Próximo
    Abra a janela selecionada para incluir, habilitar ou desabilitar uma coluna XML.

  Encerrar
    Disponível quando você acaba de trabalhar com a coluna.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Incluir uma coluna XML

  Nome da tabela
    Digite o nome da tabela ou selecione o nome a partir da lista de tabelas disponíveis. A tabela deve ser definida para incluir uma coluna XML. Exemplo:

        SALES_DB

  Nome da coluna
    Digite o nome que você deseja usar para a coluna XML. Exemplo:

        ORDER

  |Tipo de dados
    Selecione o tipo de dados a partir da lista de tipos disponíveis, como XMLCLOB, XMLVARCHAR ou XMLFILE. Exemplo:

        XMLVARCHAR

  Voltar
    Abre na janela Selecionar uma tarefa usada para trabalhar com colunas XML.

  Encerrar
    Inclui a coluna XML e retorna para a Barra de Lançamento.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Habilitar uma coluna XML

  Nome da tabela
    Digite o nome da tabela que possui uma coluna XML ou selecione o nome a partir da lista de nomes de tabelas disponíveis. Exemplo

        SALES_TAB

  Nome da coluna
    Digite o nome de uma coluna XML existente na tabela ou selecione o nome a partir da lista de colunas disponíveis. Exemplo:

        ORDER

  Nome do arquivo DAD
    Digite a localização do arquivo DAD que mapeia o documento XML para a coluna XML e para as tabelas laterais ou clique em ... para procurar um arquivo DAD existente. Exemplo:

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

  Table space
    Opcional: Digite o nome de um tablespace criado anteriormente para tabelas laterais associadas à coluna XML. Se o table space não estiver especificado, um table space padrão será utilizado.

  View padrão
    Opcional: Digite o nome de uma view padrão que une a tabela XML e todas as tabelas laterais relacionadas.

  |ID da raiz
    Recomendado, mas opcional: digite o nome de coluna da chave primária na tabela para associar todas as tabelas laterais com a tabela da aplicação. Se não for especificado uma ID DA RAIZ, o XML Extender inclui uma coluna DXXROOT_ID na tabela e gera um identificador.

  Voltar
    Abre na janela Selecionar uma tarefa usada para trabalhar com colunas XML.

  Encerrar
    Ativa a coluna XML e retorna para a Barra de Lançamento. Para habilitar a coluna, o XML Extender determina se a tabela XML tem chave primária, cria tabelas laterais que são especificadas no arquivo DAD e cria uma view padrão para a tabela XML e para as tabelas laterais.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento

  ### Desabilitar uma coluna XML

  Nome da tabela
    Digite o nome da tabela que contém a coluna XML ou selecione o nome a partir da lista de tabelas disponíveis.

  Nome da coluna
    Digite o nome de uma coluna existente na tabela ou selecione o nome a partir da lista de nomes da coluna.

  Voltar
    Abre na janela Selecionar uma tarefa usada para trabalhar com colunas XML.

  Encerrar
    Desativa a coluna XML e retorna para a Barra de Lançamento. Uma coluna desativada não pode mais conter documentos XML.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ## Tarefas

  ### Incluindo uma coluna XML

  1. Clique em Trabalhar com colunas XML na Barra de Lançamento. A janela Selecionar uma tarefa é aberta.
  2. Clique em Incluir uma Coluna XML. A janela Incluir uma coluna XML é aberta.
  3. Selecione o nome da tabela a partir da lista Nome da tabela ou digite o nome da tabela a ser alterada.
  4. Digite o nome da coluna para ser incluído a tabela no campo Nome da coluna.
  5. Selecione o UDT para a coluna a partir da lista |Tipo de dados.
  6. Clique em Encerrar para incluir a coluna do tipo XML.

  ### Habilitando uma coluna XML

  1. Clique em Trabalhar com colunas XML na Barra de Lançamento para exibir as tarefas relacionadas a coluna do XML Extender. Abre-se a janela Selecionar Tarefa.
  2. Clique em |Ativar uma Coluna XML e em seguida em Próximo para ativar uma coluna de tabela existente no banco de dados.
  3. Selecione a tabela que contém a coluna XML a partir do campo Nome da tabela.
  4. Selecione a coluna que está sendo habilitada no campo Nome da coluna. A coluna deve existir e ser do tipo XML.
  5. Digite o caminho do DAD e o nome do arquivo dentro do campo Nome do arquivo DAD ou clique em ... para navegar até um arquivo DAD existente.
  6. Opcionalmente, digite o nome de um table space existente no campo Table space.

     O tablespace contém tabelas laterais criadas pelo XML Extender. Quando se especifica um tablespace, as tabelas laterais são criadas nele. Quando não se especifica tablespace, as tabelas laterais são criadas no tablespace padrão.

  7. Opcionalmente, digite o nome da view padrão no campo View padrão.

     Quando especificada, a view padrão é automaticamente criada no momento em que a coluna é habilitada e une a tabela XML e todas as tabelas laterais relacionadas a ela.

  8. Opcionalmente, digite o nome da coluna da chave primária na tabela de aplicação no campo ID da Raiz. Isto é necessário.

     O XML Extender usa o valor da ID raiz como identificador único para associar todas as tabelas laterais com a tabela da aplicação. Quando ela não é especificada, o XML Extender inclui uma coluna DXXROOT_ID na tabela da aplicação e gera um identificador.

  9. Clique em Finalizar para ativar a coluna XML, criar as tabelas laterais e retornar para a Barra de Lançamento.
     - Se a habilitação da coluna ocorrer sem problemas, será dada a mensagem `Coluna habilitada com sucesso`.
     - Se ocorrerem problemas na habilitação, será apresentada uma caixa de erro. Corrija os valores nos campos de entrada até que a coluna seja ativada com sucesso.

  ### Desabilitando uma coluna XML

  1. Clique em Trabalhando com colunas XML na Barra de Lançamento para exibir as tarefas relacionadas a coluna do XML Extender. Abre-se a janela Selecionar Tarefa.
  2. Clique em |Desativar uma Coluna XML e em seguida em Próximo na janela Selecione uma Tarefa para desativar uma coluna de tabela existente no banco de dados.
  3. Selecione a tabela que contém a coluna XML a partir do campo Nome da tabela.
  4. Selecione no campo Nome da coluna a coluna que está sendo desabilitada.
  5. Clique em Finalizar.
     - Se a desabilitação da coluna ocorrer sem problemas, será dada a mensagem `Coluna desabilitada com sucesso`.
     - Se ocorrerem problemas na desabilitação, será apresentada uma caixa de erro. Corrija os valores nos campos de entrada até que a coluna seja desativada com sucesso.

  # Trabalhando com coleções XML

  Com este assistente, é possível habilitar ou desabilitar coleções XML.

  ## Campos e controles

  ### Selecionar uma tarefa (para coleções)

  Habilitar uma Coleção XML
    Selecione para abrir a janela Habilitar uma coleção XML. Habilitar uma coleção XML faz com que o arquivo DAD seja analisado para identificar as tabelas e colunas relacionadas a documentos XML e faz com que sejam registradas informações de controle. Esta opção só fica disponível se o banco de dados estiver habilitado e existir um arquivo DAD.

  Desabilitar uma Coleção XML
    Selecione para abrir a janela Desabilitar uma coleção ou para remover marcadores que identificam tabelas e colunas como parte de uma coleção XML. Se a coleção não estiver habilitada, esta opção não estará disponível.

  Próximo
    Abre a janela selecionada para habilitar ou desabilitar uma coleção XML.

  Encerrar
    Disponível quando você acaba de trabalhar com a coleção.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Habilitar uma coleção XML

  Nome da coleção
    Digite o nome da coleção XML que você deseja habilitar.

  Nome do arquivo DAD
    Digite o nome do arquivo DAD que mapeia a estrutura do documento XML nas tabelas DB2 a partir das quais um documento foi composto ou decomposto ou clique em ... para procurar um arquivo DAD existente.

  ...
    Abra uma janela Procurar para selecionar um nome de arquivo DAD existente.

  Table space
    Digite o nome de um tablespace criado antes se ele existir. Ele conterá as novas tabelas do DB2 geradas para composição ou decomposição.

  Voltar
    Abre a janela Selecionar uma tarefa usada para trabalhar com coleções XML.

  Encerrar
    Ativa a coleção XML e retorna para a Barra de Lançamento. Para habilitar a coleção, o XML Extender usou o arquivo DAD para identificar as tabelas e colunas dos documentos XML, registrando informações de controle na tabela XML_USAGE.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ### Desabilitar uma coleção XML

  Nome da coleção
    Selecione o nome da coleção XML que você deseja desabilitar a partir da lista de coleções.

  Voltar
    Abre a janela Selecionar uma tarefa usada para trabalhar com coleções XML.

  Encerrar
    Desativa a coleção XML e retorna para a Barra de Lançamento. Para desabilitar uma coleção, o XML Extender remove marcadores que identificam tabelas e colunas como parte de uma coleção XML.

  Cancelar
    Cancela o assistente e retorna para a Barra de Lançamento.

  ## Tarefas

  ### Ativando uma coleção XML

  1. Clique em Trabalhar com Coleções XML na Barra de Lançamento. A janela Selecionar uma Tarefa é exibida.
  2. Clique em |Ativar uma Coleção XML e em seguida em Próximo. A janela Habilitar uma Coleção é exibida.
  3. Selecione o nome da coleção que você deseja habilitar no campo Nome da coleção a partir da lista.
  4. Digite o nome do arquivo DAD dentro do campo Nome do arquivo DAD ou clique em ... para navegar para um arquivo DAD existente.
  5. Opcionalmente, digite no campo Tablespace o nome de um tablespace criado antes.

     Ele conterá as novas tabelas do DB2 geradas para decomposição.

  6. Clique em Finalizar para ativar a coleção e retornar para a Barra de Lançamento.
     - Se a habilitação da coleção ocorrer sem problemas, será dada a mensagem `Coleção habilitada com sucesso`.
     - Se ocorrerem problemas na habilitação, será apresentada uma caixa de erro. Corrija os valores nos campos de entrada até que a coleção seja ativada com sucesso.

  ### Desativando uma coleção XML

  1. Clique em Trabalhar com Coleções XML na Barra de Lançamento para exibir as tarefas relacionadas a coleção do XML Extender. A janela Selecionar uma Tarefa é exibida.
  2. Clique em Desativar uma Coleção XML e em seguida em Próximo para desativar uma coleção XML. A janela Desabilitar uma Coleção é exibida.
  3. Digite o nome da coleção que você deseja desabilitar no campo Nome da coleção.
  4. Clique em Finalizar para desativar a coleção e retornar para a Barra de Lançamento.
     - Se a desabilitação da coleção ocorrer sem problemas, será dada a mensagem `Coleção desabilitada com sucesso`.
     - Se ocorrerem problemas na desabilitação, será apresentada uma caixa de erro. Corrija os valores nos campos de entrada até que a coleção seja desativada com sucesso.