Jitterbit Design Studio SAP Event Listener
Visão Geral
O Jitterbit SAP Event Listener é um aplicativo instalado localmente que escuta por IDocs que estão saindo do SAP. Sua configuração requer o uso do conector SAP para Jitterbit Design Studio a fim de configurar um Evento IDoc do SAP como parte de uma operação do Design Studio. Uma vez que o SAP Event Listener esteja 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 Conector SAP devem ser atendidos, conforme descrito em Pré-requisitos no conector SAP.
Se seguir nossa recomendação de 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 para o SAP Event Listener também devem ser atendidos:
- O sistema SAP deve ser configurado com um destino RFC, uma porta de RFC transacional (tRFC) e um perfil de parceiro para uso pelo Jitterbit SAP Event Listener.
- O listener de eventos SAP deve ser instalado em uma máquina que atenda a esses requisitos:
- Possuir um sistema operacional de 64 bits usando Windows Server 2019 ou posterior, Windows 10 ou posterior, ou uma distribuição recente de Linux baseada em Debian ou RPM.
- Ter os arquivos apropriados do SAP Java connector (SAP JCo) 3.1 SDK instalados.
- O listener 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 deve ser instalada e configurada exatamente da mesma forma em cada agente do grupo.
- Se estiver usando SAP S/4HANA de inquilino único, é necessária a versão 8.29.2.3 ou posterior do SAP Event Listener. (SAP ECC é suportado sem número mínimo de versão.)
- A versão 8.29.2.8 ou posterior do Design Studio é necessária para configurar e usar o listener de eventos SAP.
Comece a usar
O guia de início rápido do ouvinte de eventos SAP fornece um resumo e a ordem recomendada dos passos de instalação e configuração para começar a usar o Ouvinte de Eventos SAP, além de uma descrição de como o Harmony e o Ouvinte de Eventos SAP processam eventos IDoc.
Protocolos RFC suportados
O Ouvinte de Eventos SAP suporta os 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 de transação único) já foi processado. Se foi, a chamada de função tRFC é ignorada.
- Se o sistema de destino não estiver disponível quando a chamada for feita, o Conector SAP continua tentando processar a transação. O Conector SAP também continua a processar outras chamadas de função tRFC.
- A ordem em que as chamadas de 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 apenas se não tiver predecessores na fila participante.
- Após uma chamada de função qRFC ser executada, 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 é atribuída a um nome de fila.
Problema conhecido
A versão mais recente do Ouvinte de Eventos SAP tem este problema conhecido:
-
Ouvinte de Eventos SAP: A interface de configuração do Windows não pode ser aberta
- Resumo: Ao tentar abrir a configuração do Ouvinte de Eventos SAP no Windows através da interface, uma exceção ocorre.
-
Informações Adicionais: Este problema ocorre quando uma configuração previamente salva que inclui o conjunto externo necessário de
<events>
e</events>
no campo Detalhes do Evento foi inadvertidamente salva 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 interface de configuração do Windows pode ser aberta novamente.