---
sourceDocument: Analytics der Xanadu-Plattform
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Analytics der Xanadu-Plattform

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Verwenden Sie eine lokale Dateninstanz mit einer Datenvisualisierung

# Verwenden Sie eine lokale Dateninstanz mit einer Datenvisualisierung {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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)](https://www.servicenow.com/docs/access?context=data-resources&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).

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 <kbd class="ph userinput">Datenvisualisierung</kbd>.  
   Sie erhalten eine Auswahl der Datenressourcen, die Sie verwenden können.  

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.  

   <br />

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.  

    <br />

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. <kbd class="ph userinput">Fügen Sie „.output.result“</kbd> 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`.  

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 {#ariaid-title2}

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 <kbd class="ph userinput">parFilters</kbd>, weisen Sie ihm den Typ JSON zu, und legen Sie den Anfangswert <kbd class="ph userinput">{}</kbd>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 <kbd class="ph userinput">Wert @state.parFilters</kbd> 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.
**Zugehörige Konzepte**   

* [Filter in Platform Analytics](https://servicenow-prod.fluidtopics.net/2CmXvmcM9YH16LHmYNWZtw "Filtern Sie Listen und Datenvisualisierungen in einem Dashboard nach dem möglichen Datenwert, nach dem Wert „wahr“ oder „falsch“ oder nach dem Datum. Der Filter gilt für alle Elemente im selben Dashboard oder auf der gleichen Dashboard-Registerkarte, abhängig von der Platzierung des Filters.")

## Aktivieren Sie das Zwischenspeichern von Daten für eine lokale Dateninstanz {#ariaid-title3}

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.  
   {#enable-caching-local-data-instance__table_k5f_bng_2bc__entry__2}

   | 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. |
   [ ]

   {#enable-caching-local-data-instance__table_k5f_bng_2bc}