Ir para o conteúdo

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

Visão geral

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

Requisitos do sistema

Servidor de banco de dados

Conta do Salesforce com ADO.NET

Navegador da web do cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instruções de conexão

O seguinte passo é um pré-requisito e deve ser concluído no aplicativo Salesforce ou no ambiente sandbox.

Criar um aplicativo OAuth personalizado no Salesforce

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

  2. Na página inicial, vá para Ferramentas da Plataforma > Aplicativos > Gerenciador de Aplicativos

  3. Clique no botão Novo Aplicativo Conectado

  4. Insira um Nome para exibir aos usuários quando eles fizerem login para conceder permissões ao seu aplicativo, juntamente com um endereço de Email de contato

  5. Clique em Ativar Configurações OAuth

  6. Insira um valor no campo URL de Retorno. Este deve ser o URL da sua instância do App Builder com um Provedor de Segurança anexado.

    Nota

    A sensibilidade a maiúsculas e minúsculas é importante, portanto, o nome do provedor de segurança que criamos a seguir deve corresponder à sensibilidade a maiúsculas e minúsculas na URL de Retorno.

  7. Escopos OAuth Selecionados devem ser definidos para o escopo de permissões que o aplicativo deve solicitar ao usuário.

    1. Defina como "Acesso total (full)" e "Realizar solicitações a qualquer momento (refresh_token,offline_acesss)"

    Interface gráfica do usuário, descrição do aplicativo gerada automaticamente

  8. Clique em Gerenciar Detalhes do Consumidor para visualizar o ID do Cliente e o valor do Segredo. Anote esses valores em um local que possa ser facilmente referenciado ao configurar a partir do App Builder.

Criar um provedor de segurança OAuth no App Builder

  1. Configure um Provedor de Segurança no App Builder navegando até IDE > Provedores de Segurança

  2. Clique no botão + Autenticação de Fonte de Dados

  3. Forneça os seguintes detalhes:

    • Nome: Identifica o Provedor de Segurança e aparece na URL ocasionalmente. Exemplo: Salesforce

    • Tipo: OAuth

    • Tipo de Autenticação: OAuth

    • Concessão OAuth: Código de Autorização

    • Autenticação do Cliente OAuth: Básica

    • Autenticação de Recurso OAuth: Bearer

    • Proprietário do Token: Usuário

    • Redirecionar em Desafio: Verdadeiro

    attachment

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

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

    • Tipo: Cliente

    • Nome de Usuário: ID do Cliente do Salesforce

    • Senha: Segredo do Salesforce

  6. Clique em + Reivindicação e crie os seguintes 3 registros para provisionamento de usuários:

    • Nome: preferred_username

    • Nome ID: preferred_username

    • Endereço de Email: email

attachment

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

  1. Vá para o IDE do App Builder e clique em Servidores de Dados

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

  3. Atribua um Nome de 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 como o que criamos. Exemplo: SalesForce

    attachment

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

attachment

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

Nota

Uma importação das tabelas do Salesforce precisará ser realizada para acessá-las a partir do App Builder.

Solução de Problemas

Se você encontrar problemas com o Salesforce ADO.NET, estas etapas de solução de problemas são recomendadas:

  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 CData ADO.NET Provider for Salesforce para informações detalhadas.

Recursos