Considerações sobre objetos externos do Salesforce Maps

Como o Salesforce Maps recupera dados de objetos externos

Objetos externos permitem que os administradores do Salesforce acessem dados que estão fora de uma organização do Salesforce em tempo real por meio do Salesforce Connect. Você pode plotar objetos externos no Salesforce Maps, mas há limitações importantes quando sua origem de dados externa usa conexões OData 2.0, OData 4.0 ou entre organizações.

Quando você plota objetos externos, o Maps recupera dados por meio do Salesforce Connect, que faz chamadas a sistemas externos. Essa integração em tempo real introduz restrições específicas que não se aplicam a objetos padrão do Salesforce.

Limitações de SOQL e consulta

Os objetos externos têm várias restrições de consulta que afetam como o Salesforce Maps pode recuperar e mostrar dados:

• Pesquisas de relacionamento: Consultas que envolvem relacionamentos entre objetos externos e objetos padrão podem não oferecer suporte a todas as operações SOQL. Verifique se seus relacionamentos de objeto externo oferecem suporte aos campos que você precisa plotar.
• Funções agregadas: As funções COUNT, SUM, AVG, MIN e MAX não têm suporte na maioria das fontes de dados externas. Os recursos do Maps que dependem de agregação podem não funcionar com objetos externos.
• Operações de filtro: Nem todos os operadores de filtro SOQL estão disponíveis para objetos externos. Os operadores específicos suportados dependem da versão e da configuração OData da sua fonte de dados externa.
• Clausula LIMIT: As fontes de dados externas podem impor seus próprios limites de registro independentemente das cláusulas LIMIT do Salesforce SOQL. Verifique a documentação da origem de dados externa quanto a restrições específicas.

Dica Teste suas consultas de objeto externo no Developer Console antes de configurá-las como objetos de base no Salesforce Maps para identificar operações sem suporte com antecedência.

Requisitos de código geográfico e campo de endereço

A codificação geográfica de objetos externos requer consideração especial:

• Campos de endereço: Os objetos externos devem ter campos de endereço expostos por meio da origem de dados externa. Se os campos de endereço não estiverem disponíveis diretamente, você deverá configurar um relacionamento de pesquisa com um objeto padrão ou personalizado que contenha o endereço.
• Limites da API de codificação geográfica: Sempre que o Maps plota objetos externos, ele pode acionar operações de codificação geográfica que contam para os limites de codificação geográfica da sua organização. Monitore seu uso de codificação geográfica ao trabalhar com grandes conjuntos de dados externos.
• Pesquisas indiretas: Se você plotar registros que não têm endereços, certifique-se de que o relacionamento entre o objeto externo e o objeto que contém o endereço esteja adequadamente configurado como uma pesquisa indireta.

Limitações da Shield Platform Encryption

Se a sua organização usa o Shield Platform Encryption, esteja ciente destas restrições adicionais ao plotar objetos externos:

• Campos criptografados: Objetos externos não suportam o Shield Platform Encryption diretamente. No entanto, se você estiver usando pesquisas indiretas para objetos padrão que contêm campos criptografados, algumas operações de filtro e pesquisa talvez não funcionem conforme o esperado.
• Restrições de pesquisa: Campos criptografados em objetos padrão relacionados não podem ser usados em consultas de pesquisa quando acessados por meio de relacionamentos de objeto externo.
• Limitações do operador: Operadores de comparação (como, CONTAINS etc.) podem não funcionar em campos criptografados referenciados por meio de relacionamentos de objeto externo.

Importante Se você encontrar um comportamento de filtragem inesperado com objetos externos, verifique se os objetos relacionados contêm campos criptografados que podem estar causando a limitação.

Considerações de desempenho

Plotar objetos externos pode afetar o desempenho do Maps devido à recuperação de dados em tempo real:

• Limites de chamada externa: Cada solicitação para recuperar dados de objeto externo conta para os limites de chamada da sua organização. Conjuntos de dados grandes ou atualizações de mapa frequentes podem consumir chamadas rapidamente.
• Tempo de resposta: O desempenho do Maps depende do tempo de resposta da sua origem de dados externa. Sistemas externos lentos resultarão em atraso no carregamento e no plotamento do mapa.
• Volume de dados: Plotar grandes volumes de registros de objetos externos pode ser mais lento do que plotar objetos padrão. Considere usar filtros para reduzir o número de registros recuperados e plotados.
• Limitações de cache: Diferentemente de objetos padrão, os dados de objetos externos são recuperados em tempo real em cada solicitação. Os mecanismos de cache do Salesforce que melhoram o desempenho de objetos padrão não se aplicam a dados externos.

Dica Para um desempenho ideal, use filtros para recuperar apenas os registros externos que você precisa plotar e evite plotar números excessivos de objetos externos simultaneamente.

Comportamento da camada com objetos externos

Ao criar camadas de dados ou camadas de marcador com objetos externos:

• Criação de camada: Você pode criar camadas de dados com base em objetos externos, mas todas as limitações de consulta descritas acima se aplicam.
• Clique para criar: A funcionalidade de clique para criar pode ter limitações ao usar objetos externos como o objeto de destino. Verifique se sua origem de dados externa oferece suporte às operações de inserção necessárias.
• Atualizações do conjunto de dados ativo: As alterações feitas em dados externos no sistema de origem podem não aparecer imediatamente nas camadas do Maps devido a intervalos de cache ou de atualização da fonte de dados.
• Capas codificadas por cores: A codificação por cores com base em valores de campo de objeto externo funciona da mesma forma que objetos padrão, mas o desempenho pode ser mais lento com grandes conjuntos de dados externos.

Comportamento de pesquisa e filtro

A funcionalidade de pesquisa tem limitações específicas com objetos externos:

• Pesquisa POI: A pesquisa de Ponto de interesse (POI) pode ser executada mais lentamente com objetos externos devido à recuperação de dados em tempo real.
• Pesquisa de texto: Os recursos de pesquisa de texto completo dependem do suporte da sua origem de dados externa para operações de pesquisa de texto.
• Persistência do filtro: Os filtros aplicados a camadas de objeto externo podem precisar ser reavaliados em cada carregamento de mapa, possivelmente afetando o tempo de carregamento.

Solução de problemas de objeto externo

Se você encontrar problemas ao plotar objetos externos, verifique o seguinte:

Melhores práticas de objeto externo

Siga estas práticas recomendadas ao trabalhar com objetos externos no Salesforce Maps:

• Teste as consultas primeiro: Use o Developer Console para testar consultas SOQL em objetos externos antes de configurá-las no Maps.
• Use filtros de forma estratégica: Aplique filtros para limitar o número de registros externos recuperados e plotados.
• Limites do monitor: Acompanhe os limites de chamadas e o uso da API de codificação geográfica ao trabalhar com dados externos.
• Fontes de dados de documentos: Mantenha a documentação sobre suas origens de dados externas, incluindo suas limitações, agendas de atualização e operações com suporte.
• Plano de latência: Defina as expectativas do usuário que os mapeamentos com objetos externos podem ser carregados mais lentamente do que os mapas com apenas objetos padrão.
• Verificar relacionamentos: Certifique-se de que os relacionamentos de pesquisa indireta estejam corretamente configurados antes de tentar plotar objetos externos que não tenham seus próprios endereços.