Ir para o conteúdo

Conector JMS

Resumo

O Harmony JMS Connector estabelece acesso a provedores JMS (Java Message Service).

O conector JMS fornece uma interface para criar uma conexão JMS, a base usada para gerar instâncias de atividades JMS. Estas atividades, uma vez configuradas, interagem com os provedores JMS através da conexão.

O conector JMS é acessado na aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).

Visão Geral do Conector

Este conector é usado para configurar primeiro uma conexão JMS. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Juntos, uma conexão JMS específica e suas atividades são chamadas de endpoint JMS:

Tipos de atividade JMS

  • Reconhecer: Envia uma confirmação em massa de mensagens JMS e destina-se a ser usado como destino em uma operação.

  • Pegar: Recupera todas as mensagens JMS disponíveis em uma fila específica e destina-se a ser usada como origem em uma operação.

  • Consumir: Consome mensagens de uma fila JMS e destina-se a ser usado como origem em uma operação.

  • Enviar: Envia mensagens para uma fila ou tópico JMS e destina-se a ser usado como destino em uma operação.

Nota

Este conector é um SDK do conector, que pode ser referido pelo Jitterbit ao comunicar alterações feitas em conectores criados com o Connector SDK.

Pré-requisitos e Versões de API Suportadas

O conector JMS requer o uso de uma versão do agente 10.1 ou mais tarde. Essas versões do agente baixam automaticamente a versão mais recente do conector quando necessário.

Um Agente Privado Harmony é necessário nestas circunstâncias:

  • Ao usar a autenticação SSL/TLS para uma conexão ActiveMQ.

  • Ao usar o IBM MQ como provedor JMS. IBM MQ versão 9.2 é suportado. Outras versões do IBM MQ também podem funcionar, mas não foram testadas pelo Jitterbit.

  • Ao usar um provedor JMS personalizado.

O conector JMS suporta a especificação Java Message Service 1.1.

Autenticação

O conector JMS suporta autenticação básica e autenticação SSL/TLS. Para usar SSL/TLS para autenticar a conexão, o cliente JMS deve ser configurado para usar SSL/TLS e você deve adicionar um certificado em PKCS #12 para o repositório de chaves Jitterbit Java (consulte Adicionar certificados ao keystore para Agentes Privados).

Nota

Assim que os pré-requisitos forem atendidos, uma conexão ActiveMQ usará automaticamente SSL/TLS. Para descontinuar o uso de SSL/TLS na conexão, você deve remover o certificado do repositório de chaves Jitterbit Java. Uma conexão do IBM MQ requer configuração adicional em sua conexão.

Para obter informações sobre como configurar seu agente de mensagens para usar autenticação SSL/TLS, consulte a documentação do provedor JMS:

Para obter informações sobre como obter um certificado em PKCS #12, consulte a documentação do provedor JMS:

Solução de Problemas

Se você tiver problemas com o conector JMS, estas etapas de resolução de problemas são recomendadas:

  1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e garantir que a versão mais recente do conector seja baixada para o agente (a menos que você use a Desativar atualização automática do conector política da organização).

  2. Verifique os logs de operação para qualquer informação escrita durante a execução da operação.

  3. Habilite o registro de depurar de operação (para Agentes em Nuvem ou para Agentes Privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando Agentes Privados, você pode ativar registro detalhado do conector para este conector usando esta entrada de configuração específica de nome e nível do criador de logs:

    <logger name="org.jitterbit.connector.sdkjms" level="DEBUG"/>

  5. Se estiver usando Agentes Privados, você pode verificar os logs do agente Para maiores informações.