Udostępnij przez


Microsoft Dataverse [PRZESTARZAŁE]

Zapewnia dostęp do bazy danych środowiska w Microsoft Dataverse.

Ten łącznik jest dostępny w następujących produktach i regionach:

Service Klasa Regiony
Copilot Studio Premium Wszystkie Power Automate regiony
Logic Apps Standard Wszystkie regiony usługi Logic Apps
Power Apps - Niedostępny
Power Automate Premium Wszystkie Power Automate regiony
Contact
Nazwa/nazwisko Microsoft
adres URL Obsługa usługi Microsoft LogicApps
Microsoft Power Automate Wsparcie
Metadane łącznika
Wydawca Microsoft
Witryna sieci web https://powerapps.microsoft.com/common-data-service/

Notatka

Microsoft Dataverse (starsza wersja) łącznika będzie obsługiwana przez firmę Microsoft, Microsoft Dataverse dopóki łącznik nie będzie obsługiwał usługi Logic Apps.

Aby użyć tego łącznika w Power Apps, dowiedz się więcej o tym, jak używać tego łącznika w Power Apps.

Znane problemy i ograniczenia

  1. Zdarzają się sytuacje, w których wyzwalacze CDS nie działają w środowisku produkcyjnym z trybem administracyjnym ustawionym na "włączony". Jeśli wystąpi ten problem, obejściem tego problemu będzie wyłączenie trybu administratora w centrum administracyjnym Power Platforms.
  2. Jeśli tryb administracyjny jest włączony dla używanego środowiska (piaskownicy lub środowiska produkcyjnego), Power Automate przepływ z wyzwalaczem Gdy rekord jest modyfikowany , nie będzie uruchamiany, gdy rekord zostanie zmodyfikowany. Więcej informacji na temat ustawiania trybu administracyjnego można znaleźć na tej stronie.
  3. Jeśli używasz wyzwalacza "Po wybraniu rekordu" w przepływie, a zaraz po nim masz krok Jeśli warunek, zostanie wyświetlony błąd, jeśli atrybut w warunku ma wartość null. Komunikat o błędzie, który zobaczysz, to "Nieprawidłowy typ. Oczekiwano ciągu, ale otrzymano wartość Null.". Sugerowanym obejściem tego problemu jest wstawienie akcji "Pobierz wiersz" między krokiem "Po wybraniu rekordu" a krokiem Jeśli warunek. Korzystając z danych wyjściowych akcji "Pobierz wiersz" w swoim stanie, będziesz w stanie uniknąć tego błędu.

Mapowanie typu danych Power Apps

Power Apps Microsoft Dataverse (starsza wersja)
Opcja wyboru Wybór, tak/nie
DateTime Data i godzina, data i godzina, tylko data
obraz obraz
Liczba Liczba zmiennoprzecinkowa, waluta, liczba dziesiętna, czas trwania, język, strefa czasowa, liczba całkowita
Tekst E-mail, tekst wielowierszowy, telefon, tekst, obszar tekstowy, symbol giełdowy, adres URL
Identyfikator GUID Unikatowy identyfikator

Delegowane funkcje i operacje Power Apps dla Dataverse

Te operacje Power Apps dla danego typu danych mogą być delegowane do Dataverse w celu przetwarzania (zamiast przetwarzania lokalnego w Power Apps).

Produkt Numer [1] Tekst [2] Opcja wyboru Data/godzina [3] Identyfikator GUID
Filtruj Tak Tak Tak Tak Tak
Sortuj Tak Tak Nie Tak -
SortByColumns Tak Tak Nie Tak -
Lookup Tak Tak Tak Tak Tak
=, <> Tak Tak Tak Tak Tak
<, <=, >, >= Tak Tak Nie Tak -
And/Or/Not Tak Tak Tak Tak Tak
StartsWith - Tak - - -
IsBlank Tak [4] Tak [4] Nie [4] Tak [4] Tak
Suma, minimalna, maksymalna, średnia Tak [5] - - Nie -
  1. Wartości liczbowe z wyrażeniami arytmetycznymi (na przykład Filter(tabela, pole + 10 > 100) ) nie są delegowalne. Język i strefa czasowa nie są delegowalne.
  2. Nie obsługuje opcji Przycinanie [Zakończenia] ani Len. Obsługuje inne funkcje, takie jak Lewy, Środkowy, Prawy, Górny, Dolny, Zamień, Zastąp itp.
  3. DateTime można zazwyczaj delegować z wyjątkiem funkcji DateTime Now() i Today().
  4. Obsługuje porównanie. Na przykład: Filter(TableName, MyCol = Blank()).
  5. Funkcje agregujące są ograniczone do kolekcji 50 000 wierszy. W razie potrzeby użyj funkcji Filter, aby wybrać 50 000 wierszy z większego zbioru przed rozpoczęciem korzystania z funkcji agregującej.

Notatka

Funkcje Choices, Guids i Aggregate dla Dataverse są obsługiwane tylko w nowej wersji łącznika. W zależności od używanej wersji usługi Power Apps, włącz ten łącznik za pomocą przełącznika Podgląd o nazwie:

  • Dane relacyjne, wybory i inne nowe funkcje dla Dataverse
    lub ten eksperymentalny przełącznik:
  • Korzystanie z łącznika Dataverse
    Aby znaleźć te przełączniki, otwórz menu Plik, a następnie wybierz Ustawienia >aplikacji Ustawienia zaawansowane.

Szczegółowe informacje o konektorze

Aby uzyskać więcej informacji na temat łącznika, zobacz szczegółową sekcję.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Uwierzytelnianie certyfikatu klienta Podaj poświadczenia identyfikatora entra firmy Microsoft przy użyciu certyfikatu PFX i hasła Wszystkie regiony Udostępnialne
Uwierzytelnianie Oauth Uwierzytelnianie Oauth Wszystkie regiony Udostępnialne
Główna usługa Podaj poświadczenia identyfikatora entra firmy Microsoft przy użyciu identyfikatora klienta i wpisu tajnego Wszystkie regiony Udostępnialne
Domyślne [PRZESTARZAŁE] Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. Wszystkie regiony Nie można udostępniać

Uwierzytelnianie certyfikatu klienta

Identyfikator uwierzytelniania: CertOauth

Dotyczy: Wszystkie regiony

Podaj poświadczenia identyfikatora entra firmy Microsoft przy użyciu certyfikatu PFX i hasła

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Nazwa/nazwisko Typ Description Wymagane
Tenant ciąg Prawda
ID klienta ciąg Identyfikator klienta aplikacji Microsoft Entra ID Prawda
Klucz tajny certyfikatu klienta certyfikat klienta Klucz tajny certyfikatu klienta dozwolony przez tę aplikację Prawda

Uwierzytelnianie Oauth

Identyfikator uwierzytelniania: Oauth

Dotyczy: Wszystkie regiony

Uwierzytelnianie Oauth

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Podmiot usługi

Identyfikator uwierzytelniania: ServicePrincipalOauth

Dotyczy: Wszystkie regiony

Podaj poświadczenia identyfikatora entra firmy Microsoft przy użyciu identyfikatora klienta i wpisu tajnego

Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs

Nazwa/nazwisko Typ Description Wymagane
ID klienta ciąg Identyfikator klienta (lub aplikacji) aplikacji Microsoft Entra ID. Prawda
Tajemnica klienta securestring Wpis tajny klienta aplikacji Microsoft Entra ID. Prawda
Tenant ciąg Identyfikator dzierżawy aplikacji Microsoft Entra ID. Prawda

Domyślne [PRZESTARZAŁE]

Dotyczy: Wszystkie regiony

Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.

To nie jest połączenie, którego można udostępniać. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 1000 60 s

Akcje

Aktualizowanie wiersza (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje zaktualizowanie istniejącego wiersza tabeli

Aktualizowanie wiersza [PRZESTARZAŁE]

Ta operacja powoduje zaktualizowanie istniejącego wiersza tabeli

Dodaj nowy wiersz [PRZESTARZAŁE]

Ta operacja powoduje dodanie nowego wiersza tabeli

Dodawanie nowego wiersza (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje dodanie nowego wiersza tabeli

Lista wierszy (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje pobranie wierszy tabeli

Pobiera wiersz z tabeli [PRZESTARZAŁE]

Pobiera wiersz z tabeli

Pobierz wiersz (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje pobranie określonego wiersza tabeli

Usuwanie wiersza (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje usunięcie wiersza z kolekcji tabel

Wyświetlanie listy wierszy [PRZESTARZAŁE]

Ta operacja powoduje pobranie wierszy tabeli

Aktualizowanie wiersza (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje zaktualizowanie istniejącego wiersza tabeli

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Identyfikator wiersza
id True string

Identyfikator wiersza

Element wiersza
item True dynamic

Wiersz do zaktualizowania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Aktualizowanie wiersza [PRZESTARZAŁE]

Ta operacja powoduje zaktualizowanie istniejącego wiersza tabeli

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Identyfikator wiersza
id True string

Identyfikator wiersza

Element wiersza
item True dynamic

Wiersz do zaktualizowania

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Dodaj nowy wiersz [PRZESTARZAŁE]

Ta operacja powoduje dodanie nowego wiersza tabeli

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Element wiersza
item True dynamic

Wiersz do utworzenia

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Dodawanie nowego wiersza (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje dodanie nowego wiersza tabeli

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Element wiersza
item True dynamic

Wiersz do utworzenia

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Lista wierszy (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje pobranie wierszy tabeli

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Przekształcenie agregacji
$apply string

Sekwencja przekształceń agregacji protokołu OData

Zapytanie filtru
$filter string

Zapytanie filtru ODATA służące do ograniczania wpisów zwróciło wynik (np. stringColumn eq 'ciąg' OR numberColumn lt 123).

Uporządkuj wg
$orderby string

Zapytanie orderBy protokołu ODATA służące do określania kolejności wpisów.

Liczba pierwszych
$top integer

Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).

Rozwiń zapytanie
$expand string

Powiązane wpisy do uwzględniania z żądanymi wpisami (wartość domyślna = brak)

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobiera wiersz z tabeli [PRZESTARZAŁE]

Pobiera wiersz z tabeli

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Identyfikator przedmiotu
id True string

Identyfikator wiersza

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobierz wiersz (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje pobranie określonego wiersza tabeli

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Identyfikator przedmiotu
id True string

Identyfikator wiersza

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Usuwanie wiersza (starsza wersja) [PRZESTARZAŁE]

Ta operacja powoduje usunięcie wiersza z kolekcji tabel

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Identyfikator przedmiotu
id True string

Identyfikator wiersza

Wyświetlanie listy wierszy [PRZESTARZAŁE]

Ta operacja powoduje pobranie wierszy tabeli

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Zapytanie filtru
$filter string

Zapytanie filtru ODATA służące do ograniczania wpisów zwróciło wynik (np. stringColumn eq 'ciąg' OR numberColumn lt 123).

Uporządkuj wg
$orderby string

Zapytanie orderBy protokołu ODATA służące do określania kolejności wpisów.

Liczba pierwszych
$top integer

Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).

Rozwiń zapytanie
$expand string

Powiązane wpisy do uwzględniania z żądanymi wpisami (wartość domyślna = brak)

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wyzwalacze

Gdy wiersz jest modyfikowany (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz jest modyfikowany w Dataverse

Gdy wiersz jest modyfikowany (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz jest modyfikowany w Dataverse

Gdy wiersz jest modyfikowany [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz jest modyfikowany Dataverse.

Gdy wiersz zostanie usunięty (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz zostanie usunięty w Dataverse

Gdy wiersz zostanie usunięty [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz zostanie usunięty Dataverse.

Po dodaniu wiersza (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ po dodaniu wiersza Dataverse

Po dodaniu wiersza (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ po dodaniu wiersza Dataverse

Po dodaniu wiersza [PRZESTARZAŁE]

Wyzwala przepływ po dodaniu Dataverse wiersza.

Po wybraniu wiersza

Wyzwól przepływ po wybraniu wiersza z menu Przepływ na pasku poleceń. (Dostępne tylko dla Power Automate.)

Gdy wiersz jest modyfikowany (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz jest modyfikowany w Dataverse

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Gdy wiersz jest modyfikowany (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz jest modyfikowany w Dataverse

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Gdy wiersz jest modyfikowany [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz jest modyfikowany Dataverse.

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko.

Nazwa tabeli
table True string

Wybierz tabelę.

Scope
scope True string

Zakres.

Filtry kolumn
AttributeFilters array of string

Filtry kolumn

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Gdy wiersz zostanie usunięty (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz zostanie usunięty w Dataverse

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Gdy wiersz zostanie usunięty [PRZESTARZAŁE]

Wyzwala przepływ, gdy wiersz zostanie usunięty Dataverse.

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko.

Nazwa tabeli
table True string

Wybierz tabelę.

Scope
scope True string

Zakres.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po dodaniu wiersza (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ po dodaniu wiersza Dataverse

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po dodaniu wiersza (tylko administrator) [PRZESTARZAŁE]

Wyzwala przepływ po dodaniu wiersza Dataverse

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko

Nazwa tabeli
table True string

Wybierz tabelę

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po dodaniu wiersza [PRZESTARZAŁE]

Wyzwala przepływ po dodaniu Dataverse wiersza.

Parametry

Nazwa Klucz Wymagane Typ Opis
Environment
dataset True string

Wybierz środowisko.

Nazwa tabeli
table True string

Wybierz tabelę.

Scope
scope True string

Zakres.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Po wybraniu wiersza

Wyzwól przepływ po wybraniu wiersza z menu Przepływ na pasku poleceń. (Dostępne tylko dla Power Automate.)

Parametry

Nazwa Klucz Wymagane Typ Opis
operationId
operationId True string
gospodarz
host object
parametry
parameters True object
schemat
schema True object
headersSchema (Schemat nagłówków)
headersSchema object

Zwraca

Nazwa Ścieżka Typ Opis
wiersze
body.rows array of object
elementy(-ów)
body.rows object
Identyfikator użytkownika
headers.x-ms-user-id-encoded guid

Unikatowy identyfikator użytkownika, który wyzwolił przepływ w usłudze AAD.

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

Godzina wyzwolenia przepływu.