Atividade Chamar Procedimento
Durante o tempo de execução, a atividade Chamar Procedimento executa um procedimento armazenado em um banco de dados. O procedimento armazenado deve ser gravado e instalado no banco de dados antes que você possa concluir a configuração da atividade Chamar Procedimento no Studio.
Incluir uma Atividade Chamar Procedimento na Orquestração
- Criar ou abrir uma orquestração. Uma representação gráfica da orquestração é aberta.
- Selecione a guia Atividades e expanda a pasta Banco de Dados.
- Arraste a atividade Chamar Procedimento para a orquestração.
- Selecione a atividade Chamar Procedimento.
Criar, Selecionar ou Editar um Terminal de Banco de Dados
- Clique na tarefa Selecionar Terminal na Lista de Verificação e
escolha a partir de uma das seguintes ações:
- Selecione um terminal existente:
- Selecione Procurar. O Explorador de Projetos é aberto.
- Selecione um terminal existente e clique em OK. Vá para o procedimento da atividade Configurar uma Atividade Chamar Procedimento.
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é aberto.
- Selecione um terminal existente e clique em OK.
- Clique em Editar. A área de janela Editar Terminal é mostrada.
- Crie um novo terminal:
- Selecione Novo. A área de janela Criar Terminal é aberta.
- Selecione um terminal existente:
- Crie ou edite um terminal do banco de dados
Configurar uma Atividade Chamar Procedimento
- Clique em Procedimento Armazenado na Lista de Verificação. A área de janela Procedimento Armazenado é aberta.
- Clique em Procurar.... A caixa de diálogo Procurar Procedimentos Armazenados é mostrada.
- Para ver todos os procedimentos armazenados no banco de dados e não apenas os visíveis com o esquema do usuário selecionado, clique em Limpar.
- Selecione um Procedimento Armazenado na lista.
- Clique em OK. As informações de parâmetro para
o procedimento armazenado selecionado são exibidas na área de janela
Procedimento Armazenado.Nota: A exclusão de parâmetros de chamada do procedimento armazenado do meio da lista de parâmetros não é suportada. Se você desejar especificar parâmetros em uma ordem diferente da que eles são exibidos na lista, será possível criar um procedimento armazenado do wrapper (por exemplo, WrapperStoredProcedure1) que não tem diferenças em parâmetros (isto é, contém o subconjunto exato dos parâmetros necessários) e, em seguida, chamará o novo procedimento armazenado de procedimento armazenado subjacente (por exemplo: BackendStoredProcedure1) usando o formato @parameter = value suportado pelo Microsoft SQL Server. É possível então fazer com que a orquestração utilize o procedimento armazenado de wrapper somente com os parâmetros necessários. Como alternativa, é possível fornecer os conjuntos completos de parâmetros sem omissões e valores padrão no Studio para o procedimento armazenado subjacente original (por exemplo, BackendStoredProcedure1). Observe que enquanto excluir parâmetros de chamada do procedimento armazenado do meio de uma lista de parâmetros não é suportado, parâmetros exibidos no final de uma lista de parâmetros podem ser excluídos.
- Para alterar a codificação de caracteres atual (originalmente obtida do terminal de banco de dados), selecione uma opção de codificação diferente na listar Codificação. Isto altera a codificação de caracteres padrão para todos os parâmetros de entrada do procedimento armazenado.
- Por padrão, todos os parâmetros de entrada e saída (IN,
INOUT, RETURN, OUT) do procedimento armazenado são
selecionados. Não é necessário incluir todos os parâmetros de entrada e de
saída definidos para um procedimento armazenado. Limpar a caixa de seleção
Usar para um parâmetro de saída (INOUT, RETURN,
OUT) significa que o parâmetro de saída não está disponível
na tarefa Mapear Entradas. Limpar a caixa de
seleção Usar para um parâmetro de entrada
(IN, INOUT) significa que o parâmetro de
entrada não está disponível na tarefa Mapear
Entradas. Limpe a caixa de seleção Usar
apenas para parâmetros de entrada para os quais você não precisa
especificar valores de entrada no tempo de execução. Alguns parâmetros de
entrada do procedimento armazenado podem ter valores padrão.
A maioria dos bancos de dados retorna apenas um único parâmetro de retorno. Para estes bancos de dados, se a caixa de seleção Usar for selecionada para o parâmetro de retorno, o valor de retorno será retornado no nó results/result/RETURN_VALUE único na área de janela Da Atividade da tarefa Mapear Saídas. O banco de dados Informix, entretanto, suporta diversos parâmetros de retorno e, para o banco de dados Informix, os parâmetros de retorno são retornados no nó results/result/result/resultsSets/any de repetição. Mesmo se um parâmetro for retornado do procedimento armazenado, o parâmetro de retorno será retornado no nó results/result/result/resultsSets/any. Use a função CopyOf no mapa para copiar o conteúdo do nó result (incluindo o nó-filho chamado resultSet) em uma variável. Para que a função CopyOf copie corretamente os valores dos nós de origem nos nós de destino, o Esquema XML da variável de destino deve corresponder ao Esquema XML do nó de origem. Para obter informações adicionais, consulte Função CopyOf.
- Clique no título da coluna para classificar as linhas pelo valor da coluna. Por exemplo, para classificar as linhas por seus nomes de coluna, clique no título Nome da Coluna da coluna. Uma seta é mostrada à direita do nome do cabeçalho da coluna. Uma seta para cima indica que a coluna é classificada em ordem alfabética iniciando com a e continuando até z. Um seta para baixo indica que a coluna é classificada em ordem alfabética reversa iniciando com z e continuando até a. Clique na seta para a reverter a ordem alfabética.
- Se necessário, altere as configurações dos valores Tipo de
Dado, Codificação, ou
Anulável para cada parâmetro de entrada de
consulta.
Clique no campo para fazer uma nova seleção:
- Tipo de Dado - Padronizado com o Tipo de Dado do
parâmetro. Selecione um tipo de dado alternativo para o parâmetro clicando na
célula Tipo de Dados e selecionando outro Tipo de Dados na lista da célula correspondente. Você deve alterar qualquer tipo de dado que seja
NÃO SUPORTADO. Nota: (Para tipos de dados MONEY e XMLTYPE) Para o tipo de dado XMLTYPE em um banco de dados Oracle e os tipos de dados MONEY em um banco de dados SQL Server, o Studio não associa automaticamente o tipo de dado correto, portanto, você deve selecionar manualmente o tipo de dado apropriado.
- Encoding - É padronizado com a codificação padrão atual que foi configurada no nível do banco de dados ou no nível da tabela. Se a codificação necessária para o parâmetro for diferente da codificação padrão atual, selecione outra codificação clicando na célula Codificação e selecionando outra Codificação na lista.
- Tamanho — Tamanho da coluna definida na tabela. Este tamanho é recuperado da tabela de banco de dados e não é configurável.
- Tipo de Dado - Padronizado com o Tipo de Dado do
parâmetro. Selecione um tipo de dado alternativo para o parâmetro clicando na
célula Tipo de Dados e selecionando outro Tipo de Dados na lista da célula correspondente. Você deve alterar qualquer tipo de dado que seja
NÃO SUPORTADO.
- Clique em Reconfigurar para reconfigurar todas as propriedades de parâmetros com seus padrões. Isto também seleciona a opção Usar para todos os parâmetros.
- Configure
Regras
de Entrega. Nota: Se você selecionar a opção Exatamente uma vez na tarefa Regras de Entrega, deverá criar tabelas de controle que serão usadas pelo Integration Appliance durante o tempo de execução. Crie as tabelas de controle após publicar a orquestração do Studio para o Integration Appliance. Crie as tabelas de controle usando o Web Management Console (WMC) antes de implementar o projeto.Nota: Se você selecionar a opção Exatamente uma Vez, deverá ativar a persistência. Para obter informações adicionais, consulte Ativando a Persistência.
- Configure as Opções de Nova Tentativa.
Mapear a Entrada da Atividade
- Selecione a tarefa Mapear Entradas na Lista de Verificação. Os parâmetros de entrada para a atividade são exibidos sob o elemento calls na área de janela Para Atividade. Os parâmetros de entrada exibidos na área de janela Para Atividade correspondem aos parâmetros IN e INOUT selecionados na tarefa Procedimento Armazenado. Se a caixa de seleção Colocar Diversas Linhas em Lote Por Mensagem estiver selecionada nas Regras de Entrega, o ícone de diversas ocorrências será exibido próximo ao elemento call.
- Mapeie todos os parâmetros de entrada exibidos. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.
Mapear a Saída da Atividade
- Selecione a tarefa Mapear Saídas na Lista de Verificação.
Os parâmetros de saída para a atividade são exibidos sob o elemento
results na área de janela Da
Atividade. Os parâmetros de saída exibidos na área de janela
Da Atividade correspondem aos parâmetros OUT,
RETURN e INOUT selecionados na tarefa Procedimento
Armazenado.
Se a caixa de seleção Colocar Diversas Linhas em Lote Por Mensagem estiver selecionada nas Regras de Entrega, o ícone de diversas ocorrências será exibido próximo ao elemento result.
Um nó de repetição chamado resultSet é exibido na área de janela Da Atividade da atividade Chamar Procedimento, mesmo se o procedimento armazenado não tiver parâmetros de retorno. Durante o tempo de execução, se o procedimento armazenado iniciado a partir da atividade retornar um conjunto de resultados, este conjunto de resultados será retornado a partir da atividade no nó resultSet. Por exemplo, se o procedimento armazenado iniciar uma instrução select, o conjunto de resultados da instrução select será retornado no nó resultSet. Use a função CopyOf no mapa para copiar o conteúdo do nó result (incluindo o nó-filho chamado resultSet) em uma variável.Atenção: Para que a função CopyOf copie corretamente os valores dos nós de origem nos nós de destino, o Esquema XML da variável de destino deve corresponder ao Esquema XML do nó de origem. Para obter informações adicionais, consulte Função CopyOf. - Mapeie os parâmetros de saída necessários para as variáveis. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento. Não é necessário mapear parâmetros de saída para esta atividade.