Power BI
Usługa Power BI to zestaw narzędzi do analizy biznesowej do analizowania danych i udostępniania szczegółowych informacji. Połącz się, aby uzyskać łatwy dostęp do danych na pulpitach nawigacyjnych, raportach i zestawach danych usługi Power BI.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Wszystkie regiony usługi Power Automate |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps |
| Power Apps | Standard | Wszystkie regiony usługi Power Apps |
| Power Automate | Standard | Wszystkie regiony usługi Power Automate |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL | https://powerbi.microsoft.com/en-us/support/ |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://powerbi.microsoft.com/ |
| Zasady ochrony prywatności | https://privacy.microsoft.com/privacystatement |
| Kategorie | Analiza biznesowa; Witryna internetowa |
Aby korzystać z tej integracji, musisz mieć dostęp do konta usługi Power BI. Aby nawiązać połączenie, wybierz pozycję Zaloguj. Zostanie wyświetlony monit o podanie konta, postępuj zgodnie z pozostałymi ekranami, aby utworzyć połączenie.
W przypadku korzystania z połączenia może być wymagane posiadanie pewnych konfiguracji na koncie usługi Power BI. Aby na przykład użyć wyzwalaczy alertu opartego na danych, musisz mieć już skonfigurowany alert oparty na danych.
Teraz możesz rozpocząć korzystanie z tej integracji.
Znane problemy i ograniczenia
Łącznik usługi Power BI nie jest obsługiwany w przypadku klastrów suwerennych chmur usługi Power BI (tj. klastrów dla instytucji rządowych Chin, Niemiec i Stanów Zjednoczonych).
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Aktualizowanie celu (wersja zapoznawcza) |
Aktualizuje stan celu usługi Power BI. |
| Aktualizowanie ewidencjonu (wersja zapoznawcza) |
Aktualizuje ewidencjonować cel usługi Power BI. |
| Dodawanie notatki do zaewidencjonowania (wersja zapoznawcza) |
Dołącza nową notatkę do ewidencjonowania celu usługi Power BI. |
| Dodawanie wierszy do zestawu danych |
Użyj interfejsu API REST usługi Power BI, aby dodać wiersze do zestawu danych. |
| Eksportowanie do pliku dla raportów podzielonych na strony |
Używanie interfejsu API REST usługi Power BI do inicjowania eksportu dla raportów podzielonych na strony |
| Eksportowanie do pliku dla raportów usługi Power BI |
Używanie interfejsu API REST usługi Power BI do tworzenia eksportu dla raportów usługi Power BI |
| Odświeżanie zestawu danych |
Odświeżanie zestawu danych powerbi przy użyciu interfejsu API REST usługi Power BI. |
| Pobieranie ewidencjonu celu (wersja zapoznawcza) |
Uzyskaj ewidencjonować cel usługi Power BI. |
| Pobieranie ewidencjonów celów (wersja zapoznawcza) |
Pobierz wszystkie ewidencjonacje w celu usługi Power BI. |
| Pobieranie kart wyników (wersja zapoznawcza) |
Pobiera listę kart wyników usługi Power BI w określonym obszarze roboczym. |
| Tworzenie celu (wersja zapoznawcza) |
Tworzy cel usługi Power BI na określonej karcie wyników. |
| Tworzenie ewidencjonowania (wersja zapoznawcza) |
Tworzy ewidencjonować cel usługi Power BI. |
| Tworzenie karty wyników (wersja zapoznawcza) |
Tworzy kartę wyników dla celów usługi Power BI. |
| Uruchamianie zapytania JSON względem zestawu danych |
Użyj interfejsu API REST usługi Power BI, aby uruchomić zapytanie w formacie json. |
| Uruchamianie zapytania względem zestawu danych |
Użyj interfejsu API REST usługi Power BI, aby uruchomić zapytanie. |
| Uzyskiwanie celu (wersja zapoznawcza) |
Pobiera określony cel usługi Power BI na karcie wyników. |
| Uzyskiwanie wielu celów (wersja zapoznawcza) |
Pobierz listę celów usługi Power BI na określonej karcie wyników. |
Aktualizowanie celu (wersja zapoznawcza)
Aktualizuje stan celu usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Name
|
name | string |
Jeśli zostanie podana, nowa nazwa celu. |
|
|
Właściciel
|
owner |
Jeśli zostanie podany, adres e-mail nowego właściciela celu. |
||
|
Bieżąca wartość
|
value | number |
Jeśli zostanie podana, ustawia nową wartość celu. |
|
|
Wartość docelowa
|
target | number |
Jeśli zostanie podana, ustawia nowy cel celu. |
|
|
Status
|
status | string |
Jeśli zostanie podany, ustawia nowy stan celu. |
|
|
Data rozpoczęcia
|
startDate | date |
Jeśli zostanie podana, nowa data rozpoczęcia celu. Przykład: 2021-07-15. |
|
|
Data ukończenia
|
completionDate | date |
Jeśli zostanie podana, nowa data zakończenia celu. Przykład: 2021-07-29. |
Aktualizowanie ewidencjonu (wersja zapoznawcza)
Aktualizuje ewidencjonować cel usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Data zaewidencjonu
|
goalCheckin | True | date |
Przykład: 2021-07-21 |
|
Wartość
|
value | number | ||
|
Status
|
status | string |
Stan celu. |
Dodawanie notatki do zaewidencjonowania (wersja zapoznawcza)
Dołącza nową notatkę do ewidencjonowania celu usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Data zaewidencjonu
|
goalCheckin | True | date |
Przykład: 2021-07-21 |
|
Uwaga / Notatka
|
note | True | string |
Może być tekstem wielowierszowy |
Dodawanie wierszy do zestawu danych
Użyj interfejsu API REST usługi Power BI, aby dodać wiersze do zestawu danych.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Dataset
|
datasetid | True | string |
Unikatowy identyfikator zestawu danych. |
|
Tabela
|
tablename | True | string |
Nazwa tabeli. |
|
Ładunek do wysłania
|
Payload | dynamic |
Eksportowanie do pliku dla raportów podzielonych na strony
Używanie interfejsu API REST usługi Power BI do inicjowania eksportu dla raportów podzielonych na strony
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Raport
|
reportid | True | string |
Unikatowy identyfikator raportu podzielonego na strony. |
|
Format eksportu
|
format | True | string |
Format eksportu raportu podzielonego na strony. Obsługiwane formaty to: PPTX (PowerPoint), PDF, ACCESSIBLEPDF (Accessible PDF), XLSX (Excel), DOCX (Word), CSV, XML, MHTML i Image (BMP, EMF, GIF, JPEG, PNG lub TIFF). |
|
Nazwa użytkownika
|
username | True | string |
Obowiązująca nazwa użytkownika odzwierciedlana przez token do stosowania reguł zabezpieczeń na poziomie wiersza (w przypadku modelu onPrem nazwa użytkownika może składać się z znaków alfanumerycznych lub dowolnego z następujących znaków ".", "-", "_", "!", "#", "^", "~", "\", "@", również nazwa użytkownika nie może zawierać spacji. W przypadku modelu chmury nazwa użytkownika może składać się ze wszystkich znaków ASCII. Nazwa użytkownika musi mieć maksymalnie 256 znaków) |
|
Zbiory danych
|
datasets | array of string |
Tablica zestawów danych, dla których ta tożsamość ma zastosowanie |
|
|
Role
|
roles | array of string |
Tablica ról zabezpieczeń na poziomie wiersza odzwierciedlana przez token podczas stosowania reguł zabezpieczeń na poziomie wiersza (tożsamość może zawierać maksymalnie 50 ról, rola może składać się z dowolnego znaku oprócz znaku "" i musi zawierać maksymalnie 50 znaków) |
|
|
CustomData
|
customData | string |
Wartość customdata, która ma być używana do stosowania reguł zabezpieczeń na poziomie wiersza. Obsługiwane tylko w przypadku połączeń na żywo z usługami Azure Analysis Services. |
|
|
Wartość obiektu blob
|
value | True | string |
Token dostępu OAuth2 dla usługi SQL Azure |
|
Reports
|
reports | array of string |
Tablica raportów, dla których ta tożsamość ma zastosowanie, obsługiwana tylko w przypadku raportów podzielonych na strony |
|
|
FormatSettings
|
formatSettings | object |
Słownik ustawień formatu. Klucze to nazwy właściwości informacji o urządzeniu dla żądanego formatu pliku. |
|
|
nazwa
|
name | string |
Nazwa parametru raportu |
|
|
value
|
value | string |
Wartość parametru raportu |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Eksportowanie do pliku dla raportów usługi Power BI
Używanie interfejsu API REST usługi Power BI do tworzenia eksportu dla raportów usługi Power BI
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Raport
|
reportid | True | string |
Unikatowy identyfikator raportu pbi. |
|
Format eksportu
|
format | True | string |
Format eksportu raportu usługi Power BI. Obsługiwane formaty to: PPTX (PowerPoint), PDF i PNG |
|
Lokalizacja
|
locale | string |
Ustawienia regionalne do zastosowania |
|
|
Dołączanie ukrytych stron
|
includeHiddenPages | boolean |
Flaga wskazująca, czy podczas eksportowania całego raportu mają być uwzględniane ukryte strony (podczas przekazywania określonych stron ta właściwość zostanie zignorowana). Jeśli nie zostanie podana, domyślne zachowanie polega na wykluczeniu ukrytych stron |
|
|
Nazwa zakładki
|
name | string |
Nazwa zakładki |
|
|
Stan zakładki
|
state | string |
Stan zakładki |
|
|
Filter
|
filter | string |
Filtr do zastosowania |
|
|
pageName
|
pageName | string |
Nazwa strony |
|
|
visualName
|
visualName | string |
(Opcjonalnie) Nazwa wizualizacji do wyeksportowania |
|
|
Nazwa zakładki
|
name | string |
Nazwa zakładki |
|
|
Stan zakładki
|
state | string |
Stan zakładki |
|
|
Nazwa użytkownika
|
username | True | string |
Obowiązująca nazwa użytkownika odzwierciedlana przez token do stosowania reguł zabezpieczeń na poziomie wiersza (w przypadku modelu onPrem nazwa użytkownika może składać się z znaków alfanumerycznych lub dowolnego z następujących znaków ".", "-", "_", "!", "#", "^", "~", "\", "@", również nazwa użytkownika nie może zawierać spacji. W przypadku modelu chmury nazwa użytkownika może składać się ze wszystkich znaków ASCII. Nazwa użytkownika musi mieć maksymalnie 256 znaków) |
|
Zbiory danych
|
datasets | array of string |
Tablica zestawów danych, dla których ta tożsamość ma zastosowanie |
|
|
Role
|
roles | array of string |
Tablica ról zabezpieczeń na poziomie wiersza odzwierciedlana przez token podczas stosowania reguł zabezpieczeń na poziomie wiersza (tożsamość może zawierać maksymalnie 50 ról, rola może składać się z dowolnego znaku oprócz znaku "" i musi zawierać maksymalnie 50 znaków) |
|
|
CustomData
|
customData | string |
Wartość customdata, która ma być używana do stosowania reguł zabezpieczeń na poziomie wiersza. Obsługiwane tylko w przypadku połączeń na żywo z usługami Azure Analysis Services. |
|
|
Wartość obiektu blob
|
value | True | string |
Token dostępu OAuth2 dla usługi SQL Azure |
|
Reports
|
reports | array of string |
Tablica raportów, dla których ta tożsamość ma zastosowanie, obsługiwana tylko w przypadku raportów podzielonych na strony |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Odświeżanie zestawu danych
Odświeżanie zestawu danych powerbi przy użyciu interfejsu API REST usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Dataset
|
datasetid | True | string |
Unikatowy identyfikator zestawu danych. |
Pobieranie ewidencjonu celu (wersja zapoznawcza)
Uzyskaj ewidencjonować cel usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Data zaewidencjonu
|
goalCheckin | True | date |
Przykład: 2021-07-21 |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Date
|
timestamp | date |
Data zaewidencjonu. |
|
Wartość
|
value | number |
Wartość w momencie zaewidencjonowania, jeśli jest ustawiona. |
|
Status
|
status | string |
Stan celu w momencie zaewidencjonowania. |
|
Notatki
|
notes | GoalNotes |
Lista notatek. |
Pobieranie ewidencjonów celów (wersja zapoznawcza)
Pobierz wszystkie ewidencjonacje w celu usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Ewidencjonacje
|
value | array of object |
Lista zaewidencjonowania. |
|
Date
|
value.timestamp | datetime |
Data zaewidencjonu. |
|
Wartość
|
value.value | number |
Wartość w momencie zaewidencjonowania. |
|
Status
|
value.status | string |
Stan celu w momencie zaewidencjonowania. |
|
Notatki
|
value.notes | GoalNotes |
Lista notatek. |
Pobieranie kart wyników (wersja zapoznawcza)
Pobiera listę kart wyników usługi Power BI w określonym obszarze roboczym.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
Zwraca
Cała treść odpowiedzi.
- Pobierane
- ListedScorecards
Tworzenie celu (wersja zapoznawcza)
Tworzy cel usługi Power BI na określonej karcie wyników.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Name
|
name | True | string |
Nazwa celu. |
|
Właściciel
|
owner |
Adres e-mail właściciela celu. Przykład: foo@bar.com |
||
|
Bieżąca wartość
|
value | string |
Bieżąca wartość śledzonego celu. |
|
|
Wartość docelowa
|
target | string |
Wartość docelowa celu. |
|
|
Status
|
status | string |
Bieżący stan celu. |
|
|
Data rozpoczęcia
|
startDate | date |
Data rozpoczęcia celu. Przykład: 2021-07-15. |
|
|
Data ukończenia
|
completionDate | date |
Data zakończenia celu. Przykład: 2021-07-29. |
|
|
Uwaga / Notatka
|
note | string |
Pamiętaj, aby dołączyć do początkowego zaewidencjonowania podczas tworzenia celu. Może być tekstem wielowierszowy |
|
|
Identyfikator celu nadrzędnego
|
parentId | string |
Jeśli ten cel jest podgoalny, unikatowy identyfikator jego celu nadrzędnego. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator celu. |
Tworzenie ewidencjonowania (wersja zapoznawcza)
Tworzy ewidencjonować cel usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Date
|
timestamp | True | date |
Data zaewidencjonu. Przykład: 2021-07-21 |
|
Wartość
|
value | number | ||
|
Status
|
status | string |
Stan celu. |
|
|
Uwaga / Notatka
|
note | string |
Może być tekstem wielowierszowy |
Tworzenie karty wyników (wersja zapoznawcza)
Tworzy kartę wyników dla celów usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Name
|
name | True | string |
Nazwa karty wyników |
|
Description
|
description | string |
Opis karty wyników |
Zwraca
Utworzono kartę wyników.
- Utworzono kartę wyników
- CreatedScorecard
Uruchamianie zapytania JSON względem zestawu danych
Użyj interfejsu API REST usługi Power BI, aby uruchomić zapytanie w formacie json.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Dataset
|
datasetid | True | string |
Unikatowy identyfikator zestawu danych. |
Zwraca
- response
- object
Uruchamianie zapytania względem zestawu danych
Użyj interfejsu API REST usługi Power BI, aby uruchomić zapytanie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Dataset
|
datasetid | True | string |
Unikatowy identyfikator zestawu danych. |
|
Tekst zapytania
|
query | True | string |
Tekst zapytania. Może to być tekst wielowierszowy. |
|
Uwzględnione wartości null
|
includeNulls | boolean |
Jeśli wartości null zostaną uwzględnione w wynikach. Wartość domyślna to Nie. |
|
|
Personifikuj użytkownika
|
impersonatedUserName | string |
Tożsamość użytkownika w formacie UPN, aby uruchomić zapytanie jako inny użytkownik. |
Zwraca
Wyniki wykonywania zapytania.
Uzyskiwanie celu (wersja zapoznawcza)
Pobiera określony cel usługi Power BI na karcie wyników.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
Zwraca
Informacje o celach.
- Goal
- FetchedGoal
Uzyskiwanie wielu celów (wersja zapoznawcza)
Pobierz listę celów usługi Power BI na określonej karcie wyników.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
Zwraca
Cała treść odpowiedzi.
- Pobierane
- FetchedGoals
Wyzwalacze
| Gdy bieżąca wartość celu zmieni się (wersja zapoznawcza) |
Gdy bieżąca wartość niektórych celów usługi Power BI ulegnie zmianie. |
| Gdy cel ulegnie zmianie (wersja zapoznawcza) |
Gdy zmienia się właściwość niektórych celów usługi Power BI. |
| Gdy ktoś dodaje lub edytuje zaewidencjonować cel (wersja zapoznawcza) |
Wyzwalacz dla niektórych zmian zaewidencjonu lub zanotuj cel usługi Power BI. |
| Gdy ktoś przypisze nowego właściciela do celu (wersja zapoznawcza) |
Gdy ktoś przypisze nowego właściciela do celu usługi Power BI. |
| Gdy odświeżanie danych dla celu zakończy się niepowodzeniem (wersja zapoznawcza) |
Gdy odświeżanie danych dla celu usługi Power BI zakończy się niepowodzeniem. |
| Gdy stan celu zmieni się (wersja zapoznawcza) |
Gdy stan niektórych celów usługi Power BI ulegnie zmianie. |
| Kliknięty przycisk usługi Power BI |
Ten wyzwalacz umożliwia uruchomienie przepływu po kliknięciu przycisku usługi Power BI. (Dostępne tylko dla usługi Power Automate). |
| Po wyzwoleniu alertu opartego na danych |
Zwróć szczegóły określonego alertu opartego na danych z usługi Power BI po wyzwoleniu alertu. |
Gdy bieżąca wartość celu zmieni się (wersja zapoznawcza)
Gdy bieżąca wartość niektórych celów usługi Power BI ulegnie zmianie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Interwał sondowania (s)
|
pollingInterval | True | number |
Liczba sekund między sprawdzaniem nowych danych. Wartość minimalna to 300. |
Zwraca
Zmieniono właściwości celu.
- Zmieniono cel
- GoalValueChanged
Gdy cel ulegnie zmianie (wersja zapoznawcza)
Gdy zmienia się właściwość niektórych celów usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Interwał sondowania (s)
|
pollingInterval | True | number |
Liczba sekund między sprawdzaniem nowych danych. Wartość minimalna to 300. |
Zwraca
Zmieniono właściwości celu.
- Zmieniono cel
- GoalChanged
Gdy ktoś dodaje lub edytuje zaewidencjonować cel (wersja zapoznawcza)
Wyzwalacz dla niektórych zmian zaewidencjonu lub zanotuj cel usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Interwał sondowania (s)
|
pollingInterval | True | number |
Liczba sekund między sprawdzaniem nowych danych. Wartość minimalna to 300. |
Zwraca
Dodano lub zmieniono ewidencjonacje lub notatki dotyczące celu.
- Zaktualizowany cel
- GoalValueOrNoteUpserted
Gdy ktoś przypisze nowego właściciela do celu (wersja zapoznawcza)
Gdy ktoś przypisze nowego właściciela do celu usługi Power BI.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Właściciel
|
owner |
Adres e-mail właściciela. Może być Twój. Może być pusty podczas śledzenia dowolnego właściciela. |
||
|
Interwał sondowania (s)
|
pollingInterval | True | number |
Liczba sekund między sprawdzaniem nowych danych. Wartość minimalna to 300. |
Zwraca
Przypisane informacje o bramkach.
- Przypisano
- GoalsAssigned
Gdy odświeżanie danych dla celu zakończy się niepowodzeniem (wersja zapoznawcza)
Gdy odświeżanie danych dla celu usługi Power BI zakończy się niepowodzeniem.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Śledzenie źródła docelowego
|
trackTargetSource | True | string |
Będzie śledzić link do celu. |
|
Śledzenie źródła wartości
|
trackValueSource | True | string |
Będzie śledzić link dla wartości celu. |
|
Interwał sondowania (s)
|
pollingInterval | True | number |
Liczba sekund między sprawdzaniem nowych danych. Wartość minimalna to 300. |
Zwraca
Problemy z niepowodzeniem odświeżania celu.
- Niepowodzenie odświeżania
- GoalRefreshIssues
Gdy stan celu zmieni się (wersja zapoznawcza)
Gdy stan niektórych celów usługi Power BI ulegnie zmianie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Unikatowy identyfikator obszaru roboczego. |
|
Identyfikator karty wyników
|
scorecardId | True | string |
Unikatowy identyfikator karty wyników. |
|
Identyfikator celu
|
goalId | True | string |
Unikatowy identyfikator celu. |
|
Interwał sondowania (s)
|
pollingInterval | True | number |
Liczba sekund między sprawdzaniem nowych danych. Wartość minimalna to 300. |
Zwraca
Zmieniono właściwości celu.
- Zmieniono cel
- GoalStatusChanged
Kliknięty przycisk usługi Power BI
Ten wyzwalacz umożliwia uruchomienie przepływu po kliknięciu przycisku usługi Power BI. (Dostępne tylko dla usługi Power Automate).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
gospodarz
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
headersSchema
|
headersSchema | object | ||
|
schemat
|
schema | object |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Wierszy
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
Adres e-mail użytkownika
|
headers.x-ms-user-email-encoded | byte |
Adres e-mail użytkownika, który wyzwolił przepływ. |
|
Nazwa użytkownika
|
headers.x-ms-user-name-encoded | byte |
Nazwa wyświetlana użytkownika, który wyzwolił przepływ. |
|
Sygnatura czasowa
|
headers.x-ms-user-timestamp | string |
Czas wyzwolenia przepływu. |
|
Identyfikator użytkownika
|
headers.x-ms-user-id | guid |
Unikatowy identyfikator użytkownika, który wyzwolił przepływ w usłudze AAD. |
Po wyzwoleniu alertu opartego na danych
Zwróć szczegóły określonego alertu opartego na danych z usługi Power BI po wyzwoleniu alertu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator alertu
|
alertId | True | string |
Identyfikator alertu do śledzenia. |
Zwraca
- Body
- EvaluatedAlert
Definicje
QueryExecutionResults
Wyniki wykonywania zapytania.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Pierwsze wiersze tabeli
|
firstTableRows | array of object |
Wyniki zapytania są tablicą wierszy. |
CreatedScorecard
Utworzono kartę wyników.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator karty wyników. |
ListedScorecards
Cała treść odpowiedzi.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Karty wyników
|
value | array of ListedScorecard |
Lista kart wyników. |
Karta ListedScorecard
Karta wyników.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator karty wyników. |
|
Name
|
name | string |
Nazwa karty wyników. |
|
Kontakt
|
contact | string |
Informacje kontaktowe karty wyników. |
FetchedGoals
Cała treść odpowiedzi.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Cele
|
value | array of FetchedGoal |
Lista celów. |
FetchedGoal
Informacje o celach.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator celu. |
|
Name
|
name | string |
Nazwa celu. |
|
Właściciel
|
owner |
Adres e-mail właściciela celu. |
|
|
Data rozpoczęcia
|
startDate | date |
Data rozpoczęcia celu. Przykład: 2021-07-15. |
|
Data ukończenia
|
completionDate | date |
Data ukończenia celu do ukończenia. Przykład: 2021-07-29. |
|
Identyfikator celu nadrzędnego
|
parentId | string |
Jeśli ten cel jest podgoalny, unikatowy identyfikator jego celu nadrzędnego. |
|
Bieżąca wartość
|
currentValue | number |
Bieżąca wartość śledzonego celu. |
|
Znacznik czasu bieżącej wartości
|
currentValueTimestamp | date |
Znacznik czasu, kiedy ustawiono bieżącą wartość celu. |
|
Wartość docelowa
|
targetValue | number |
Wartość docelowa celu. |
|
Sygnatura czasowa wartości docelowej
|
targetValueTimestamp | date |
Sygnatura czasowa ustawienia wartości docelowej celu. |
|
Status
|
status | string |
Stan celu. |
|
Sygnatura czasowa stanu
|
statusTimestamp | date |
Sygnatura czasowa ustawienia stanu celu. |
|
Częstotliwość
|
cycle | string |
Śledzenie interwału częstotliwości cyklu wyświetlanego na wizualizacjach tego celu. |
|
Data cyklu śledzenia
|
cyclePeriod | date |
Data ustalenia dodatkowych właściwości cyklu śledzenia. |
GoalChanged
Zmieniono właściwości celu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator celu. |
|
Stara nazwa
|
oldName | string |
Nazwa celu. |
|
Stary właściciel
|
oldOwner |
Adres e-mail właściciela celu. |
|
|
Stara data rozpoczęcia
|
oldStartDate | date |
Data rozpoczęcia celu. Przykład: 2021-07-15. |
|
Stara data ukończenia
|
oldCompletionDate | date |
Data ukończenia celu do ukończenia. Przykład: 2021-07-29. |
|
Stary identyfikator celu nadrzędnego
|
oldParentId | string |
Jeśli ten cel jest podgoalny, unikatowy identyfikator jego celu nadrzędnego. |
|
Stara bieżąca wartość
|
oldCurrentValue | number |
Bieżąca wartość śledzonego celu. |
|
Stara wartość docelowa
|
oldTargetValue | number |
Wartość docelowa celu. |
|
Stary stan
|
oldStatus | string |
Stan celu. |
|
Stara częstotliwość
|
oldCycle | string |
Stary interwał częstotliwości śledzenia wyświetlany na wizualizacjach tego celu. |
|
Stara data cyklu śledzenia
|
oldCyclePeriod | date |
Stara data ustalenia dodatkowych właściwości cyklu śledzenia. |
|
Nowa nazwa
|
newName | string |
Nazwa celu. |
|
Nowy właściciel
|
newOwner |
Adres e-mail właściciela celu. |
|
|
Nowa data rozpoczęcia
|
newStartDate | date |
Data rozpoczęcia celu. |
|
Nowa data ukończenia
|
newCompletionDate | date |
Data ukończenia celu do ukończenia. |
|
Nowy identyfikator celu nadrzędnego
|
newParentId | string |
Jeśli ten cel jest podgoalny, unikatowy identyfikator jego celu nadrzędnego. |
|
Nowa bieżąca wartość
|
newCurrentValue | number |
Bieżąca wartość śledzonego celu. |
|
Nowa wartość docelowa
|
newTargetValue | number |
Wartość docelowa celu. |
|
Nowy stan
|
newStatus | string |
Stan celu. |
|
Nowa częstotliwość
|
newCycle | string |
Nowy interwał śledzenia wyświetlany na wizualizacjach tego celu. |
|
Nowa data cyklu śledzenia
|
newCyclePeriod | date |
Nowa data ustalenia dodatkowych właściwości cyklu śledzenia. |
|
Lista zmian
|
changeList | string |
Rozdzielona przecinkami lista zmian. Przykład: "status,currentValue". |
GoalStatusChanged
Zmieniono właściwości celu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator celu. |
|
Stary stan
|
oldStatus | string |
Stan celu. |
|
Nowy stan
|
newStatus | string |
Stan celu. |
GoalValueChanged
Zmieniono właściwości celu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
id | string |
Unikatowy identyfikator celu. |
|
Stara bieżąca wartość
|
oldCurrentValue | number |
Bieżąca wartość śledzonego celu. |
|
Nowa bieżąca wartość
|
newCurrentValue | number |
Bieżąca wartość śledzonego celu. |
GoalRefreshIssues
Problemy z niepowodzeniem odświeżania celu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Issues
|
issues | array of GoalRefreshIssue |
Problemy z odświeżaniem celu. |
GoalRefreshIssue
Problem z odświeżaniem celu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Typ połączenia
|
connectionType | string |
Typ połączenia, bieżący lub docelowy. |
|
Sygnatura czasowa
|
timestamp | string |
Sygnatura czasowa niepowodzenia odświeżania. |
|
Komunikat o błędzie
|
message | string |
Opis błędu. |
CelePrzypisane
Przypisane informacje o bramkach.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Cele
|
assignedGoals | array of object |
Lista celów, które zostały przypisane do nowego właściciela. |
|
Id
|
assignedGoals.id | string |
Unikatowy identyfikator celu. |
|
Identyfikator karty wyników
|
assignedGoals.scorecardId | string |
Unikatowy identyfikator karty wyników. |
|
Name
|
assignedGoals.name | string |
Nazwa celu. |
|
Właściciel
|
assignedGoals.owner | string |
Nowy właściciel, do którego przypisano cel. |
|
Ostatnia modyfikacja przez
|
assignedGoals.lastModifiedBy | string |
Użytkownik, który ostatnio zmodyfikował cel. |
|
Data rozpoczęcia
|
assignedGoals.startDate | date |
Data rozpoczęcia celu. |
|
Data ukończenia
|
assignedGoals.completionDate | date |
Data zakończenia celu. |
GoalValueOrNoteUpserted
Dodano lub zmieniono ewidencjonacje lub notatki dotyczące celu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Ewidencjonacje
|
values | array of object |
Dodano lub zaktualizowano ewidencjonacje. |
|
Date
|
values.timestamp | date |
Data zaewidencjonu. |
|
Wartość
|
values.value | number |
Wartość celu w momencie zaewidencjonowania. |
|
Status
|
values.status | string |
Stan celu w momencie zaewidencjonowania. |
|
Notatki
|
notes | array of object |
Dodano lub zmieniono notatki. |
|
Data zaewidencjonu
|
notes.valueTimestamp | date |
Data zaewidencjonowania, do którego dodano tę notatkę. |
|
Tekst
|
notes.body | string |
Tekst nowo dodanej notatki. |
|
Czas utworzenia
|
notes.createdTime | datetime |
Data utworzenia notatki. |
Przypisy do celów
Lista notatek.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Tekst
|
body | string |
Zawartość notatki. |
|
Czas utworzenia
|
createdTime | datetime |
Data utworzenia notatki. |
OcenaAlert
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Tytuł alertu
|
alertTitle | string |
Tytuł alertu. |
|
Próg alertu
|
alertThreshold | number |
Próg wyzwalania alertu. |
|
Czy wyzwalany jest alert
|
isAlertTriggered | boolean |
Wartość logiczna (prawda, fałsz) określająca, czy alert został wyzwolony. |
|
Adres URL kafelka
|
tileUrl | string |
Adres URL łączący się z kafelka pulpitu nawigacyjnego, w którym jest skonfigurowany alert. |
|
Wartość kafelka
|
tileValue |
Wartość kafelka. |
binarny
Jest to podstawowy typ danych "binary".
obiekt
Jest to typ "object".