Jitterbit MQ (Beta) Obter Atividade¶

Introdução¶

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

Este conector é lançado atualmente como uma versão beta. Para fornecer feedback sobre bugs e melhorias, entre em contato com seu gerente de sucesso do cliente (CSM).

Criar uma Atividade de Obtenção do Jitterbit MQ (Beta)¶

Uma instância de uma atividade Jitterbit MQ (Beta) Get é criada a partir de uma conexão Jitterbit MQ (Beta) 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 Criando uma instância de atividade em Reutilização de componente.

Uma atividade Jitterbit MQ (Beta) Get existente pode ser editada a partir destes locais:

• A quadro de design (consulte Menu de ações do componente em Quadro de Design).
• A aba Componentes do painel do projeto (consulte Menu de ações do componente na Guia Componentes do painel do projeto).

Configurar uma Atividade de Obtenção do Jitterbit MQ (Beta)¶

Siga estas etapas para configurar uma atividade Jitterbit MQ (Beta) Get:

• Etapa 1: Digite um Nome e Especifique a Fila
  Forneça um nome para a atividade e especifique a fila.

• Etapa 2: Revise os Esquemas de Dados
  Qualquer solicitação ou esquema de resposta é exibido.

Etapa 1: Digite 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 a seguir.

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

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

• Reconhecimento Automático: Selecione para ativar o reconhecimento automático de mensagens recuperadas. Esta opção gera uma resposta para cada mensagem confirmada e pode causar tempos de processamento mais longos. Se Reconhecimento Automático for deixado desmarcado, reconhecimentos explícitos (usando a Atividade de reconhecimento) estão limitados a 50 por ambiente e 500 por organização.

  Nota

  Se Reconhecimento Automático for deixado desmarcado, as mensagens recuperadas usando a atividade Obter devem ser confirmadas (pelo Atividade de reconhecimento) ou negativamente reconhecido (pela atividade NACK) antes de um tempo limite de 30 minutos. Depois que o tempo limite de 30 minutos expirar, as mensagens continuarão a ser recuperadas por um Get ou Get Bulk activity.

• Save & Exit: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

• Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme 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 a seguir.

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

  Informação

  Se você não estiver usando a opção Auto Acknowlegde (especificada na etapa 1), você pode usar o ackId na resposta da atividade Obter como entrada para a Atividade de reconhecimento ou atividade NACK do 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	Número inteiro da etiqueta de entrega a ser anexada à mensagem (usado na Atividade de reconhecimento)
  isRedeliver	é reentregar
  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	Número inteiro que indica se a mensagem recuperada persiste 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 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	A hora do pedido
  headers	Nó contendo qualquer cabeçalho 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 Atualizar para regenerar esquemas do endpoint Jitterbit MQ (Beta). Essa ação também regenera um esquema em outros locais do projeto em que 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 as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximos Passos¶

Depois de configurar uma atividade Jitterbit MQ (Beta) Get, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode definir as configurações de operação, que incluem a capacidade de encadear operações que estão no mesmo workflows ou em diferentes.

As ações de menu para uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte Menu de ações de atividade em Noções básicas do conector.

As atividades Jitterbit MQ (Beta) 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 (apenas como a primeira fonte)
• Padrão de arquivo HTTP de dois destinos (apenas como a primeira fonte)

Um caso de uso típico é usar uma atividade Jitterbit MQ (Beta) Get no Transformation Pattern. Neste exemplo, a atividade Jitterbit MQ (Beta) Get gera uma estrutura de resposta que é recebida pela transformação (Get Response), que é gravada em uma variável por uma atividade Variable Write (Write Get Response) e uma mensagem é então registrada pelo script Write to Operation Log:

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 da operação.