Conexão JMS

Introdução

Uma conexão JMS, criada usando o conector JMS, estabelece acesso a provedores JMS. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades JMS associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Criar ou editar uma conexão JMS

Uma nova conexão JMS é criada usando o conector JMS a partir de uma destas localizações:

• A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A página Endpoints Globais (veja Criar um endpoint global em Endpoints Globais).

Uma conexão JMS existente pode ser editada a partir destas localizações:

• A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A aba Componentes do painel do projeto (veja Menu de ações de componentes em Aba Componentes do painel do projeto).
• A página Endpoints Globais (veja Editar um endpoint global em Endpoints Globais).

Configurar uma conexão JMS

Cada elemento da interface do usuário da tela de configuração da conexão JMS é descrito abaixo.

A interface utilizada na configuração da conexão JMS depende do Provedor JMS selecionado:

• Active MQ

• IBM MQ

• Custom

Active mq

Quando Active MQ é selecionado como o Provedor JMS, a interface descrita abaixo é apresentada.

• Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser único para cada conexão JMS e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint JMS, que se refere tanto a uma conexão específica quanto às suas atividades.

• Provedor JMS: No menu, selecione Active MQ.

• Fábrica JNDI inicial: Insira a fábrica JNDI (Java Naming and Directory Interface) inicial.

• URL do provedor: Insira a URL de conexão a ser utilizada.

• Nome da fábrica: Insira o nome da fábrica de conexão.

• Configurações opcionais: Clique para expandir uma configuração opcional adicional:

  • Usar pesquisa JNDI: Selecione para interagir apenas com filas e tópicos existentes especificados em uma atividade. Quando esta opção é selecionada, e a fila ou tópico especificado não existe, um erro é retornado pela atividade. Opcionalmente, quando esta configuração está habilitada, você pode ativar a Criar Destino se a Pesquisa Falhar na Atividade de Envio para criar uma nova fila ou tópico com o nome especificado quando um não existir.

    Quando desmarcado (padrão), a atividade não verifica a existência de uma fila ou tópico e será concluída com sucesso, independentemente de a mensagem ter sido enviada com sucesso para a fila ou tópico especificado.

