Ir para o conteúdo

Atividade Jitterbit MQ Get Bulk

Introdução

Uma atividade Jitterbit MQ Get Bulk, utilizando sua conexão Jitterbit MQ, recupera um lote de mensagens disponíveis em uma fila de mensagens Jitterbit específica e é destinada a ser usada como uma fonte para fornecer dados em uma operação.

Nota

A atividade Get Bulk recupera um lote de mensagens de uma fila de mensagens Jitterbit. Para recuperar uma única mensagem de uma fila de mensagens Jitterbit, use a atividade Get.

Criar uma atividade Jitterbit MQ Get Bulk

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

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 Jitterbit MQ Get Bulk existente pode ser editada a partir destes locais:

Configurar uma atividade Jitterbit MQ Get Bulk

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

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

Neste passo, forneça um nome para a atividade e especifique as configurações. Cada elemento da interface do usuário deste passo é descrito abaixo.

Configuração da atividade Jitterbit MQ Get Bulk passo 1

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 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 Bulk e não deve conter barras / ou dois pontos :.

  • Fila: Forneça o nome da fila contendo 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 esteja inserido corretamente, pois as operações não falham se um nome de fila inválido for inserido. Em vez disso, as operações serão bem-sucedidas e a messageCount retornada será 0.

  • Tamanho do Lote: Insira o tamanho do lote. Você pode inserir um valor entre 1 e 10000.

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

    Nota

    Se Reconhecimento Automático não for selecionado, as mensagens recuperadas usando a atividade Get Bulk devem ser reconhecidas (pela atividade de Reconhecimento) ou negativamente reconhecidas (pela atividade NACK) antes de um tempo limite de 30 minutos. Uma vez que o tempo limite de 30 minutos tenha expirado, as mensagens continuarão a ser recuperadas por uma atividade Get Bulk ou atividade 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 qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

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

Configuração da atividade Jitterbit MQ Get Bulk etapa 2

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

    Os esquemas de dados de resposta consistem nos seguintes nós e campos:

    Nó/Campo do Esquema de Resposta Descrição
    messageCount O número de mensagens recuperadas
    messages Nó contendo as mensagens
    item Nó contendo cada mensagem
    messageBody O corpo da mensagem
    queue A fila contendo a mensagem
    ackId O ID de reconhecimento a ser usado na atividade de Reconhecimento
    properties Nó contendo as propriedades da mensagem
    envelope Nó contendo os dados do envelope
    deliveryTag Inteiro do tag de entrega a ser anexado à mensagem (usado na atividade de Reconhecimento)
    isRedeliver É reentregar
    appId O identificador da aplicação 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 em 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 as aplicações precisarem identificar mensagens, é recomendável que usem este atributo em vez de colocá-lo na carga útil da mensagem)
    priority Valor inteiro variando de 0 a 9 indicando a prioridade da mensagem (9 sendo a prioridade mais baixa)
    type String contendo o tipo da mensagem, por exemplo, o tipo de evento ou comando que esta mensagem representa.
    timestamp O tempo 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 atualizar ou na palavra Atualizar para regenerar esquemas do endpoint Jitterbit MQ. 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 você confirmar que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Jitterbit MQ Obter em Lote, 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 Jitterbit MQ Obter em Lote 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.