Ir para o conteúdo

Conector de Eventos do Salesforce para Jitterbit Integration Studio

Resumo

O conector de Eventos do Salesforce estabelece acesso a Eventos da Plataforma Salesforce e Eventos de Captura de Dados de Mudança (CDC) do Salesforce em uma instância do Salesforce.

O conector de Eventos do Salesforce fornece uma interface para criar uma conexão de Eventos do Salesforce, a base utilizada para gerar instâncias de atividades de Eventos do Salesforce. Essas atividades, uma vez configuradas, interagem com os Eventos do Salesforce por meio da conexão.

O conector de Eventos do Salesforce é acessado na aba Endpoints e conectores do projeto da paleta de componentes de design (veja Paleta de componentes de design).

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão de Eventos do Salesforce. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntos, uma conexão específica de Eventos do Salesforce e suas atividades são referidos como um endpoint de Eventos do Salesforce:

Tipos de atividades de Eventos do Salesforce

  • Assinar Evento: Recebe um evento de plataforma ou um evento CDC do Salesforce e se destina a ser usado como uma fonte em uma operação.

  • Assinar Evento CDC de Inserção: Recebe um evento CDC de inserção do Salesforce e se destina a ser usado como uma fonte em uma operação.

  • Publicar Evento: Publica um evento de plataforma no Salesforce e é destinado a ser usado como um alvo em uma operação.

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

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

Nota

Este conector é um conector baseado no Connector SDK, que pode ser referido pela Jitterbit ao comunicar alterações feitas em conectores construídos com o Connector SDK.

A classe de licença deste conector é Enterprise, disponível como um complemento à sua assinatura do Harmony iPaaS. Para habilitá-lo, entre em contato com seu Gerente de Sucesso do Cliente. Os endpoints criados com este conector estão incluídos na reportagem de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

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

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

Solução de Problemas

Se você encontrar problemas com o conector de Eventos do Salesforce, estas etapas de solução de problemas são recomendadas:

  1. Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada para o 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 registro de depuração da 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 registro 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 o registro detalhado do conector, consulte Registro 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 solução de problemas, consulte Solução de problemas de operação.

Problemas comuns com atividades de escuta (Assinar evento, Assinar evento de inserção cdc, Assinar evento de atualização cdc ou Assinar evento de exclusão cdc) são descritos abaixo.

Problema Causa Solução alternativa
Eventos não podem ser ativados ou desativados. O agente privado foi recentemente instalado ou reiniciado. Abra a configuração da conexão e teste a conexão para forçar o conector a ser baixado para o agente.
Eventos não podem ser ativados.

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 da conexão está correta.
Eventos não podem ser ativados. 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 medição como $ e % não são retornados devido ao design da API do Salesforce. Nenhuma.
Valores nulos são retornados na resposta. Para atividades de CDC, campos não modificados são retornados como nulos na resposta devido ao design da API do Salesforce. Nenhuma.