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.

Nota: A sobrecarga do nome da função para procedimentos armazenados no banco de dados Informix não é suportada. Os procedimentos armazenados não podem ter o mesmo nome no Informix, mesmo se suas assinaturas forem exclusivas.

Incluir uma Atividade Chamar Procedimento na Orquestração

  1. Criar ou abrir uma orquestração. Uma representação gráfica da orquestração é aberta.
  2. Selecione a guia Atividades e expanda a pasta Banco de Dados.
  3. Arraste a atividade Chamar Procedimento para a orquestração.
  4. Selecione a atividade Chamar Procedimento.

Criar, Selecionar ou Editar um Terminal de Banco de Dados

  1. Clique na tarefa Selecionar Terminal na Lista de Verificação e escolha a partir de uma das seguintes ações:
    • Selecione um terminal existente:
      1. Selecione Procurar. O Explorador de Projetos é aberto.
      2. 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:
      1. Selecione Procurar. O Explorador de Projetos é aberto.
      2. Selecione um terminal existente e clique em OK.
      3. Clique em Editar. A área de janela Editar Terminal é mostrada.
    • Crie um novo terminal:
      1. Selecione Novo. A área de janela Criar Terminal é aberta.
  2. Crie ou edite um terminal do banco de dados

Configurar uma Atividade Chamar Procedimento

  1. Clique em Procedimento Armazenado na Lista de Verificação. A área de janela Procedimento Armazenado é aberta.
  2. Clique em Procurar.... A caixa de diálogo Procurar Procedimentos Armazenados é mostrada.
  3. 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.
  4. Selecione um Procedimento Armazenado na lista.
  5. Clique em OK. As informações de parâmetro para o procedimento armazenado selecionado são exibidas na área de janela Procedimento Armazenado.
  6. 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.
  7. 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.

  8. 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.
  9. 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 Dado e selecionando outro Tipo de Dado na lista a partir 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.
  10. 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.
  11. 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.
  12. Configure as Opções de Nova Tentativa.
 

Mapear a Entrada da Atividade

  1. 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.
  2. 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

  1. 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.
  2. 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.