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.
Incluindo uma Atividade Chamar RFC do SAP na Orquestração
- Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta SAP.
- Arraste a atividade Chamar RFC do SAP para a orquestração.
- Selecione a atividade. A Lista de Verificação é exibida.
Criando, Selecionando ou Editando um Terminal SAP
- 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 é exibido.
- Selecione um terminal existente e clique em OK. Acesse o procedimento Configurando a Atividade.
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK.
- Clique em Editar. O painel Editar Terminal é exibido.
- Crie um novo terminal: Selecione Novo. O painel Criar Terminal é exibido.
- Selecione um terminal existente:
- Crie ou edite um terminal SAP.
Configurando a Atividade
- Selecione a tarefa Configurar a partir da Lista de Verificação. O painel Configurar é exibido.
- No campo Nome da RFC, clique em Procurar.... A caixa de diálogo Lista de RFCs é exibida.
- 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.
- Na tabela Funções SAP Correspondentes, selecione uma das Funções SAP e clique em OK.
Especificando as Opções de Nova Tentativa
- Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. O painel Tentar Novamente é exibido.
- 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
- 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.
- 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:
- 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.
- 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.
- Depois de as operações de transação serem selecionadas, preencha os dados de entrada do RFC.
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
- 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.
- 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.