Ir para o conteúdo

Ouvinte de eventos SAP

Visão geral

O Jitterbit SAP Event Listener é um aplicativo instalado localmente que escuta IDocs que são de saída do SAP. Sua configuração requer o uso do conector SAP para Jitterbit Design Studio para configurar um SAP IDoc Event como parte de uma operação do Design Studio. Depois que o SAP Event Listener estiver totalmente configurado, os IDocs que ele recebe acionam a operação do Design Studio.

Pré-requisitos

Para usar o SAP Event Listener, todos os pré-requisitos do SAP Connector devem ser atendidos, conforme descrito em Pré-requisitos em conector SAP.

Se seguir nossa recomendação para instalar o SAP Event Listener em um agente privado, todos os pré-requisitos de um agente privado devem ser atendidos, conforme descrito em Requisitos do sistema para agentes privados.

Esses pré-requisitos específicos do SAP Event Listener também devem ser atendidos:

  • O sistema SAP deve ser configurado com um destino RFC, uma porta RFC transacional (tRFC) e um perfil de parceiro para uso pelo Jitterbit SAP Event Listener.
  • O ouvinte de eventos SAP deve estar instalado em uma máquina que atenda a estes requisitos:
    • Tem um sistema operacional de 64 bits usando Windows Server 2012 R2 ou posterior, Windows 8 ou posterior, ou uma distribuição Linux recente baseada em Debian ou RPM.
    • Possui os arquivos apropriados do SAP Java connector (SAP JCo) 3.1 SDK instalados.
  • O ouvinte de eventos SAP deve ser configurado para usar um agente privado. Recomendamos instalar o SAP Event Listener na mesma máquina que um agente privado.
  • Para que o SAP Event Listener tenha alta disponibilidade, se houver mais de um agente privado em um grupo de agentes privados, uma instância do SAP Event Listener deverá ser instalada e configurada exatamente da mesma maneira em cada agente do grupo.
  • Se estiver usando o SAP S/4HANA single-tenant, será necessário o SAP Event Listener versão 8.29.2.3 ou posterior. (O SAP ECC é compatível sem número mínimo de versão.)
  • O Design Studio versão 8.29.2.8 ou posterior é necessário para configurar e usar o ouvinte de eventos SAP.

Começar

O guia de introdução ao ouvinte de eventos SAP fornece um resumo e a ordem recomendada das etapas de instalação e configuração para começar a usar o SAP Event Listener, bem como uma descrição de como o Harmony e o SAP Event Listener processam eventos IDoc.

Protocolos RFC suportados

O SAP Event Listener oferece suporte aos protocolos RFC transacional (tRFC) e RFC enfileirado (qRFC):

  • RFCs transacionais
    • Uma chamada de função tRFC é executada exatamente uma vez no sistema de destino.
    • O sistema verifica se um TID (identificador exclusivo de transação) já foi processado. Se tiver, a chamada de função tRFC é ignorada.
    • Se o sistema de destino não estiver disponível quando a chamada for feita, o SAP Connector continuará tentando processar a transação. O SAP Connector também continuará processando outras chamadas de função tRFC.
    • A ordem em que as chamadas da função tRFC são processadas não é garantida.
  • RFCs enfileirados
    • Cada chamada de função qRFC é colocada em uma fila de saída que é processada em uma ordem específica.
    • Uma chamada de função qRFC não pode ser executada até que todos os seus predecessores na fila tenham sido processados. Uma chamada de função qRFC é transferida somente se não tiver predecessores na fila participante.
    • Após a execução de uma chamada de função qRFC, o sistema tenta iniciar a próxima transação qRFC na sequência da fila.
    • Um nome de fila e um contador de fila são necessários para cada transação qRFC para administração de fila. Cada chamada qRFC que deve ser processada cronologicamente recebe um nome de fila.

Problema conhecido

A versão mais recente do SAP Event Listener tem este problema conhecido:

  • SAP Event Listener: A interface de configuração do Windows não pode ser aberta

    • Resumo: Ao tentar abrir a configuração do Windows SAP Event Listener por meio da interface do usuário, ocorre uma exceção.

    • Informações adicionais: Esse problema ocorre quando uma configuração salva anteriormente que inclui o conjunto externo necessário de <events> e </events> tags no campo Detalhes do Evento foram inadvertidamente salvas sem essas tags.

    • Recuperação: Edite manualmente o arquivo de configuração em C:\ProgramData\JitterbitSAPEventListener\conf\sapeventconfig.xml para substituir as tags externas necessárias. A UI de configuração do Windows pode ser aberta novamente.