Kontrolka kafelek Power BI w Power Apps

Kontrolka, która pokazuje kafelek Power BI wewnątrz aplikacji.

Nie dysponujesz Power BI? Zarejestruj się.

Opis

Skorzystaj z istniejącej analizy danych i raportowania, wyświetlając Twoje kafelki Power BI wewnątrz własnych aplikacji. Określ kafelek, który ma zostać wyświetlony, ustawiając jego właściwości Workspace, Dashboard i Tile na karcie Dane panelu opcji.

Uwaga

  • Kontrolka kafelka Power BI jest niedostępny w środowiskach GCC High i DoD.
  • Kontrolka kafelek Power BI jest niedostępny w Chinach.
  • Aby uzyskać informacje na temat wymagań licencyjnych dotyczących osadzania kafelka Power BI, zobacz Licencjonowanie.

Udostępnianie i zabezpieczenia

W przypadku udostępniania aplikacji z zawartością Power BI konieczne jest udostępnienie nie tylko samej aplikacji, ale także pulpitu nawigacyjnego, z którego pochodzi kafelek. W przeciwnym razie zawartość Power BI nie będzie wyświetlana nawet tym użytkownikom, którzy otworzą aplikację. Aplikacje, które zawierają zawartość Power BI, przestrzegają uprawnień dotyczących tej zawartości.

Wydajność

Nie zaleca się ładować w tym samym czasie w jednej aplikacji więcej niż trzech kafelków Power BI. Ładowanie i wyładowywanie kafelka można kontrolować, ustawiając właściwość LoadPowerBIContent.

Opcje osadzania

Osadzenie jest różne w różnych wersjach interfejsu API Power BI. Z powodu nowego schematu uwierzytelniania interfejsu API usługi Power BI Twój kafelek może być niedostępny na urządzeniach mobilnych lub w innych osadzonych scenariuszach (Teams lub SharePoint).

Użycie wersji interfejsu API można kontrolować, używając właściwości AllowNewAPI. Aby uzyskać więcej informacji, zobacz Właściwości klucza.

Wartość właściwości AllowNewAPI Zachowanie
Prawda Możesz osadzić pulpit nawigacyjny, raport lub kafelek, pobierając Umieść adres URL z usługi Power BI i nadając mu wartość TileUrl.
Fałsz Kafelek pulpitu nawigacyjnego możesz osadzić za pomocą Umieść adres URL i nadając mu wartość TileUrl lub korzystając z udostępnionego interfejsu graficznego.

Uwaga

Osadzanie adresu URL usługi Power BI (na przykład w ramce IFrame) nie jest obsługiwane na urządzeniach mobilnych usługi Power Apps, ponieważ uwierzytelnianie żądania adresu URL usługi Power BI nie jest obsługiwane przez odtwarzacz mobilny.

Filtrowanie

Filtrowanie różni się w poszczególnych wersjach interfejsu API Power BI. Zobacz odpowiednie sekcje poniżej, w zależności od konfiguracji kontrolki.

Używanie nowego interfejsu API do wywołania Power BI

Gdy właściwość AllowNewAPI ma wartość „True”, używasz nowego interfejsu API do wywoływania usługi Power BI. Więcej informacji: Filtrowanie raportu przy użyciu parametrów ciągu zapytania w adresie URL.

Używanie oryginalnego interfejsu API do wywołania Power BI

Gdy właściwość AllowNewAPI jest ustawiona na wartość „False”, używasz oryginalnego interfejsu API do wywoływania usługi Power BI. W takim przypadku, przekazując pojedynczy parametr z aplikacji, możesz filtrować wyniki wyświetlane na kafelku usługi Power BI. Obsługiwane są jednak tylko wartości typu ciąg i operator równa się, a filtr może nie działać, jeśli nazwa tabeli lub nazwa kolumny nie zawiera spacji.

Aby przekazać pojedynczy element Filter, należy zmodyfikować wartość właściwości TileURL, która ma następującą składnię:

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

Aby uzyskać tę wartość, dołącz tę składnię:

&$filter=<TableName>/<ColumnName> eq '<Value>'

Na przykład użycie wartości z pola listy:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

Parametr filtruje wartość w zestaw danych raportu, z którego pochodzi kafelek. Funkcja filtrowania ma jednak następujące ograniczenia:

  • Można stosować tylko jeden filtr.
  • Obsługiwany jest tylko operator eq.
  • Typ pola musi być typu String.
  • Filtrowanie jest dostępne tylko w przypadku przypiętych kafelków wizualizacji. Nie jest obsługiwane w przypadku przypiętych raportów.
  • Wizualizacje skryptów R i Pythona nie mogą być filtrowane.

W raporcie Power BI można użyć pól obliczanych w celu przekonwertowania innych typów wartościowych na ciąg lub łączenia wielu pól w jedno.

Kluczowe właściwości

AllowNewAPI — czy używać nowego interfejsu API podczas wywoływania usługi Power BI. Ustawienie wartości na True pozwoli na korzystanie z nowego API Power BI (który nie jest obsługiwane w urządzeniach mobilnych i niektórych scenariuszach wbudowanych, ale pozwala na bardziej zaawansowane filtrowanie). False będzie używać pierwotnego interfejsu API. Wartość domyślna to false.

Dashboard – pulpit nawigacyjny Power BI, z której pochodzi kafelek.

LoadPowerBIContent – jeśli wartość ustawiono na true, zawartość Power BI zostaje załadowana i wyświetlona. Jeśli wartość ustawiono na false, zawartość Power BI zostaje wyładowana, co powoduje zwolnienie pamięci i optymalizację wydajności.

PowerBIInteractions — gdy ma wartość True, zawartość Power BI może być przedmiotem interakcji, ale zdarzenie Power Apps OnSelect nie będzie wyzwalane. Gdy ma wartość False, nie można wchodzić w interakcję z kafelkiem, ale zdarzenie Power Apps OnSelect będzie wyzwalane, gdy kafelek zostanie wybrany.

Tile – nazwa kafelka Power BI, który chcesz wyświetlić.

Workspace – obszar roboczy Power BI, z której pochodzi kafelek.

Dodatkowe właściwości

BorderColor – kolor obramowania kontrolki.

BorderStyle – rodzaj obramowania kontrolki: Ciągłe, Kreskowane, Kropkowane lub Brak.

BorderThickness – grubość obramowania kontrolki.

DisplayMode – czy kontrolka zezwala na wprowadzanie danych wejściowych przez użytkownika (Edytuj), czy tylko wyświetla dane (Wyświetl) lub jest wyłączona (Wyłączone).

Height – odległość między górną i dolną krawędzią kontrolki.

OnSelect — akcje do wykonania po wyborze formantu przez użytkownika. Domyślnie powoduje otwarcie raportu Power BI skojarzonego z kafelkiem.

TileUrl – adres URL dla żądania kafelka z Power BI. Aby dodać filtrowanie ciągów zapytania do adresu URL, zobacz powyższy sekcję filtrowania.

Visible – czy kontrolka jest widoczna, czy ukryta.

Width – odległość między lewą i prawą krawędzią kontrolki.

X — odległość między lewą krawędzią kontrolki a lewą krawędzią jej kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).

Y — odległość między górną krawędzią kontrolki a górną krawędzią kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).

Przykład

  1. Na karcie Wstaw otwórz menu Wykresy, a następnie dodaj kontrolkę Kafelek Power BI.

    Nie wiesz, jak dodać i skonfigurować kontrolkę?

  2. Na karcie Dane w panelu opcji wybierz pozycję Mój obszar roboczy jako ustawienie Workspace.

  3. Z listy pulpitów nawigacyjnych wybierz odpowiedni pulpit nawigacyjny, a następnie z listy kafelków wybierz odpowiedni kafelek.

    Kafelek Power BI jest renderowany przez kontrolkę .

Wytyczne dotyczące ułatwień dostępu

Power BI tile jest po prostu kontenerem zawierającym treść Power BI. Dowiedz się, jak utworzyć dostępną zawartość, korzystając ze wskazówek dotyczących ułatwień dostępności w Power BI.

Jeśli zawartość Power BI nie ma tytułu, rozważ dodanie nagłówka przy użyciu kontrolki Etykieta w celu obsługi czytników zawartości ekranu. Etykietę można umieścić bezpośrednio przed kafelkiem Power BI.

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).