Conector Salesforce Events no Jitterbit Studio
Resumo
O conector Salesforce Events estabelece acesso a Salesforce Platform Events e 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 utilizada para gerar instâncias de atividades Salesforce Events. Essas atividades, uma vez configuradas, interagem com Salesforce Events por meio da conexão.
Acessa-se o conector Salesforce Events a partir da aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (veja Design component palette).
Visão geral do conector
Este conector é usado para primeiro configurar uma conexão Salesforce Events. Os tipos de atividade associados a essa conexão são então utilizados para criar instâncias de atividades destinadas a serem usadas como origens (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:

-
Subscribe Event: Recebe um evento de plataforma ou um evento CDC do Salesforce e destina-se a ser usado como origem em uma operação.
-
Subscribe Insert CDC Event: Recebe um evento CDC de inserção do Salesforce e destina-se a ser usado como origem em uma operação.
-
Publish Event: Publica um evento de plataforma no Salesforce e destina-se a ser usado como destino em uma operação.
-
Subscribe Update CDC Event: Recebe um evento CDC de atualização do Salesforce e destina-se a ser usado como origem em uma operação.
-
Subscribe Delete CDC Event: Recebe um evento CDC de exclusão do Salesforce e destina-se a ser usado como origem em uma operação.
A classe de licença deste conector é Enterprise, disponível como um complemento de 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, você pode 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 de Salesforce Events.
O conector Salesforce Events utiliza a versão da API REST do Salesforce especificada na conexão. A versão padrão é 63.0. Consulte a documentação da API para obter informações sobre nós de esquema e campos.
Resolução de problemas
Se você tiver problemas com o conector Salesforce Events, recomenda-se executar estas etapas de resolução de problemas:
-
Clique no botão Test na configuração da conexão para garantir que a conexão seja bem-sucedida e 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).
-
Verifique os logs de operação para qualquer informação registrada durante a execução da operação.
-
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.
-
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.xmldo seu agente privado:<logger name="org.jitterbit.connector.platformevents" level="DEBUG"/>Para mais informações sobre o log detalhado do conector, consulte Log detalhado para conectores que usam agentes privados Jitterbit.
-
Se estiver usando agentes privados, você pode verificar os logs do agente para obter mais informações.
-
Para outras considerações de resolução de problemas, consulte Resolução de problemas de operação.
Os 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) sã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: |
Confirme que 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. |
| Não é possível ativar eventos. | O objeto não está selecionado para Captura de Dados de Alteração no Salesforce. Neste caso, os seguintes detalhes de erro serão retornados: |
Adicione o objeto a Entidades Selecionadas no Salesforce, conforme descrito em Selecionar as entidades que geram eventos. |
| 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. |