Ir para o conteúdo

Conector Salesforce Events no Jitterbit Studio

Resumo

O conector Salesforce Events estabelece acesso aos Salesforce Platform Events e aos Salesforce Change Data Capture (CDC) Events em uma instância do Salesforce.

O conector Salesforce Events fornece uma interface para criar uma conexão Salesforce Events, a base usada para gerar instâncias de atividades Salesforce Events. Essas atividades, uma vez configuradas, interagem com Salesforce Events através da conexão.

O conector Salesforce Events é acessado a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão Salesforce Events. 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).

Juntos, uma conexão Salesforce Events específica e suas atividades são chamados de endpoint Salesforce Events:

Tipos de atividade Salesforce Events

  • Subscribe Event: Recebe um evento de plataforma ou um evento CDC do Salesforce e é destinado a ser usado como uma fonte em uma operação.

  • Subscribe Insert CDC Event: Recebe um evento CDC de inserção do Salesforce e é destinado a ser usado como uma fonte em uma operação.

  • Publish Event: Publica um evento de plataforma no Salesforce e é destinado a ser usado como um destino em uma operação.

  • Subscribe Update CDC Event: Recebe um evento CDC de atualização do Salesforce e é destinado a ser usado como uma fonte em uma operação.

  • Subscribe Delete CDC Event: Recebe um evento CDC de exclusão do Salesforce e é destinado a ser usado como uma fonte em uma operação.

A classe de licença deste conector é Enterprise, disponível como um complemento à sua assinatura Harmony iPaaS. Para habilitá-la, entre em contato com seu Customer Success Manager. Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

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 Disable Auto Connector Update.

Os pré-requisitos para usar o conector Salesforce Events estão descritos em Pré-requisitos do Salesforce Events.

O conector Salesforce Events usa a versão da Salesforce REST API especificada na conexão. A versão padrão é 63.0. Consulte a documentação da API para obter informações sobre os nós de esquema e campos.

Solução de problemas

Se você enfrentar problemas com o conector Salesforce Events, recomenda-se seguir estas etapas de solução de problemas:

  1. Clique no botão Test (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 organizacional Disable Auto Connector Update).

  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 na 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.platformevents" 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.

Problemas comuns com atividades de escuta (Inscrever evento, Inscrever evento CDC de inserção, Inscrever evento CDC de atualização ou Inscrever evento CDC de exclusão) estão descritos abaixo.

Problema Causa Solução
Não é possível ativar ou desativar eventos. O agente privado foi instalado ou reiniciado recentemente. Abra a configuração de conexão e teste a conexão para forçar o download do conector para o agente.
Não é possível ativar eventos.

As credenciais de conexão do Salesforce podem estar bloqueadas ou incorretas.

Neste caso, os seguintes detalhes de erro serão retornados: Unable to login; INVALID_LOGIN: Invalid username, password, security token; or user locked out.

Confirme se a configuração de conexão está correta.
Não é possível ativar eventos. O número máximo de clientes (assinantes) permitido pela instância do Salesforce foi atingido. Nenhuma.
Unidades de medida não são retornadas na resposta. Símbolos de medida como $ e % não são retornados devido ao design da API do Salesforce. Nenhuma.
Valores nulos são retornados na resposta. Para atividades CDC, campos não modificados são retornados como nulos na resposta devido ao design da API do Salesforce. Nenhuma.