Rozhraní API místního úložiště
Pomocí rozhraní API místního úložiště můžete ukládat data v místním úložišti prohlížeče. Pokud chcete použít rozhraní API místního úložiště, musí být povolený přepínač správce místního úložiště zákazníka.
Místní úložiště je izolované, takže každý typ vizuálu má vlastní samostatný přístup k úložišti.
Poznámka:
Je zodpovědností vývojáře zajistit, aby uložená data odpovídala zásadám organizace spotřebitele a aby informovala uživatele o tom, jaké informace jsou uložené, pokud to vyžaduje citlivost dat. Vývojáři vlastních vizuálů by měli data šifrovat, pokud je očekávají obchodní cíle nebo scénáře.
Jak používat místní úložiště
Tato verze rozhraní API místního úložiště je naplánovaná pro vyřazení. Nepřijímáme žádné další žádosti. Pokud je to možné, použijte verzi 2.
V následujícím příkladu se čítač zvýší při každém zavolání metody aktualizace . Hodnota čítače se ukládá místně a volá se při každém spuštění vizuálu. Tímto způsobem čítač pokračuje v počítání místa, kde skončil, místo aby se spouštěl při každém spuštění vizuálu:
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());
// ...
}
}
Úvahy a omezení
- Limit místního úložiště je 1 MB na identifikátor GUID.
- Data je možné sdílet mezi vizuály pouze se stejným identifikátorem GUID.
- Data nejde sdílet s jinou instancí Power BI Desktopu.
- Rozhraní API místního úložiště není ve výchozím nastavení aktivované. Pokud ho chcete aktivovat pro vizuál Power BI, odešlete žádost podpoře
pbicvsupport@microsoft.com
vizuálů Power BI. - Rozhraní API místního úložiště nepodporuje
await
konstrukce. Jsou povoleny pouzethen
metody acatch
metody.
Vizuál by měl být dostupný v AppSource a měl by být certifikovaný.
Související obsah
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro