Objetos do Salesforce

Resumo

Pré-requisitos

Para usar o conector do Salesforce Objects, você deve ter um nome de usuário e uma 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 do perfil e pesquise e verifique se a caixa de seleção API ativada está marcada . 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 relacionamento

Ligar a objetos do Salesforce a partir do Power Query Desktop

Para conectar-se aos dados do Salesforce Objects:

1. Selecione Salesforce Objects na lista de conectores de dados específicos do produto e, em seguida, selecione Conectar. Para obter mais informações, vá para Onde obter dados.

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

   

   Também pode selecionar Personalizar e introduzir um URL personalizado para iniciar sessão. Este URL personalizado pode ser um domínio personalizado que criou dentro do 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, URLs personalizadas só suportam os domínios salesforce.com e cloudforce.com.

   Observação

   Os URL de Lightning não são suportados.

   Além disso, você pode selecionar Incluir colunas de relacionamento. 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 o URL, selecione OK para continuar.

3. Selecione Entrar para fazer login na sua conta do Salesforce.

   

   Depois de iniciar sessão com êxito, selecione Conectar.

4. Se estiver a iniciar sessão pela primeira vez com uma aplicação específica, ser-lhe-á pedido que verifique a sua autenticidade introduzindo um código enviado para o seu endereço de e-mail. Em seguida, você será perguntado se deseja que o aplicativo que está usando acesse os dados. Por exemplo, você é 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 do Salesforce que deseja carregar. Em seguida, você pode selecionar Carregar para carregar os dados ou selecionar Transformar dados para transformar os dados.

Ligar a objetos do Salesforce a partir do Power Query Online

Para conectar-se aos dados do Salesforce Objects:

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

2. Em objetos do 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 fazer login.

   

   Observação

   Atualmente, 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.

   Também pode selecionar Personalizar e introduzir um URL personalizado para iniciar sessão. Essa URL personalizada pode ser um domínio personalizado criado 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 relacionamento. 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 fazer login na sua conta do Salesforce. Depois de iniciar sessão com êxito, selecione Seguinte.

5. Na caixa de diálogo Navegador , selecione os objetos do Salesforce que 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 compatível da API do Salesforce para usar o conector Salesforce. Pode fazê-lo modificando a consulta utilizando 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 suporta, encontrará uma mensagem de erro indicando que especificou uma ApiVersion não suportada.

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

Problemas conhecidos e limitações

• Se houver tabelas ausentes nos resultados do conector Salesforce Objects, uma causa pode ser que o ApiVersion deva ser especificado ou atualizado para uma versão suportada pelo Salesforce. 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])

  A Salesforce descontinua periodicamente as versões de API, por isso, certifique-se de especificar uma versão de API suportada pelo Salesforce.

• Há um limite para o número de campos que uma consulta ao Salesforce pode conter. O limite varia dependendo do tipo de 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 Selecionar consulta avançada e especifique os campos 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 do qual elas se originaram está desativada .

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

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

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

• Os URL de Lightning não são suportados.

• URLs personalizadas apenas suportam os domínios salesforce.com e cloudforce.com. A utilização de outros domínios resulta num erro de "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) que usam a API do Salesforce. Para reduzir a probabilidade deste erro:

  • Certifique-se de que o número de consultas do Salesforce seja mantido a um mínimo.
  • Utilize as opções disponíveis (como fluxos de dados) para armazenar temporariamente os dados provenientes 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 internos da API do Salesforce, vá para Referência rápida de limites e alocações do desenvolvedor do Salesforce.