Ir para o conteúdo

Atividade NACK do Jitterbit MQ

Introdução

Uma atividade NACK do Jitterbit MQ, utilizando sua conexão Jitterbit MQ, reconhece negativamente mensagens (usando o ackId) e é destinada a ser usada como um alvo para consumir dados em uma operação.

Para usar a atividade NACK, você deve primeiro usar uma Obter ou Obter atividade em massa para recuperar o ackId para a(s) mensagem(ns). O ackId deve ser fornecido no esquema de solicitação da atividade NACK.

Criar uma atividade NACK do Jitterbit MQ

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

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

Configurar uma atividade NACK do Jitterbit MQ

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

Passo 1: Insira um nome e selecione uma opção de reenvio

Neste passo, forneça um nome para a atividade e selecione uma opção de reenvio. Cada elemento da interface do usuário deste passo é descrito abaixo.

  • Menu de Endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, veja Alterar o endpoint atribuído em Telhas de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint atualmente selecionado.

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

  • Opções de Reenvio: Selecione uma opção de reenvio, seja Rejeitar Mensagens Após NACK ou Reenviar Mensagens Após NACK:

    • Rejeitar Mensagens Após NACK: Esta opção rejeitará mensagens presentes na coluna Mensagens Não Reconhecidas na aba Filas de Mensagens na página Filas de Mensagens do Console de Gerenciamento e as removerá da fila.

    • Reenviar Mensagens Após NACK: Esta opção enviará mensagens presentes na coluna Mensagens Não Reconhecidas na aba Filas de Mensagens na página Filas de Mensagens do Console de Gerenciamento para a coluna Mensagens Prontas para serem recuperadas por uma Obter ou Atividade de Obter em Lote em um momento posterior.

      Cuidado

      Esta opção está sujeita a um limite de entrega de 20 tentativas quando usada com uma fila Quorum. Se uma mensagem for recuperada e negativamente reconhecida 20 vezes sem um reconhecimento bem-sucedido, a mensagem será removida permanentemente da fila sem uma mensagem de erro. Se sua integração exigir mais de 20 tentativas de reenvio, use uma fila Clássica.

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

  • 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ção

    Para usar a atividade NACK, você deve primeiro usar uma Obter ou Obter em massa para recuperar o ackId para a(s) mensagem(ns). O ackId deve ser fornecido no esquema de solicitação da atividade NACK.

    Os esquemas de dados de solicitação e resposta consistem nos seguintes nós e campos:

    Nó/Campo do Esquema de Solicitação Descrição
    ackId String contendo o ID de reconhecimento (obtido de uma Obter ou atividade Obter em massa)
    deliverTag Inteiro do tag de entrega (configurado como deliveryTag em uma Enviar ou atividade Enviar em massa); por exemplo, se definido como 3, mensagens com tags de entrega definidas como 1, 2 ou 3 são reconhecidas
    multiple Definido como true se várias mensagens devem ser reconhecidas, definido como false se apenas uma única mensagem deve ser reconhecida
    requeueOptionAfterNack Definido como nackrequeue para colocar a mensagem de volta na fila para ser consumida por uma Obter ou Obter em massa, definido como nackreject para descartar a mensagem
    Esquema de Resposta Nó/Campo Descrição
    success Booleano representando o sucesso (true) ou falha (false) do reconhecimento
    error Nó contendo quaisquer erros
    statusCode Código de status da resposta HTTP retornado
    error String contendo quaisquer mensagens de erro
    additionalProperties String contendo quaisquer propriedades adicionais

    Nota

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

  • 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 ao longo 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 NACK, 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 Menu de ações da atividade em Fundamentos do Conector.

Atividades NACK do Jitterbit MQ podem ser usadas como um alvo 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.