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.

Primeiros Passos¶

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 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 Jitterbit RFC, 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 baixar os arquivos SAP Java Connector (SAP JCo) 3.1 SDK da página SAP SAP Java Connector na seção Baixar Java Connector 3.1 SDK (é necessário fazer login no SAP). Esses arquivos são necessários durante a instalação do aplicativo SAP Event Listener, conforme descrito em Download de 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 deve instalar os arquivos JCo SDK relevantes conforme descrito em Instalando os componentes necessários em Instalação do SAP Event Listener.

4. Baixando o SAP Event Listener¶

Um usuário do Harmony deve baixar o SAP Event Listener do Downloads do Harmony Portal conforme descrito em Download do 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 deve 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 Event Details 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 em branco até ser instruído em uma etapa posterior.

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

Você pode então testar a conexão dentro da 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. Ativando Eventos SAP IDoc no Design Studio¶

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

8. Obtenção de Detalhes do Evento¶

Um usuário do 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 do evento necessária para concluir a configuração do SAP Event Listener. Isso é 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. Finalizando 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 evento obtidas na etapa anterior no campo Event Details da configuração do SAP Event Listener. Os Detalhes do evento são inseridos nas Propriedades de conexão do evento SAP da seção 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 as 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 é descrito em Verificando a conectividade com o SAP Event Listener em configuração do sistema SAP do ouvinte de eventos SAP.

Compreendendo o 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 enfileirado (qRFC) ou o protocolo RFC transacional (tRFC) é usado. O ID do programa configurado no destino SAP RFC é usado pelo Harmony e o SAP Event Listener para receber o evento IDoc.

Processamento de Eventos Qrfc IDoc¶

A qualquer momento, quando qRFC IDocs 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 Harmony também concluem o processamento de qRFC IDocs na mesma ordem de sequência em que os IDocs foram recebidos.

O processamento de eventos qRFC IDoc ocorre nesta ordem:

O 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 qRFC IDoc até que a operação tenha concluído com êxito o processamento do qRFC IDoc 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.
Uma vez que uma mensagem de sucesso para o primeiro qRFC IDoc é recebida pelo SAP, o próximo qRFC IDoc na sequência para o ID do programa é enviado para o SAP Event Listener.
Se a operação falhar ao 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 à fila/ID do programa do SAP somente após o IDoc anterior ser processado com sucesso. No entanto, o SAP Event Listener recebe outras mensagens para processamento que pertencem a uma fila/ID de programa diferente.

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

Se o qRFC IDoc foi processado com sucesso pelo Harmony, certifique-se de que qualquer mensagem com falha para esse qRFC IDoc 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 um estado de falha. Nesse caso, reinicie o SAP Event Listener e o SAP reenviará/tentará processar o qRFC IDoc 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 tRFC IDocs são processados em paralelo em todas as instalações disponíveis do SAP Event Listener e Agente Privado.

Se qualquer 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 tRFC IDoc 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 do SAP, todos os cinco IDocs poderão ser recebidos pelo mesmo SAP Event Listener ou os cinco IDocs poderão ser distribuídos por várias instâncias do SAP Event Listener.