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

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • 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.

      Adicione o link do recurso de dados quando ainda não houver recursos 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.
      Seleção de recursos de dados para visualizações de dados.
    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.

      A referência @data para uma fonte de dados, com o botão Copiar.
    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.

      Opção Vincular dados para o campo Dados.
    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.
      Caixa de diálogo Vincular dados a dados mostrando a vinculação de recursos de dados a data_visualization_api_for_table_data_source_1.
    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.

    Antes de Iniciar

    Função necessária: ui_builder_admin, administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Para habilitar a aplicação de filtros a uma fonte de dados local, primeiro você precisa criar um parâmetro de estado do cliente chamado parFilters e, em seguida, adicionar esse parâmetro de estado à instância de dados local.

    Procedimento

    1. Abra a página Construtor de IU com a instância de dados local e as visualizações de dados que você deseja filtrar.
    2. Na gaveta Dados e scripts, selecione Parâmetros de estado do cliente.
    3. Selecione + Adicionar.
    4. Na caixa de diálogo Editar parâmetros de estado do cliente, nomeie o novo parâmetro parFilters, atribua a ele o tipo JSON e defina o valor inicial de {}.

      Parâmetro de estado do cliente parFilters na caixa de diálogo Editar parâmetros de estado do cliente.
    5. Feche a caixa de diálogo Editar parâmetros de estado do cliente.
    6. Na gaveta Dados e scripts, em Recursos de dados, selecione a instância de dados local desejada.
    7. Na edição<name of local data instance> caixa de diálogo, role para baixo até o campo Configurações de filtro.
    8. Insira @state.parFilters no campo Configurações de filtro e feche o editor de instância de dados.
    9. No painel de configuração de uma visualização de dados que usa este recurso de dados local, ative os filtros Seguir na seção Atualização de dados.
    10. Opcional: Ative Mostrar ícone de filtro.
    11. Salve a página Construtor de IU.

    O que Fazer Depois

    Adicione componentes de filtro à página Construtor de IU e configure-os para valores relevantes da instância de dados local.

    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.

    Antes de Iniciar

    Função necessária: ui_builder_admin, administrador

    Procedimento

    1. Abra a página Construtor de IU com a instância de dados local cujos dados você deseja armazenar em cache.
    2. Na gaveta Dados e scripts, em Recursos de dados, selecione a instância de dados local desejada.
    3. Role para baixo até Usar cache de dados e ative-o.
      Qualquer visualização de dados que usa essa fonte de dados usa as configurações de cache na fonte de dados. As configurações de cache de dados na própria visualização são removidas do painel de configuração.
    4. Defina outras propriedades de cache conforme necessário.
      Propriedade Descrição
      Horário de expiração de cache Por quanto tempo o cache, depois de criado, é retido antes de ser atualizado no trabalho de atualização de cache.
      Invalidar cache Use esta configuração com a lógica extra que você cria para invalidar o cache e buscar novos dados. Por exemplo, você pode adicionar um componente de botão à página e criar um script para seu manipulador de eventos para invalidar o cache.
      Chave adicional Insira uma cadeia de caracteres que contribuirá para gerar a chave de hash exclusiva para cada cache de dados criado nesta instância de dados. Use um valor de chave adicional exclusivo para cada instância de dados local.