Ir para o conteúdo

Conexão SAP

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 organizacional. 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, Token de Segurança e 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 do 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. 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 do cliente numérico associado ao sistema SAP. O administrador SAP da organização pode fornecer essa informação.

  • Idioma: Insira 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 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.

    -   <span class="icon-plus" style="color: #908c94"></span> **Adicionar:** Adiciona uma linha à tabela. Insira um par chave-valor para cada propriedade.
-   <span class="icon-success" style="color: #908c94"></span> **Enviar:** Salva o par chave-valor na tabela. Visível ao passar o mouse sobre uma linha no modo de edição.
-   <span class="icon-fail" style="color: #908c94"></span> **Descartar:** Descarte 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.
-   <span class="icon-edit" style="color: #908c94"></span> **Editar:** Permite editar um par chave-valor existente. Visível ao passar o mouse sobre uma linha existente.
-   <span class="icon-trash" style="color: #908c94"></span> **Excluir:** Exclui a linha da tabela. Visível ao passar o mouse sobre uma linha existente.
-   **Limpar Tudo:** Exclui todas as linhas da tabela.

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

!!! important "Importante"
    Os campos na tabela **Configuração Adicional da Conexão SAP** exibem o ícone de variável <span class="icon-variable"></span> apenas 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](/pt/release-notes/harmony-release-notes/summer-2023/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: