Guia de Primeiros Passos do SAP Event Listener¶

Introdução¶

Este guia resume as etapas de configuração necessárias para começar a usar o SAP Event Listener e descreve como o Harmony e o SAP Event Listener processam eventos IDoc.

Etapas Iniciais¶

Use as etapas abaixo como um guia para a ordem recomendada para concluir a configuração do SAP Event Listener. Essas etapas incluem links para outras páginas no SAP Event Listener seção da documentação que fornece detalhes e instruções adicionais.

1. Configurando o Sistema SAP¶

Um administrador SAP deve configurar o sistema SAP conforme descrito em Configuração do sistema SAP Event Listener SAP. Como parte desse processo, eles configurarão o destino RFC do Jitterbit, criarão uma porta tRFC (a porta tRFC é usada para chamadas de função tRFC e qRFC) e configurarão o Jitterbit como um parceiro SAP.

Nesta fase do processo de configuração, um administrador SAP não poderá testar com êxito a conexão dentro do sistema SAP, pois é necessária configuração adicional fora do sistema SAP para estabelecer a conectividade.

2. Baixando os Arquivos SAP JCo SDK¶

Um usuário SAP deve fazer download dos arquivos SAP Java Connector (SAP JCo) 3.1 SDK da página SAP SAP Java Connector na seção Baixar SDK do Java Connector 3.1 (é necessário fazer login no SAP). Esses arquivos são necessários durante a instalação do aplicativo SAP Event Listener, conforme descrito em Baixando componentes necessários em Instalação do SAP Event Listener.

3. Instalando os Arquivos SAP JCo SDK¶

Um usuário com acesso a cada máquina onde o SAP Event Listener será instalado deverá instalar os arquivos JCo SDK relevantes conforme descrito em Instalar componentes necessários em Instalação do SAP Event Listener.

4. Baixando o SAP Event Listener¶

Um usuário Harmony deve baixar o SAP Event Listener em Downloads do Portal Harmony, conforme descrito em Baixando o SAP Event Listener em Instalação do SAP Event Listener.

5. Instalando o SAP Event Listener¶

Um usuário com acesso a cada máquina onde o SAP Event Listener será instalado deverá instalar o aplicativo SAP Event Listener conforme descrito em Instalação do SAP Event Listener. Durante o processo de instalação, você será solicitado a configurar o SAP Event Listener, conforme descrito na próxima etapa.

6. Configurando o SAP Event Listener¶

Um usuário com acesso a cada máquina SAP Event Listener deve configurar o aplicativo SAP Event Listener conforme descrito em Configuração do SAP Event Listener.

Nesta fase do processo de configuração, a parte Detalhes do evento da configuração do SAP Event Listener não pode ser concluída, pois é necessária uma configuração adicional fora da configuração do SAP Event Listener para obter a entrada para este campo. Deixe a parte Detalhes do Evento da configuração vazia até ser orientado em uma etapa posterior.

Você também deve adicionar a porta do gateway SAP ao sistema operacional services arquivo, se ainda não estiver presente.

Você pode então testar a conexão na configuração do SAP Event Listener e verificar se o serviço SAP Event Listener está em execução. O serviço deve estar em execução mesmo que os detalhes do evento ainda não tenham sido inseridos.

7. Habilitando Eventos SAP IDoc no Design Studio¶

Um usuário Harmony que esteja projetando o projeto de integração deve ativar uma configuração no aplicativo Design Studio que permita a configuração de eventos SAP IDoc conforme descrito em Ativando eventos SAP IDoc em Configuração e uso do SAP Event Listener Design Studio.

8. Obtenção de Detalhes do Evento¶

Um usuário Harmony que está projetando o projeto de integração deve criar uma operação SAP IDoc Event para cada evento no Design Studio para obter a configuração de evento necessária para concluir a configuração do SAP Event Listener. Isso está descrito em Criando uma operação de evento SAP IDoc e obtendo detalhes do evento em Configuração e uso do SAP Event Listener Design Studio.

9. Concluindo a Configuração do SAP Event Listener¶

Um usuário com acesso a cada máquina SAP Event Listener deve concluir a configuração do aplicativo SAP Event Listener inserindo as configurações de eventos obtidas na etapa anterior no campo Event Details da configuração do SAP Event Listener. Os Detalhes do Evento são inseridos em Propriedades de Conexão de Evento SAP seção da configuração do SAP Event Listener.

10. Reiniciando o Serviço SAP Event Listener¶

