Udostępnij za pośrednictwem

Osadzanie raportu

  • Artykuł

Napiwek

Spróbuj osadzić raport lub eksperymentować z naszymi interfejsami API klienta w Eksploruj nasze interfejsy API sekcji Narzędzia do analizy osadzonej usługi Power BI.

W tym artykule opisano kroki osadzania raportu usługi Power BI w aplikacji. Dowiedz się więcej o raportach w raportach w usłudze Power BI.

Jak osadzić raport

Podczas osadzania zawartości usługi Power BI w aplikacji należy użyć obiektu konfiguracji, aby zdefiniować osadzaną zawartość i określić ustawienia zawartości. Następnie przekazujesz ten obiekt do interfejsu API. Aby uzyskać więcej informacji, zobacz Konfigurowanie ustawień raportu.

Osadzanie istniejącego raportu

W przypadku osadzania raportu, który już istnieje, użyj obiektu konfiguracji typu IReportLoadConfiguration.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

Ten interfejs zawiera następujące właściwości:

  • accessToken — token, który zapewnia dostęp do osadzonych danych usługi Power BI. Zobacz Omówienie różnych rozwiązań osadzania, aby dowiedzieć się więcej na temat tokenów dostępu.

  • datasetBinding — zestaw danych definiujący schemat danych używany przez osadzony raport. Aby uzyskać więcej informacji na temat zestawów danych, zobacz Wiązanie zestawów danych dynamicznie z raportem.

  • embedUrl — adres URL raportu, który osadzasz. Ten adres URL staje się źródłem elementu iframe HTML zawierającego osadzony raport. W szczególności interfejs API przypisuje adres URL do atrybutu srciframe. Aby uzyskać ten adres URL, możesz użyć interfejsu API raportów . Dwa przykłady to:

  • id — identyfikator raportu usługi Power BI, który osadzasz.

  • permissions — operacje przydzielane użytkownikom dla osadzonego raportu. Dostępne są następujące wartości:

    • Read — użytkownicy mogą wyświetlać raport.
    • ReadWrite — użytkownicy mogą wyświetlać, edytować i zapisywać raport.
    • Copy — użytkownicy mogą zapisywać kopię raportu przy użyciu polecenia Zapisz jako.
    • Create — użytkownicy mogą utworzyć nowy raport.
    • All — użytkownicy mogą tworzyć, wyświetlać, edytować, zapisywać i zapisywać kopię raportu.

  • tokenType — rodzaj tokenu, który zapewnia dostęp do osadzonych danych usługi Power BI.

    • Użyj models.TokenType.Aad, jeśli osadzasz dla organizacji (użytkownik jest właścicielem danych).
    • Użyj models.TokenType.Embed, jeśli osadzasz dla swoich klientów (aplikacja jest właścicielem danych).

    Aby uzyskać więcej informacji, zobacz Omówienie różnych rozwiązań osadzania.

  • type — rodzaj osadzonej zawartości. Użyj 'report' dla raportu usługi Power BI.

Interfejs IReportLoadConfiguration zawiera również inne właściwości. Aby uzyskać informacje na temat tych właściwości, zobacz Konfigurowanie ustawień raportu:

  • bookmark
  • contrastMode
  • filters
  • pageName
  • settings
  • slicers
  • theme
  • viewMode

Osadzanie nowego raportu

Podczas osadzania nowego raportu utworzonego na podstawie zestawu danych użyj obiektu konfiguracji typu IReportCreateConfiguration.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

Właściwości w tym interfejsie są podobne do właściwości w interfejsie IReportLoadConfiguration z następującymi wyjątkami:

  • datasetId — identyfikator zestawu danych, który definiuje schemat danych używany przez nowy raport.

  • embedUrl — adres URL zestawu danych definiujący schemat danych używany przez nowy raport. Ten adres URL staje się źródłem elementu iframe HTML zawierającego osadzony raport. W szczególności interfejs API przypisuje adres URL do atrybutu srciframe. Aby uzyskać ten adres URL, możesz użyć interfejsu API zestawów danych . Dwa przykłady to:

Zobacz Tworzenie, edytowanie i zapisywanie osadzonego raportu, aby uzyskać informacje na temat edytowania i tworzenia raportów.

Przykład

W poniższym przykładzie pokazano, jak osadzić raport:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    permissions: somePermissions,
    tokenType: aTokenType,
    type: 'report'
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the report.
let report = powerbi.embed(embedContainer, embedConfiguration);

Powiązana zawartość