Freigeben über


API für lokalen Speicher

Mit der API für den lokalen Speicher können Sie Daten im lokalen Speicher des Browsers speichern. Um die API für den lokalen Speicher zu verwenden, muss die Administratoreinstellung für den lokalen Speicher des Kunden aktiviert sein.

Der lokale Speicher ist isoliert, sodass jeder Visualtyp über einen eigenen separaten Speicherzugriff verfügt.

Hinweis

Es liegt in der Verantwortung der Entwickler, zu gewährleisten, dass die gespeicherten Daten den Organisationsrichtlinien der Endkunden entsprechen. Darüber hinaus liegt es in der Verantwortung der Entwickler, die Benutzer darüber informieren, welche Informationen gespeichert werden, wenn die Vertraulichkeit der Daten das erfordert. Entwickler von benutzerdefinierten Visuals sollten die Daten insbesondere dann verschlüsseln, wenn Geschäftsziele oder -szenarios das erfordern.

So verwenden Sie den lokalen Speicher

Diese Version der API für den lokalen Speicher soll eingestellt werden. Es werden keine weiteren Supportanfragen akzeptiert. Verwenden Sie nach Möglichkeit Version 2.

Im folgenden Beispiel wird ein Leistungsindikator jedes Mal erhöht, wenn die Updatemethode aufgerufen wird. Der Indikatorwert wird lokal gespeichert und bei jedem Start des Visuals aufgerufen. So zählt der Leistungsindikator ab der Position, an der er zuletzt angehalten wurde, anstelle jedes Mal neu zu beginnen, wenn das Visual gestartet wird.

export class Visual implements IVisual {
        // ...
        private updateCountName: string = 'updateCount';
        private updateCount: number;
        private storage: ILocalVisualStorageService;
        // ...

        constructor(options: VisualConstructorOptions) {
            // ...
            this.storage = options.host.storageService;
            // ...

            this.storage.get(this.updateCountName).then(count =>
            {
                this.updateCount = +count;
            })
            .catch(() =>
            {
                this.updateCount = 0;
                this.storage.set(this.updateCountName, this.updateCount.toString());
            });
            // ...
        }

        public update(options: VisualUpdateOptions) {
            // ...
            this.updateCount++;
            this.storage.set(this.updateCountName, this.updateCount.toString());
            // ...
        }
}

Überlegungen und Einschränkungen

  • Das Limit für den lokalen Speicher liegt bei 1 MB pro GUID.
  • Daten können nur zwischen Visuals mit derselben GUID freigegeben werden.
  • Daten können nicht mit einer anderen Instanz von Power BI Desktop geteilt werden.
  • Die API für den lokalen Speicher ist standardmäßig nicht aktiviert. Wenn Sie die API für Ihr Power BI-Visual aktivieren möchten, senden Sie eine Anfrage an das Supportteam für Power BI-Visuals (pbicvsupport@microsoft.com).
  • Die lokale Speicher-API unterstützt keine await-Konstruktionen. Nur then- und catch-Methoden sind zulässig.

Ihr Visual sollte in AppSource verfügbar und zertifiziert sein.