Usar uma instância de dados local com uma visualização de dados

Para obter um controle mais refinado da fonte de dados do que você tem com fontes de dados pré-configuradas, crie uma instância de dados local. Em seguida, vincule a instância de dados local à propriedade dataPassthrough da visualização de dados.

Antes de Iniciar

Importante:

Este é um procedimento avançado. Considere com cuidado se você precisa de uma instância de dados local ou pode usar uma fonte de dados padrão.

Antes de prosseguir, revise Dynamically expose data in UI Builder pages (advanced feature).

Função necessária: ui_builder_admin, administrador

Procedimento

1. Abra o painel técnico ou outra página Construtor de IU em Construtor de IU.
2. Na gaveta Dados e scripts, em Recursos de dados, selecione + Adicionar recurso de dados.
   
   
   
3. Na janela Selecionar um recurso de dados, pesquise por Visualização de dados.
   Você obtém uma seleção dos recursos de dados que pode usar.
   
   
4. Selecione um recurso de dados que corresponda ao tipo de dados que você deseja mostrar.
5. Leia o painel de informações e copie ou faça anotações sobre os detalhes de configuração.
6. Selecione Adicionar.
7. Conclua as opções de configuração necessárias para o tipo de visualização com a qual você planeja usar esta instância de dados.
   Crie e configure uma instância de dados local separada para cada tipo de visualização em que você deseja usar os mesmos dados. Por exemplo, se você planeja ter uma barra e uma série de tempo que mostram pontuações do mesmo indicador, crie duas instâncias de dados locais: uma para visualizações de barra e de série de tempo, mas ambas no mesmo indicador.

   Dica:

   Você pode adicionar a visualização de dados à página e comparar seu painel de configuração com as opções da instância de dados local.
8. Copie a vinculação de dados @data para esta fonte de dados.
   
   
   
9. Adicione o componente de visualização de dados desejado à página.
10. No painel de configuração dessa visualização de dados, na seção Fontes de dados, ative Definir dados manualmente.
11. Para o campo Dados, selecione Vincular dados ou usar scripts.
    
    
    
12. Na caixa de diálogo Vincular dados a dados, em Tipos de dados, selecione Recurso de dados.
13. Clique duas vezes na seção Adicionar uma saída de dados a esta área e cole a vinculação de dados à sua instância de dados local na caixa azul.
14. Acrescente .output.result ao final da vinculação de dados.
    Por exemplo, a vinculação de dados concluída à instância de dados local data_visualization_api_for_table_data_source_1 é @data.data_visualization_api_for_table_data_source_1.output.result.
    
    
15. Selecione Aplicar.

Resultado

Você criou uma instância de dados local e a vinculou a uma visualização de dados. Agora você pode concluir a configuração da visualização de dados.

• Habilitar filtros para aplicar a uma instância de dados local
  Para permitir que um visualizador alterne entre os valores de campo ou elementos de detalhamento que ele vê em uma visualização de dados, adicione componentes de filtro à página Construtor de IU. Para que esses filtros se apliquem a uma instância de dados local, configure essa instância adequadamente.
• Habilitar cache de dados para uma instância de dados local
  Para ajudar a reduzir o tempo de carregamento das visualizações de dados e se dados em tempo real ou muito atualizados não forem necessários, habilite o cache de dados na fonte de dados.
• Instâncias de dados locais para várias visualizações
  Um recurso de dados especial da API de visualização de dados está disponível para buscar dados para várias visualizações de dados simultaneamente. Este recurso de dados reduz o número de chamadas de API e, portanto, pode acelerar a busca de dados.