Atividade Chamar RFC do SAP

Use a atividade Chamar RFC do SAP para chamar uma Remote Function Call (RFC), que é ativada remotamente no terminal SAP especificado, durante o tempo de execução.

Nota: Para conectar-se ao Sistema SAP a partir do Studio, você deve fazer download e instalar os arquivos JAR do SAP e DLLs em sua máquina de desenvolvimento do Windows. Para obter informações adicionais, consulte Fazendo download e instalando os Arquivos Jar e os DLLs do SAP.

Incluindo uma Atividade Chamar RFC do SAP na Orquestração

  1. Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
  2. Selecione a guia Atividades e expanda a pasta SAP.
  3. Arraste a atividade Chamar RFC do SAP para a orquestração.
  4. Selecione a atividade. A Lista de Verificação é exibida.

Criando, Selecionando ou Editando um Terminal SAP

  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 é exibido.
      2. Selecione um terminal existente e clique em OK. Acesse o procedimento Configurando a Atividade.
    • Selecione um terminal existente e edite o terminal:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK.
      3. Clique em Editar. O painel Editar Terminal é exibido.
    • Crie um novo terminal: Selecione Novo. O painel Criar Terminal é exibido.
  2. Crie ou edite um terminal SAP.

Configurando a Atividade

  1. Selecione a tarefa Configurar a partir da Lista de Verificação. O painel Configurar é exibido.
  2. No campo Nome da RFC, clique em Procurar.... A caixa de diálogo Lista de RFCs é exibida.
  3. No campo Função de Procura da RFC, insira uma combinação de caracteres e o caractere curinga * para localizar o nome de RFC desejado, conforme mostrado nos exemplos a seguir:
    • AB* — Localiza todas as RFCs cujos nomes iniciam com o prefixo AB.
    • AB*TRANSACTION — Localiza todas as RFCs cujos nomes iniciam com o prefixo AB e terminam com a cadeia: TRANSACTION.

      O sistema SAP é interrogado e os nomes de RFC que correspondem à expressão curinga são listados na tabela Funções SAP Correspondentes.

  4. Na tabela Funções SAP Correspondentes, selecione uma das Funções SAP e clique em OK.

Especificando as Opções de Nova Tentativa

  1. Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. O painel Tentar Novamente é exibido.
  2. Configure as opções de nova tentativa para se conectar a um Sistema SAP. A tabela a seguir descreve as opções de nova tentativa para se conectar a um Sistema SAP:
    Opções de Nova Tentativa Descrição
    1) Aguardar ___ segundos entre cada nova tentativa. Especifica o número de segundos que o Integration Appliance aguarda antes de tentar estabelecer uma conexão com o Sistema SAP.
    2) Tentar se conectar ___ vezes antes de falhar. Especifica o número máximo de vezes que o Integration Appliance tenta estabelecer uma conexão com o Sistema SAP antes de emitir um erro e parar o processamento da tarefa de orquestração atual. Se você implementar uma orquestração que contém uma atividade Chamar RFC do SAP e o Integration Appliance não puder conectar-se ao Sistema SAP especificado, o Integration Appliance registrará os erros de conexão como avisos nos logs do sistema e de orquestração até o valor de contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro nos logs do sistema e da orquestração e para o processamento da tarefa de orquestração atual. Por exemplo, você configura a contagem de novas tentativas para 3. O primeiro, segundo e terceiro erros de conexão aparecem no log do sistema como avisos. O Integration Appliance registra o quarto erro de conexão como um erro e para o processamento da tarefa de orquestração atual.

Mapeando as Entradas da Atividade

  1. Selecione a tarefa Mapear Entradas na Lista de Verificação. Os Esquemas XML gerados a partir dos parâmetros de entrada do RFC são exibidos como nós no parâmetro de entrada request na área de janela Atividade de Destino. Além disso, se a RFC contiver tabelas, os Esquemas XML que representam as tabelas do RFC, serão exibidos como nós no parâmetro de entrada request no painel Atividade de Destino.
  2. Crie um mapa entre as variáveis de orquestração e os parâmetros e tabelas de entrada de RFC. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.

    Os valores devem ser fornecidos no tempo de execução para quaisquer elementos obrigatórios dos parâmetros de entrada ou tabelas de RFC. Um valor pode ser fornecido ao especificar um valor padrão para o elemento ou ao vincular o elemento ao nó de entrada. Durante o tempo de execução, se nenhum valor for fornecido para um elemento obrigatório, a atividade lançará uma exceção durante o tempo de execução que será relatada pelo Web Management Console (WMC). Se um valor não for fornecido no tempo de execução para um elemento opcional dos parâmetros de entrada ou tabelas de RFC, nenhuma exceção será lançada durante o tempo de execução.

