No IBM® Integration Bus, você implementa manualmente um nó FileRead , um nó JavaCompute , um nó Banco de Dados ou um nó DatabaseRetrieve para recriar uma transformação de Consulta de Relacionamento que é definido em um mapaWebSphere Enterprise Service Bus . Opcionalmente, você pode usar um nó Compute ou um nó JavaCompute se nenhum dado for recuperado da tabela de arquivo ou banco de dados. Em seguida, você se conectar um dos nós para o nó Mapeamento responsável por transformar seus dados.
No
WebSphere Enterprise Service Bus, você define uma transformação de Consulta de
relacionamento como uma transformação Customizada. Uma transformação de Consulta de Relacionamento executa o gerenciamento de relacionamento entre dados estáticos de referência cruzada. A origem e o destino de uma transformação de Consulta de
Relacionamento devem ser tipos simples. Os dados que você geralmente transforma usando relacionamentos são números de ID (como ID do pedido ou do produto) e outros valores que são representados como códigos (como país, moeda, ou status civil).
O ferramenta
de conversão do WebSphere ESB cria um marcador Tarefa em seu mapa onde ele encontra uma transformação de Consulta de Relacionamento.
Para recriar uma transformação de Consulta no IBM Integration Bus, conclua as seguintes etapas manualmente:
- Crie um arquivo de valor separado por vírgula ou uma tabela de banco de dados com os
valores que você usa para preencher um relacionamento estático no
WebSphere Enterprise Service Bus.
- Escolha qualquer um dos nós do fluxo de
mensagens a seguir:
- Escolha um FileRead se você criou um arquivo na etapa 1. Para obter informações adicionais, consulte Nó FileRead.
- Escolha um JavaCompute se você criou um arquivo na etapa 1. Para obter informações adicionais, consulte Nó JavaCompute.
- Escolha um Banco de Dados se você criou uma tabela de banco de dados na etapa 1. Para informações adicionais, consulte Nó Banco de Dados.
- Escolha um DatabaseRetrieve se você criou uma tabela de banco de dados na etapa 1. Para informações adicionais, consulte Nó DatabaseRetrieve.
Você pode usar um nó FileRead ou um nó JavaCompute para ler os dados de um arquivo no meio de um fluxo de mensagens. Para informações adicionais, consulte Combinando uma Mensagem de Resultado com uma Mensagem Recebida.
Você pode usar um nó Banco de Dados ou um nó DatabaseRetrieve para modificar uma mensagem usando informações de um banco de dados. Para informações adicionais, consulte Acessando Bancos de Dados em Fluxos de Mensagens.
- Arraste e solte um dos anterior do Nós do no fluxo de mensagens.
- Configure as propriedades do nó do fluxo de mensagens.
- Configure o nó FileRead.
- Configure as propriedades Registros e Elementos.
Essas propriedades definem como identificar registros em um arquivo.
- Configure as propriedades de Resultado. Essas propriedades
definem como transmitir os dados.
- Você deve configurar a propriedade Expressão de seleção de
registro para especificar a expressão a ser usada para selecionar o registro
correto do arquivo.
- Configure a propriedade Classe Java no nó JavaCompute . Esta propriedade define o nome da classe Java que é usada.
- Configure o nó DatabaseRetrieve:
- Configure as propriedades Básicas. Essas propriedades definem
as características da tabela de banco de dados.
- Configure as propriedades da Tabela de elementos de
dados.
Essas propriedades definem informações sobre os dados a serem
recuperados.
- Você deve configurar a propriedade Elementos de dados para
especificar a expressão a ser usada para selecionar o registro correto da tabela de banco
de dados.
- Configure as propriedades do nó Banco de Dados Básico .
Essas propriedades definem
as características da tabela de banco de dados.
- Você deve configurar a propriedade Instrução para especificar a expressão a ser usada para selecionar o registro correto da tabela de banco de dados.
- Você deve configurar a propriedade Origem de Dados para definir o banco de dados que contém as tabelas.
- Determine se o nó que você escolheu na etapa 2 é necessário antes ou após o nó Mapeamento .
- Quando uma conversão de Consulta é chamada a partir de um elemento de entrada no mapa XML, conecte um terminal de saída do nó que você escolheu na etapa 2 para o terminal In do nó Mapeamento ou para o terminal In de um nó Compute .
- Quando uma conversão Consulta é chamada a partir de um elemento de saída no mapa XML, conecte o terminal Out do nó Mapeamento ao terminal In do nó escolhido na etapa 2.
- Opcional: Se o nó que você escolheu na etapa 2 é necessário antes do nó Mapeamento , conclua as seguintes etapas:
- Conecte o terminal Out de um nó FileRead ou um JavaCompute quando os dados forem recuperados com êxito de um arquivo.
- Conecte o terminal Sem Correspondência de um nó FileRead ou o Alternativo terminal de um nó JavaCompute para o terminal In do nó Compute quando o arquivo não existir no sistema de arquivos ou existir, mas nenhum registro que corresponde à expressão de filtro puder ser encontrado
- Conecte o terminal Out de um nó DatabaseRetrieve ou um Banco de Dados quando os dados forem recuperados com êxito de um recurso externo.
- Conecte o terminal KeyNotFound de um nó DatabaseRetrieve para o terminal In do nó Compute quando o conjunto de resultados está vazio.
- Opcional: Para manipular o cenário onde o valor de saída está vazio ou não definido, conclua as seguintes etapas:
- Defina o valor de saída.
- Se você definiu o valor da propriedade com.ibm.wbit.mapping.xml.lookup.default no WebSphere Enterprise Service Bus, configure o valor de saída para usar este valor.
- Se nenhuma propriedade é definida, configure o valor de saída como sequência vazia.
- Arraste e solte um nó Compute ou um nó JavaCompute no fluxo de mensagens.
- Quando uma transformação de Consulta é chamada a partir de um elemento de entrada no mapa XML, conecte o terminal Out do nó Compute ou o JavaCompute do nó para o terminal In do nó Mapeamento .
- Quando uma transformação de Consulta é chamado a partir de um elemento de saída no mapa XML, conecte o terminal Out do nó Mapeamento para o terminal In do nó Compute ou o JavaCompute do nó.
Próximas etapas:
- Em seu mapa, exclua o marcador Tarefa: Clique em Tarefae selecione Excluir.
- Na visualização Revisar Resultados, clique com o botão direito na tarefa de pendência. Selecione
Concluir.