Pré-requisitos do conector SAP

Introdução

Esta página documenta os pré-requisitos para o conector SAP e pré-requisitos adicionais para sua atividade Receber IDoc.

Pré-requisitos do conector SAP

É necessária uma instância SAP usando ECC versão 6 ou posterior, ou SAP S/4HANA single-tenant. O SAP R/3 não é suportado.

Para usar o conector SAP, é necessária a versão 10.1 ou posterior do agente. Essas versões do agente baixam automaticamente a versão mais recente do conector.

Se forem utilizados agentes privados, eles devem ter certas bibliotecas fornecidas pela SAP instaladas.

Receber pré-requisitos de atividade do IDoc

A atividade Receber IDoc tem pré-requisitos adicionais além dos pré-requisitos do conector SAP.

Para usar a atividade Receber IDoc, os seguintes pré-requisitos devem ser atendidos:

• O sistema SAP deve ser configurado com o seguinte, cada um descrito mais adiante nesta página:

  • Criar um destino RFC (transação SM59)
  • Criar uma porta RFC transacional (tRFC) (transação WE21)
  • Especifique um sistema lógico (transação BD54)
  • Configurar um perfil de parceiro (transação WE20)
  • Configurar o modelo de distribuição (transação BD64)

• O agente privado versão 11.37 ou posterior deve ser usado. Para se beneficiar totalmente dos recursos de balanceamento de carga e tolerância a falhas do serviço de escuta, é recomendável ter no mínimo dois agentes privados no grupo de agentes. O agente privado deve ter certas bibliotecas fornecidas pela SAP instaladas.

• O agente privado deve ter o serviço de escuta habilitado conforme descrito em Habilitar o serviço de escuta no agente. Esta é uma etapa manual na configuração e não é habilitada por padrão.

• Depois que uma operação é implantada, o projeto do Integration Studio deve ter o serviço de escuta habilitado no nível da operação e no nível da atividade, conforme descrito em Habilitar o serviço de escuta na operação e na atividade. Esta é uma etapa manual realizada no momento do design do projeto ou do gerenciamento do projeto.

Crie um destino RFC

Um destino RFC deve ser criado no sistema de gateway SAP para que ele possa ser vinculado à porta RFC transacional (tRFC).

Siga estas etapas para criar um destino RFC no sistema SAP:

1. Efetue login na GUI do SAP.

2. Na caixa de pesquisa, insira o código de transação SAP SM59.

3. A tela Configuração de conexões RFC é exibida. Clique no botão criar para criar um novo destino RFC:

   

4. A tela de configuração RFC Destination é exibida. Conclua a configuração da seguinte forma:

   

   1. No campo Destino RFC, insira um nome para o destino RFC, como JITTERBIT.

   2. No campo Tipo de conexão, selecione T para Conexão TCP/IP.

   3. Em Descrição, insira uma descrição, como SAP Destination for Jitterbit.

   4. Na aba Configurações técnicas:

      1. Em Tipo de ativação, selecione Programa de servidor registrado.
      2. Em Programa de servidor registrado, no campo ID do programa, insira um nome para o programa a ser usado pelo SAP Event Listener para se conectar ao gateway SAP, como JITTERBIT.

   5. Salve o destino RFC.

      !!! note "Nota" O botão Teste de conexão não deve ser usado neste ponto da configuração. Se usado, um erro é esperado. Para testar a conexão após toda a configuração ser concluída, consulte Verificar conectividade com o SAP Gateway no final desta página.

Crie uma porta RFC transacional (tRFC)

A porta RFC transacional (tRFC) é a porta lógica usada pelo destino RFC para trocar informações com a atividade Receber IDoc. Para poder se comunicar com o servidor SAP, uma porta deve ser criada no sistema SAP e vinculada ao destino RFC.

Siga estas etapas para criar uma porta tRFC:

1. Efetue login na GUI do SAP.

2. Na caixa de pesquisa, insira o código de transação SAP WE21.

3. A tela Portas no processamento de IDoc é exibida. Selecione a pasta RFC transacional e clique no botão Criar:

   

4. A caixa de diálogo Portas no processamento de IDoc é exibida. Selecione nome da porta própria e especifique o nome da porta para o programa, como JITTERBIT:

   

5. Na tela Portas no processamento de IDoc para a nova porta, conclua a configuração da seguinte maneira:

   

   1. No campo Descrição, insira uma descrição, como Jitterbit tRFC Port for Destination JITTERBIT.

   2. Em Versão:

      1. Selecione a versão dos tipos de registro IDoc a serem trocados usando esta porta.

      2. No campo Destino RFC, insira o nome do destino RFC que você definiu anteriormente, como JITTERBIT.

   3. Salve a porta.

