Filtrar gráficos incorporados

Especificar campos filtráveis

Um autor de gráfico 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 gráficos. Um autor de gráfico pode limitar o acesso aos dados permitindo que apenas determinados campos sejam pré-filtrados ou filtrados. Por padrão, nenhum campo é permitido, o que significa que o gráfico não pode ser pré-filtrado ou filtrado até que você permita explicitamente pelo menos um campo.

Para definir campos filtráveis para pré-filtros e filtros:

1. Navegue até o painel que contém o gráfico onde você deseja definir os campos filtráveis.

2. Para o gráfico desejado, clique em botão e selecione Embed Chart no menu suspenso.

3. Na seção Allowed filter fields , use o menu suspenso para selecionar quais campos os visualizadores do gráfico podem usar para filtrar dados no gráfico. Você também pode digitar valores manualmente para adicionar campos não listados no menu suspenso.

   Observação

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

   Para especificar em quais campos os visualizadores do gráfico podem pré-filtrar ou filtrar dados, você pode:

   • Use o menu suspenso para selecionar os campos.

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

   • Selecione Allow all fields in the data source used in this chart.

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

Os visualizadores do gráfico e os aplicativos que renderizam o gráfico agora podem usar pré-filtros e filtros com base nos campos especificados para exibir subconjuntos dos dados originais do gráfico. 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 Charts 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ê faça o seguinte:

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

• Aplique filtros antes da execução da query para queries de gráficos 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 de gráficos e antes do início das consultas e filtros de gráficos. Para saber mais sobre a ordem dos segmentos de pipeline, consulte agregação pipeline.

Utilize o parâmetro de query preFilter para filtrar dados antes que a query de gráfico comece a ser executada, para o gráfico incorporado em um iframe.

Você pode especificar um documento MQL como seu parâmetro de consulta do preFilter desde que os campos utilizados no seu filtro estejam na lista de campos filtráveis permitidos.

Filtrar dados em Charts incorporados em um iframe

Use o parâmetro de query filter para exibir somente dados que correspondam a um filtroMQL especificado em seu gráfico incorporado em um iframe.

Você pode utilizar o parâmetro de query filter em gráficos Unauthenticated e Verified Signature . O comportamento de filtragem é diferente de cada configuração de autenticação:

• Com gráficos não autenticados, o autor do gráfico especifica os campos que podem ser incluídos nos filtros definidos pelo código do aplicação de incorporação ou adicionados pelos visualizadores de gráficos. Para saber como especificar campos filtráveis, consulte Especificar campos filtráveis.

• Com gráficos que exigem uma Assinatura Verificada, todos os campos do documento podem ser filtrados, no entanto, você deve gerar o filtro no código do lado do servidor e incluir o filtro como parte da carga útil assinada.

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

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

{ "quantity": { $gte: 20 } }

{ $or: [ { quantity: { $lt: 20 } }, { price: 10 } ] }

https://charts.mongodb.com/charts-atlasproject1-piocy/embed/charts?
id=93584ddb-1115-4a12-afd9-5129e47bbb0d&
timestamp=1564156636&
expires-in=300&
filter=%7B%22imdb.rating%22%3A%20%7B%24gte%3A%208%7D%7D&
autoRefresh=60&
signature=8e0d92b33934c928f6c6974e2f0102ace77f56d851cb0d33893e84c359ab1043

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

Dados pré-filtro em Charts incorporados com o SDK

Você pode adicionar um preFilter a um gráfico incorporado com a opção preFilter . A pré-filtragem permite que o autor do gráfico execute um filtro após as visualizações do gráfico e antes da execução da consulta do gráfico e dos filtros do gráfico.

No modal Embed Chart , você deve especificar os campos que deseja incluir no pré-filtro. O modal Embed Chart 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:

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

Filtrar dados em Charts incorporados com o SDK

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

No modal Embed Chart , você deve especificar os campos que deseja incluir no filtro. O modal Embed Chart 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:

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

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