API di archiviazione localeLocal Storage API

L'API di archiviazione locale è un'API che un oggetto visivo personalizzato può usare per richiedere all'host di salvare o caricare dati dalla risorsa di archiviazione del dispositivo.The Local Storage API is an API a custom visual can use to request the host to save or load data from the device's storage. L'archiviazione è isolata, nel senso che l'accesso alla risorsa di archiviazione da parte di tipi di oggetti visivi diversi è separato.It's isolated in the sense that there's separation of storage access between different visual types.

EsempioSample

Se l'oggetto visivo personalizzato deve aumentare il contatore ogni volta che viene chiamato il metodo Update, ma il valore del contatore deve anche essere mantenuto e non reimpostato a ogni avvio dell'oggetto visivo:If the custom visual should increase some counter every time the update method is called, but the counter value should also be preserved and not reset on every visual start:

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());
            // ...
        }
}

Limitazioni e problemi notiKnown limitations and issues

Per impostazione predefinita, l'API di archiviazione locale non è attivata per gli oggetti visivi di Power BI.Local Storage API isn't activated for Power BI visuals by default. Se si vuole attivarla per l'oggetto visivo di Power BI, inviare una richiesta al supporto per gli oggetti visivi di Power BI pbicvsupport@microsoft.com.If you want to activate it for your Power BI visual, send a request to Power BI visuals Support pbicvsupport@microsoft.com.
Si noti che l'oggetto visivo deve essere disponibile in AppSource e deve essere certificato.Please note that your visual should be available in AppSource and be certified.