Ir para o conteúdo

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.