Ir para o conteúdo

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 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:

Configurar uma atividade JMS Get

Siga estas etapas para configurar uma atividade JMS Get:

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.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • 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 de onde 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 aguardar a 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 Concluído 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 confirmar que você deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos. 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ó que representa a resposta da atividade
    acknowledgeId String com o ID de reconhecimento, retornado apenas ao usar uma sessão transacionada
    messages Nó que representa as mensagens recuperadas
    item Nó que representa cada mensagem recuperada
    messageHeaders Nó que representa o cabeçalho da mensagem da mensagem recuperada
    JMSCorrelationID String do ID de correlação da mensagem recuperada
    JMSDeliveryMode String que indica se a mensagem recuperada será persistente (2) ou não persistente (1)
    JMSDestination String que representa o destino da mensagem
    JMSExpiration Inteiro que representa 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 Send ou no campo de cabeçalho JMSReplyTo da mensagem JMS
    JMSTimestamp O tempo em milissegundos em que a mensagem foi enviada
    JMSType O tipo de mensagem que é fornecido no campo de cabeçalho JMSType da mensagem JMS
    customMessageProperties Nó que representa as propriedades personalizadas da mensagem JMS
    item Nó que representa 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 solicita que você confirme que 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 Noções básicas sobre conectores.

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

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.