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 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.

Os seguintes pré-requisitos específicos para o SAP Event Listener também devem ser atendidos:

  • O sistema SAP deve estar 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 estar instalado em uma máquina que atenda a esses requisitos:
    • Possui 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.
    • Possui os arquivos apropriados do SAP Java connector (SAP JCo) 3.1 SDK instalados.
  • O listener de eventos SAP deve estar 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 single-tenant, é necessária a versão 8.29.2.3 ou posterior do SAP Event Listener. (SAP ECC é suportado sem número de versão mínima.)
  • 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 a execução de uma chamada de função qRFC, o sistema tenta iniciar a próxima transação qRFC na sequência a partir 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.

Solução de Problemas

Para solução de problemas relacionada, consulte o seguinte no guia de solução de problemas do Design Studio: