Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Filtrado de datos en tiempo de ejecución para paneles e imágenes integrados de Amazon Quick Sight Puede utilizar los métodos de filtrado del SDK de incrustación de Amazon Quick Sight para aprovechar la potencia de los filtros de Amazon Quick Sight en su aplicación de software como servicio (SaaS) en tiempo de ejecución. Los filtros de tiempo de ejecución permiten a los propietarios de empresas integrar su aplicación con sus paneles y elementos visuales integrados de Amazon Quick Sight. Para ello, cree controles de filtro personalizados en su aplicación y aplique valores predeterminados de filtros en función de los datos de su aplicación. De este modo, los desarrolladores pueden personalizar las configuraciones de los filtros para los usuarios finales en tiempo de ejecución. Los desarrolladores pueden crear, consultar, actualizar y eliminar los filtros de Amazon Quick Sight en un panel integrado o en un elemento visual de su aplicación con el SDK de incrustación de Amazon Quick Sight. Cree objetos de filtrado de Amazon Quick Sight en su aplicación con el modelo de [FilterGroup](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_FilterGroup.html)datos y aplíquelos a cuadros de mando e imágenes integrados mediante los métodos de filtrado. Para obtener más información sobre el uso del SDK de incrustación de Amazon Quick Sight, consulte [amazon-quicksight-embedding-sdk](https://github.com/awslabs/amazon-quicksight-embedding-sdk)la GitHub **Requisitos previos** Antes de empezar, asegúrese de utilizar la versión 2.5.0 o superior del SDK de incrustación de Amazon Quick Sight. ## Terminología y conceptos La siguiente terminología puede resultar útil cuando trabaje con el filtrado de tiempo de ejecución incrustado. + *Grupo de filtros*: grupo de filtros individuales. Los filtros que se encuentran dentro de un `FilterGroup` están conectados entre sí mediante el operador OR. Los filtros incluidos en a [FilterGroup](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_FilterGroup.html)se aplican a las mismas hojas o imágenes. + *Filtro*: un filtro único. El filtro puede ser de categoría, numérico o de fecha y hora. Para obtener más información sobre filtros, consulte [Filtro](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_Filter.html). ## Configuración Antes de comenzar, asegúrese de que tiene preparados los activos y la información que se indican a continuación. + El identificador de la hoja a la que desea aplicar el ámbito de `FilterGroup`. Esto se puede obtener con el método `getSheets` del SDK de incrustación. + El identificador de columna y el conjunto de datos del conjunto de datos que desea filtrar. Esto se puede obtener mediante la operación de la [DescribeDashboardDefinition](https://docs.aws.amazon.com/APIReference/API_DescribeDashboardDefinition.html)API. En función del tipo de columna que use, es posible que haya restricciones en cuanto a los tipos de filtro que se pueden agregar a un activo incrustado. Para obtener más información sobre las restricciones de los filtros, consulte [Filtrar](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_Filter.html). + El identificador visual del elemento visual al que desea aplicar el ámbito de `FilterGroup`, si corresponde. Esto se puede obtener al usar el método `getSheetVisuals` del SDK de incrustación. Además del método `getSheetVisuals`, el `FilterGroup` que agregue solo puede tener como ámbito la hoja actualmente seleccionada. Para usar esta función, ya debe tener un panel de control o un elemento visual integrado en su aplicación a través del SDK de incrustación de Amazon Quick Sight. Para obtener más información sobre el uso del SDK de incrustación de Amazon Quick Sight, consulte [amazon-quicksight-embedding-sdk](https://github.com/awslabs/amazon-quicksight-embedding-sdk)la GitHub ## Interfaz del método del SDK **Métodos getter de incrustación del panel** En la siguiente tabla se describen los diferentes métodos getter de incrustación de panel que pueden usar los desarrolladores. | Método | Description (Descripción) | | --- | --- | | `getFilterGroupsForSheet(sheetId: string) ` | Devuelve todo lo FilterGroups que se encuentra actualmente dentro del ámbito a la hoja que se proporciona en el parámetro. | | `getFilterGroupsForVisual(sheetId: string, visualId: string)` | Devuelve todos los `FilterGroups` que tienen como ámbito el elemento visual que se proporciona en el parámetro. | Si la hoja que se proporciona en el parámetro no es la hoja actualmente seleccionada del panel incrustado, los métodos anteriores devolverán un error. **Métodos getter de incrustación de elemento visual** En la siguiente tabla se describen los diferentes métodos getter de incrustación de elemento visual que pueden usar los desarrolladores. | Método | Description (Descripción) | | --- | --- | | `getFilterGroups()` | Devuelve todos los `FilterGroups` que actualmente tienen como ámbito el elemento visual incrustado. | **Métodos Setter** En la siguiente tabla se describen los diferentes métodos setter que los desarrolladores pueden usar para la incrustación de paneles o elementos visuales. | Método | Description (Descripción) | | --- | --- | | `addFilterGroups(filterGroups: FilterGroup[])` | Agrega y aplica lo suministrado **FilterGroups**al panel de control o imagen incrustado. Se devuelve un mensaje `ResponseMessage` que indica si la incorporación se realizó correctamente. | | `updateFilterGroups(filterGroups: FilterGroup[])` | Actualiza `FilterGroups` en la experiencia incrustada que contiene el mismo `FilterGroupId` que el `FilterGroup` que se proporciona en el parámetro. Se devuelve un mensaje `ResponseMessage` que indica si la actualización se realizó correctamente. | | `removeFilterGroups(filterGroupsOrIds: FilterGroup[] \| string[])` | Quita lo suministrado FilterGroups del tablero y devuelve un `ResponseMessage` que indica si el intento de extracción se ha realizado correctamente. | El `FilterGroup` que se proporciona debe tener como ámbito los elementos visuales o las hojas incrustados actualmente seleccionados.