O que é preciso
- Um utilizador da org Salesforce que quer conectar, por exemplo a sandbox de UAT. Use um administrador Salesforce ou um utilizador que possa aprovar apps que ainda não estão instaladas na org.
- Direitos de administrador no seu workspace do UAT Studio.
- A sua org só permite a sua própria página de entrada? Então tenha à mão o endereço My Domain dela, por exemplo yourcompany--uat.sandbox.my.salesforce.com.
Conectar uma org
Adicionar o Salesforce no UAT Studio
No UAT Studio, abra o seu workspace e clique em Connections. Em Add a connection, escolha Salesforce e clique em Add. Dê à integração um nome que diga qual é a org, por exemplo Salesforce · UAT sandbox, e clique em Save settings.
Entrar no Salesforce
- Em Where to sign in, escolha Sandbox (test.salesforce.com) para uma sandbox, Production or Developer Edition (login.salesforce.com) para produção, ou My Domain address of the org e preencha esse endereço.
- Clique em Connect Salesforce. Abre-se a página de entrada do Salesforce.
- Entre com um utilizador dessa org. O Salesforce pergunta se o UAT Studio pode ter acesso: clique em Allow.
- Volta a Connections. O cartão mostra Connected, o nome da org, Sandbox ou Production e o utilizador que fez a conexão.
Testa mais orgs, por exemplo uma sandbox de UAT e uma sandbox de formação? Adicione o Salesforce mais uma vez para cada org.
Escolher a org por projeto
Abra o projeto e vá a Setup. Defina CRM como Salesforce e depois escolha a org em Salesforce org. A escolha é guardada de imediato.
Testar, conectar de novo, desconectar
| Botão | O que faz |
|---|---|
| Test connection | Entra de novo na org e mostra o nome dela. O cartão mostra quando a integração foi usada pela última vez. |
| Connect again | Entra de novo, por exemplo com outro utilizador ou depois de o acesso ter sido revogado. |
| Disconnect | Revoga o acesso no Salesforce e esquece-o no UAT Studio. Os projetos mantêm a sua escolha, por isso conectar de novo repõe tudo. |
| Remove | Elimina a integração; os projetos que a usavam deixam de ter uma org. |
Quem pode fazer o quê
Se algo falhar
| Vê | O que fazer |
|---|---|
| O Salesforce diz que o utilizador não pode aprovar a app | A sua org só deixa alguns utilizadores aprovar apps que ainda não estão instaladas. Entre com um administrador Salesforce ou peça ao seu administrador a permissão Approve Uninstalled Connected Apps. |
| O Salesforce não recebeu acesso | Clicou em Deny ou fechou a página. Clique em Connect Salesforce e escolha Allow. |
| A página de entrada diz que o endereço não é válido | Escolha o local certo em Where to sign in: uma sandbox entra em test.salesforce.com. Com My Domain, preencha o endereço sem o caminho, como yourcompany.my.salesforce.com. |
| Conexão perdida | O Salesforce já não aceita o acesso: expirou, ou alguém o revogou no Salesforce. Clique em Connect Salesforce para entrar de novo. |
| A entrada demorou demasiado | Comece de novo com Connect Salesforce e conclua a entrada em 15 minutos. |
Continua com dificuldades? Escreva para [email protected] com a mensagem que vê. Nunca nos envie uma senha.
Como tratamos o acesso
- Entra na página do próprio Salesforce (OAuth com PKCE). O UAT Studio nunca vê a sua senha do Salesforce.
- O UAT Studio só pede acesso à API do Salesforce e para se manter conectado, para que não tenha de entrar de novo sempre.
- O acesso é guardado encriptado (AES-256) no nosso servidor, nunca no navegador. A chave para o desencriptar é guardada separadamente da base de dados. Ninguém o pode voltar a ler: nem na app, nem através do suporte.
- O seu administrador Salesforce vê o UAT Studio no Salesforce em Setup › Connected Apps OAuth Usage e pode revogá-lo aí; Disconnect no UAT Studio faz o mesmo.