Um usuário com acesso a cada máquina SAP Event Listener deve reiniciar o serviço SAP Event Listener após alterações de configuração, conforme descrito em Reiniciando o serviço SAP Event Listener em Instalação do SAP Event Listener.

11. Verificando a Conectividade com o SAP Event Listener¶

Um administrador SAP deve verificar a conectividade entre o gateway SAP e o SAP Event Listener testando a conexão do destino RFC configurado. Isso está descrito em Verificando a conectividade com o SAP Event Listener em Configuração do sistema SAP do ouvinte de eventos SAP.

Noções Básicas Sobre Processamento de Eventos IDoc¶

Esta seção descreve como o Harmony e o SAP Event Listener processam cada evento IDoc, dependendo se o protocolo RFC em fila (qRFC) ou o protocolo RFC transacional (tRFC) é usado. O ID do programa configurado no destino SAP RFC é usado pelo Harmony e pelo SAP Event Listener para receber o evento IDoc.

Processamento de Eventos Qrfc IDoc¶

A qualquer momento, quando IDocs qRFC são enviados do SAP para um ID de programa de servidor registrado, as operações do Harmony recebem os IDocs em sequência para essa fila específica. As operações do Harmony também completam o processamento de IDocs qRFC na mesma ordem em que os IDocs foram recebidos.

O processamento de eventos qRFC IDoc ocorre nesta ordem:

A SAP envia o primeiro qRFC IDoc para um ID de programa por meio do SAP Event Listener. O Harmony impede que o SAP envie outro IDoc qRFC até que a operação tenha concluído com êxito o processamento do IDoc qRFC atual.
O Harmony envia uma mensagem de sucesso somente após a operação ser concluída com sucesso. A mensagem de sucesso é enviada por meio do SAP Event Listener para o SAP.
Depois que uma mensagem de sucesso para o primeiro qRFC IDoc for recebida pelo SAP, o próximo qRFC IDoc na sequência do ID do programa será enviado ao SAP Event Listener.
Se a operação não conseguir processar com êxito o qRFC IDoc, o Harmony enviará uma mensagem de falha por meio do SAP Event Listener para o SAP. O SAP reenvia/tenta novamente o qRFC IDoc até que uma mensagem de sucesso seja recebida do SAP Event Listener.
O SAP Event Listener recebe o próximo qRFC IDoc relacionado ao ID da fila/programa do SAP somente depois que o IDoc anterior for processado com êxito. No entanto, o SAP Event Listener recebe outras mensagens para processamento que pertencem a um ID de fila/programa diferente.

Se o SAP Event Listener ficar inativo ou for interrompido durante o processamento de um IDoc qRFC, o SAP Event Listener não receberá uma mensagem de sucesso ou falha. Você pode verificar nos arquivos de log se o último IDoc qRFC foi processado com sucesso:

Se o IDoc qRFC foi processado com êxito pelo Harmony, certifique-se de que qualquer mensagem com falha desse IDoc qRFC seja excluída do SAP antes de reiniciar o SAP Event Listener.
Se a operação qRFC IDoc não for concluída com êxito, o SAP já estará aguardando em estado de falha. Nesse caso, reinicie o SAP Event Listener, e a SAP reenviará/tentará novamente processar o IDoc qRFC anterior.

Processamento de Eventos Trfc IDoc¶

A qualquer momento, quando os IDocs tRFC são enviados do SAP para um ID de programa de servidor registrado, as operações do Harmony concluem o processamento dos IDocs tRFC em qualquer ordem. Os IDocs tRFC são processados em paralelo em todas as instalações disponíveis do SAP Event Listener e do Agente Privado.

Se alguma operação tRFC falhar ao concluir o processamento, o SAP Event Listener ainda poderá receber outros IDocs tRFC do SAP e o Agente Privado poderá concluir o processo.

A qualquer momento, o SAP Event Listener garante que IDocs tRFC com falha sejam armazenados no SAP.

Se o SAP Event Listener estiver configurado em vários Agentes Privados em um Grupo de Agentes Privados e um IDoc tRFC for enviado pelo SAP para qualquer ID de programa registrado, apenas uma das instâncias do SAP Event Listener receberá o IDoc.

Por exemplo, se cinco IDocs tRFC forem enviados por push do SAP, todos os cinco IDocs poderão ser recebidos pelo mesmo SAP Event Listener ou os cinco IDocs poderão ser distribuídos em diversas instâncias do SAP Event Listener.