Loading
Estender o Salesforce com cliques, não com código
Definir uma origem de dados externa para o adaptador entre organizações do Salesforce Connect

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
  1. Em Configuração, insira Origens de dados externas na caixa Busca rápida e selecione Origens de dados externas.
  2. Clique em Novo Origem de dados externa, ou clique em Editar para modificar uma origem de dados externa existente.
  3. Preencha os campos.
    Campo Descrição
    Fonte de dados externa

    Um nome de origem de dados externa que seja conveniente para o usuário. O rótulo aparece na interface de usuário do Salesforce, como em modos de exibição de lista.

    Se você configurou Tipo de identidade como Por usuário, este rótulo aparece quando os usuários visualizam ou editam suas configurações de autenticação de sistemas externos.

    Nome

    Um identificador exclusivo usado para fazer referência a essa definição de origem de dados externa por meio da API.

    O nome só pode conter sublinhados e caracteres alfanuméricos. Deve ser exclusivo, começar com uma letra, não incluir espaços, não terminar com sublinhado e não conter dois sublinhados consecutivos.

    Tipo Selecione Salesforce Connect: Entre organizações.
    Conectar a Determina qual URL é usado para conexão à organização provedora.
    URL Se tiver selecionado Conectar-se a Custom URL, insira o URL de login da organização provedora.
    Versão da API Selecione uma versão da API que tenha suporte na organização provedora. A versão da API determina quais objetos, campos e tipos da organização provedora poderão ser acessados a partir da organização assinante.
    Tempo limite de conexão (segundos) Número de segundos de espera por uma resposta da organização provedora antes de atingir o tempo limite. Por padrão, o valor é definido para o máximo de 120 segundos.
    Objetos externos graváveis A plataforma do Lightning e usuários nessa organização podem criar, atualizar e excluir registros de objetos externos associados à fonte de dados externa. Os dados do objeto externo são armazenados fora da organização. Por padrão, objetos externos são somente leitura.
    Ativar pesquisa

    Determina se pesquisas globais na organização assinante também pesquisarão dados dos objetos externos, que estão armazenados na organização provedora.

    Quando selecionado, é possível controlar quais objetos externos podem ser pesquisados ao marcar ou desmarcar Permitir pesquisa em cada objeto externo.

    Apenas os campos de texto, área de texto e área de texto longo podem ser pesquisados nos objetos externos. Se um objeto externo não tiver campos pesquisáveis, as pesquisas nesse objeto não retornarão nenhum registro.

  4. 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.
  5. 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.

  6. Clique em Salvar.
  7. 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().
  8. 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.
 
Carregando
Salesforce Help | Article