Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Filtern von Daten zur Laufzeit für eingebettete Dashboards und Grafiken von Amazon Quick Sight Sie können Filtermethoden im Amazon Quick Sight Embedding SDK verwenden, um die Leistungsfähigkeit der Amazon Quick Sight-Filter in Ihrer SaaS-Anwendung (Software as a Service) zur Laufzeit zu nutzen. Laufzeitfilter ermöglichen es Geschäftsinhabern, ihre Anwendung in ihre eingebetteten Amazon Quick Sight-Dashboards und Grafiken zu integrieren. Um dies zu erreichen, erstellen Sie benutzerdefinierte Filtersteuerungen in Ihrer Anwendung und wenden Sie Filtervoreinstellungen an, die auf Daten aus Ihrer Anwendung basieren. Anschließend können Entwickler zur Laufzeit Filterkonfigurationen für Endbenutzer personalisieren. Entwickler können mit dem Amazon Quick Sight Embedding SDK Amazon Quick Sight-Filter in einem eingebetteten Dashboard oder einer Grafik aus ihrer Anwendung erstellen, abfragen, aktualisieren und entfernen. Erstellen Sie Amazon Quick Sight-Filterobjekte in Ihrer Anwendung mit dem [FilterGroup](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_FilterGroup.html)Datenmodell und wenden Sie sie mithilfe der Filtermethoden auf eingebettete Dashboards und Grafiken an. Weitere Informationen zur Verwendung des Amazon Quick Sight Embedding SDK finden Sie [amazon-quicksight-embedding-sdk](https://github.com/awslabs/amazon-quicksight-embedding-sdk)unter GitHub. **Voraussetzungen** Bevor Sie beginnen können, stellen Sie sicher, dass Sie das Amazon Quick Sight Embedding SDK Version 2.5.0 oder höher verwenden. ## Terminologie und Konzepte Die folgende Terminologie kann nützlich sein, wenn Sie mit eingebetteten Laufzeitfiltern arbeiten. + *Filtergruppe* – Eine Gruppe einzelner Filter. Filter, die sich innerhalb einer `FilterGroup` befinden, sind miteinander ODER-verknüpft. Filter innerhalb von [FilterGroup](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_FilterGroup.html)werden auf dieselben Blätter oder Grafiken angewendet. + *Filter* – Ein einzelner Filter. Bei dem Filter kann es sich um einen Kategorien-, numerischen oder Datums-/Uhrzeitfilter handeln. Weitere Informationen zu Filtern finden Sie unter [Filter](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_Filter.html). ## Einrichtung Bevor Sie beginnen, stellen Sie bitte sicher, dass Sie die folgenden Ressourcen und Informationen bereit haben. + Die Blatt-ID des Blatts, auf das Sie die `FilterGroup` beschränken möchten. Dies kann mit der Methode `getSheets` im Embedding SDK abgerufen werden. + Der Datensatz und die Spalten-ID des Datensatzes, den Sie filtern möchten. Dies kann über den [DescribeDashboardDefinition](https://docs.aws.amazon.com/APIReference/API_DescribeDashboardDefinition.html)API-Vorgang abgerufen werden. Je nach verwendetem Spaltentyp kann es Einschränkungen hinsichtlich der Filtertypen geben, die einer eingebetteten Ressource hinzugefügt werden können. Weitere Informationen zu Filterbeschränkungen finden Sie unter [Filter](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_Filter.html). + Falls zutreffend, die visuelle ID der Visualisierung, auf das Sie die `FilterGroup` beschränken möchten. Dies kann mit der Methode `getSheetVisuals` im Embedding SDK abgerufen werden. Zusätzlich zu der Methode `getSheetVisuals` kann die `FilterGroup`, die Sie hinzufügen, nur auf das aktuell ausgewählte Blatt beschränkt werden. Um diese Funktion nutzen zu können, müssen Sie bereits über das Amazon Quick Sight Embedding SDK ein Dashboard oder eine Grafik in Ihre Anwendung eingebettet haben. Weitere Informationen zur Verwendung des Amazon Quick Sight Embedding SDK finden Sie [amazon-quicksight-embedding-sdk](https://github.com/awslabs/amazon-quicksight-embedding-sdk)unter GitHub. ## SDK-Methodenschnittstelle **Getter-Methoden der Dashboard-Einbettung** In der folgenden Tabelle werden verschiedene Getter-Methoden zum Einbetten von Dashboards beschrieben, die Entwickler verwenden können. | Methode | Description | | --- | --- | | `getFilterGroupsForSheet(sheetId: string) ` | Gibt alle FilterGroups Daten zurück, die sich derzeit auf das im Parameter angegebene Blatt beziehen. | | `getFilterGroupsForVisual(sheetId: string, visualId: string)` | Gibt alle `FilterGroups` zurück, die auf die im Parameter angegebene Visualisierung beschränkt sind. | Wenn das im Parameter angegebene Blatt nicht das aktuell ausgewählte Blatt des eingebetteten Dashboards ist, geben die oben genannten Methoden einen Fehler zurück. **Getter-Methoden der Visualisierungseinbettung** In der folgenden Tabelle werden verschiedene Getter-Methoden zum Einbetten von Visualisierungen beschrieben, die Entwickler verwenden können. | Methode | Description | | --- | --- | | `getFilterGroups()` | Gibt alle `FilterGroups` zurück, die derzeit auf die eingebettete Visualisierung beschränkt sind. | **Setter-Methoden** In der folgenden Tabelle werden verschiedene Getter-Methoden zum Einbetten von Dashboards oder Visualisierungen beschrieben, die Entwickler verwenden können. | Methode | Description | | --- | --- | | `addFilterGroups(filterGroups: FilterGroup[])` | Fügt das bereitgestellte Element hinzu und wendet **FilterGroups**es auf das eingebettete Dashboard oder visuelle Element an. Eine `ResponseMessage`, die angibt, ob das Hinzufügen erfolgreich war, wird zurückgegeben. | | `updateFilterGroups(filterGroups: FilterGroup[])` | Aktualisiert die `FilterGroups` im Einbettungserlebnis, das dieselbe `FilterGroupId` enthält wie die `FilterGroup`, die im Parameter angegeben ist. Eine `ResponseMessage`, die angibt, ob das Aktualisieren erfolgreich war, wird zurückgegeben. | | `removeFilterGroups(filterGroupsOrIds: FilterGroup[] \| string[])` | Entfernt das bereitgestellte FilterGroups Objekt aus dem Dashboard und gibt einen Wert zurück`ResponseMessage`, der angibt, ob der Entfernungsversuch erfolgreich war. | Die angegebene `FilterGroup` muss sich auf das eingebettete Blatt oder die Visualisierung beschränken, das/die derzeit ausgewählt ist.