Acesso ao Salesforce para o Data Foundation
O Data Foundation reúne os dados de todos os sistemas que você conecta, em quantas instâncias você tiver, em um único Common Finance Model. O Salesforce é um dos sistemas que ele lê diretamente. O Salesforce é uma fonte de CRM, não um razão: ele fornece clientes, produtos e o funil de vendas, nunca lançamentos do razão geral. Esta página é para o administrador do Salesforce que configura o acesso e para o usuário do PlaidCloud que o solicita a ele.
O PlaidCloud apenas lê dados. Ninguém envia uma senha ou um token de segurança por e-mail.
Enviar a solicitação de acesso
Seção intitulada “Enviar a solicitação de acesso”Na guia Foundation do projeto, escolha Criar uma nova conexão e selecione Salesforce. O formulário mostra a solicitação completa. Clique em Copiar solicitação para colá-la na sua própria mensagem ou em Enviar solicitação por e-mail para abri-la no seu programa de e-mail com o assunto “Read-only Salesforce access for PlaidCloud (OAuth 2.0 client credentials).”
O que o administrador do Salesforce configura
Seção intitulada “O que o administrador do Salesforce configura”-
Criar um External Client App em Setup > Apps > External Client Apps > New, ou um Connected App se a sua organização ainda os tiver:
- Ative as configurações de OAuth e marque somente Enable Client Credentials Flow (sem fluxo de código de autorização nem de senha).
- Escopo OAuth: Manage user data via APIs (
api). - Run As: um usuário de integração dedicado (etapa 2).
-
Dar ao usuário de integração um perfil ou conjunto de permissões com:
- API Enabled
- Leitura em Account (inclusive o campo Account Number), Product2, Opportunity, OpportunityLineItem e Organization (para a moeda padrão)
- View All Data, ou um compartilhamento que permita enxergar todas as oportunidades sobre as quais você gera relatórios
O Salesforce limita toda linha e todo campo que o PlaidCloud pode ler ao que esse usuário consegue ver.
-
Copiar a Consumer Key (ID do cliente) e o Consumer Secret do aplicativo, e o URL do My Domain da organização, por exemplo
https://yourcompany.my.salesforce.com.
O que devolver
Seção intitulada “O que devolver”| O administrador envia | Informado no PlaidCloud como |
|---|---|
| O URL do My Domain | URL do My Domain |
| O ID do cliente (Consumer Key) | ID do cliente |
| O segredo do cliente (Consumer Secret), pelo formulário de conexão seguro, não por e-mail | Segredo do cliente |
Em Entidade, informe em Nome a entidade à qual pertence o funil de vendas da organização do Salesforce: uma organização não tem entidades para listar. Uma organização é uma entidade, então duas organizações são duas conexões.
Verificar o acesso
Seção intitulada “Verificar o acesso”De volta ao PlaidCloud, clique em Testar conexão. Cada conjunto de dados aparece como Legível, Permissão ausente ou Erro:
| Conjunto de dados | O que ele lê no Salesforce |
|---|---|
| Clientes | Account |
| Produtos | Product2 |
| Funil de vendas | Opportunity e OpportunityLineItem, com os números de conta |
Os três são opcionais. Quando um deles mostra Permissão ausente, peça ao administrador que adicione ao usuário de integração o acesso de leitura a esse objeto e teste novamente.
Os valores do funil de vendas estão na moeda da oportunidade. Uma organização que usa uma única moeda não tem esse campo, então o PlaidCloud usa a moeda padrão da organização, obtida de Organization, e, na falta dela, a moeda da entidade.