• Usar Autenticação: Selecione para autenticar a conexão usando autenticação básica. Quando selecionado, esses campos ficam disponíveis:

  -   **Nome de usuário:** Insira o nome de usuário para o provedor JMS.
  
  -   **Senha:** Insira a senha para o provedor JMS.
  
  !!! note "Nota"
      Para usar autenticação SSL/TLS com ActiveMQ, o SSL deve ser configurado para o cliente JMS e um certificado deve ser adicionado ao keystore Java do Jitterbit (conforme descrito em [pré-requisitos](/pt/integration-studio/design/connectors/jms/#prerequisites-and-supported-api-versions)). Uma vez que os pré-requisitos tenham sido atendidos, a conexão usará automaticamente a autenticação SSL/TLS. Para descontinuar a autenticação SSL/TLS, você deve remover o certificado do keystore Java do Jitterbit.
  

• Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a Desativar Atualização Automática do Conector política organizacional.

• Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de Componentes, Exclusão e Remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

IBM MQ

Quando IBM MQ é selecionado como o Provedor JMS, a interface descrita abaixo é apresentada.

• Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão JMS e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint JMS, que se refere tanto a uma conexão específica quanto às suas atividades.

• Provedor JMS: No menu, selecione IBM MQ.

• URL do provedor: Insira a URL de conexão a ser utilizada.

• Gerenciador de filas: Insira o nome do gerenciador de filas.

• Canal: Insira o canal conectado ao gerenciador de filas especificado.

• Porta: Insira a porta à qual o canal está conectado.

• Configurações opcionais: Clique para expandir configurações opcionais adicionais:

  • Usar pesquisa JNDI: Selecione para interagir apenas com filas e tópicos existentes especificados em uma atividade. Quando esta opção é selecionada, e a fila ou tópico especificado não existe, um erro é retornado pela atividade. Opcionalmente, quando esta configuração está habilitada, você pode ativar a Criar Destino se a Pesquisa Falhar na atividade de envio para criar uma nova fila ou tópico com o nome especificado quando um não existir.

    Quando não selecionado (padrão), a atividade não verifica a existência de uma fila ou tópico e será concluída com sucesso, independentemente de a mensagem ter sido enviada com sucesso para a fila ou tópico especificado.

• Usar Autenticação: Selecione para autenticar a conexão usando autenticação básica. Quando selecionado, esses campos ficam disponíveis:

  • Nome de Usuário: Insira o nome de usuário para o provedor JMS.

  • Senha: Insira a senha para o provedor JMS.

• Usar SSL: Selecione para autenticar a conexão usando o cliente Secure Sockets Layer (SSL). Quando selecionado, os campos abaixo são apresentados.

  Importante

  Ao usar esta opção, o SSL deve ser configurado para o cliente JMS e um certificado deve ser adicionado ao keystore Java do Jitterbit (conforme descrito em pré-requisitos).

  • Cifra SSL: Insira o SSL CipherSpec. Para mais informações sobre IBM MQ CipherSpecs, consulte a documentação do IBM MQ.

  • Protocolo de Segurança: No menu, selecione o protocolo de segurança a ser utilizado, um dos TLS, TLSv1.0, TLSv1.1 ou TLSv1.2. Para mais informações, consulte a documentação do IBM MQ.

• Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

• Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para confirmar que você deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de Componentes, Exclusão e Remoção). Uma mensagem pede para confirmar que você deseja excluir a conexão.

Custom

Quando Custom (Apenas Agente Privado) é selecionado como o provedor JMS, a interface descrita abaixo é apresentada.

• Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão JMS e não deve conter barras / ou dois-pontos :. Este nome também é usado para identificar o endpoint JMS, que se refere tanto a uma conexão específica quanto às suas atividades.

• Provedor JMS: No menu, selecione Custom (Apenas Agente Privado).

  Nota

  Esta opção foi confirmada como funcionando com os provedores JMS JBoss EAP, Oracle WebLogic e GlassFish. Outros provedores JMS devem funcionar, mas não foram testados pela Jitterbit.

• Fábrica inicial JNDI: Insira a fábrica inicial JNDI (Java Naming and Directory Interface).

• URL do provedor: Insira a URL de conexão a ser utilizada.

• Nome da fábrica: Insira o nome da fábrica de conexão.

• Apenas Agente Privado: Quando selecionado, exibe a tabela Configuração adicional do provedor, que é usada para adicionar propriedades de configuração adicionais como pares chave-valor a serem enviados com cada solicitação de atividade:

  • Adicionar: Adiciona uma linha à tabela. Insira um par chave-valor para cada propriedade.
  • Enviar: Salva o par chave-valor na tabela. Visível ao passar o mouse sobre uma linha no modo de edição.
  • Descartar: Descartar uma nova linha ou quaisquer edições feitas em uma linha existente. Visível ao passar o mouse sobre uma linha no modo de edição.
  • Editar: Permite editar um par chave-valor existente. Visível ao passar o mouse sobre uma linha existente.
  • Excluir: Exclui a linha da tabela. Visível ao passar o mouse sobre uma linha existente.
  • Limpar Tudo: Exclui todas as linhas da tabela.

  Importante

  Campos na tabela Configuração adicional do provedor exibem o ícone de variável apenas no modo de edição. Para que os valores das variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

  Campos na tabela Configuração adicional do provedor não suportam o uso de variáveis para passar JSON bruto. Se seu caso de uso não suportar a definição de JSON bruto nos campos diretamente, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escapando {"success": "true"}; torna-se {\"success\": \"true\"};.

• Configurações opcionais: Clique para expandir uma configuração adicional opcional:

  • Usar Autenticação: Selecione para autenticar a conexão usando autenticação básica. Quando selecionado, esses campos ficam disponíveis:

    • Nome de usuário: Insira o nome de usuário para o provedor JMS.

    • Senha: Insira a senha para o provedor JMS.

• Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.

• Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximas etapas

Após a criação de uma conexão JMS, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para mais detalhes, veja Menus de ações em Conceitos básicos do conector.

Estes tipos de atividade estão disponíveis:

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

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

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

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