Ir para o conteúdo

Conexão SAP

Introdução

Uma conexão SAP criou o conector SAP, estabelece acesso ao SAP ECC versão 6 e superior ou ao SAP S/4HANA single-tenant. Após a configuração de uma conexão, você pode criar instâncias de atividades SAP associadas a ela para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

Este conector oferece suporte à política da organização Habilitar Reautenticação na Alteração. Se habilitado, uma alteração no Host, Nome de Usuário ou Chave do Consumidor nesta conexão exigirá que os usuários insiram novamente a Senha, o Token de Segurança e o Segredo do Consumidor da conexão.

Criar ou editar uma conexão SAP

Uma nova conexão SAP é criada usando o conector SAP de um destes locais:

Uma conexão SAP existente pode ser editada nestes locais:

Configurar uma conexão SAP

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

Configuração de conexão SAP

Dica

Campos com um suporte a ícones variáveis usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das 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 tipo de sistema SAP. O conector SAP é compatível com o SAP ECC versão 6 e superior ou com o SAP S/4HANA single-tenant. O SAP R/3 não é compatível.

  • Nome de usuário: Digite o nome de usuário para efetuar login no sistema SAP.

  • Senha: Digite a senha para efetuar login no sistema SAP.

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

  • Idioma: Digite o código do 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 aplicativos 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 de conexão: Nesta seção, você pode selecionar o tipo de conexão SAP e especificar configurações de conexão adicionais.

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

      • Para Conexão com Balanceamento de Carga: Selecione se a conexão SAP processa solicitações por meio 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 com balanceamento de carga:

        • Nome do grupo: Insira o nome do grupo SAP dos servidores de aplicativos.

        • MSHost: Insira o nome do hospedar 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 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 inativa: Insira o tempo máximo (em segundos) que uma conexão pode permanecer inativa 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, estes campos devem ser configurados:

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

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

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

      Nota

      Confirme se 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 de 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: Descarta uma nova linha ou qualquer edição feita 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 menor que 1 resultará em um erro ao testar a conexão.

      Importante

      Os campos na tabela Configuração adicional de conexão SAP exibem o ícone de variável somente no modo de edição. Para que os valores das variáveis 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 de Conexão SAP não suportam o uso de variáveis para passar JSON bruto. Se o seu caso de uso não suportar a definição de JSON bruto diretamente nos campos, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escape {"success": "true"};torna-se {\"success\": \"true\"};.

  • Teste: 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 permite suspender o download da versão mais recente do conector usando a política da 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 Agente Jitterbit ou não possui funcionalidade. Erro: NoClassDefFoundError com/sap/conn/jco/JCoException. Consulte os logs para obter mais detalhes.

    Para instalar as bibliotecas SAP necessárias, consulte Instalação do conector SAP.

  • Salvar alterações: Clique para salvar e fechar a configuração de 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 solicitará que você confirme se 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem solicitará que você confirme se deseja excluir a conexão.

Próximos passos

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

As ações de menu para uma conexão e seus tipos de atividade podem ser acessadas no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividades estão disponíveis: