Kontrolka kafelka usługi Power BI w usłudze Power Apps

Kontrolka, która wyświetla kafelek usługi Power BI wewnątrz aplikacji.

Nie masz usługi Power BI? Zarejestruj się.

Description

Skorzystaj z istniejącej analizy danych i raportowania, wyświetlając kafelki usługi Power BI w aplikacjach. Określ kafelek, który chcesz wyświetlić, ustawiając jego właściwości Obszar roboczy, Pulpit nawigacyjny i Kafelek na karcie Dane panelu opcji.

Udostępnianie i zabezpieczenia

Gdy udostępniasz aplikację zawierającą zawartość usługi Power BI, musisz udostępnić nie tylko samą aplikację, ale także pulpit nawigacyjny , z którego pochodzi kafelek. W przeciwnym razie zawartość usługi Power BI nie będzie wyświetlana nawet dla użytkowników, którzy otwierają aplikację. Aplikacje zawierające zawartość usługi Power BI szanują uprawnienia do tej zawartości.

Performance

Nie zaleca się jednoczesnego ładowania więcej niż trzech kafelków usługi Power BI w aplikacji. Ładowanie i zwalnianie kafelków można kontrolować, ustawiając właściwość LoadPowerBIContent .

Opcje osadzania

Osadzanie różni się między wersjami interfejsu API usługi Power BI. Ze względu na nowy schemat uwierzytelniania interfejsu API usługi Power BI kafelek może nie być dostępny na urządzeniach przenośnych lub w innych scenariuszach osadzonych (Teams lub SharePoint).

Możesz kontrolować użycie wersji interfejsu API przy użyciu właściwości AllowNewAPI . Aby uzyskać więcej informacji, zobacz Właściwości klucza.

Filtering

Filtrowanie różni się między wersjami interfejsu API usługi Power BI. Zapoznaj się z odpowiednimi sekcjami poniżej w zależności od sposobu konfigurowania kontrolki.

W przypadku używania nowego interfejsu API do wywoływania usługi Power BI

Gdy właściwość AllowNewAPI jest ustawiona na wartość "True", używasz nowego interfejsu API do wywoływania usługi Power BI. Aby uzyskać więcej informacji, zobacz Filtrowanie raportu przy użyciu parametrów ciągu zapytania w adresie URL.

W przypadku używania oryginalnego interfejsu API do wywoływania usługi 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 jeden parametr z aplikacji, można filtrować wyniki wyświetlane na kafelku usługi Power BI. Obsługiwane są jednak tylko wartości ciągów i operator równości, a filtr może nie działać, jeśli nazwa tabeli lub nazwa kolumny zawiera spacje.

Aby przekazać pojedynczą wartość filtru, zmodyfikuj wartość właściwości TileURL , która jest zgodna z następującą składnią:

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

Do tej wartości dołącz następującą 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 zestawie danych raportu, z którego pochodzi kafelek. Jednak funkcja filtrowania ma następujące ograniczenia:

• Można zastosować tylko jeden filtr.
• eq Obsługiwany jest tylko operator.
• Typ pola musi być ciągiem.
• Filtrowanie jest dostępne tylko na przypiętych kafelkach wizualizacji. Nie jest obsługiwana w przypadku przypiętych raportów.
• Nie można filtrować wizualizacji skryptów języka R i Python.

Możesz użyć pól obliczanych w raporcie usługi Power BI, aby przekonwertować inne typy wartości na ciąg lub połączyć wiele pól w jeden.

Właściwości klucza

AllowNewAPI — czy używać nowego interfejsu API podczas wywoływania usługi Power BI. Ustawienie wartości true umożliwi użycie nowego interfejsu API usługi Power BI (który nie jest obsługiwany w przypadku urządzeń przenośnych i niektórych scenariuszy osadzonych, ale umożliwia bardziej zaawansowane filtrowanie). Wartość False będzie używać oryginalnego interfejsu API. Wartość domyślna to false.

Pulpit nawigacyjny — pulpit nawigacyjny usługi Power BI, z którego pochodzi kafelek.

LoadPowerBIContent — po ustawieniu wartości True zawartość usługi Power BI jest ładowana i wyświetlana. Po ustawieniu wartości False zawartość usługi Power BI zostanie zwolniona, która zwalnia pamięć i optymalizuje wydajność.

PowerBIInteractions — po ustawieniu wartości True zawartość usługi Power BI może być wchodzić w interakcję, ale zdarzenie OnSelect usługi Power Apps nie zostanie wyzwolone. W przypadku ustawienia wartości Fałsz nie można wchodzić w interakcję z kafelkiem, ale po wybraniu kafelka zostanie wyzwolone zdarzenie OnSelect usługi Power Apps.

Kafelek — nazwa kafelka usługi Power BI, który chcesz wyświetlić.

Workspace — obszar roboczy usługi Power BI, z którego pochodzi kafelek.

Dodatkowe właściwości

BorderColor — kolor obramowania kontrolki.

BorderStyle — czy obramowanie kontrolki to Solid, Dashed, Dotted lub None.

BorderThickness — grubość obramowania kontrolki.

DisplayMode — określa, czy kontrolka zezwala na wprowadzanie danych przez użytkownika (Edycja), wyświetla tylko dane (Widok) lub jest wyłączona (wyłączone).

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

OnSelect — akcje do wykonania, gdy użytkownik wybierze kontrolkę. Domyślnie zostanie otwarty raport usługi Power BI skojarzony z kafelkiem.

TileUrl — adres URL, pod którym jest żądany kafelek z usługi Power BI. Aby dodać filtrowanie ciągów zapytania do adresu URL, zobacz sekcję filtrowania powyżej.

Visible — określa, czy kontrolka jest wyświetlana, 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ą kontenera nadrzędnego (ekran — jeśli nie ma kontenera nadrzędnego).

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

Example

1. Na karcie Wstawianie otwórz menu Wykresy , a następnie dodaj kontrolkę kafelka usługi Power BI .

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

2. Na karcie Dane panelu opcji wybierz pozycję Mój obszar roboczy dla ustawienia Obszar roboczy .

3. Wybierz pulpit nawigacyjny na liście pulpitów nawigacyjnych, a następnie wybierz kafelek na liście kafelków.

   Kontrolka renderuje kafelek usługi Power BI.

Wytyczne dotyczące ułatwień dostępu

Kafelek usługi Power BI to po prostu kontener zawartości usługi Power BI. Dowiedz się, jak tworzyć dostępną zawartość za pomocą tych wskazówek dotyczących ułatwień dostępu usługi Power BI.

Jeśli zawartość usługi 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 usługi Power BI.