Acesso ao Salesforce para o Data Foundation
O Data Foundation reúne os dados de todos os sistemas que ligar, em tantas instâncias quantas tiver, num único Common Finance Model. O Salesforce é um dos sistemas que lê diretamente. O Salesforce é uma origem de CRM, não um razão: fornece clientes, produtos e o pipeline de vendas, nunca lançamentos do razão geral. Esta página destina-se ao administrador do Salesforce que configura o acesso e ao utilizador do PlaidCloud que lho pede.
O PlaidCloud só lê dados. Ninguém envia uma palavra-passe ou um token de segurança por email.
Enviar o pedido de acesso
Seção intitulada “Enviar o pedido de acesso”No separador Base do projeto, escolha Criar uma nova ligação e selecione Salesforce. O formulário mostra o pedido completo. Clique em Copiar pedido para o colar na sua própria mensagem, ou em Enviar pedido por email para o abrir no seu programa de correio 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 uma External Client App em Setup > Apps > External Client Apps > New, ou uma Connected App se a sua organização ainda as tiver:
- Ative as definições de OAuth e assinale apenas Enable Client Credentials Flow (sem fluxo de código de autorização nem de palavra-passe).
- Âmbito OAuth: Manage user data via APIs (
api). - Run As: um utilizador de integração dedicado (passo 2).
-
Atribuir ao utilizador de integração um perfil ou conjunto de permissões com:
- API Enabled
- Leitura em Account (incluindo o campo Número da conta), Product2, Opportunity, OpportunityLineItem e Organization (para a moeda predefinida)
- View All Data, ou partilha que lhe permita ver todas as oportunidades sobre as quais reporta
O Salesforce limita todas as linhas e campos que o PlaidCloud pode ler ao que este utilizador consegue ver.
-
Copiar a Consumer Key (ID do cliente) e o Consumer Secret da aplicação, e o URL My Domain da organização, por exemplo
https://yourcompany.my.salesforce.com.
O que enviar de volta
Seção intitulada “O que enviar de volta”| O administrador envia | Introduzido no PlaidCloud como |
|---|---|
| O URL My Domain | My Domain URL |
| O ID do cliente (Consumer Key) | ID do cliente |
| O segredo do cliente (Consumer Secret), através do formulário de ligação seguro, não por email | Segredo do cliente |
Em Entidade, introduza em Nome a entidade a que pertence o pipeline da organização do Salesforce: uma organização não tem entidades para listar. Uma organização é uma entidade, pelo que duas organizações são duas ligações.
Verificar o acesso
Seção intitulada “Verificar o acesso”De volta ao PlaidCloud, clique em Testar ligação. Cada conjunto de dados aparece como Legível, Permissão em falta ou Erro:
| Conjunto de dados | O que lê no Salesforce |
|---|---|
| Clientes | Account |
| Produtos | Product2 |
| Pipeline | Opportunity e OpportunityLineItem, com os números de conta |
Os três são opcionais. Quando um mostra Permissão em falta, peça ao administrador que adicione ao utilizador de integração o acesso de leitura a esse objeto e teste novamente.
Os montantes do pipeline estão na moeda da oportunidade. Uma organização que utilize uma só moeda não tem esse campo, pelo que o PlaidCloud utiliza a moeda predefinida da organização a partir de Organization e, caso contrário, a moeda da entidade.