No IBM® Integration Bus, você implementa manualmente uma
transformação de Consulta de Relacionamento em um mapa. Você define e configura um nó
FileRead ou um nó DatabaseRetrieve para ler os dados no meio de um
fluxo de mensagens.
No IBM Integration Bus, você implementa manualmente um
nó FileRead ou um nó DatabaseRetrieve para concluir a conversão de uma transformação de
Consulta de Relacionamento. Como opção, use um nó de Cálculo se nenhum dado for
recuperado do arquivo ou da tabela de banco de dados. No
WebSphere Enterprise Service Bus, você define uma transformação de Consulta de
relacionamento como uma transformação Customizada.
No
WebSphere Enterprise Service Bus, 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
representados como códigos (como país, moeda, ou status civil).
Conclua as etapas a seguir 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 nó FileRead se você criou um arquivo na etapa 1. Para obter informações adicionais, consulte Nó FileRead.
- Escolha um nó DatabaseRetrieve se você criou uma tabela de banco de dados na etapa 1. Para informações adicionais, consulte Nó DatabaseRetrieve.
Use um nó de leitura de arquivo 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.
Use 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 nó FileRead ou um nó DatabaseRetrieve 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 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.
- Determine se o nó FileRead ou o nó DatabaseRetrieve é necessário antes ou após o nó
de Mapeamento.
- Quando uma transformação de Consulta é chamada a partir de um elemento de entrada
no mapa XML, você conecta um terminal de saída de um nó FileRead ou DatabaseRetrieve
ao terminal de Entrada do nó de Mapeamento ou ao terminal de
Entrada do nó de Cálculo.
- Conecte o terminal de Saída de um nó FileRead quando os dados
forem recuperados com êxito de um arquivo.
- Conecte o terminal Sem correspondência de um nó FileRead ao
terminal de Entrada do nó de Cálculo quando o arquivo não existir
no sistema de arquivos ou existir, mas nenhum registro que corresponda à expressão de
filtro puder ser encontrado. Em seguida, conecte o terminal de
Saída do nó de Cálculo ao terminal de
Entrada do nó de Mapeamento.
- Conecte o terminal de Saída de um nó DatabaseRetrieve quando
os dados forem recuperados com êxito de um recurso externo.
- Conecte o terminal KeyNotFound de um nó DatabaseRetrieve ao
terminal de Entrada do nó de Cálculo quando o conjunto de
resultados estiver vazio. Em seguida, conecte o terminal de Saída
do nó de Cálculo ao terminal de Entrada do nó de Mapeamento.
- Quando uma transformação de Consulta é chamada a partir de um elemento de saída
no mapa XML, você conecta o terminal de Saída do nó de Mapeamento
ao terminal de Entrada de um nó FileRead ou DatabaseRetrieve.
- Opcional: Use um nó de Cálculo para configurar o valor de saída quando nenhuma saída estiver
definida para a entrada fornecida. Se você definiu o valor da propriedade com.ibm.wbit.mapping.xml.lookup.default no
WebSphere Enterprise Service Bus, use esse valor. Configure o valor de saída
como sequência vazia se nenhuma propriedade for definida.
Próximas etapas:
Na visualização Resultados da Conversão, clique com o
botão direito do mouse na tarefa de Pendências. Selecione
Concluir.