Ir para o conteúdo

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 Receive IDoc.

Pré-requisitos do conector SAP

É necessário ter uma instância SAP utilizando a versão ECC 6 ou posterior, ou SAP S/4HANA de inquilino único. SAP R/3 não é suportado.

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

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

Pré-requisitos da atividade Receive IDoc

A atividade Receive IDoc possui pré-requisitos adicionais além dos pré-requisitos do conector SAP.

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

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

  • Deve ser utilizada a versão 11.37 ou posterior do agente privado.

  • É necessário um número ímpar de agentes privados no grupo de agentes. Recomenda-se um mínimo de 3.

  • \((N + 1) / 2\) de um total de \(N\) agentes no grupo de agentes deve estar em execução. Por exemplo, se 5 agentes estão em um grupo de agentes, 3 deles devem estar em execução.

  • As portas TCP 5701 e 5801 devem estar abertas em todos os hosts de agentes.

    Nota

    Dependendo do seu sistema, os seguintes comandos podem ser usados para testar portas abertas em um agente:

    • telnet <endereço do agente> <porta>
    • netcat -vz <endereço do agente> <porta> ou nc -vz <endereço do agente> <porta>
    • Test-NetConnection <endereço do agente> -Port <porta> (PowerShell)

    Certifique-se de que seu antivírus e firewall permitam conexões nas portas 5701 e 5801 para testes precisos.

  • Todos os agentes na mesma rede.

  • Cada agente privado deve ter certas bibliotecas fornecidas pela SAP instaladas.

  • Cada agente privado deve ter o serviço de escuta habilitado conforme descrito em Habilitar o serviço de escuta no agente. Este é um passo manual na configuração e não está habilitado por padrão.

  • Uma vez que uma operação é implantada, o projeto do Integration Studio deve ter o serviço de escuta habilitado tanto no nível da operação quanto no nível da atividade, conforme descrito em Habilitar o serviço de escuta na operação e na atividade. Este é um passo manual realizado no momento do design do projeto ou gerenciamento do projeto.

Criar um destino RFC

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

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

  1. Faça login no SAP GUI.

  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 de criar anexo para criar um novo destino RFC:

    anexo

  4. A tela de configuração do Destino RFC é exibida. Complete a configuração da seguinte forma:

    anexo

    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. Na Descrição, insira uma descrição, como Destino SAP para 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 que será usado pelo Listener de Eventos SAP para se conectar ao gateway SAP, como JITTERBIT.

    5. Salve o destino RFC.

      Nota

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

Criar 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.

Nota

A atividade Receber IDoc utiliza a porta tRFC para chamadas de função tanto tRFC quanto qRFC.

Siga estas etapas para criar uma porta tRFC:

  1. Faça login no SAP GUI.

  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:

    attachment

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

    attachment

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

    attachment

    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.

Especificar 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. Faça login no SAP GUI.

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

  3. A tela Alterar Visualização "Sistemas Lógicos": Visão Geral é exibida. Clique no botão Novas Entradas:

    attachment

  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. Faça login no SAP GUI.

  2. Na caixa de pesquisa, insira o código da 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, complete a configuração da seguinte forma:

    attachment

    1. No campo Nº do Parceiro, insira o nome do sistema lógico, como JITTERBIT.
    2. No campo Tipo de Parceiro, insira LS.
    3. Na aba Processamento posterior: agente permitido:
      1. No campo Ty., insira US como o tipo de usuário.
      2. No campo Agente, insira o ID do usuário permitido, como JITTERBIT.
      3. No campo Lang., insira 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 attachment para adicionar quantos parâmetros de saída forem necessários. A tela Perfis de parceiro: Parâmetros de saída é aberta. Para cada parâmetro de saída, complete a configuração da seguinte forma:

    attachment

    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 previamente definida, como JITTERBIT.
      2. Em Modo de Saída, para a maioria dos casos de uso, selecione Transferir IDoc Imediatamente. 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 attachment para adicionar quantos parâmetros de entrada forem necessários. A tela Perfis de parceiro: Parâmetros de entrada é aberta. Para cada parâmetro de entrada, complete a configuração da seguinte forma:

    attachment

    1. No campo Papel 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 deve 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. Faça login no SAP GUI.

  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 deve ser recebida, e então salve.

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

    modelo de distribuição

Verifique a conectividade com o SAP Gateway

A conectividade não deve ser estabelecida até que todas as etapas de configuração estejam completas tanto no sistema SAP (descrito nesta página), na conexão do conector SAP, quanto na atividade Receber IDoc.

Uma vez que essas etapas de configuração estejam completas, 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. Faça login no SAP GUI.

  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 do 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:

    anexo