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 usada 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 a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

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 destinadas 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 chamados de endpoint JMS:

JMS activity types

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

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

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

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

Os endpoints criados com este conector são incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, você pode suspender essas atualizações com a política de organização Disable Auto Connector Update.

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

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

  • Ao usar IBM MQ como provedor JMS. As versões 9.2, 9.3 e 9.4 do IBM MQ 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 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 formato PKCS #12 ao Jitterbit Java KeyStore (consulte adicionar certificados ao keystore para agentes privados).

Nota

Após atender aos pré-requisitos, 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 Jitterbit. Uma conexão IBM MQ requer configuração adicional em sua conexão.

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

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

Solução de problemas

Se você tiver problemas com o conector JMS, recomenda-se seguir estas etapas de solução de problemas:

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

  2. Verifique os logs de operação para obter informações registradas durante a execução da operação.

  3. Ative o log de depuração 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 o log 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 obter mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

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

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