Ir para o conteúdo

Conector JMS no Jitterbit Studio

Resumo

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

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

O conector JMS é acessado na aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).

Visão geral do conector

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

Juntos, uma conexão JMS específica e suas atividades são referidos como um endpoint JMS:

Tipos de atividades JMS

  • Acknowledge: Envia um reconhecimento em massa de mensagens JMS e é destinado a ser usado como um alvo em uma operação.

  • Get: Recupera todas as mensagens JMS disponíveis em uma fila específica e é destinado a ser usado como uma fonte em uma operação.

  • Consume: Consome mensagens de uma fila ou tópico JMS e é destinado a ser usado como uma fonte em uma operação.

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

Nota

Este conector é um conector baseado no Connector SDK, que pode ser referido pelo Jitterbit ao comunicar mudanças feitas em conectores construídos com o Connector SDK.

Os endpoints criados com este conector estão incluídos na reportagem de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

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

Um agente privado Jitterbit é necessário nas seguintes circunstâncias:

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

  • Ao usar IBM MQ como o provedor JMS. As versões do IBM MQ 9.2, 9.3 e 9.4 são suportadas. Outras versões do IBM MQ também podem funcionar, mas não foram testadas pela 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 tanto autenticação básica quanto 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 no formato PKCS #12 ao Jitterbit Java KeyStore (veja adicionar certificados ao keystore para agentes privados).

Nota

Uma vez que os pré-requisitos tenham sido 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 keystore Java da Jitterbit. Uma conexão IBM MQ requer configuração adicional em sua conexão.

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

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

Solução de Problemas

Se você encontrar problemas com o conector JMS, as seguintes 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 de organização Desativar Atualização Automática do Conector).

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

  3. Ative o registro de depuração da 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 o registro detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

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

Para mais informações sobre o registro detalhado de conectores, consulte Registro detalhado para conectores usando agentes privados Jitterbit.

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

  2. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.