Freigeben über


Arbeiten mit einer Power BI-Instanz

Erfahren Sie, wie Sie eine Power BI-Instanz abrufen oder zurücksetzen. Beispielsweise müssen Sie eine Berichtsinstanz abrufen, um Filter festzulegen.

Abrufen eines Verweises auf eine vorhandene Power BI-Komponente

Die powerbi.get-Methode wird verwendet, um eine eingebettete Instanz abzurufen, wenn bereits ein eingebettetes Element in der angegebenen <div>vorhanden ist.

In der Regel erhalten Sie eine Power BI-Elementinstanz (z. B. einen Bericht) mithilfe der methoden powerbi.embed oder powerbi.bootstrap. Wenn Sie jedoch eine Elementinstanz abrufen müssen, nachdem der Bericht eingebettet wurde, können Sie sie möglicherweise nicht verwenden. Verwenden Sie in diesen Fällen die get-Methode, um die Instanz abzurufen.

let report = powerbi.get(element);

Zurücksetzen eines Elements

Wenn Sie einen Bericht in ein Element eingebettet haben und das Element wieder auf den Anfangszustand zurücksetzen möchten, rufen Sie Folgendes auf:

powerbi.reset(element);

Mit dieser Methode wird das Einbetten aus dem Dienst entfernt und der iframe entfernt, der erforderlich ist, um zu verhindern, dass der Dienst den Verweis anhält, der im DOM nicht vorhanden ist. Normalerweise müssen Sie die Zurücksetzung aufrufen, bevor das enthaltende Element vom übergeordneten Element aus dem DOM entfernt wird.