Compartilhar via

Objetos do Salesforce

Resumo

Elemento Descrição
Estado da liberação Disponibilidade geral
Produtos Excel
Power BI (modelos semânticos)
Power BI (fluxos de dados)
Arquitetura (Dataflow Gen2)
Power Apps (fluxos de dados)
Dynamics 365 Customer Insights
Analysis Services
Tipos de autenticação com suporte Conta do Salesforce

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Aviso

Por padrão, o Salesforce não dá suporte ao Internet Explorer 11, que é usado como parte da experiência de autenticação para serviços online no Power Query Desktop. Aceite o suporte estendido para acessar a experiência do Lightning usando o Microsoft Internet Explorer 11. Talvez você também queira examinar a documentação do Salesforce sobre como configurar o Internet Explorer. Neste momento, os usuários estão impossibilitados de autenticar, mas as credenciais armazenadas continuarão a funcionar até que os seus tokens atuais de autenticação expirem. Para resolver esse problema, acesse Habilitar o Microsoft Edge (Chromium) para Autenticação OAuth no Power BI Desktop.

Pré-requisitos

Para usar o conector de Objetos do Salesforce, você deve ter o nome de usuário e a senha da conta do Salesforce.

Além disso, o acesso à API do Salesforce deve ser habilitado. Para verificar as configurações de acesso, acesse sua página pessoal do Salesforce, abra as configurações de perfil e pesquise e verifique se a caixa de seleção habilitada para API está selecionada. Observe que as contas de avaliação do Salesforce não têm acesso à API.

Capacidades Suportadas

  • Produção
  • Personalizado
    • Domínios personalizados
    • Redirecionamentos de registro CNAME
    • Colunas de relação

Conectar-se a objetos Salesforce do Power Query Desktop

Para se conectar aos dados do Salesforce Objects:

  1. Selecione Objetos Salesforce na lista de conectores de dados específicos do produto e, em seguida, Conectar. Para obter mais informações, acesse Onde obter dados.

  2. Em Objetos Salesforce, escolha a URL de Produção se você usar a URL de produção do Salesforce (https://www.salesforce.com) para fazer login.

    Captura de tela da caixa de diálogo Obter dados com a URL de produção selecionada.

    Você também pode selecionar Personalizado e inserir uma URL personalizada para entrar. Essa URL personalizada pode ser um domínio personalizado que você criou no Salesforce, como https://contoso.salesforce.com. Você também pode usar a seleção de URL personalizada se estiver usando seu próprio registro CNAME que redireciona para o Salesforce. Atualmente, as URLs personalizadas só dão suporte aos domínios salesforce.com e cloudforce.com.

    Observação

    Não há suporte para URLs Lightning.

    Além disso, você pode selecionar Incluir colunas de relação. Essa seleção altera a consulta incluindo colunas que podem ter relações de chave estrangeira com outras tabelas. Se essa caixa estiver desmarcada, você não verá essas colunas.

    Depois de selecionar a URL, selecione OK para continuar.

  3. Selecione Entrar para entrar em sua conta do Salesforce.

    Captura de tela da caixa de diálogo de entrada para sua conta do Salesforce.

    Depois de fazer login com sucesso, selecione Conectar.

  4. Se você estiver entrando pela primeira vez usando um aplicativo específico, será solicitado que você verifique sua autenticidade inserindo um código enviado ao seu endereço de email. Em seguida, você é perguntado se deseja que o aplicativo que você está usando acesse os dados. Por exemplo, você será perguntado se deseja permitir que o Power BI Desktop acesse seus dados do Salesforce. Selecione Permitir.

  5. Na caixa de diálogo Navegador , selecione os Objetos salesforce que você deseja carregar. Em seguida, você pode selecionar Carregar para carregar os dados ou selecionar Transformar Dados para transformar os dados.

Conectar-se aos Objetos do Salesforce do Power Query Online

Para se conectar aos dados do Salesforce Objects:

  1. Selecione Objetos Salesforce na lista de conectores de dados específicos do produto e, em seguida, Conectar. Para obter mais informações, acesse Onde obter dados.

  2. Em objetos Salesforce, escolha a URL que você deseja usar para se conectar. Selecione a URL de Produção se você usar a URL de produção do Salesforce (https://www.salesforce.com) para entrar.

    Captura de tela da janela Conectar na fonte de dados em que você adiciona informações de conexão dos Objetos Salesforce.

    Observação

    No momento, talvez seja necessário selecionar a URL Personalizada , inserir https://www.salesforce.com na caixa de texto e, em seguida, selecionar Produção para se conectar aos seus dados.

    Você também pode selecionar Personalizado e inserir uma URL personalizada para entrar. Essa URL personalizada pode ser um domínio personalizado que você criou no Salesforce, como https://contoso.salesforce.com. Você também pode usar a seleção de URL personalizada se estiver usando seu próprio registro CNAME que redireciona para o Salesforce.

    Além disso, você pode selecionar Incluir colunas de relação. Essa seleção altera a consulta incluindo colunas que podem ter relações de chave estrangeira com outras tabelas. Se essa caixa estiver desmarcada, você não verá essas colunas.

  3. Se você estiver fazendo essa conexão pela primeira vez, selecione um gateway de dados local, se necessário.

  4. Selecione Entrar para entrar em sua conta do Salesforce. Depois de entrar com êxito, selecione Avançar.

  5. Na caixa de diálogo Navegador , selecione os Objetos salesforce que você deseja carregar. Em seguida, selecione Transformar Dados para transformar os dados.

Especificando uma versão da API do Salesforce

Exigimos que você especifique uma versão da API do Salesforce com suporte para usar o conector do Salesforce. Você pode fazer isso modificando a consulta usando o editor avançado do Power Query. Por exemplo, Salesforce.Data("https://login.salesforce.com/", [ApiVersion=48]).

Se você especificar uma versão que o Salesforce não dá suporte, você encontrará uma mensagem de erro indicando que você especificou uma ApiVersion sem suporte.

Para obter mais informações sobre versões e suporte da API do Salesforce, visite o site do Salesforce.

Problemas e limitações conhecidos

  • Se houver tabelas ausentes nos resultados do conector de Objetos Salesforce, uma das causas pode ser a necessidade de especificar ou atualizar a ApiVersion para uma versão que o Salesforce suporte. Para especificar ou atualizar o ApiVersion, use o Editor Avançado e adicione explicitamente o ApiVersion parâmetro. Por exemplo:

    Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])

    O Salesforce abandona periodicamente versões da API, portanto, verifique se você está especificando uma versão da API com suporte do Salesforce.

  • Há um limite no número de campos que uma consulta para o Salesforce pode conter. O limite varia dependendo do tipo das colunas, do número de colunas computadas e assim por diante. Quando você recebe o Query is either selecting too many fields or the filter conditions are too complicated erro, isso significa que sua consulta excede o limite. Para evitar esse erro, use a opção avançada Selecionar Consulta e especifique os campos de que você realmente precisa.

  • As configurações de sessão do Salesforce podem bloquear essa integração. Certifique-se de que a configuração Bloquear sessões para o endereço IP de origem esteja desabilitada.

  • O acesso à API do Salesforce deve ser habilitado. Para verificar as configurações de acesso, acesse as configurações de perfil do usuário atual e procure pela caixa de seleção API Ativado.

  • As contas de avaliação do Salesforce não têm acesso à API.

  • As operações "Criar registro" e "Atualizar registro" não dão suporte a campos personalizados do tipo Picklist (Multi-Select).

  • Não há suporte para URLs Lightning.

  • As URLs personalizadas só dão suporte aos domínios salesforce.com e cloudforce.com. O uso de outros domínios resulta em um erro "Argumentos Inválidos".

  • O Salesforce limita o número de consultas simultâneas que uma única conta pode executar. Erro 'INVALID_QUERY_LOCATOR' Esse é um limite do Salesforce e pode ser encontrado quando há várias consultas simultâneas no Salesforce usando a mesma conta. Esse limite inclui todos os aplicativos cliente (não apenas o conector do PowerQuery) usando a API do Salesforce. Para reduzir a probabilidade deste erro:

    • Verifique se o número de consultas do Salesforce é mantido no mínimo.
    • Use as opções disponíveis (como fluxos de dados) para organizar os dados do Salesforce.
    • Confirme se outros usos da API do Salesforce com a mesma conta não estão agendados simultaneamente.

Para obter mais informações sobre os limites da API interna do Salesforce, acesse a Referência Rápida de Limites e Alocações de Desenvolvedores do Salesforce.

  • Last updated on