Freigeben über


Verwenden der Power BI-Korrelations-ID

Mit der eingebetteten Power BI-Korrelations-ID können Sie Ihre Anwendungssitzungs-ID mit der eingebetteten Power BI-Sitzungs-ID korrelieren. Das Bereitstellen der Sitzungs-ID an die Power BI-Unterstützung hilft beim Abrufen zusätzlicher Debuginformationen.

Sie können die getCorrelationId-Funktion aus allen eingebetteten Power BI-Elementen aufrufen, einschließlich Berichten und Dashboards.

Mit der getCorrelationId-API können Sie die aktuelle eingebettete Power BI-Korrelations-ID abrufen.

So erhalten Sie die Power BI-Korrelations-ID

Die im folgenden Codebeispiel gezeigte getCorrelationId-Funktion gibt die eingebettete Korrelations-ID zurück.

getCorrelationId(): Promise<string>

Beispiel

let correlationId = await report.getCorrelationId();

In diesem Beispiel wird gezeigt, wie Die Korrelations-ID abgerufen wird, wenn ein Fehler auftritt.

dashboard.on("error", function (error) {
    let correlationId = await dashboard.getcorrelationId();
    console.log("Error occurred in embed session: " + correlationId + " Error: " + error.detail.message);
});

Überlegungen und Einschränkungen

Die funktion getCorrelationId funktioniert nur, nachdem der Bericht geladen wurde.