Ir para o conteúdo

Conector JMS

Resumo

O conector JMS estabelece acesso aos 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. Essas atividades, uma vez configuradas, interagem com provedores JMS por meio da conexão.

O conector JMS é acessado na aba endpoints e conectores do projeto 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 atividade associados a essa conexão são então usados para criar instâncias de atividades que devem ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Juntas, 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 deve ser usado como um alvo em uma operação.

  • Pegar: Recupera todas as mensagens JMS disponíveis em uma fila específica e deve ser usada como fonte em uma operação.

  • Consumir: Consome mensagens de uma fila JMS e deve ser usado como fonte em uma operação.

  • Enviar: Envia mensagens para uma fila ou tópico JMS e deve ser usado como um alvo em uma operação.

Nota

Este conector é um Connector SDK, que pode ser referenciado 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 de agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

Um agente privado da Harmony é necessário nestas circunstâncias:

  • Ao usar 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 formato para o Jitterbit Java KeyStore (veja adicionar certificados ao repositório de chaves para agentes privados).

Nota

Depois 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 Java Jitterbit. Uma conexão 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 solução de problemas são recomendadas:

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

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

  3. Habilite o registro de depurar da operação (para agentes de nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode habilitar conector verbose logging para este conector usando esta entrada de configuração específica de nome e nível do registrador:

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

  5. Se estiver usando agentes privados, você pode verificar os registros do agente para mais informações.