Atividade JMS Get

Introdução

Uma atividade JMS Get, utilizando sua conexão JMS, recupera todas as mensagens JMS disponíveis em uma fila específica e é destinada a ser usada como uma fonte em uma operação.

Criar uma atividade JMS Get

Uma instância de uma atividade JMS Get é criada a partir de uma conexão JMS usando seu tipo de atividade Get.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para mais detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade JMS Get existente pode ser editada a partir destes locais:

• A tela de design (veja Menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).

Configurar uma atividade JMS Get

Siga estas etapas para configurar uma atividade JMS Get:

• Etapa 1: Insira um nome e especifique as configurações
  Forneça um nome para a atividade e especifique as opções para recuperar mensagens.

• Etapa 2: Revise os esquemas de dados
  Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.

Etapa 1: Insira um nome e especifique as configurações

Nesta etapa, forneça um nome para a atividade e especifique as opções para recuperar mensagens. Cada elemento da interface do usuário desta etapa é descrito abaixo.

• Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade JMS Get e não deve conter barras / ou dois pontos :.

• Nome da fila: Insira o nome da fila para recuperar as mensagens JMS.

• Seletor de mensagem: Insira um seletor de mensagem para especificar as mensagens a serem recuperadas (opcional).

• Tempo de espera (milissegundos): Insira o tempo em milissegundos para esperar pela recuperação das mensagens.

• Tamanho máximo do lote: Insira o número máximo de mensagens a serem recuperadas.

• Sessão transacionada: Selecione para usar uma sessão transacionada. Ao usar uma sessão transacionada, um acknowledgeId é retornado na resposta da atividade, que pode ser usado para reconhecer a mensagem através da Atividade de Reconhecimento. Se não selecionado, um acknowledgeId não é retornado.

• Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

• Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Finalizado na última etapa.

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

Etapa 2: Revisar os esquemas de dados

Qualquer esquema de solicitação ou resposta gerado a partir do endpoint é exibido. Cada elemento da interface do usuário desta etapa é descrito abaixo.

• Esquemas de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

  Nota

  Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

  O esquema de dados de resposta consiste nos seguintes nós e campos:

  Nó/Campo do Esquema de Resposta	Descrição
  getActivityResponse	Nó representando a resposta da atividade
  acknowledgeId	String com o ID de reconhecimento, retornado apenas ao usar uma sessão transacionada
  messages	Nó representando as mensagens recuperadas
  item	Nó representando cada mensagem recuperada
  messageHeaders	Nó representando o cabeçalho da mensagem da mensagem recuperada
  JMSCorrelationID	String do ID de correlação da mensagem recuperada
  JMSDeliveryMode	String indicando se a mensagem recuperada será persistente (2) ou não persistente (1)
  JMSDestination	String representando o destino da mensagem
  JMSExpiration	Inteiro representando o tempo em milissegundos para expirar a mensagem, com 0 indicando que uma mensagem nunca expirará
  JMSMessageID	Identificador único para a mensagem
  JMSPriority	Valor inteiro variando de 0 a 9 indicando a prioridade da mensagem
  JMSRedelivered	Definido como true se a mensagem estiver sendo reenviada para o consumidor
  JMSReplyTo	O destino de resposta que é fornecido no campo replyTo no esquema de solicitação da atividade de envio ou no campo de cabeçalho JMSReplyTo da mensagem JMS
  JMSTimestamp	O tempo em milissegundos que a mensagem foi enviada
  JMSType	O tipo de mensagem que é fornecido no campo de cabeçalho JMSType da mensagem JMS
  customMessageProperties	Nó representando as propriedades personalizadas da mensagem JMS
  item	Nó representando as propriedades personalizadas
  name	O nome da propriedade personalizada
  value	O valor da propriedade personalizada
  messageBody	O corpo da mensagem JMS

• Atualizar: Clique no ícone de atualização ou na palavra Atualizar para regenerar esquemas do endpoint JMS. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

• Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.

• Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

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

Próximas etapas

Após configurar uma atividade JMS Get, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.

As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja o menu de ações da atividade em Conceitos básicos do conector.

As atividades JMS Get podem ser usadas como fonte com esses padrões de operação:

• Padrão de transformação
• Padrão de arquivo de dois alvos (como a primeira fonte apenas)
• Padrão de arquivo HTTP de dois alvos (como a primeira fonte apenas)
• Padrão de duas transformações (como a primeira fonte apenas)

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.