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. Para o dashboard desejado, clique no botão e selecione Embed no menu suspenso.

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

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

Os visualizadores do painel e os aplicativos que renderizam o painel agora podem usar filtros com base nos campos especificados para exibir subconjuntos dos dados originais do painel. Se um visualizador tentar usar um filtro para um campo não incluído na lista Campos de filtro permitidos , o Atlas Charts retornará um erro.

{
  "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 filtroMQL especificado em seu dashboard incorporado em um iframe.

Você só pode usar o parâmetro de query filter no painel Unauthenticated . Com painéis não autenticados, o autor do painel especifica os campos que podem ser incluídos nos filtros definidos pelo código do aplicação de incorporação ou adicionados pelos visualizadores do painel. Para saber como especificar campos filtráveis, consulte Especificar campos filtráveis.

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

Você pode adicionar um filtro a um painel incorporado com a opção filter . A filtragem permite que o autor do painel exiba apenas dados no painel incorporado que correspondam a um filtro MQL especificado.

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 };
}