Verwenden Sie eine lokale Dateninstanz mit einer Datenvisualisierung

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer

    • Um eine detailliertere Steuerung der Datenquelle als mit vorkonfigurierten Datenquellen zu ermöglichen, erstellen Sie eine lokale Dateninstanz. Binden Sie dann die lokale Dateninstanz an die Eigenschaft dataPassthrough der Datenvisualisierung.

    Vorbereitungen

    Wichtig:
    Dies ist ein erweitertes Verfahren. Überlegen Sie sich gut, ob Sie eine lokale Dateninstanz benötigen oder eine Standarddatenquelle verwenden können.

    Bevor Sie fortfahren, überprüfen Sie Dynamically expose data in UI Builder pages (advanced feature).

    Erforderliche Rolle: ui_builder_admin, admin

    Prozedur

    1. Öffnen Sie das technische Dashboard oder eine andere UI Builder -Seite in UI Builder.
    2. Wählen Sie im Drawer Daten und Skripts unter Datenressourcen die Option + Datenressource hinzufügenaus.

      Datenressourcenlink hinzufügen, wenn noch keine Datenressourcen vorhanden sind.
    3. Suchen Sie im Fenster Datenressource auswählen nach Datenvisualisierung.
      Sie erhalten eine Auswahl der Datenressourcen, die Sie verwenden können.
      Auswahl von Datenressourcen für Datenvisualisierungen
    4. Wählen Sie eine Datenressource aus, die dem anzuzeigenden Datentyp entspricht.
    5. Lesen Sie sich den Informationsbereich durch, und kopieren Sie die Konfigurationsdetails, oder machen Sie sich Notizen zu ihnen.
    6. Wählen Sie Hinzufügen.
    7. Füllen Sie die Konfigurationsoptionen aus, die Sie für den Visualisierungstyp benötigen, mit dem Sie diese Dateninstanz verwenden möchten.
      Erstellen und konfigurieren Sie eine separate lokale Dateninstanz für jede Art von Visualisierung, die dieselben Daten verwenden soll. Wenn Sie beispielsweise einen Balken und eine Zeitreihe verwenden möchten, die Punktzahlen aus demselben Indikator anzeigen, erstellen Sie zwei lokale Dateninstanzen: jeweils eine für Balken- und Zeitreihenvisualisierungen, beide jedoch für denselben Indikator.
      Tipp:
      Sie können die Datenvisualisierung zur Seite hinzufügen und ihren Konfigurationsbereich mit den Optionen für die lokale Dateninstanz vergleichen.
    8. Kopieren Sie die @ data-Datenbindung für diese Datenquelle.

      Die @data-Referenz für eine Datenquelle mit der Schaltfläche „Kopieren“.
    9. Fügen Sie der Seite die gewünschte Datenvisualisierungskomponente hinzu.
    10. Aktivieren Sie im Konfigurationsbereich für diese Datenvisualisierung im Abschnitt „Datenquellen“ die Option Daten manuell definieren.
    11. Wählen Sie im Feld Daten die Option Daten binden oder Skripts verwendenaus.

      Option zum Binden von Daten für das Feld Daten.
    12. Wählen Sie im Dialogfeld Daten an Daten binden unter Datentypen die Option Datenressourceaus.
    13. Doppelklicken Sie auf den Abschnitt Datenausgabe zu diesem Bereich hinzufügen, und fügen Sie die Datenbindung an Ihre lokale Dateninstanz in das blaue Feld ein.
    14. Fügen Sie „.output.result“ am Ende der Datenbindung an.
      Beispiel: Die abgeschlossene Datenbindung an die lokale Dateninstanz data_visualization_api_for_table_data_source_1 lautet @data.data_visualization_api_for_table_data_source_1.output.result.
      Dialogfeld „Daten an Daten binden“, das die Datenressourcenbindung an „data_visualization_api_for_table_data_source_1“ zeigt.
    15. Wählen Sie Übernehmen.

    Ergebnisse

    Sie haben eine lokale Dateninstanz erstellt und an eine Datenvisualisierung gebunden. Sie können jetzt die Konfiguration Ihrer Datenvisualisierung abschließen.

    Aktivieren Sie Filter, die auf eine lokale Dateninstanz angewendet werden sollen

    Damit ein Betrachter zwischen den in einer Datenvisualisierung angezeigten Feldwerten oder Aufgliederungselementen wechseln kann, fügen Sie der Seite UI Builder Filterkomponenten hinzu. Damit diese Filter auf eine lokale Dateninstanz angewendet werden, konfigurieren Sie diese Instanz entsprechend.

    Vorbereitungen

    Erforderliche Rolle: ui_builder_admin, admin

    Warum und wann dieser Vorgang ausgeführt wird

    Damit Filter auf eine lokale Datenquelle angewendet werden können, müssen Sie zuerst einen Client-Statusparameter namens „parFilters “ erstellen und diesen Statusparameter dann der lokalen Dateninstanz hinzufügen.

    Prozedur

    1. Öffnen Sie die Seite UI Builder mit der lokalen Dateninstanz und den Datenvisualisierungen, die Sie filtern möchten.
    2. Wählen Sie im Drawer Daten und Skripts Client-Statusparameteraus.
    3. Wählen Sie + Hinzufügen aus.
    4. Benennen Sie im Dialogfeld „Client-Statusparameter bearbeiten“ den neuen Parameter parFilters, weisen Sie ihm den Typ JSON zu, und legen Sie den Anfangswert {}fest.

      Client-Statusparameter „parFilters“ im Dialogfeld „Client-Statusparameter bearbeiten“.
    5. Schließen Sie das Dialogfeld „Client-Statusparameter bearbeiten“.
    6. Wählen Sie im Drawer „Daten und Skripts“ unter „Datenressourcen“ die gewünschte lokale Dateninstanz aus.
    7. Im Bearbeiten<name of local data instance> Scrollen Sie im Dialogfeld nach unten zum Feld Filterkonfigurationen.
    8. Geben Sie im Feld Filterkonfigurationen den Wert @state.parFilters ein, und schließen Sie den Dateninstanz-Editor.
    9. Aktivieren Sie im Konfigurationsbereich einer Datenvisualisierung, die diese lokale Datenressource verwendet, Filter nachverfolgen im Abschnitt „Datenaktualisierung“.
    10. Wahlweise: Filtersymbol anzeigen aktivieren.
    11. Speichern Sie die Seite UI Builder.

    Nächste Maßnahme

    Fügen Sie der Seite UI Builder Filterkomponenten hinzu, und konfigurieren Sie sie für relevante Werte aus der lokalen Dateninstanz.

    Aktivieren Sie das Zwischenspeichern von Daten für eine lokale Dateninstanz

    Um die Ladezeit von Datenvisualisierungen zu verkürzen und keine Echtzeitdaten oder sehr aktuellen Daten erforderlich sind, aktivieren Sie das Zwischenspeichern von Daten in der Datenquelle.

    Vorbereitungen

    Erforderliche Rolle: ui_builder_admin, admin

    Prozedur

    1. Öffnen Sie die Seite UI Builder mit der lokalen Dateninstanz, deren Daten Sie zwischenspeichern möchten.
    2. Wählen Sie im Drawer „Daten und Skripts“ unter „Datenressourcen“ die gewünschte lokale Dateninstanz aus.
    3. Scrollen Sie nach unten zu Daten-Cache verwenden und aktivieren Sie diese Option.
      Jede Datenvisualisierung, die diese Datenquelle verwendet, verwendet die Cache-Einstellungen für die Datenquelle. Die Daten-Cache-Einstellungen in der Visualisierung selbst werden aus dem Konfigurationsbereich entfernt.
    4. Legen Sie nach Bedarf andere Caching-Eigenschaften fest.
      Eigenschaft Beschreibung
      Cache-Ablaufzeit Gibt an, wie lange der Cache nach der Erstellung aufbewahrt wird, bevor er im Cache-Aktualisierungsauftrag aktualisiert wird.
      Cache ungültig machen Verwenden Sie diese Einstellung mit zusätzlicher Logik, die Sie erstellen, um den Cache für ungültig zu erklären und neue Daten abzurufen. Beispielsweise können Sie der Seite eine Schaltflächen-Komponente hinzufügen und ihren Ereignishandler in ein Skript aufnehmen, um den Cache für ungültig zu erklären.
      Zusätzlicher Schlüssel Geben Sie eine Zeichenfolge ein, die zur Generierung des eindeutigen Hash-Schlüssels für jeden in dieser Dateninstanz erstellten Daten-Cache beiträgt. Verwenden Sie für jede lokale Dateninstanz einen eindeutigen zusätzlichen Schlüsselwert.