Ir para o conteúdo

Conexão SAP no Jitterbit Studio

Introdução

Uma conexão SAP, criada pelo conector SAP, estabelece acesso ao SAP ECC versão 6 e superior ou ao SAP S/4HANA de inquilino único. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades SAP associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

Este conector suporta a política de Habilitar Reautenticação em Caso de Alteração política de organização. Se habilitado, uma alteração no Host, Nome de Usuário ou Chave do Consumidor nesta conexão requer que os usuários reentrem a Senha, o Token de Segurança e o Segredo do Consumidor para a conexão.

Criar ou editar uma conexão SAP

Uma nova conexão SAP é criada usando o conector SAP a partir de uma destas localizações:

Uma conexão SAP existente pode ser editada a partir destas localizações:

Configurar uma conexão SAP

Cada elemento da interface do usuário da tela de configuração da conexão SAP é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão SAP. O nome deve ser exclusivo para cada conexão SAP e não deve conter barras (/) ou dois-pontos (:).

  • Versão SAP: Selecione ECC ou S4HANA como o tipo de sistema SAP. O conector SAP é compatível com a versão 6 e superior do SAP ECC ou com o SAP S/4HANA de inquilino único. O SAP R/3 não é suportado.

  • Nome de usuário: Insira o nome de usuário para fazer login no sistema SAP.

  • Senha: Insira a senha para fazer login no sistema SAP.

  • Cliente: Insira o ID numérico do cliente associado ao sistema SAP. O administrador SAP da organização pode fornecer essa informação.

  • Idioma: Insira o código de idioma para o idioma em que as mensagens SAP devem ser enviadas. O idioma padrão é o inglês.

  • Host: Insira o nome do host do Servidor de Aplicação SAP.

  • Número do sistema: Insira o número do sistema SAP.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Configuração Adicional da Conexão: Nesta seção, você pode selecionar o tipo de conexão SAP e especificar configurações adicionais de conexão.

      • Para Conexão Direta: Selecione se a conexão SAP é uma conexão direta com o servidor (padrão). Quando selecionado, não selecione também Para Conexão Balanceada.

      • Para Conexão Balanceada: Selecione se a conexão SAP processa solicitações através de um balanceador de carga. Quando selecionado, não selecione também Para Conexão Direta. Forneça as seguintes informações para configurar uma conexão balanceada:

        • Nome do grupo: Insira o nome do grupo SAP dos servidores de aplicação.

        • MSHost: Insira o nome do host do servidor de mensagens SAP.

        • MSPort: Insira a porta do servidor de mensagens SAP.

        • ID do sistema: Insira o ID do sistema SAP.

      • Roteador: Se o sistema SAP estiver protegido por um firewall, insira a string do roteador necessária para se conectar a ele.

    • Pool de Conexões: Nesta seção, você pode especificar as configurações do pool de conexões para o seu sistema SAP.

      • Máximo de conexões ativas: Insira o número máximo de conexões simultâneas permitidas do pool de conexões do sistema SAP. O valor padrão é 10. O valor máximo permitido é 250.

      • Número máximo de conexões: Insira o número de conexões armazenadas no pool de conexões. O valor padrão é 15. O valor máximo permitido é 250.

      • Tempo limite de conexão ociosa: Insira o tempo máximo (em segundos) que uma conexão pode permanecer ociosa no pool de conexões. O valor padrão e máximo permitido é 3600 segundos.

    • Propriedades da Atividade do Listener: Se você pretende usar a atividade Receber IDoc, esses campos devem ser configurados:

      • Contagem de Listeners: Insira o número de threads a serem alocadas para escutar solicitações recebidas. O padrão é 1, pois cada thread de listener é capaz de aceitar e processar uma chamada IDoc por vez. Definir um valor mais alto permite que o servidor lide com mais chamadas RFC simultâneas.

      • Destino: Insira o Destino RFC configurado no sistema SAP, conforme descrito em Pré-requisitos. O destino deve ser único para cada conexão SAP.

      • Serviço de Gateway: Insira o nome do servidor de gateway para o sistema SAP.

      Nota

      Confirme que os valores desses campos são válidos, pois valores inválidos podem resultar em um erro ao implantar a operação ou habilitar o listener.

    • Configuração Adicional da Conexão SAP: Use esta tabela para adicionar quaisquer pares chave-valor a serem enviados com cada solicitação de atividade. Cada valor adicionado à tabela é incluído no esquema de solicitação de cada atividade.

      • Adicionar: Adiciona uma linha à tabela. Insira um par chave-valor para cada propriedade.
      • Enviar: Salva o par chave-valor na tabela. Visível ao passar o mouse sobre uma linha no modo de edição.
      • Descartar: Descartar uma nova linha ou quaisquer edições feitas em uma linha existente. Visível ao passar o mouse sobre uma linha no modo de edição.
      • Editar: Permite editar um par chave-valor existente. Visível ao passar o mouse sobre uma linha existente.
      • Excluir: Exclui a linha da tabela. Visível ao passar o mouse sobre uma linha existente.
      • Limpar Tudo: Exclui todas as linhas da tabela.

      Nota

      O valor mínimo permitido no campo Valor é 1. Qualquer valor inferior a 1 resultará em um erro ao testar a conexão.

      Importante

      Os campos na tabela Configuração Adicional da Conexão SAP exibem o ícone de variável apenas no modo de edição. Para que os valores de variável desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

      Os campos na tabela Configuração Adicional da Conexão SAP não suportam o uso de variáveis para passar JSON bruto. Se seu caso de uso não suportar a definição de JSON bruto nos campos diretamente, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escapando {"success": "true"}; torna-se {\"success\": \"true\"};.

  • Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

    Dica

    Ao testar a conexão, esta mensagem de erro pode ser retornada se as bibliotecas SAP necessárias não estiverem instaladas:

    Ocorreu um erro: O conector está parcialmente carregado no Jitterbit Agent ou está faltando funcionalidade. Erro: NoClassDefFoundError com/sap/conn/jco/JCoException. Veja os logs para mais detalhes.

    Para instalar as bibliotecas SAP necessárias, veja instalação do conector SAP.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximas etapas

Após a criação de uma conexão SAP, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Conceitos Básicos do Conector.

Estes tipos de atividade estão disponíveis: