Udostępnij za pośrednictwem

Tworzenie, edytowanie i zapisywanie osadzonego raportu

  • Artykuł

Osadzona analiza usługi Power BI umożliwia tworzenie, edytowanie i zapisywanie osadzonych raportów. Raport można utworzyć na podstawie istniejącego zestawu danych lub edytować istniejący raport. Możesz również zapisać raport po jego utworzeniu lub edycji.

Jak utworzyć raport

Dowiedz się, jak utworzyć nowy, pusty raport z istniejącego zestawu danych.

Wymagane uprawnienia tokenu dostępu do tworzenia raportu

Wygeneruj token osadzania z dostępem do zestawu danych. Jeśli używasz metody uwierzytelniania użytkownika głównego , upewnij się, że aplikacja ma następujące zakresy: , i . Aby uzyskać więcej informacji, zobacz Token osadzania — generowanie tokenu.

Wymagane uprawnienia po stronie klienta do tworzenia raportu

Do utworzenia raportu są wymagane następujące uprawnienia po stronie klienta:

  • Tworzenie — użytkownicy mogą utworzyć nowy raport.

  • Wszystkie — użytkownicy mogą tworzyć, wyświetlać, edytować, zapisywać i zapisywać kopię raportu.

Tworzenie nowego raportu

Utwórz nowy, pusty raport na podstawie istniejącego zestawu danych. Potrzebny będzie identyfikator zestawu danych i adres URL osadzania. Na przykład możesz użyć interfejsu API REST getDatasetsInGroup i pobrać CreateReportEmbedURL. Aby uzyskać więcej informacji, zobacz Zestawy danych — pobieranie zestawów danych w grupie.

Nuta

Aby utworzyć nowy raport, musisz mieć uprawnienia do kompilowania lub zapisu w zestawie danych.

