Recuperar dados dinamicamente com repetidores de dados
Use um repetidor de dados para se conectar a um objeto padrão ou personalizado do Salesforce e recuperar um conjunto de dados com base nos critérios de filtro especificados.
Edições obrigatórias
| Disponível em: Salesforce Classic |
Disponível para compra em: Edições Enterprise, Performance e Unlimited Disponível (como limitações) em: Developer Edition |
| Permissões necessárias ao usuário | |
|---|---|
| Para criar, editar e gerenciar sites do Site.com: | Campo Usuário Editor do Site.com ativado na página de detalhes do usuário E Papel de administrador do site ou designer atribuído no nível do site |
| Para editar o perfil de usuário convidado: | Campo Usuário Editor do Site.com ativado na página de detalhes do usuário E Papel de administrador do site ou designer atribuído no nível do site E Gerenciar perfis e conjuntos de permissão E Personalizar aplicativo |
Você pode se conectar a objetos padrão ou personalizados do Salesforce ou a listas ou categorias de conteúdo em seu site. Ao combinar um repetidor de dados com elementos de dados, código personalizado ou blocos de conteúdo, é possível criar um “modelo de repetição” que exibe um ou mais registros na página.
Para adicionar um repetidor de dados em uma página:
- Arraste um Repetidor de dados do painel Elementos de páginas para a página.
-
Selecione o objeto ao qual deseja se conectar.
Nota- Para usuários do Site.com, a lista suspensa exibe apenas os objetos disponíveis para usuários convidados, pois os visitantes do site acessam seu site público por meio da licença de Usuário convidado. Para disponibilizar outros objetos, vá para o perfil de usuário convidado, ative a permissão "Ler" dos objetos relevantes e atualize a lista.
- Para usuários de Comunidades, a lista suspensa exibe objetos que não estão sempre disponíveis para os visitantes do site. Para os visitantes autenticados, o acesso a objetos em páginas públicas e privadas é controlado por seus perfis de usuário. Para os visitantes não autenticados, o acesso a objetos em páginas públicas é controlado pelo perfil de usuário convidado do site.
-
Opcionalmente, selecione nos Filtros as condições para filtrar o conjunto de dados. Se nenhum critério for selecionado, todos os dados do item serão retornados.
- Selecione o campo no qual os critérios do filtro se aplicam. A lista suspensa Campo exibe os campos do objeto, seguidos pelos campos de todos os objetos pai, que usam o formato parent_object_name.field_name.
- Selecione o operador para controlar como os resultados são filtrados. Por exemplo, selecione Igual a para retornar uma correspondência exata.
- Selecione a origem do valor do filtro. Por exemplo, para especificar um valor explícito, selecione Valor fixo ou, para usar os valores passados à página por meio de uma string de consulta, selecione String de consulta de URL.
- Defina o valor do filtro. Se estiver usando uma string de consulta, você também pode especificar o que acontece se a string de consulta estiver ausente.
- Adicione critérios de filtro adicionais conforme necessário, para restringir ainda mais os resultados. Cada item de filtro é combinado a um operador AND.
Nota Se estiver usando um valor fixo para filtrar os resultados, você pode exibir os registros retornados na seção Visualização da conexão. Para atualizar a lista de registros, clique em Recarregar visualização. - Em Classificação, especifique se deseja classificar os resultados segundo um ou mais campos, em ordem crescente ou decrescente. Por exemplo, se estiver trabalhando com um objeto que contém dados de usuário, você pode classificar os resultados primeiro por sexo e depois por nome.
- Em Limites, você pode limitar o número de resultados retornados. Por exemplo, se estiver interessado somente nos cinco resultados principais, digite 5 no campo Limitar resultados a.
- Se você for adicionar paginação, especifique o número de resultados a ser exibido por página no campo Resultados por página.
- Clique em Salvar.
Em seguida, você deve adicionar elementos de dados, código personalizado ou blocos de conteúdo ao repetidor de dados para exibir os dados recuperados por eles.
- Exibir dados ou conteúdo usando elementos de dados
É possível usar um elemento de dados para exibir aqueles recuperados por uma conexão de dados de página ou um repetidor de dados. O elemento de dados se liga a um campo no objeto e atua como um espaço reservado que é substituído pelos dados do campo quando a página carrega. - Exibir dados ou conteúdo usando código personalizado
Além de elementos de dados e blocos de conteúdo, também é possível usar código personalizado como modo alternativo de exibir dados no repetidor de dados em uma conexão de dados de página. Isso é especialmente útil para exibir dados do campo de acordo com o texto. - Exibindo dados usando blocos de conteúdo
Além de elementos de dados e código personalizado, também é possível usar blocos de conteúdo como modo alternativo de exibir dados no repetidor de dados ou uma conexão de dados de página. Isso é especialmente útil para exibir dados do campo de acordo com o texto. - Recuperar dados dinamicamente com tabelas de dados
Use uma tabela de dados para se conectar a um objeto Salesforce padrão ou personalizado, recupere um conjunto de dados com base nos critérios de filtro especificados e exiba um ou mais registros em linhas na tabela. - Editar colunas em uma tabela de dados
As colunas de uma tabela de dados são vinculadas aos campos do objeto ao qual está conectada. Cada célula de coluna atua como espaço reservado substituído pelos dados do campo quando a página é carregada. - Adicionar paginação aos repetidores de dados e tabelas de dados
Os eventos permitem incluir efeitos interativos e animados às páginas e elementos de páginas do seu site Ao usar repetidores de dados e tabelas de dados, você pode adicionar eventos de paginação de modo que os usuários possam percorrer facilmente as páginas de dados exibidas. Os eventos de paginação são especialmente úteis ao trabalhar com grandes quantidades de dados. - Usando funções de dados
A função de dados conecta-se a um objeto Salesforce padrão ou personalizado, executa cálculos sobre os resultados retornados e exibe os cálculos na página. Por exemplo, pra um campo específico em um objeto, use uma função de dados para calcular o valor total ou a quantidade média de todos os registros retornados. - Visão geral das conexões de dados de página
Com as conexões de dados de página, os administradores e designers do site criam uma página de detalhes referente a um único registro ao trabalhar com objetos do Salesforce com mais facilidade. - Recuperando dados com conexões de dados de página
Use uma conexão de dados de página para criar uma página de detalhes para um único registro ao trabalhar com objetos do Salesforce. - Acessar dados na visão geral de objetos relacionados
Objetos padrão e personalizados têm relacionamentos que definem como os registros de um objeto se relacionam aos registros de outro. Por exemplo, o objeto Contas tem um relacionamento de um para muitos com o objeto Contatos — ou seja, cada conta pode ter um ou mais contatos associados a ela. Esse relacionamento também é conhecido como relacionamento de pai para filho ou de detalhes mestres. - Exibindo dados de objetos relacionados usando repetidores de dados aninhados
Pode-se recuperar dados de qualquer objeto filho de um objeto pai usando um repetidor de dados que contenha outro repetidor de dados, tabela de dados ou função de dados. - Melhorar o desempenho com o uso de cache
Quando se trabalha com elementos de página vinculados a dados, como repetidores, tabelas e funções de dados, é possível melhorar o desempenho e o processamento da página do seu site usando o cache. O cache controla quantas vezes uma página que contém uma conexão de dados solicita dados a partir do Salesforce. - Filtros de dados
Quando você adiciona um repetidor de dados, uma tabela de dados ou uma função de dados na página, você não precisa limitar os registros que ele recupera. Contudo, se você estiver trabalhando com um objeto do Salesforce que contém milhares de registros, você poderá limitar os resultados usando critérios de filtro. - Sobre a exibição de dados dinâmicos usando expressões
O idioma de expressão usa o Site.com para exibir dados dinamicamente. As expressões servem como espaços reservados para dados substituídos por informações quando a página for carregada. Ao trabalhar com elementos de páginas vinculados a dados ou propriedades de widget personalizadas, é possível usar expressões para personalizar como os dados serão exibidos na página. - Exemplos de filtros de dados
Ao trabalhar com repetidores de dados, tabelas de dados e funções de dados, você pode filtrar os dados recuperados de muitas maneiras. Neste tópico, exploramos duas opções (valores fixos e strings de consulta de URL) para ilustrar algumas técnicas comuns de filtragem.
Este artigo resolveu seu problema?
Diga-nos para podermos melhorar!
