Use um procedimento armazenado do banco de dados DB2 ou Oracle
como uma origem em um Nó Mapping.
Para mapear um elemento de destino a partir de um procedimento armazenado de
banco de dados, configure o
Nó Mapping para:
- executar o procedimento armazenado para recuperar as linhas relevantes do
banco de dados
- preencher os elementos de destino da mensagem com valores do banco de dados
Conclua estas etapas para mapear um elemento de destino a partir
de um procedimento armazenado:
- Inclua um procedimento armazenado como uma origem para o mapeamento, conforme
descrito em Incluindo um Banco de Dados como Origem ou Destino. Após você ter incluído
um procedimento armazenado no mapeamento, a área de janela Origem e a
área de janela Planilha conterão entradas $db:proc. Estas entradas $db:proc contêm detalhes
dos parâmetros usados pelo procedimento armazenado. Para cada parâmetro ela mostra seu nome, seu modo (IN, INOUT
ou OUT) e seu tipo de dado.
A entrada $db:proc na área de janela Planilha
também contém uma linha 'for'. Por padrão,
a posição da linha 'for' na entrada $db:proc indica
que onde há mais de um registro no conjunto de resultados, o corpo da
mensagem de saída contém elementos de repetição. Se você desejar que uma mensagem separada
seja enviada para cada registro em um conjunto de resultados, mova o elemento $target
na área de janela Planilha abaixo da linha 'for'.
Se você estiver usando um procedimento armazenado do DB2 que
especifica um número máximo de conjuntos de resultados, a área de janela Origem também inclui
uma lista de conjuntos de resultados. Se você estiver usando um procedimento armazenado Oracle
que especifica parâmetros ref cursor do modo INOUT ou OUT, o Nó Mapping os tratará como
conjuntos de resultados denominados em vez de parâmetros. O Nó Mapping não suporta
parâmetros ref cursor do modo IN.
- Se seu procedimento armazenado tiver parâmetros de modo IN ou INOUT,
forneça valores para cada um deles:
- Digite uma expressão no campo Valor
próximo ao parâmetro na área de janela Planilha.
- Selecione o parâmetro na área de janela Planilha, arraste um
elemento da mensagem de origem para a área de janela Editar e pressione Enter.
- Se seu procedimento armazenado configurar um valor de retorno, clique com o botão
direito do mouse na entrada $db:proc na área de janela Origem e selecione Comutar
entre Incluir/Remover Valor de Retorno do Procedimento Armazenado. Um elemento chamado
ReturnValue do tipo INTEGER é incluído na área de janela Origem.
O DB2 em sistemas distribuídos
retorna SQLCODE se o procedimento armazenado não configurar um valor de retorno.
DB2 nos procedimentos armazenados z/OS e Oracle
não configura um valor de retorno.
- Para cada conjunto de resultados que seu procedimento armazenado retorna,
defina as colunas que ele contém:
- Clique com o botão direito do mouse na entrada do conjunto de resultados na área de janela Origem
e selecione Incluir ou Remover Colunas do Conjunto de Resultados. A janela Incluir ou Remover Colunas do Conjunto de Resultados é aberta.
- (Opcional) Selecione um item a partir da lista Restaurar
Configurações Anteriores a partir de. A lista Colunas
do Conjunto de Resultados é substituída.
- (Opcional) Selecione colunas na lista Colunas da Tabela
de Banco de Dados Disponíveis e inclua-as na lista Colunas
do Conjunto de Resultados.
- (Opcional) Digite um nome de coluna no campo Nova
Coluna e inclua-a na lista Colunas do
Conjunto de Resultados. Use este método para incluir colunas calculadas
que são nomeadas no procedimento armazenado.
- (Opcional) Altere o nome no campo Salvar Configurações
Atuais em que é usado para salvar as colunas mostradas
em Colunas do Conjunto de Resultados quando você clica em Concluir. As configurações são salvas no diretório \.metadata.
É possível recuperar estas configurações em outro mapa de mensagem, conforme descrito
na etapa 4a. Se você não alterar o nome padrão, as configurações serão
recuperadas automaticamente quando o procedimento armazenado for usado em
outro mapa de mensagem.