let embedCreateConfiguration = {
    tokenType: tokenType,
    accessToken: accessToken,
    embedUrl: embedURL,
    datasetId: datasetId,
    settings: settings,
    theme: theme, // optional
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Create report
let report = powerbi.createReport(embedContainer, embedCreateConfiguration);

Istnieje również możliwość utworzenia raportu z zastosowanym motywem. Nowe wizualizacje dodane do raportu będą szanować styl motywu. Aby uzyskać więcej informacji, zobacz Zastosuj motywy raportów.

Jak edytować raport

Dowiedz się, jak edytować istniejący raport i przełączać się między trybami widoku i edycji.

Wymagane uprawnienia tokenu dostępu do edycji

Wygeneruj token osadzania z dostępem do raportu. Jeśli używasz metody uwierzytelniania użytkownika głównego , upewnij się, że aplikacja ma następujące zakresy: i . Należy również ustawić flagę allowEdit: true dla każdego raportu, który użytkownik końcowy musi edytować. Aby uzyskać więcej informacji, zobacz Token osadzania — generowanie tokenu.

Wymagane uprawnienia po stronie klienta do edycji

Do edytowania raportu są wymagane następujące uprawnienia po stronie klienta:

  • copy — użytkownicy mogą zapisywać kopię raportu przy użyciu Zapisz jako.

  • ReadWrite — użytkownicy mogą wyświetlać, edytować i zapisywać raport.

  • Wszystkie — użytkownicy mogą tworzyć, wyświetlać, edytować, zapisywać i zapisywać kopię raportu.

Edytowanie raportu

Załaduj istniejący raport w trybie edycji. Raport musi być osadzony w taki sam sposób, jak aplikacja osadza zwykły raport, a tryb wyświetlania musi być w trybie Edycji. Upewnij się, że ustawiono parametr viewMode na models.ViewMode.Editi że masz odpowiednie uprawnienia klienta.

let config = {
    type: 'report',
    tokenType: models.TokenType.Aad or models.TokenType.Embed,
    accessToken: YourAccessToken,
    embedUrl: YourEmbedUrl,
    id: YourEmbedReportId,
    permissions: models.Permissions.All,
    viewMode: models.ViewMode.Edit,
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Embed report
let report = powerbi.embed(embedContainer, config);

Użytkownik może teraz edytować raport na podstawie uprawnień , które zostały włączone.

Po załadowaniu raportu można również przełączać się między trybami Edytowanie i Wyświetlanie.

report.switchMode("view");

Aby przełączyć się do trybu edycji:

report.switchMode("edit");

Jak zapisać raport

Dowiedz się, jak zapisać raport, w tym dodatkowe opcje, takie jak zapisanie kopii raportu i zapisanie raportu w innym obszarze roboczym.

Wymagane uprawnienia tokenu dostępu do zapisywania

Wygeneruj token osadzania z dostępem do raportu i zestawu danych. Jeśli chcesz zapisać raport w innym obszarze roboczym, token musi mieć dostęp do docelowego obszaru roboczego. Jeśli używasz metody uwierzytelniania użytkownika głównego, upewnij się, że aplikacja ma następujące zakresy: Report.ReadWrite.Alli Workspaces.ReadWrite.all. Należy również ustawić flagę allowEdit: true dla każdego raportu, który klient musi edytować. Aby uzyskać więcej informacji, zobacz Token osadzania — generowanie tokenu.

Wymagane uprawnienia po stronie klienta do zapisywania

Do zapisywania raportu są wymagane następujące uprawnienia po stronie klienta:

  • ReadWrite — użytkownicy mogą wyświetlać, edytować i zapisywać raport.

  • Tworzenie — użytkownicy mogą utworzyć nowy raport.

  • copy — użytkownicy mogą zapisywać kopię raportu przy użyciu Zapisz jako.

  • Wszystkie — użytkownicy mogą tworzyć, wyświetlać, edytować, zapisywać i zapisywać kopię raportu.

Zapisywanie raportu

Podczas tworzenia raportu raport nie jest zapisywany, dopóki nie wywołasz operacji save z menu pliku lub języka JavaScript.

report.save();

Zapisywanie kopii raportu

Zapisz dodatkową kopię pod inną nazwą. Kopia raportu zostanie zapisana w tym samym obszarze roboczym co zestaw danych raportu.

let saveAsParameters = {
    name: "newReport"
};

report.saveAs(saveAsParameters);

Możesz również zapisać raport w innym obszarze roboczym. Upewnij się, że masz odpowiednie uprawnienia do docelowego obszaru roboczego.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Sprawdź, czy raport został zapisany

Wywołaj report.isSaved, aby upewnić się, że raport został zapisany. Ta metoda może pomóc w zapobieganiu utracie niezapisanych zmian.

let isReportSaved = await report.isSaved();

Tworzenie środowiska zapisywania niestandardowego

Okno dialogowe niestandardowego saveAs można utworzyć, dodając ustawienie raportu useCustomSaveAsDialog: true do obiektu konfiguracji. To ustawienie powoduje ukrycie domyślnego okna dialogowego interfejsu użytkownika.

Zdarzenie saveAsTriggered jest zgłaszane, gdy użytkownik kliknie pozycję Zapisz jako w interfejsie użytkownika. Użyj tych informacji, aby wyświetlić niestandardowe okno dialogowe.

report.on("saveAsTriggered", function (event) {
    console.log(event);
});

Aby wykonać operację zapisz jako, możesz wywołać report.saveAs z okna dialogowego niestandardowego. Aby uzyskać więcej informacji, zobacz Zapisz kopię raportu.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Nasłuchiwanie zdarzeń zapisywania i zapisywaniaA

Zdarzenie saved jest zgłaszane, gdy zapisywanie jest wyzwalane przez akcję save lub saveAs w interfejsie użytkownika lub przy użyciu interfejsów API. Aby uzyskać więcej informacji, zobacz Jak obsługiwać zdarzenia.

report.on("saved", function (event) {
    console.log(event);
});

Powiązana zawartość