Filtraggio dei dati in fase di esecuzione per dashboard e elementi visivi incorporati - Amazon QuickSight
Concetti e terminologiaConfigurazioneSDKinterfaccia del metodo

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Filtraggio dei dati in fase di esecuzione per dashboard e elementi visivi incorporati

Puoi utilizzare i metodi di filtro nell' QuickSight incorporamento di Amazon SDK per sfruttare la potenza dei QuickSight filtri all'interno della tua applicazione Software as a Service (SaaS) in fase di esecuzione. I filtri di runtime consentono agli imprenditori di integrare la propria applicazione con QuickSight dashboard e immagini integrate. A tale scopo, create controlli di filtro personalizzati nell'applicazione e applicate filtri preimpostati in base ai dati dell'applicazione. Quindi, gli sviluppatori possono personalizzare le configurazioni dei filtri per gli utenti finali in fase di esecuzione.

Gli sviluppatori possono creare, interrogare, aggiornare e rimuovere filtri su una dashboard o un elemento visivo incorporato dalla loro applicazione con Embedding. QuickSight SDK Crea oggetti QuickSight filtranti nell'applicazione con il modello di FilterGroupdati e applicali a dashboard e immagini incorporate utilizzando i metodi di filtro. Per ulteriori informazioni sull'utilizzo di QuickSight EmbeddingSDK, consulta on. amazon-quicksight-embedding-sdk GitHub

Prerequisiti

Prima di iniziare, assicurati di utilizzare la SDK versione di QuickSight Embedding 2.5.0 o successiva.

Concetti e terminologia

La seguente terminologia può essere utile quando si lavora con il filtro di runtime incorporato.

  • Gruppo di filtri: un gruppo di filtri individuali. I filtri che si trovano all'interno di un FilterGroup vengono messi in OR l'uno con l'altro. I filtri all'interno di a FilterGroupvengono applicati agli stessi fogli o immagini.

  • Filtro: un solo filtro. Il filtro può essere di tipo di filtro di categoria, numerico o data/ora. Per ulteriori informazioni sui filtri, consulta Filtro.

Configurazione

Prima di iniziare, assicurati di aver preparato le seguenti risorse e informazioni.

  • L'ID del foglio a cui desideri FilterGroup assegnare l'ambito. Questo può essere ottenuto con il getSheets metodo dell'Embedding. SDK

  • Il set di dati e l'identificatore di colonna del set di dati che desideri filtrare. Questo può essere ottenuto tramite l'operazione. DescribeDashboardDefinitionAPI

    A seconda del tipo di colonna utilizzato, potrebbero esserci delle restrizioni sui tipi di filtri che possono essere aggiunti a una risorsa incorporata. Per ulteriori informazioni sulle restrizioni dei filtri, consulta Filtro.

  • L'ID visivo dell'oggetto visivo a cui desideri FilterGroup assegnare l'ambito, se applicabile. Questo può essere ottenuto utilizzando il getSheetVisuals metodo dell'incorporamento. SDK

    Oltre al getSheetVisuals metodo, FilterGroup ciò che aggiungi può essere limitato solo al foglio attualmente selezionato.

Per utilizzare questa funzionalità, è necessario disporre già di una dashboard o di un elemento visivo incorporato nell'applicazione tramite l' QuickSight incorporamentoSDK. Per ulteriori informazioni sull'utilizzo dell' QuickSight incorporamentoSDK, consulta [link errato in Quip].

SDKinterfaccia del metodo

Dashboard che incorpora metodi migliori

La tabella seguente descrive i diversi metodi getter di incorporamento della dashboard che gli sviluppatori possono utilizzare.

Metodo Descrizione

getFilterGroupsForSheet(sheetId: string)

Restituisce tutto FilterGroups ciò che è attualmente compreso nell'ambito del foglio fornito nel parametro.

getFilterGroupsForVisual(sheetId: string, visualId: string)

Restituisce tutto FilterGroups ciò che rientra nell'ambito dell'immagine fornita nel parametro.

Se il foglio fornito nel parametro non è il foglio attualmente selezionato del pannello di controllo incorporato, i metodi precedenti restituiscono un errore.

Metodi migliori per l'incorporamento visivo

La tabella seguente descrive diversi metodi getter di incorporamento visivo che gli sviluppatori possono utilizzare.

Metodo Descrizione

getFilterGroups()

Restituisce tutto FilterGroups ciò che è attualmente incluso nell'oggetto visivo incorporato.

Metodi Setter

La tabella seguente descrive diversi metodi setter che gli sviluppatori possono utilizzare per la dashboard o l'incorporamento visivo.

Metodo Descrizione

addFilterGroups(filterGroups: FilterGroup[])

Aggiunge e applica quello fornito FilterGroupsalla dashboard o alla visualizzazione incorporata. Viene restituito un messaggio ResponseMessage che indica se l'aggiunta è avvenuta correttamente.

updateFilterGroups(filterGroups: FilterGroup[])

Aggiorna l'FilterGroupsesperienza incorporata che contiene le FilterGroupId FilterGroup stesse informazioni fornite nel parametro. Viene restituito un messaggio ResponseMessage che indica se l'aggiornamento è stato eseguito correttamente.

removeFilterGroups(filterGroupsOrIds: FilterGroup[] | string[])

Rimuove l'elemento fornito FilterGroups dalla dashboard e restituisce un ResponseMessage messaggio che indica se il tentativo di rimozione è riuscito.

FilterGroupCiò che viene fornito deve essere limitato al foglio o all'elemento visivo incorporato attualmente selezionato.