Ir para o conteúdo

Conexão Jitterbit MQ no Jitterbit Studio

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ça 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 dessas localizações:

Uma conexão Jitterbit MQ existente pode ser editada a partir dessas 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 esse 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 estiver 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 da organização.

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