Opções de Transação:

  1. Nas Entradas do Mapa da atividade, clique com o botão direito do mouse na seção Atividade de Destino e selecione Mostrar Parâmetros Opcionais. Uma variável transactionOptions aparece na entrada do mapa. Essa propriedade está disponível somente no Cast Iron Studio versão 6.1.0.12.
  2. Selecione um dos seguintes valores:
    Nota: Se não configurar nenhum valor para a propriedade transactionOptions, o valor COMMIT_HANDLED_BY_RFC será usado.
    Tabela 1.
    Valor Descrição
    COMMIT_HANDLED_BY_RFC A confirmação do RFC é assumida pelo próprio RFC. O conector não realizada nenhuma chamada de confirmação explícita.
    COMMIT_TRANSACTION_AFTER_COMPLETION Durante o tempo de execução, o conector do SAP chama o RFC e espera por uma mensagem de retorno do Sistema SAP. O código de retorno da mensagem retornada pelo sistema SAP determina se o conector do SAP envia outra chamada solicitando que o sistema SAP confirme ou retroceda a transação:
    • Se o código de retorno passado do RFC indicar sucesso, o conector do SAP fará outra chamada solicitando que o sistema SAP confirme a transação e imediatamente inicia o processamento da próxima atividade na orquestração.
    • Se o código de retorno passado do RFC indicar falha, o conector do SAP realizará uma solicitação de retrocesso para o sistema SAP e imediatamente começa a processar a próxima atividade na orquestração.
    COMMIT_TRANSACTION_AND_WAIT_UPON_COMPLETION Durante o tempo de execução, o conector do SAP chama o RFC e espera por uma mensagem de retorno do sistema SAP. O código de retorno da mensagem retornada pelo sistema SAP determina se o conector do SAP envia outra mensagem solicitando que o sistema SAP confirme ou retroceda a transação:
    • Se o código de retorno passado de volta do RFC indicar sucesso, o conector do SAP fará outra chamada solicitando que o sistema SAP confirme a transação. A orquestração aguardará até que o Sistema SAP envie uma segunda mensagem indicando que a transação foi confirmada, antes de processar a próxima atividade na orquestração.
    • Se o código de retorno passado de volta do RFC indicar falha, o conector do SAP fará uma solicitação de retrocesso para o sistema SAP. A orquestração espera até que o sistema SAP envie uma segunda mensagem indicando que o retrocesso da transação ocorreu, antes de processar a próxima atividade na orquestração.
  3. Depois de as operações de transação serem selecionadas, preencha os dados de entrada do RFC.
O conector SAP também suporta uma conexão de terminal dinâmico com um sistema SAP diferente. Durante o tempo de execução, inclua parâmetros opcionais em sapConnectionProperties das entradas de mapa se quiser se conectar dinamicamente a um sistema SAP diferente do configurado no painel do terminal, se quiser se conectar ao mesmo sistema SAP com um nome de usuário e senha diferentes dos campos usados no painel do terminal ou se quiser um token de SSO diferente do incluído no painel do terminal. Os parâmetros de sapConnectionProperties estão descritos na seguinte tabela:
Tabela 2. Propriedades da Conexão
Parâmetro opcional Descrição
Parâmetros sapConnectionProperties
hostName Especifica o Endereço IP do nome da máquina que contém o sistema SAP.
systemNumber Especifica o número que identifica a instância específica do sistema SAP ao qual o Studio deve se conectar. Seu administrador SAP deve fornecer estas informações.
cliente Especifica um número que identifica o Studio e o Integration Appliance como um cliente para o sistema SAP. Seu administrador SAP deve fornecer estas informações.
idioma Especifica a opção de idioma da mensagem para o SAP. Por exemplo, EN é o código ISO para inglês.
Parâmetros basicAuthentication
username Especifica o nome de usuário a ser usado ao se conectar com o sistema SAP.
password Especifica a senha para o nome de usuário ao se conectar com o sistema SAP.
Parâmetros ssoAuthentication
ssotoken Especifica o token de conexão única (SSO).
Parâmetros sncAuthentication
sncmode Especifica se o modo Conexão de Rede Segura (SNC) está ativado.
sncname Especifica o nome distinto da conexão SNC.
parceiro Especifica o nome distinto do parceiro SNC.
qop Especifica o nível de segurança do SNC.
Certificado X509 Especifica o certificado X509 a ser usado como chamado de logon. Esse campo só será opcional se Autenticação baseada em nome de usuário/senha for usado com SNC.
Parâmetros connectionPool
maximumConnections Especifica as conexões SAP adicionais, até a quantidade especificada, que o Integration Appliance abre com base no carregamento de mensagem.
maxIdleTime Especifica o número de minutos que uma conexão SAP pode ficar aberta e inativa antes de ser encerrada pelo Integration Appliance.

Mapeando as Saídas da Atividade

  1. Selecione a tarefa Mapear Saídas na Lista de Verificação. Os Esquemas XML gerados a partir dos tipos de retorno da RFC são exibidos como nós sob o parâmetro de saída request no painel Atividade de Partida. Além disso, se a RFC contiver tabelas, os Esquemas XML que representam as tabelas serão exibidos como nós sob o nó request em Atividade de Partida.
  2. Crie um mapa entre os parâmetros de saída e as tabelas de RFC e as variáveis de orquestração. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento.

Nota sobre Implementação de uma Orquestração SAP

Antes de poder implementar uma orquestração com atividades SAP usando o WMC, o Integration Appliance deve primeiro estar apto a estabelecer uma conexão com o Sistema SAP. Se o Integration Appliance não puder estabelecer a conexão com o Sistema SAP, a orquestração não será implementada.




Feedback | notices