Filtern von Daten zur Laufzeit für eingebettete Dashboards und Grafiken von Amazon Quick Sight - Amazon Quick Suite
Terminologie und KonzepteEinrichtungSDK-Methodenschnittstelle

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 FilterGroupDatenmodell 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-sdkunter 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 FilterGroupwerden 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.

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 DescribeDashboardDefinitionAPI-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.

  • 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-sdkunter 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 FilterGroupses 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ückResponseMessage, 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.