Ir para o conteúdo

Guia de conexão Salesforce ADO.NET para Jitterbit App Builder

Visão geral

Este guia descreve os requisitos de sistema e as instruções para conectar o App Builder a uma fonte de dados Salesforce ADO.NET. Essa conexão utiliza um Provedor de Segurança OAuth com o tipo de concessão Authorization Code.

Requisitos de sistema

Servidor de banco de dados

Conta Salesforce com ADO.NET

Navegador web do cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instruções de conexão

A etapa a seguir é um pré-requisito e deve ser concluída no ambiente do app ou sandbox do Salesforce.

Criar um app OAuth personalizado no Salesforce

  1. Faça login em Salesforce.com ou no seu ambiente sandbox do Salesforce

  2. Na página inicial, acesse Platform Tools > Apps > App Manager

  3. Clique no botão New Connected App

  4. Digite um Name para exibir aos usuários quando fizerem login para conceder permissões ao seu app, junto com um endereço de Email de contato

  5. Clique em Enable OAuth Settings

  6. Digite um valor no campo Callback URL. Deve ser a URL da sua instância do App Builder com um Security Provider anexado.

    Nota

    A sensibilidade a maiúsculas e minúsculas é importante, portanto o nome do security provider que criaremos a seguir deve corresponder à sensibilidade a maiúsculas e minúsculas na Callback URL.

  7. Selected OAuth Scopes deve ser configurado com o escopo de permissões que o aplicativo deve solicitar ao usuário.

    1. Defina como "Full access (full)" e "Perform requests at any time (refresh_token,offline_acesss)"

    Graphical user interface, application Description automatically generated

  8. Clique em Manage Consumer Details para visualizar o valor de Client ID e Secret. Anote esses valores em um local que possa ser facilmente consultado ao configurar no App Builder.

Criar um security provider OAuth no App Builder

  1. Configure um Security Provider no App Builder navegando até IDE > Security Providers

  2. Clique no botão + Security Provider

  3. Forneça os seguintes detalhes:

    • Name: Identifica o Security Provider e aparece na URL ocasionalmente. Exemplo: Salesforce

    • Type: OAuth

    • Authentication Type: OAuth

    • OAuth Grant: Authorization Code

    • OAuth Client Authentication: Basic

    • OAuth Resource Authentication: Bearer

    • Token Owner: User

    • Redirect on Challenge: True

    attachment

  4. Clique em + Endpoints e configure os 3 registros a seguir:

  5. Clique em + Credential e crie o seguinte registro:

    • Type: Client

    • User Name: Client ID do Salesforce

    • Password: Secret do Salesforce

  6. Clique em + Claim e crie os 3 registros a seguir para provisionamento de usuários:

    • Name: preferred_username

    • Name ID: preferred_username

    • E-mail Address: email

attachment

Criar a fonte de dados Salesforce ADO.NET no App Builder

  1. Acesse o App Builder IDE e clique em Data Servers

  2. Clique no botão + Server para adicionar uma nova fonte de dados

  3. Atribua um Nome do Servidor. Este nome deve corresponder à URL de Callback configurada no Salesforce. Exemplo: SalesForce

  4. Selecione o Tipo como Salesforce ADO.NET

  5. Expanda as Configurações de Segurança e defina o Provedor de Segurança para aquele que criamos. Exemplo: SalesForce

    attachment

  6. Por fim, se estiver usando um ambiente de sandbox do Salesforce, clique no botão Configurações Avançadas e configure a URL do servidor OAuth

attachment

  1. Expanda Testes e clique no botão Testar Conexão para garantir que a configuração está funcionando conforme esperado.

Nota

Será necessário realizar uma importação das tabelas do Salesforce para acessá-las no App Builder.

Solução de Problemas

Se encontrar problemas com o Salesforce ADO.NET, recomenda-se seguir estas etapas de solução de problemas:

  1. Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.

  2. Consulte a documentação do Provedor CData ADO.NET para Salesforce para obter informações detalhadas.

Recursos