Conexão Salesforce Events no Jitterbit Studio

Introdução

Uma conexão Salesforce Events, criada usando o conector Salesforce Events, estabelece acesso a Salesforce Platform Events e Salesforce Change Data Capture Events em uma instância do Salesforce. Após configurar uma conexão, é possível criar instâncias de atividades Salesforce Events associadas a essa conexão, para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Criar ou editar uma conexão Salesforce Events

Uma nova conexão Salesforce Events é criada usando o conector Salesforce Events de um destes locais:

• A aba Project endpoints and connectors da paleta de componentes de design (consulte Design component palette).
• A página Global Endpoints (consulte Create a global endpoint em Global Endpoints).

Uma conexão Salesforce Events existente pode ser editada nestes locais:

• A aba Project endpoints and connectors da paleta de componentes de design (consulte Design component palette).
• A aba Components do painel de projeto (consulte Component actions menu em Project pane Components tab).
• A página Global Endpoints (consulte Edit a global endpoint em Global Endpoints).

Configurar uma conexão Salesforce Events

Cada elemento da interface do usuário da tela de configuração da conexão Salesforce Events é descrito abaixo.

• Connection name: Digite um nome para identificar a conexão. O nome deve ser único para cada conexão Salesforce Events e não deve conter barras / ou dois-pontos :. Este nome também é usado para identificar o endpoint Salesforce Events, que se refere a uma conexão específica e suas atividades.

• Host: Digite a URL de login da organização Salesforce sandbox ou produção.

• Authentication: Selecione o método de autenticação para usar na conexão com o Salesforce.

  • Username-Password: (Padrão.) Selecione esta opção para autenticar usando um nome de usuário e senha do Salesforce:

    • Username: Digite o nome de usuário associado à conta Salesforce.

    • Password: Digite a senha associada à conta Salesforce.

    • Security token: Digite o security token associado à conta Salesforce.

• Chave do consumidor: Digite a chave do consumidor do aplicativo conectado do Salesforce (consulte Pré-requisitos).

  -   **Segredo do consumidor:** Digite o segredo do consumidor do aplicativo conectado do Salesforce (consulte [Pré-requisitos](/pt/integration-studio/design/connectors/salesforce-events/prerequisites/#key-secret)).
  
  -   **Tipo de concessão:** Digite um tipo de concessão de `password`.
  

  • Credenciais do cliente: Selecione esta opção para fazer autenticação usando a chave do consumidor e o segredo de um aplicativo cliente externo do Salesforce ou um aplicativo conectado (autenticação de máquina para máquina). O Salesforce exige que o fluxo de credenciais do cliente OAuth 2.0 use a URL do Meu Domínio da sua organização em vez do servidor de login genérico, então configure o Host acima para uma URL como https://exampleDomain.my.salesforce.com em vez do valor padrão:

    • Chave do consumidor: Digite a chave do consumidor de um aplicativo cliente externo do Salesforce ou um aplicativo conectado configurado para o fluxo de credenciais do cliente OAuth 2.0. Para instruções sobre como configurar o aplicativo e obter esse valor, consulte Pré-requisitos do OAuth 2.0 com duas pernas para conectores baseados em Salesforce.

    • Segredo do consumidor: Digite o segredo do consumidor do mesmo aplicativo cliente externo do Salesforce ou aplicativo conectado.

  • JWT Bearer: Selecione esta opção para fazer autenticação usando uma asserção JWT auto-assinada assinada com uma chave privada (autenticação de servidor para servidor que não requer uma senha):

    • Nome de usuário: Digite o nome de usuário associado à conta do Salesforce.

    • Chave do consumidor: Digite a chave do consumidor de um aplicativo conectado do Salesforce configurado para o fluxo JWT bearer do OAuth 2.0. Para mais informações, consulte a documentação do Salesforce sobre Fluxo JWT Bearer do OAuth 2.0 para Integração de Servidor para Servidor.

    • Chave privada: Digite a chave privada que corresponde ao certificado digital carregado no aplicativo conectado do Salesforce, neste formato:

      -----BEGIN PRIVATE KEY-----
      
      <private key>
      
      -----END PRIVATE KEY-----
      

      Substitua <private key> (incluindo os colchetes angulares < >) pelo valor apropriado. Uma chave privada PKCS1 no formato -----BEGIN RSA PRIVATE KEY----- também é compatível.

• Versão da API: Digite a versão da API REST do Salesforce em formato numérico (54, 56, etc.). Por padrão, este campo é preenchido automaticamente com a versão 63.

• Testar: 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 oferece suporte à suspensão do download da versão mais recente do conector usando a política de organização Desabilitar Atualização Automática do Conector.

• Salvar alterações: Clique para salvar e fechar a configuração de conexão.

• Descartar alterações: Depois de fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

• Excluir: Depois de 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 solicita que você confirme que deseja excluir a conexão.

Próximas etapas

Depois que uma conexão Salesforce Events tiver sido criada, coloque um tipo de atividade na tela 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 de uma conexão e seus tipos de atividade são acessíveis no painel de projeto e na paleta de componentes de design. Para mais detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividade estão disponíveis:

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

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

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

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

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