Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Jitterbit MQ Obter atividade

Introdução

Uma atividade Jitterbit MQ Get, usando sua conexão Jitterbit MQ, recupera uma única mensagem disponível em uma fila de mensagens Jitterbit específica e se destina a ser usado como uma fonte para fornecer dados em uma operação.

Nota

A atividade Get recupera uma única mensagem de uma fila de mensagens Jitterbit. Para recuperar um lote de mensagens de uma fila de mensagens Jitterbit, use Obter atividade em massa.

Crie uma atividade Jitterbit MQ Get

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

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

Uma atividade Get existente do Jitterbit MQ pode ser editada nestes locais:

Configurar uma atividade Jitterbit MQ Get

Siga estas etapas para configurar uma atividade Get do Jitterbit MQ:

Etapa 1: insira um nome e especifique a fila

Nesta etapa, forneça um nome para a atividade e especifique a fila. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Etapa 1 da configuração da atividade Jitterbit MQ Get

Dica

Campos com um ícone variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

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

  • Fila: Forneça o nome da fila que contém as mensagens a serem recuperadas. A fila deve estar no ambiente especificado na conexão Jitterbit MQ.

    Nota

    Certifique-se de que o nome da fila para o ambiente especificado seja inserido corretamente, pois as operações não falharão se um nome de fila inválido for inserido. Em vez disso, as operações serão bem-sucedidas e o messageCount será devolvido 0.

  • Auto Acknowledge: Selecione para habilitar o reconhecimento automático de mensagens recuperadas. Esta opção gera uma resposta para cada mensagem reconhecida e pode causar tempos de processamento mais longos. Se Auto Acknowledge não for selecionado, reconhecimentos explícitos (usando a Atividade de reconhecimento) são limitados a 50 por ambiente e 500 por organização.

    Nota

    Se Auto Acknowledge não for selecionado, as mensagens recuperadas usando a atividade Get devem ser reconhecidas (pela atividade Acknowledge) ou reconhecido negativamente (pela atividade NACK) antes de um tempo limite de 30 minutos. Depois que o tempo limite de 30 minutos tiver expirado, as mensagens continuarão a ser recuperadas por uma atividade em massa Get ou Get.

  • 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 nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revise os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento de interface de usuário desta etapa é descrito abaixo.

Etapa 2 da configuração da atividade Jitterbit MQ Get

  • 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.

    Informações

    Se você não estiver usando a opção Auto Acknowlegde (especificada em etapa 1), você pode usar o ackId na resposta da atividade Get como entrada para a atividade Acknowledge ou atividade NACK esquema de solicitação.

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

    Nó/Campo do Esquema de Resposta Descrição
    messageCount O número de mensagens recuperadas, seja 0 ou 1
    messageBody O corpo da mensagem
    queue A fila contendo a mensagem
    ackId O ID de confirmação a ser usado na atividade de confirmação
    properties Nó contendo as propriedades da mensagem
    envelope Nó contendo os dados do envelope
    deliveryTag Inteiro da tag de entrega a ser anexada à mensagem (usada na atividade Reconhecer)
    isRedeliver É reenviar
    appId O identificador do aplicativo que produziu a mensagem
    contentEncoding Codificação de conteúdo para a mensagem
    contentType O tipo de conteúdo da mensagem, como application/json
    correlationId O ID da mensagem correlacionada (a qual solicitação a mensagem está respondendo)
    deliveryMode Inteiro indicando se a mensagem recuperada é persistida no disco (2) ou não persistente (1)
    expiration O tempo de expiração após o qual a mensagem será excluída (o período TTL em milissegundos, conforme determinado nas configurações da fila de mensagens)
    messageId O ID da mensagem (se os aplicativos precisarem identificar mensagens, é recomendável que eles usem esse atributo em vez de colocá-lo na payload da mensagem)
    priority Valor inteiro variando de 0 através 9 indicando a prioridade da mensagem (9 sendo a prioridade mais baixa)
    type String contendo o tipo de mensagem, por exemplo, o tipo de evento ou comando que esta mensagem representa.
    timestamp O momento da solicitação
    headers Nó contendo quaisquer cabeçalhos de mensagem
    item Nó contendo cada cabeçalho de mensagem
    name O nome do cabeçalho da mensagem
    value O valor do cabeçalho da mensagem

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

  • Voltar: Clique para armazenar temporariamente a configuração desta 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 nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximos passos

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

As ações de menu para uma atividade são acessíveis a partir do painel do projeto e da quadro de design. Para obter detalhes, consulte menu de ações de atividade em Noções básicas do conector.

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

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

Quando estiver pronto, implantar e executar a operação e validar o comportamento verificando os logs de operação.