---
title: "¿Cómo usar el paso de parámetros en Filtros?"
canonical: "https://onesaitplatform-es.refined.site/space/DOC/2215912994/%C2%BFC%C3%B3mo%20usar%20el%20paso%20de%20par%C3%A1metros%20en%20Filtros%3F"
format: markdown
---
ES | [EN](https://onesaitplatform.atlassian.net/wiki/spaces/DOC/pages/2215912902)

> Macro (toc)

## Introducción

En este tutorial veremos cómo funciona el uso de parámetros por la URL de invocación al dashboard y cómo podemos utilizarlos. Esta funcionalidad es muy útil para filtrar desde un inicio los datos que aparezcan en los gadgets y limitar así la información que se muestra.

Hay dos tipos de parámetros, como veremos a continuación: los obligatorios que se pedirán en la carga inicial del dashboard si no vienen informados en la URL, y los no obligatorios, que están definidos. Estos últimjos podemos enviarlos por la URL y se realizará el filtrado, pero no se nos pedirán en la carga inicial.

## ¿Cómo puedo configurar los parámetros para mi dashboard?

Para hacer esto, accede a tu dashboard en modo edición:

![image](media://fe8261cc-1932-4e32-83fe-8caf9f87e1b4)

Para este ejemplo, utilizaremos una fuente de datos de restaurantes y tendrás un gadget que mostrará la puntuación dada por los comensales al restaurante, por tipo de cocina.

![image](media://b90a7bcf-ba76-4a9b-90b8-2611664bb9af)

Crea un parámetro que filtrará la información inicialmente para que solo muestre la información de los restaurantes de una zona.

Para ello, pulsa este icono > Macro (inline-media-image)

  de la barra superior del menú.

Se desplegará una ventana modal con este aspecto:

![image](media://43abf595-a10a-4c2c-ab89-9b8b1e31c274)

En esta ventana, tienes el formulario donde introducirás y modificarás los datos de los parámetros en “ADD NEW PARAMETER:”. y el listado de parámetros que hay creados y que puedes ver debajo del literal “PARAMETERS:”.

En el formulario verás unos campos:

- **Parameter Name**: Nombre del parámetro. Éste será el que pasemos por la URL junto con su valor..
- **Parameter Type**<span style="color: #003366">:</span> Puedes seleccionar el tipo de dato, si es String o Number, en función del tipo de dato de destino.
- **Target Gadget**: Aquí seleccionarás el gadget que será filtrado por el parámetro.
- **Target Field**: Éste es el campo del gadget, por el que se realizará el filtrado para el valor pasado por la URL.
- **Mandatory**: Este check indica si el parámetro es obligatorio, y se pedirá en caso de no venir informado por la URL. Si no se marca, el parámetro es opcional y no se pedirá.

![image](media://0213bf59-810d-419b-97d2-42bd94f597ba)

Para este ejemplo, carga el formulario con esta información y pulsa el icono. Entonces se te llevará a la lista de parámetros definidos.

![image](media://50d5ce76-f77e-4e94-a871-96cf5c73c46a)

Tras crearlo verás dos nuevos iconos en la columna Options:

> Macro (inline-media-image)

 Permite editar los datos del parámetro, cargándolo de nuevo en el formulario para que puedas editarlo.

 > Macro (inline-media-image)

 Elimina el parámetro de la lista.

NOTA : Cuando estés trabajando con los dashboards, es importante ir guardándolo para no perder los cambios, así que, tras crear el parámetro, pulsa el botón > Macro (inline-media-image)

 para guardar tus cambios.


## ¿Cómo puedo ver el dashboard filtrado por el parámetro?

Accede al dashboard en modo vista. Para esto, si tienes la URL del dashboard, puedes escribirla en el navegador; o bien, si no la sabes, puedes ir desde el listado de dashboards pulsando en el icono  > Macro (inline-media-image)



Previamente a mostrarse el dashboard, se te requerirán todos aquellos parámetros que sean obligatorios y que no vengan definidos ya en la URL. En este caso la URL es:

![image](media://95d2aa5f-8daf-4a79-bdb0-c5ca95de36b3)

Por lo que no tiene ningún parámetro y por lo que nos aparecerá esta pantalla previa:

![image](media://fe0f05f5-eb3e-4719-b48d-4dc855b047c7)

Introduce un valor, por ejemplo: “Manhattan”:

![image](media://e3d0451f-a6a4-485e-a51f-dc7337cd4ecf)

Tras pulsar OK, la URL cambiará, añadiéndose el parámetro obligatorio.


Puedes ver ahora que en el gadget sólo aparecen los datos de los restaurantes de la zona de Manhattan:

![image](media://ba44eaa0-e38c-4c7d-95d8-d3e71b240f34)

![image](media://312d7882-5fd1-4e18-9f19-8ba64e33f930)

Si accedes al dashboard con el parámetro en la URL, no te pedirá el parámetro obligatorio, y accederás directamente al dashboard.