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. Depois que uma conexão é configurada, você pode criar instâncias de atividades do Jitterbit MQ associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
Nota
Este conector oferece suporte à política da organização Habilitar Reautenticação na Alteração. Se habilitado, uma alteração no ID da Organização, ID do Ambiente ou Região Jitterbit nesta conexão exigirá que os usuários insiram novamente 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 de um destes locais:
- A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
- A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).
Uma conexão Jitterbit MQ existente pode ser editada nestes locais:
- A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
- A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
- A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).
Configurar uma conexão Jitterbit MQ
Cada elemento da interface do usuário da tela de configuração de conexão do Jitterbit MQ é descrito abaixo.
Dica
Campos com ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [
no campo ou clicando no ícone da variável para exibir uma lista das 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 do Jitterbit MQ, que se refere a uma conexão específica e suas atividades. -
Token de autenticação: Insira um token de autenticação associado ao ambiente. O token de autenticação é gerado nas Filas de mensagens página dentro da aba Tokens de autenticação.
-
Configurações opcionais: Clique para expandir configurações opcionais adicionais:
-
ID do ambiente: Insira o ID do ambiente Harmony para o ambiente que contém a fila de mensagens. O ID do ambiente pode ser encontrado em Ambientes página.
-
Região Jitterbit: Selecione a Região Jitterbit à qual a organização pertence, seja APAC, EMEA ou NA (obrigatório ao usar o agente versão 10.73 ou anterior). Ao usar o agente versão 10.74 ou posterior, a região da organização acessada no momento é selecionada por padrão.
-
ID da organização: Insira o ID da organização Harmony (obrigatório ao usar o agente versão 10.73 ou anterior). Ao usar o agente versão 10.74 ou posterior, este campo pode ser deixado em branco se o Token de Autenticação fornecido acima estiver associado à mesma organização em que o projeto reside. Caso contrário, você deve fornecer o ID da organização à qual o token de autenticação está associado.
-
ID do ambiente: Insira o ID do ambiente Harmony para o ambiente que contém a fila de mensagens (necessário ao usar o agente versão 10.73 ou anterior). Ao usar o agente versão 10.74 ou posterior, o ambiente do projeto será usado quando um ID de ambiente não for especificado.
-
Tempo limite de solicitação de conexão em segundos: Insira o tempo (em segundos) que a conexão deve permanecer estabelecida com o Serviço de fila de mensagens após atender a uma solicitação. O padrão é
10
segundos e o valor máximo permitido é180
segundos. Não é recomendável alterar este valor. -
Tempo limite de resposta em segundos: Insira o tempo (em segundos) de espera por uma resposta do Serviço de fila de mensagens. O padrão é
10
segundos e o valor máximo permitido é300
segundos. -
Tempo limite de conexão em segundos: Insira o tempo (em segundos) de espera até que uma nova conexão seja totalmente estabelecida. O padrão é
10
segundos e o valor máximo permitido é300
segundos. -
Repetir: Marque esta caixa de seleção para tentar estabelecer uma conexão novamente se a primeira tentativa falhar ou expirar durante a execução de uma Obter, Obter em massa ou Obter detalhes da fila atividade. Quando esta caixa de seleção é 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
para5
). -
Intervalo de repetição (em segundos): Insira quantos segundos aguardar entre cada tentativa de conexão (mínimo
1
e máximo5
).
-
-
-
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 permite suspender o download da versão mais recente do conector usando a política da organização Desativar Atualização Automática do Conector.
-
Salvar alterações: Clique para salvar e fechar a configuração de conexão.
-
Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechá-la sem salvar. Uma mensagem solicitará que você confirme se 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 (consulte Dependências, exclusão e remoção de componentes). Uma mensagem solicitará que você confirme se 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 quadro de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
As ações de menu para uma conexão e seus tipos de atividade podem ser acessadas no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.
Estes tipos de atividades estão disponíveis:
-
Obter em Massa: Recupera um lote de mensagens disponíveis em um Jitterbit específico fila de mensagens e se destina a ser usado como fonte em uma operação.
-
Reconhecer: Reconhece mensagens em uma fila de mensagens Jitterbit e se destina a ser usado como alvo em uma operação.
-
Enviar em massa: Envia um lote de mensagens para uma fila de mensagens Jitterbit e se destina a ser usado como alvo em uma operação.
-
Pegar: Recupera uma única mensagem disponível em um Jitterbit específico fila de mensagens e se destina a ser usado como fonte em uma operação.
-
NACK: Reconhece mensagens negativamente (usando o
ackId
) e se destina a ser usado como alvo em uma operação. -
Obter detalhes da fila: Recupera detalhes da fila para um Jitterbit específico fila de mensagens e se destina a ser usado como fonte em uma operação.
-
Enviar: Envia uma única mensagem para uma fila de mensagens Jitterbit e se destina a ser usado como alvo em uma operação.