Filtrar painéis incorporados

Especificar campos filtráveis

Um autor de painel especifica os campos que podem ser incluídos em pré-filtros e filtros definidos pelo código do aplicação de incorporação ou adicionados por visualizadores de painel. Um autor de painel pode limitar o acesso aos dados permitindo que somente determinados campos sejam filtrados. Por padrão, nenhum campo é permitido, o que significa que o painel não pode ser filtrado até que você permita explicitamente pelo menos um campo.

Para definir campos filtráveis:

1. Na página Dashboards, selecione o dashboard desejado. Para obter instruções sobre como navegar até dashboards, consulte Dashboards.

2. Para o dashboard desejado, clique no botão e selecione Embed no menu suspenso.

3. Na seção Allowed filter fields , clique em botão.

   Observação

   Essa opção só aparece se você já tiver o acesso de incorporação Não Autenticado ou Autenticado habilitado.

   Você pode especificar em quais campos os visualizadores do painel podem filtrar os dados:

   • Usando o menu suspenso para selecionar os campos

   • Digite manualmente valores para adicionar campos não listados no menu suspenso

   • Seleção Allow all fields in the data source used in this dashboard

4. Após selecionar todos os campos desejados, clique em Save abaixo do menu suspenso.

Dashboard viewers and applications which render the dashboard can now use filters based on the specified fields to display subsets of the original dashboard data. If a viewer attempts to use a filter for a field not included in the Allowed filter fields list, Atlas Charts returns an error.

{
  "name": "Alice",
  "favorites" :
  {
    "color": "green",
    "animal": "turtle",
    "season": "autumn"
  }
}

Dados pré-filtrados em dashboards incorporados em um iframe

Use pré-filtros para gráficos e painéis incorporados com um grande número de coleções. Os pré-filtros são executados em um estágio anterior no pipeline do gráfico incorporado e permitem que você alcance os seguintes resultados:

• Filtre os dados antecipadamente, para reduzir o tempo de execução da query

• Aplicar filtros após as visualizações e antes da execução da query e filtros para queries que contenham agregações

Os pré-filtros se comportam exatamente como filtros e usam a mesma sintaxe. A única diferença é que eles são executados após as visualizações e antes do início das queries e filtros. Para saber mais sobre a ordem dos segmentos de pipeline, consulte agregação pipeline.

Filtrar dados em dashboards incorporados em um iframe

Use o parâmetro de query filter para exibir somente dados que correspondam a um filtro MQL especificado em seu dashboard incorporado em um iframe.

You can only use the filter query parameter on the Unauthenticated dashboard. With unauthenticated dashboards, the dashboard Author specifies the fields that can be included in filters set by the embedding application code or added by dashboard viewers. To learn how to specify filterable fields, see Specify Filterable Fields.

https://charts.mongodb.com/charts-atlasproject1-piocy/embed/dashboards?
id=93584ddb-1115-4a12-afd9-5129e47bbb0d&
filter={"imdb.rating":%20{$gte:%208}}

{"imdb.rating": {$gte: 8}}

Dados pré-filtrados em dashboards incorporados com o SDK

Você pode adicionar um preFilter a um dashboard incorporado com a opção preFilter . A pré-filtragem permite que o autor do painel execute um filtro antes da execução da query.

No modal Embed , você deve especificar os campos que deseja incluir no pré-filtro. O modal Embed contém um menu suspenso de campos nos quais permitir a filtragem.

O seguinte usa a opção preFilter para representar somente documentos na Austrália:

createDashboard({
  baseUrl: '<your-base-url>',
  dashboardId: '<your-chart-id>',
  width: 500,
  height: 500,
  preFilter: { "address.country": "Australia" }
})

Filtrar dados em dashboards incorporados com o SDK

You can add a filter to an embedded dashboard with the filter option. Filtering allows the dashboard author to only display data in the embedded dashboard which matches a specified MQL filter.

No modal Embed , você deve especificar os campos que deseja incluir no filtro. O modal Embed contém um menu suspenso de campos nos quais permitir a filtragem.

O seguinte utiliza a opção filter para representar somente documentos nos quais o campo total é maior que 100:

createDashboard({
  baseUrl: '<your-base-url>',
  dashboardId: '<your-dashboard-id>',
  width: 500,
  height: 500,
  filter: { "total": { "$gt": 100 } }
})

function getFilter(context) {
  return { ownerId: context.token.sub };
}