Ir para o conteúdo

Conexão Jitterbit MQ

Introdução

Uma conexão Jitterbit MQ, criada usando o conector Jitterbit MQ, estabelece acesso ao serviço de fila de mensagens Jitterbit. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades Jitterbit MQ associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

Este conector suporta a política de Habilitar Reautenticação em Mudanças política da organização. Se habilitado, uma mudança no ID da Organização, ID do Ambiente ou Região Jitterbit nesta conexão requer que os usuários reentrem o Token de Autenticação para a conexão.

Criar ou editar uma conexão Jitterbit MQ

Uma nova conexão Jitterbit MQ é criada usando o conector Jitterbit MQ a partir de uma destas localizações:

Uma conexão Jitterbit MQ existente pode ser editada a partir destas localizações:

Configurar uma conexão Jitterbit MQ

Cada elemento da interface do usuário da tela de configuração da conexão Jitterbit MQ é 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 da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão Jitterbit MQ e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint Jitterbit MQ, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Token de autenticação: Insira um token de autenticação associado ao ambiente. O token de autenticação é gerado na página de Filas de mensagens dentro da aba de tokens de autenticação.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Região Jitterbit: Selecione a região Jitterbit à qual a organização pertence, sendo APAC, EMEA ou NA. Este campo é obrigatório quando você usa a versão do agente 10.73 ou anterior. Quando você usa a versão do agente 10.74 ou posterior, o sistema seleciona a região da organização que você está acessando por padrão.

    • ID da organização: Insira o ID da organização Harmony. Este campo é obrigatório quando você usa a versão do agente 10.73 ou anterior. Quando você usa a versão do agente 10.74 ou posterior, pode deixar este campo vazio se o Token de Autenticação estiver associado à mesma organização em que o projeto reside. Caso contrário, você deve inserir o ID da organização associado ao token de autenticação.

  • ID do Ambiente: Insira o ID do ambiente Harmony para o ambiente que contém a fila de mensagens. Este campo é obrigatório quando você usa a versão do agente 10.73 ou anterior. Quando você usa a versão do agente 10.74 ou posterior, pode deixar este campo vazio para usar o ambiente do projeto.

  • Tempo limite de solicitação de conexão em segundos: Insira o tempo máximo (em segundos) para a conexão permanecer aberta após a conclusão de uma solicitação. Este tempo limite ocioso controla quanto tempo uma conexão estabelecida permanece aberta antes de ser fechada. O padrão é 10 segundos e o valor máximo é 180 segundos. Não é recomendável alterar este valor.

  • Tempo limite de resposta em segundos: Insira o tempo máximo (em segundos) para aguardar que o serviço de fila de mensagens retorne dados após o envio de uma solicitação. Se o serviço não responder dentro desse período, a solicitação atinge o tempo limite. O padrão é 10 segundos e o valor máximo é 300 segundos.

  • Tempo limite de conexão em segundos: Insira o tempo máximo (em segundos) para aguardar que uma conexão inicial seja estabelecida com o serviço de fila de mensagens antes que a tentativa atinja o tempo limite. Esta configuração se aplica quando você abre uma nova conexão, antes de enviar qualquer solicitação. O padrão é 10 segundos e o valor máximo é 300 segundos.

  • Tentar Novamente: Selecione esta caixa de seleção para tentar estabelecer uma conexão novamente se a primeira tentativa falhar ou atingir o tempo limite durante a execução de uma atividade Get, Get Bulk ou Get Queue Details. Quando esta caixa de seleção está marcada, as seguintes opções ficam disponíveis:

    • Quantidade de tentativas: Insira o número máximo de tentativas de conexão a serem feitas (de 1 a 5).

    • Intervalo de tentativas (em segundos): Insira quantos segundos esperar entre cada tentativa de conexão (mínimo 1 e máximo 5).

  • Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desativar Atualização Automática do Conector política organizacional.

  • Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

  • Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos passos

Após a criação de uma conexão Jitterbit MQ, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Noções básicas sobre conectores.

Estes tipos de atividade estão disponíveis:

  • Obter em Lote: Recupera um lote de mensagens disponíveis em uma fila de mensagens Jitterbit específica e é destinado a ser usado como uma fonte em uma operação.

  • Reconhecer: Reconhece mensagens em uma fila de mensagens Jitterbit e é destinado a ser usado como um alvo em uma operação.

  • Enviar em Lote: Envia um lote de mensagens para uma fila de mensagens Jitterbit e é destinado a ser usado como um alvo em uma operação.

  • Obter: Recupera uma única mensagem disponível em uma fila de mensagens Jitterbit específica e é destinado a ser usado como uma fonte em uma operação.

  • NACK: Reconhece negativamente mensagens (usando o ackId) e é destinado a ser usado como um alvo em uma operação.

  • Obter Detalhes da Fila: Recupera detalhes da fila para uma fila de mensagens Jitterbit específica e é destinado a ser usado como uma fonte em uma operação.

  • Enviar: Envia uma única mensagem para uma fila de mensagens Jitterbit e é destinado a ser usado como um alvo em uma operação.