Filtrar tableros embebidos

Especificar campos filtrables

Un Autor de tablero de control especifica los campos que pueden incluirse en los prefiltros y filtros establecidos por el código de la aplicación adjunta o añadidos por los espectadores del tablero de control. Un autor de tablero puede limitar el acceso a los datos permitiendo solo que se filtren determinados campos. Por default, no se permite ningún campo, lo que significa que el tablero no puede filtrarse hasta que se permita explícitamente al menos un campo.

Para definir campos filtrables:

1. Desde el Dashboards página, seleccione el tablero deseado. Para obtener instrucciones sobre cómo navegar a los Tableros, consulte Tableros.

2. Para el tablero deseado, haga clic en el botón y seleccione Embed en el menú desplegable.

3. En la sección Allowed filter fields, haga clic en el botón .

   Nota

   Esta opción solo aparece si ya tienes habilitado el acceso de inserción No autenticado o Autenticado.

   Puedes especificar en qué campos pueden filtrar los datos los espectadores del tablero:

   • Usando el menú desplegable para seleccionar los campos

   • Introducir manualmente valores para añadir campos que no aparezcan en el desplegable

   • Seleccionando Allow all fields in the data source used in this dashboard

4. Cuando hayas seleccionado todos los campos deseados, haz clic en Save debajo del menú desplegable.

Tablero los espectadores y las aplicaciones que renderizan el tablero ahora pueden usar filtros basados en los campos especificados para mostrar subconjuntos de los datos originales del tablero. Si un espectador intenta utilizar un filtro para un campo que no está incluido en el En la lista de Campos de filtro permitidos, Atlas Charts devuelve un error.

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

Filtrar previamente los datos en Tableros integrados en un iframe

Utiliza pre-filtros para gráficas y tableros incrustados con un gran número de colecciones. Los prefiltros se ejecutan en una etapa anterior de la pipeline de gráficos incrustados y le permiten lograr los siguientes resultados:

• Filtra los datos de forma temprana para reducir el tiempo de ejecución de la query

• Aplica filtros después de las vistas y antes de la ejecución de la query, y aplica filtros para queries que contienen agregaciones

Los pre-filtros se comportan exactamente igual que los filtros y utilizan la misma sintaxis. Su única diferencia radica en que se ejecutan después de las vistas y antes de que comiencen las consultas y los filtros. Para obtener más información sobre el orden de los segmentos de la pipeline, consulta la pipeline de agregación.

Filtrar datos en tableros integrados en un iframe

Utiliza el parámetro de query filter para mostrar únicamente los datos que coincidan con una especificada Filtro de MQL en su tablero incrustado en un iframe.

Solo se puede usar el parámetro de query filter en el tablero Unauthenticated. Con tableros que no requieren autenticación, el tablero Autor especifica los campos que pueden incluirse en los filtros establecidos por el código de aplicación de incrustación o agregados por los espectadores del tablero. Para aprender cómo especificar campos filtrables, consulta Especificar campos filtrables.

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

Filtrar previamente datos en tableros incrustados con el SDK

Puedes añadir un preFiltro a un tablero embebido con la opción preFilter. El prefiltrado permite al autor del tablero ejecutar un filtro antes de la ejecución de la query.

En el modal Embed, debes especificar los campos que quieres incluir en el pre-filtro. La modal Embed contiene un menú desplegable de campos sobre los que permitir el filtrado.

Lo siguiente usa la opción preFilter para representar solamente documentos en Australia:

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

Filtrar datos en tableros integrados con el SDK

Puedes añadir un filtro a un tablero incrustado con la opción filter. La aplicación de filtros permite al autor del tablero mostrar solo los datos en el tablero incrustado que coinciden con el filtro MQL especificado.

En la ventana emergente Embed, debes especificar los campos que deseas incluir en el filtro. El Embed modal contiene un menú desplegable de campos en los que permitir el filtrado.

El siguiente usa la opción filter para representar solo los documentos en los que el campo total es mayor 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 };
}