Especifique um sistema lógico

Um sistema lógico deve ser especificado antes de configurar um perfil de parceiro. Siga estas etapas para especificar um sistema lógico:

1. Efetue login na GUI do SAP.

2. Na caixa de pesquisa, insira o código de transação SAP BD54.

3. A tela Alterar visualização "Sistemas lógicos": Visão geral é exibida. Clique no botão Novas entradas:

   

4. Na tabela Sistemas Lógicos, nas colunas da tabela Log.System e Nome, insira um nome para o sistema lógico, como JITTERBIT.

5. Salve o sistema lógico.

Configurar um perfil de parceiro

Um perfil de parceiro deve ser criado no sistema SAP para especificar o tipo de informação que é trocada com o Jitterbit. O perfil de parceiro especifica os tipos de IDoc que podem ser enviados pelo Jitterbit para o sistema SAP (parâmetros de entrada) e os tipos de IDoc que são enviados pelo sistema SAP para o Jitterbit.

Siga estas etapas para criar um perfil de parceiro:

1. Efetue login na GUI do SAP.

2. Na caixa de pesquisa, insira o código de transação SAP WE20.

3. A tela Perfis de parceiros é exibida. Clique no botão Criar.

4. Na tela Perfis de parceiros para o novo perfil, conclua a configuração da seguinte forma:

   

   1. No campo Número do parceiro, insira o nome do sistema lógico, como JITTERBIT.
   2. No campo Tipo de Parceira, insira LS.
   3. Na aba Pós-processamento: agente permitido:
      1. No campo Ty., digite US como o tipo de usuário.
      2. No campo Agente, insira o ID do usuário permitido, como JITTERBIT.
      3. No campo Lang., digite EN para usar o inglês como idioma de notificação.

5. Em Parâmetros de saída., clique no botão criar parâmetro para adicionar quantos parâmetros de saída forem necessários. A tela Perfis de parceiros: Parâmetros de saída é aberta. Para cada parâmetro de saída, conclua a configuração da seguinte forma:

   

   1. No campo Tipo de mensagem, insira o tipo de mensagem que deve ser enviada.

   2. Na aba Opções de saída:

      1. No campo porta do receptor, insira a porta do receptor definida anteriormente, como JITTERBIT.
      2. Em Modo de saída, para a maioria dos casos de uso, selecione Transferir IDoc Imed. Escolha outras opções conforme apropriado para o caso de uso.
      3. Em Tipo de IDoc, insira as informações para o tipo de IDoc que deve ser enviado.

   3. Salve o parâmetro de saída.

6. Em Parâmetros de entrada., clique no botão criar parâmetro para adicionar quantos parâmetros de entrada forem necessários. A tela Perfis de parceiros: Parâmetros de entrada é aberta. Para cada parâmetro de entrada, conclua a configuração da seguinte forma:

   

   1. No campo Função do parceiro, insira LS para sistema lógico.

   2. No campo Tipo de mensagem, insira o tipo de mensagem que deve ser recebida.

   3. Na aba Opções de entrada, insira o Código de processo para o módulo funcional que processará o IDoc recebido.

   4. Salve o parâmetro de entrada.

Configurar o modelo de distribuição

O modelo de distribuição deve ser configurado para o tipo de mensagem IDoc que está sendo recebido pela atividade Receber IDoc.

Siga estas etapas para configurar o modelo de distribuição:

1. Efetue login na GUI do SAP.

2. Na caixa de pesquisa, insira o código de transação SAP BD64.

3. Selecione o sistema lógico central.

4. Clique em Adicionar tipo de mensagem e insira o tipo de mensagem que será recebida e salve.

5. Repita conforme necessário para adicionar todos os tipos de mensagem:

   

Verifique a conectividade com o SAP Gateway

Não se espera que a conectividade seja estabelecida até que todas as etapas de configuração sejam concluídas no sistema SAP (descrito nesta página), na conexão do conector SAP, e o Receber IDoc atividade.

Após a conclusão dessas etapas de configuração, um administrador SAP pode testar a conexão do destino RFC configurado no sistema SAP para verificar se a conectividade foi estabelecida entre o gateway SAP e o serviço de escuta do Jitterbit.

Para testar a conexão do destino RFC:

1. Efetue login na GUI do SAP.

2. Na caixa de pesquisa, insira o código de transação SAP SM59.

3. Na coluna Conexões RFC, expanda Conexões TCP/IP e clique duas vezes para abrir o nome de destino RFC.

4. Clique no botão Teste de conexão para verificar a conectividade entre o gateway SAP e o serviço de escuta do Jitterbit: