Ir para o conteúdo

Conector Jitterbit MQ no Jitterbit Studio

Resumo

O conector Jitterbit MQ estabelece acesso ao serviço de fila de mensagens Jitterbit.

O conector Jitterbit MQ fornece uma interface para criar uma conexão Jitterbit MQ, a base usada para gerar instâncias de atividades Jitterbit MQ. Essas atividades, uma vez configuradas, interagem com o Serviço de Fila de Mensagens Jitterbit através da conexão.

Acessa-se o conector Jitterbit MQ pela aba Endpoints e conectores do projeto da paleta de componentes de design (consulte Paleta de componentes de design).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão Jitterbit MQ. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Em conjunto, uma conexão Jitterbit MQ específica e suas atividades são chamadas de endpoint Jitterbit MQ:

Tipos de atividade Jitterbit MQ

  • Get Bulk: Recupera um lote de mensagens disponíveis em uma fila de mensagens Jitterbit específica e destina-se a ser usado como fonte em uma operação.

  • Acknowledge: Confirma mensagens em uma fila de mensagens Jitterbit e destina-se a ser usado como destino em uma operação.

  • Send Bulk: Envia um lote de mensagens para uma fila de mensagens Jitterbit e destina-se a ser usado como destino em uma operação.

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

  • NACK: Nega confirmação de mensagens (usando o ackId) e destina-se a ser usado como destino em uma operação.

  • Get Queue Details: Recupera detalhes da fila para uma fila de mensagens Jitterbit específica e destina-se a ser usado como fonte em uma operação.

  • Send: Envia uma única mensagem para uma fila de mensagens Jitterbit e destina-se a ser usado como destino em uma operação.

Os endpoints criados com este conector são excluídos do relatório de uso de endpoints e da contagem de licenças.

Pré-requisitos e versões de API suportadas

Este conector pode ser usado com agentes na nuvem e agentes privados.

Os agentes baixam automaticamente a versão mais recente deste conector quando necessário. Em agentes privados, é possível suspender essas atualizações com a política organizacional Desabilitar Atualização Automática de Conector.

Nota

Se usar um agente privado que está atrás de um firewall em sua rede, é necessário adicionar à lista de permissões o serviço de fila de mensagens.

Solução de problemas

Se o número de mensagens exceder o limite de mensagens definido pelo usuário para uma fila de mensagens individual, este erro de tempo de execução será retornado:

"statuscode":500,"Error":"Error sending message."

Para resolver, você pode precisar confirmar mensagens na fila ou ajustar o limite de mensagens. O limite de mensagens definido pelo usuário é configurado na página Filas de mensagens do Console de Gerenciamento, na aba Filas de mensagens. Ajuste o valor no campo Limite de Mensagens, disponível em Opções Avançadas de uma fila.

Se você enfrentar outros problemas com o conector, recomenda-se seguir estas etapas de resolução de problemas:

  1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política de organização Desabilitar Atualização Automática do Conector).

  2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  3. Ative o log de depuração de operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

  4. Se estiver usando agentes privados, você pode ativar o log detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:

    <logger name="org.jitterbit.connector.jbmq" level="DEBUG"/>
    

    Para mais informações sobre log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

  5. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

  6. Para considerações adicionais de resolução de problemas, consulte Resolução de problemas de operação.