Definir uma origem de dados externa para o adaptador entre organizações do Salesforce Connect
Configure uma conexão de sua organização assinante para outra organização do Salesforce para que seus usuários possam acessar seus dados por meio de objetos externos.
Edições obrigatórias
| Disponível em: Salesforce Classic e Lightning Experience (não para objetos externos de alto volume de dados) |
Disponível em: Developer Edition Disponível por um custo extra em: Enterprise, Performance e Unlimited Editions |
| Permissões necessárias ao usuário | |
|---|---|
| Para criar e editar origens de dados externas: | Personalizar aplicativo |
- Em Configuração, insira Origens de dados externas na caixa Busca rápida e selecione Origens de dados externas.
- Clique em Novo Origem de dados externa, ou clique em Editar para modificar uma origem de dados externa existente.
-
Preencha os campos.
-
Selecione o método de autenticação, que especifica como a organização assinante autentica com a organização de destino. Recomendamos usar credenciais nomeadas para uma autenticação robusta e segura.
- Se você selecionar Credencial nomeada, selecione a credencial nomeada a ser usada no campo Credencial nomeada.
- Se você selecionar Legado, selecione o Tipo de identidade. O tipo de identidade determina se a organização assinante usa um ou vários conjuntos de credenciais para acessar a organização provedora. Consulte Tipo de identidade para origens de dados externas.
-
Se você selecionou Legado, selecione o protocolo de autenticação.
- Se você selecionar Autenticação por senha, insira o nome de usuário e a senha para acessar o sistema externo.
- Se você selecionar OAuth 2.0, preencha os campos a seguir.
Campo Descrição Provedor de autenticação Selecione um provedor de autenticação do Salesforce. Consulte Configurar um provedor de autenticação Salesforce. Em uma organização de produção, uma origem de dados externa não pode usar um provedor de autenticação que direciona solicitações de autorização ou de token a uma organização sandbox. Da mesma forma, em uma organização sandbox, uma origem de dados externa não pode usar um provedor de autenticação que direciona solicitações de autorização ou de token a uma organização de produção. Escopo Especifica o escopo de permissões a solicitar para o token de acesso. Seu provedor de autenticação determina os valores permitidos. Consulte Usar o parâmetro de escopo.
Considere estas considerações ao definir um escopo.
- O valor que você insere substitui o valor de Escopos padrão definido no provedor de autenticação especificado.
- Se os escopos são definidos pode afetar se cada fluxo do OAuth solicita ao usuário uma página de consentimento.
- Recomendamos que você solicite um token de atualização ou acesso offline. Do contrário, quando o token expirar, você perderá o acesso ao sistema externo.
Iniciar fluxo de autenticação ao salvar Para autenticar para o sistema externo e obter um token OAuth, marque essa caixa de seleção. Esse processo de autenticação é conhecido como fluxo de OAuth.
Quando você clicar em Salvar, o sistema externo solicitará que você efetue login. Após o login bem-sucedido, o sistema externo lhe concederá um token OAuth para acessar seus dados a partir dessa organização.
Refaça o fluxo de OAuth quando precisar de um novo token (por exemplo, se o token expirar) ou se você editar os campos Escopo ou Provedor de autenticação. Quando o token expira, o sistema externo retorna um status de erro 401 HTTP.
- Clique em Salvar.
-
Clique em Validar e sincronizar e confirme que a conexão foi bem-sucedida.
- Se você receber uma mensagem de erro, consulte estes recursos: As seções “Códigos de status e respostas de erro” no Guia do desenvolvedor da API REST e as seções “Elemento de falha da API”, “ExceptionCode”, “Erro” e “StatusCode” das seções “Tipo de dados essenciais usados em chamadas à API” no Guia do desenvolvedor da API SOAP.
- Da versão Winter '26 em diante (API versão 65.0), o método SOAP API login() está desabilitado por padrão em novas organizações. Se você encontrar um erro INVALID_OPERATION ao usar a autenticação por senha, use a API versão 64.0 ou anterior e habilite manualmente o login() da API SOAP em Configuração para resolvê-lo. Consulte login().
-
Como opção, selecione as tabelas e clique em Sincronizar para fazer o seguinte em cada tabela selecionada.
- Criar automaticamente um objeto externo do Salesforce.
- Criar automaticamente um campo personalizado para cada coluna de tabela compatível com um tipo de campo de metadados do Salesforce.
Em vez disso, você pode optar por criar manualmente os objetos externos e campos personalizados que são mapeados aos dados externos. Isso lhe permite personalizar os nomes de objetos externos, decidir para quais colunas de tabela serão criados campos personalizados e personalizar os nomes de campos personalizados. No entanto, essa abordagem toma mais tempo e requer manutenção manual.
Nota Revise estas considerações antes de sincronizar.
Consulte também:
- Configurar o Salesforce Connect para acessar dados em outra organização com o adaptador entre organizações
- Configurações de autenticação de armazenamento para sistemas externos
- Nomes de API para objetos externos e campos personalizados no Salesforce Connect — adaptador entre organizações
- Organizações assinante e provedora no Salesforce Connect — adaptador entre organizações
- Guia do desenvolvedor da API REST: Lista versões disponíveis da API REST
