Microsoft Dataverse

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 - narzędzie do automatyzacji procesów	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

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.
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.
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	-

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.
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.
DateTime można zazwyczaj delegować z wyjątkiem funkcji DateTime Now() i Today().
Obsługuje porównanie. Na przykład: Filter(TableName, MyCol = Blank()).
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

Podmiot usługi

Identyfikator uwierzytelniania: ServicePrincipalOauth

Dotyczy: Wszystkie regiony

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

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	Ta akcja umożliwia dodanie nowego wiersza w wybranej tabeli Microsoft Dataverse. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
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 plik lub obraz	Ta akcja umożliwia pobranie pliku lub zawartości obrazu z tabeli Microsoft Dataverse. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Pobierz wiersz, używając identyfikatora	Ta akcja umożliwia pobranie wiersza zgodnego z identyfikatorem w tabeli Microsoft Dataverse. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Pobierz wiersz (starsza wersja) [PRZESTARZAŁE]	Ta operacja powoduje pobranie określonego wiersza tabeli
Przekaż plik lub obraz	Ta akcja umożliwia przekazanie pliku lub zawartości obrazu do tabeli Microsoft Dataverse z zgodnym typem kolumny. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Usuwanie wiersza	Ta akcja umożliwia usunięcie wiersza z tabeli Microsoft Dataverse. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Usuwanie wiersza (starsza wersja) [PRZESTARZAŁE]	Ta operacja powoduje usunięcie wiersza z kolekcji tabel
Usuń relację wierszy	Ta akcja umożliwia usunięcie połączenia między wierszem w jednej Microsoft Dataverse tabeli do innej, jeśli tabele mają relację jeden do wielu lub wiele do wielu. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Utwórz relację wierszy	Ta akcja umożliwia połączenie wiersza w jednej tabeli Microsoft Dataverse z inną, jeśli tabele mają relację jeden do wielu lub wiele do wielu. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Wykonaj akcję anulowania powiązania	Ta akcja umożliwia wykonywanie Microsoft Dataverse akcji dostępnych w środowisku, które nie są skojarzone z żadną tabelą.
Wykonaj akcję tworzenia powiązania	Ta akcja umożliwia wykonywanie Microsoft Dataverse akcji skojarzonych z wybraną tabelą.
Wykonaj żądanie zestawu zmian	Ta akcja umożliwia wykonanie grupy operacji Microsoft Dataverse łącznika jako pojedynczej transakcji. Jeśli jedna z operacji zakończy się niepowodzeniem, wszystkie zakończone powodzeniem akcje zostaną wycofane. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Wyszukiwanie wierszy	Ta akcja umożliwia wyszukiwanie środowiska Microsoft Dataverse przy użyciu wyszukiwania według istotności i zwraca wiersze, które najlepiej pasują do terminu wyszukiwania. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Wyświetl listę wierszy	Ta akcja umożliwia wyświetlenie listy wierszy w tabeli Microsoft Dataverse zgodnej z wybranymi opcjami. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
Wyświetlanie listy wierszy [PRZESTARZAŁE]	Ta operacja powoduje pobranie wierszy tabeli
Zaktualizuj wiersz	Ta akcja umożliwia zmodyfikowanie dowolnego zaznaczonego wiersza w tabeli Microsoft Dataverse lub dodanie nowego wiersza, jeśli nie istnieje. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Aktualizowanie wiersza (starsza wersja) [PRZESTARZAŁE]

Identyfikator operacji:: PatchItem_V2

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]

Identyfikator operacji:: PatchItem

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

Identyfikator operacji:: CreateRecord

Ta akcja umożliwia dodanie nowego wiersza w wybranej tabeli Microsoft Dataverse. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa tabeli	entityName	True	string	Wybierz tabelę
Element wiersza	item	True	dynamic	Wiersz do utworzenia

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Dodaj nowy wiersz [PRZESTARZAŁE]

Identyfikator operacji:: PostItem

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]

Identyfikator operacji:: PostItem_V2

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]

Identyfikator operacji:: GetItems_V2

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]

Identyfikator operacji:: GetItem

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 plik lub obraz

Identyfikator operacji:: GetEntityFileImageFieldContent

Ta akcja umożliwia pobranie pliku lub zawartości obrazu z tabeli Microsoft Dataverse. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa tabeli	entityName	True	string	Wybierz tabelę
ID wiersza	recordId	True	string	Wprowadź unikatowy identyfikator globalny (GUID) wiersza
Nazwa kolumny	fileImageFieldName	True	string	Wybierz kolumnę
Rozmiar obrazu	size		string	Wprowadź wartość „pełny”, aby pobrać cały obraz, jeśli ta możliwość jest włączona (wartość domyślna = miniatura)

Zwraca

Zawartość pliku lub obrazu

Zawartość pliku lub obrazu: binary

Pobierz wiersz, używając identyfikatora

Identyfikator operacji:: GetItemCodeless

Ta akcja umożliwia pobranie wiersza zgodnego z identyfikatorem w tabeli Microsoft Dataverse. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Adres URL organizacji	organization	True	string	Adres URL organizacji
Nazwa tabeli	entityName	True	string	Wybierz tabelę
ID wiersza	recordId	True	string	Wprowadź unikatowy identyfikator globalny (GUID) wiersza
Wybierz kolumny	$select		string	Wprowadź listę rozdzielonych przecinkami unikatowych nazw kolumn, aby ograniczyć liczbę kolumn umieszczanych na liście
Rozwiń zapytanie	$expand		string	Wprowadź zapytanie rozwijania w stylu protokołu Odata, aby wyświetlić listę powiązanych wierszy
Identyfikator partycji	partitionId		string	Opcja określenia identyfikatora partitionId podczas pobierania danych dla tabel NoSQL

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Pobierz wiersz (starsza wersja) [PRZESTARZAŁE]

Identyfikator operacji:: GetItem_V2

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.

Przekaż plik lub obraz

Identyfikator operacji:: UpdateEntityFileImageFieldContent

Ta akcja umożliwia przekazanie pliku lub zawartości obrazu do tabeli Microsoft Dataverse z zgodnym typem kolumny. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa tabeli	entityName	True	string	Wybierz tabelę
ID wiersza	recordId	True	string	Wprowadź unikatowy identyfikator globalny (GUID) wiersza
Nazwa kolumny	fileImageFieldName	True	string	Wybierz kolumnę
Content	item	True	binary	Dodaj zawartość pliku lub obrazu
Nazwa zawartości	x-ms-file-name	True	string	Wprowadź nazwę pliku lub obrazu

Usuwanie wiersza

Identyfikator operacji:: DeleteRecord

Ta akcja umożliwia usunięcie wiersza z tabeli Microsoft Dataverse. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Adres URL organizacji	organization	True	string	Adres URL organizacji
Nazwa tabeli	entityName	True	string	Wybierz tabelę
ID wiersza	recordId	True	string	Wprowadź unikatowy identyfikator globalny (GUID) wiersza
Identyfikator partycji	partitionId		string	Opcja określenia identyfikatora partitionId podczas usuwania wiersza dla tabel NoSQL

Usuwanie wiersza (starsza wersja) [PRZESTARZAŁE]

Identyfikator operacji:: DeleteItem

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

Usuń relację wierszy

Identyfikator operacji:: DisassociateEntities

Ta akcja umożliwia usunięcie połączenia między wierszem w jednej Microsoft Dataverse tabeli do innej, jeśli tabele mają relację jeden do wielu lub wiele do wielu. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa tabeli	entityName	True	string	Wybierz tabelę
ID wiersza	recordId	True	string	Wprowadź unikatowy identyfikator globalny (GUID) wiersza
Relationship	associationEntityRelationship	True	string	Wybierz typ relacji
Usuń relację z	$id	True	string	Wprowadź adres URL wiersza, używając identyfikatora OData z poprzedniego kroku lub wpisując pełny adres URL (np. https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

Utwórz relację wierszy

Identyfikator operacji:: AssociateEntities

Ta akcja umożliwia połączenie wiersza w jednej tabeli Microsoft Dataverse z inną, jeśli tabele mają relację jeden do wielu lub wiele do wielu. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa tabeli	entityName	True	string	Wybierz tabelę
ID wiersza	recordId	True	string	Wprowadź unikatowy identyfikator globalny (GUID) wiersza
Relationship	associationEntityRelationship	True	string	Wybierz typ relacji
Utwórz relację z	@odata.id	True	string	Wprowadź adres URL wiersza, używając identyfikatora OData z poprzedniego kroku lub wpisując pełny adres URL (np. https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

Wykonaj akcję anulowania powiązania

Identyfikator operacji:: PerformUnboundAction

Ta akcja umożliwia wykonywanie Microsoft Dataverse akcji dostępnych w środowisku, które nie są skojarzone z żadną tabelą.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa akcji	actionName	True	string	Wybieranie akcji
Parametry akcji	item		dynamic	Parametry akcji

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wykonaj akcję tworzenia powiązania

Identyfikator operacji:: PerformBoundAction

Ta akcja umożliwia wykonywanie Microsoft Dataverse akcji skojarzonych z wybraną tabelą.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa tabeli	entityName	True	string	Wybierz tabelę
Nazwa akcji	actionName	True	string	Wybieranie akcji
ID wiersza	recordId	True	string	Wprowadź unikatowy identyfikator globalny (GUID) wiersza
Parametry akcji	item		dynamic	Parametry akcji

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wykonaj żądanie zestawu zmian

Identyfikator operacji:: ExecuteChangeset

Ta akcja umożliwia wykonanie grupy operacji Microsoft Dataverse łącznika jako pojedynczej transakcji. Jeśli jedna z operacji zakończy się niepowodzeniem, wszystkie zakończone powodzeniem akcje zostaną wycofane. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Wyszukiwanie wierszy

Identyfikator operacji:: GetRelevantRows

Ta akcja umożliwia wyszukiwanie środowiska Microsoft Dataverse przy użyciu wyszukiwania według istotności i zwraca wiersze, które najlepiej pasują do terminu wyszukiwania. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Adres URL organizacji	organization	True	string	Adres URL organizacji
Termin wyszukiwania	search	True	string	Wpisz wyszukiwane hasło, np. Contoso. Modyfikatory wyszukiwania, takie jak operatory logiczne, symbole wieloznaczne, wyszukiwanie rozmyte, wyszukiwanie zbliżeniowe itp., wymagają pełnego typu wyszukiwania
Typ wyszukiwania	searchtype		string	Określ, czy ma być używana składnia prostego, czy pełnego wyszukiwania (domyślnie jest używane wyszukiwanie proste)
Tryb wyszukiwania	searchmode		string	Określ, czy jest wymagane dopasowanie dowolnego, czy wszystkich terminów wyszukiwania (domyślnie jest dopasowywany dowolny termin)
Liczba wierszy	top		integer	Wprowadź liczbę wyników wyszukiwania do umieszczenia na liście (wartość domyślna = 50)
Filtr wierszy	filter		string	Wprowadź wyrażenie filtru stylów protokołu OData, aby zawęzić wyszukiwanie
Filtr tabel	entities		array of string	Wprowadź listę rozdzielonych przecinkami tabel do przeszukania (domyślnie są przeszukiwane wszystkie tabele)
Sortuj według	orderby		array of string	Wprowadź listę rozdzielonych przecinkami unikatowych nazw kolumn, po których następuje ciąg „asc” lub „desc”.
Zapytanie aspektowe	facets		array of string	Wprowadź listę rozdzielonych przecinkami zapytań aspektowych, aby zawęzić wyszukiwanie
Pomiń wiersze	skip		integer	Wprowadź liczbę wyników wyszukiwania do pominięcia
Zwróć liczbę wierszy	returntotalrecordcount		boolean	Wybierz opcję

Zwraca

Dane wyjściowe wyszukiwania.

Body: SearchOutput

Wyświetl listę wierszy

Identyfikator operacji:: ListRecords

Ta akcja umożliwia wyświetlenie listy wierszy w tabeli Microsoft Dataverse zgodnej z wybranymi opcjami. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa tabeli	entityName	True	string	Wybierz tabelę
Wybierz kolumny	$select		string	Wprowadź listę rozdzielonych przecinkami unikatowych nazw kolumn, aby ograniczyć liczbę kolumn umieszczanych na liście
Filtrowanie wierszy	$filter		string	Wprowadź wyrażenie filtru w stylu protokołu OData, aby ograniczyć liczbę wierszy umieszczanych na liście
Sortuj wg	$orderby		string	Kolumny, według których będzie wykonywane sortowanie w stylu orderBy protokołu OData (z wykluczeniem odnośników)
Rozwiń zapytanie	$expand		string	Wprowadź zapytanie rozwijania w stylu protokołu Odata, aby wyświetlić listę powiązanych wierszy
Zapytanie języka FetchXML	fetchXml		string	Wprowadź zapytanie w języku FetchXML, aby wykonać dostosowanie zaawansowane
Liczba wierszy	$top		integer	Wprowadź liczbę wierszy do umieszczenia na liście (wartość domyślna = 5000)
Pomiń token	$skiptoken		string	Wprowadź token pomijania uzyskany w poprzednim przebiegu, aby wyświetlić listę wierszy z następnej strony
Identyfikator partycji	partitionId		string	Opcja określenia identyfikatora partitionId podczas pobierania danych dla tabel NoSQL

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wyświetlanie listy wierszy [PRZESTARZAŁE]

Identyfikator operacji:: GetItems

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.

Zaktualizuj wiersz

Identyfikator operacji:: UpdateRecord

Ta akcja umożliwia zmodyfikowanie dowolnego zaznaczonego wiersza w tabeli Microsoft Dataverse lub dodanie nowego wiersza, jeśli nie istnieje. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Adres URL organizacji	organization	True	string	Adres URL organizacji
Nazwa tabeli	entityName	True	string	Wybierz tabelę
ID wiersza	recordId	True	string	Wprowadź unikatowy identyfikator globalny (GUID) wiersza
Element wiersza	item	True	dynamic	Wiersz do zaktualizowania

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, zaktualizowaniu lub usunięciu wiersza	Ten wyzwalacz umożliwia uruchomienie przepływu po dodaniu, zmodyfikowaniu lub usunięciu wiersza w tabeli Microsoft Dataverse, tak aby był zgodny z wybranymi opcjami. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.
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 zrealizowaniu akcji	Wyzwala po zakończeniu akcji Microsoft Dataverse.

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

Identyfikator operacji:: GetOnUpdatedItems

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]

Identyfikator operacji:: GetOnUpdatedItems_V2

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]

Identyfikator operacji:: SubscribeOnUpdatedItems

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]

Identyfikator operacji:: GetOnDeletedItems

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]

Identyfikator operacji:: SubscribeOnDeletedItems

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, zaktualizowaniu lub usunięciu wiersza

Identyfikator operacji:: SubscribeWebhookTrigger

Ten wyzwalacz umożliwia uruchomienie przepływu po dodaniu, zmodyfikowaniu lub usunięciu wiersza w tabeli Microsoft Dataverse, tak aby był zgodny z wybranymi opcjami. Ten łącznik był wcześniej znany jako Common Data Service (starsza wersja) i zastępuje łącznik Dynamics 365.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Nazwa tabeli	entityname	True	string	Wybierz tabelę
Zmień typ	message	True	integer	Określ, kiedy ma być wyzwalany przepływ
Scope	scope	True	integer	Wybierz zakres, aby ograniczyć liczbę wierszy, które mogą wyzwalać przepływ
Wybierz kolumny	filteringattributes		string	Wprowadź rozdzielaną przecinkami listę unikatowych nazw kolumn. Przepływ jest wyzwalany, jeśli którykolwiek z nich zostanie zmodyfikowany
Filtrowanie wierszy	filterexpression		string	Wprowadź wyrażenie filtru stylu OData, aby określić, które wiersze mogą wyzwalać przepływ
Opóźnij do	postponeuntil		string	Wprowadź godzinę, aby opóźnić obliczanie wyzwalacza, np. 2020-01-01T10:10:00Z
Uruchom jako	runas		integer	Wybierz użytkownika uruchamiającego dla kroków, w których są używane połączenia elementu wywołującego

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

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

Identyfikator operacji:: GetOnNewItems_V2

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]

Identyfikator operacji:: GetOnNewItems

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]

Identyfikator operacji:: SubscribeOnNewItems

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 zrealizowaniu akcji

Identyfikator operacji:: BusinessEventsTrigger

Wyzwala po zakończeniu akcji Microsoft Dataverse.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Environment	organization	True	string	Wybierz środowisko
Catalog	catalog	True	string	Wybierz opcję, aby filtrować tabele i akcje.
Kategoria	category	True	string	Wybierz opcję, aby filtrować tabele i akcje.
Nazwa tabeli	entityname	True	string	Wybierz tabelę, aby filtrować akcje.
Nazwa akcji	sdkmessagename	True	string	Wybierz akcję.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Definicje

Wyszukiwanie danych wyjściowych

Dane wyjściowe wyszukiwania.

Nazwa	Ścieżka	Typ	Opis
Lista wierszy	value	array of object	Lista wierszy
Wynik wyszukiwania wiersza	value.@search.score	number	Wynik wyszukiwania wiersza
Nazwa tabeli wiersza	value.@search.entityname	string	Tabela zawierająca wiersz
Identyfikator obiektu wiersza	value.@search.objectid	string	Identyfikator Objectid wiersza
Kod typu obiektu wiersza	value.@search.objecttypecode	integer	Kod Objecttypecode wiersza
Łączna liczba wierszy	totalrecordcount	integer	Łączna liczna wyników (-1, jeśli właściwość returntotalrecordcount ma wartość „fałsz”)

binarny

Jest to podstawowy typ danych "binary".