Używanie list wierszy w przepływach

Użyj akcji Wiersze listy, aby pobrać wiele wierszy naraz ze struktury zapytania Microsoft Dataverse.

Pobieranie listy wierszy

Wykonaj te kroki, aby dodać akcję Wyświetl listę wierszy do przepływu, aby zwrócić do 5000 kont z tabeli Konta w usłudze Dataverse.

Uwaga

W usłudze Power Automate między innymi jest używany klasyczny projektant przepływów w chmurze lub projektant przepływów w chmurze z funkcją Copilot. Aby ustalić, którego projektanta używasz, przejdź do sekcji Uwaga w temacie Opis nowego projektanta przepływów w chmurze z możliwościami pomocnika.

Klasyczny projektant

1. Wybierz nowy krok, aby dodać akcję do przepływu.
2. Wprowadź wiersze listy w polu wyszukiwania Wyszukaj łączniki i akcje na karcie Wybierz operację.
3. Wybierz opcję Microsoft Dataverse, aby filtrować wyniki wyszukiwania w celu wyświetlenia tylko tych akcji, które powodują wyzwolenie Microsoft Dataverse.
4. Wybierz wiersze listy.
5. Wybierz tabelę Konta z listy Nazwa tabeli.
6. Zapisz i uruchom przepływ, aby potwierdzić, że zwrócono nie więcej niż 5000 wierszy.

Edytuj za pomocą funkcji Copilot

1. Wybierz znak plus (+) >Dodaj akcję.
2. Na ekranie Dodaj akcję wprowadź wiersze listy w polu Wyszukaj.
3. W obszarze Microsoft Dataverse wybierz Wyświetlanie listy wierszy (wersja zapoznawcza).
4. Na karcie Parametry po lewej stronie wybierz polecenie Konta w menu rozwijanym Nazwa tabeli.
5. Zamknij ekran, wybierając opcję (<<).

Włączanie stronicowania w celu żądania więcej niż 5000 wierszy

Aby automatycznie uzyskać więcej niż 5000 wierszy z zapytania, należy włączyć funkcję Stronicowanie w menu Ustawienia.

Jeśli zostanie ustawione stronicowanie, a ilość wierszy przekracza liczbę skonfigurowana dla progu, odpowiedź nie będzie uwzględniać parametru @odata.nextLink na potrzeby zażądania następnego zestawu wierszy. Wyłącz stronicowanie, aby odpowiedź uwzględniła parametr @odata.nextLink, który może zostać użyty do żądania następnego zestawu wierszy. Przejdź do pozycji Pomiń token, aby dowiedzieć się, jak go używać.

W celu zapewnienia ogólnych gwarancji poziomu usług stosowane są ograniczenia wydajności i rozmiaru i limity rozmiaru komunikatów.

Klasyczny projektant

1. W prawym górnym rogu karty Wyświetl listę wierszy wybierz menu (...).

2. Wybierz Ustawienia.

3. Przesuń suwak stronicowania w pozycję Wł., jeśli jeszcze nie został włączony.

4. W polu Próg wprowadź maksymalną liczbę żądanych wierszy. Maksymalny próg z możliwością skonfigurowania to 100 000.

   Wewnętrznie ta liczba jest zaokrąglana przy użyciu przyrostów domyślnego rozmiaru strony. Na przykład, jeśli rozmiar strony wynosi 5000, a Ty wprowadzisz 7000, liczba zwróconych wierszy wyniesie 10 000.

Edytuj za pomocą funkcji Copilot

1. Wybierz kartę Wyświetlanie listy wierszy.

2. W okienku po lewej stronie wybierz kartę Ustawienia >Sieci.

3. Przesuń suwak stronicowania w pozycję Wł., jeśli jeszcze nie został włączony.

4. W polu Próg wprowadź maksymalną liczbę żądanych wierszy. Maksymalny próg z możliwością skonfigurowania to 100 000.

   Wewnętrznie ta liczba jest zaokrąglana przy użyciu przyrostów domyślnego rozmiaru strony. Na przykład, jeśli rozmiar strony wynosi 5000, a Ty wprowadzisz 7000, liczba zwróconych wierszy wyniesie 10 000.

Opcje zaawansowane

Zaawansowane opcje akcji Wiersze listy umożliwiają sortowanie, filtrowanie, rozmieszczanie i rozszerzanie wyników zapytania.

Klasyczny projektant

Opcje zaawansowane można ustawić bezpośrednio na karcie Wyświetlanie listy wierszy. Aby zobaczyć te opcje, zaznacz Pokaż opcje zaawansowane. Po wybraniu tej opcji nazwa zmienia się na Ukryj opcje zaawansowane.

Edytuj za pomocą funkcji Copilot

Opcje można ustawić w okienku konfiguracji akcji.

1. Aby zobaczyć te opcje, wybierz kartę Wyświetlanie listy wierszy.

2. Na karcie Parametry wybierz opcje zaawansowane z menu rozwijanego pozycję Dodaj nowe parametry.

   

Wybierz kolumny

W tabeli Konto wprowadź rozdzieloną przecinkami listę kolumn do zwrócenia, na przykład „nazwa, utworzona, kod preferowanej metody kontaktu, adres e-mail1, telefon1”.

Filtruj wiersze

Służy do definiowania wyrażenia filtrującego w stylu OData, aby zawęzić zestaw wierszy zwracanych przez Dataverse, na przykład „createdon ge 2021-01-01T00:00:00-00:00” dla wierszy z createdon większym niż lub równa roku 2021.

Dowiedz się, jak używać standardowych operatorów filtrowania i funkcji zapytań do tworzenia zapytania filtrowanego.

Niektóre znaki, takie jak , i ,# oraz + należy zastąpić ich odpowiednikami zakodowanymi w adresie URL. Więcej informacji: Kodowanie znaków specjalnych w adresie URL

Ważne

Filtr nie może zawierać ciągu $filter=, ponieważ ma on zastosowanie tylko wtedy, gdy interfejsy API są stosowane bezpośrednio.

Sortuj według

Użyj do definiowania wyrażenia w stylu OData definiującego kolejność, w jakiej elementy są zwracane, na przykład "name desc". Użyj sufiksu asc lub desc do wskazania odpowiednio porządku rosnącego lub malejącego. Domyślna kolejność to rosnące.

Rozwiń zapytanie

Użyj do określenia wyrażenia w stylu OData definiującego dane zwracane przez Dataverse z tabel powiązanych, na przykład primarycontactid($select=contactid,fullname), aby użyć identyfikatora primarycontactid klienta w celu pobrania kolumny fullname z powiązanego kontaktu z identyfikatorem contactid w odpowiedzi.

Istnieją dwa typy właściwości nawigacyjnych, których można użyć w funkcji Rozwiń zapytanie:

1. Właściwości nawigacji z jedną wartością odpowiadają kolumnom wyszukiwania, które obsługują wiele-do-jednego relacje i umożliwiają ustawienie odwołania do innej tabeli.

2. Właściwości nawigacji z kolekcji odpowiadają właściwościom nawigacji typu jeden-do-wielu lub wiele-do-relacje.

Jeśli uwzględniana jest tylko nazwa właściwości nawigacji, otrzymasz wszystkie właściwości pokrewnych wierszy. Aby dowiedzieć się więcej, zobacz pobieranie pokrewnych wierszy tabeli za pomocą zapytania.

Aby użyć go w kroku przepływu, należy wprowadzić to wyrażenie Odata w polu Rozwiń zapytanie: primarycontactid(contactid,fullname). W ten sposób można uzyskać kolumny contactid i fullname dla primarycontactid każdego klienta.

Liczba wierszy

Użyj tej funkcji do wskazania określonej liczby wierszy Dataverse, które mają być zwracane. Poniżej pokazano, jak zażądać 10 wierszy.

Zapytanie języka FetchXML

Zapytania agregacji nie są obecnie obsługiwane w przypadku używania akcji Wyświetl listę wierszy z zapytaniami FetchXML. Obsługiwany jest jednak odrębny operator.

Klasyczny projektant

Użyj zapytania w stylu usługi Dataverse FetchXML, który zapewnia dodatkową elastyczność podczas tworzenia zapytań niestandardowych. Te zapytania mogą być przydatne, gdy pracujesz z tabelą, która ma wiele powiązanych ze sobą tabel, lub gdy obsługujesz paginację. Na poniższym zrzucie ekranu pokazano, jak używać FetchXML.

W polu Pobierz zapytanie Xml wpisz następujące dane.

Ponieważ inny operator nie jest obecnie obsługiwany bezpośrednio w zapytaniach FetchXML z akcji wyświetlania listy wierszy, można użyć funkcji związku do usunięcia zduplikowanych wierszy. Na przykład można użyć akcji wybierania, aby przekształcić odpowiedź połączenia wyświetlania listy wierszy na określony wymagany format tablicy, a następnie utworzyć zmienną z wyrażeniem union(body(‘Select’),body(‘Select’)), aby uzyskać tablicę z różnymi wierszami.

Edytuj za pomocą funkcji Copilot

Użyj zapytania w stylu usługi Dataverse FetchXML, który zapewnia dodatkową elastyczność podczas tworzenia zapytań niestandardowych. Te zapytania mogą być przydatne, gdy pracujesz z tabelą, która ma wiele powiązanych ze sobą tabel, lub gdy obsługujesz paginację. Na poniższym zrzucie ekranu pokazano, jak używać FetchXML.

Przykładowe zapytanie FetchXML dla tabeli Konta:

<fetch count="10">
	<entity name="account">
		<attribute name="name" />
		<attribute name="preferredcontactmethodcode" />
		<attribute name="emailaddress1" />
		<attribute name="telephone1" />
   		<link-entity name="contact" to="primarycontactid" from="contactid">
      			<attribute name="fullname" />
		</link-entity>
		<filter> 
			<condition attribute="createdon" operator="ge" value="2021-01-01T00:00:00-00:00" />
		</filter>
		<order attribute="name" descending="true" />
	</entity>
</fetch>

Ponieważ inny operator nie jest obecnie obsługiwany bezpośrednio w zapytaniach FetchXML z akcji wyświetlania listy wierszy, można użyć funkcji związku do usunięcia zduplikowanych wierszy. Na przykład można użyć akcji wybierania, aby przekształcić odpowiedź połączenia wyświetlania listy wierszy na określony wymagany format tablicy, a następnie utworzyć zmienną z wyrażeniem union(body(‘Select’),body(‘Select’)), aby uzyskać tablicę z różnymi wierszami.

Token pomijania

Ponieważ usługa Power Automate stosuje limity przepustowości zawartości i limity rozmiaru wiadomości aby zapewnić ogólne gwarancje usług, często przydatne jest użycie stronicowania w celu zwrócenia mniejszej liczby wierszy w partii, zamiast domyślnych limitów liczby zwracanych wierszy tabel.

Jeśli nie używasz paginacji, obowiązuje domyślny limit stron wynoszący 5000 wierszy.

Aby z niej skorzystać, zaimplementuj pętlę, która przetworzy wartość @odata.nextLink w odpowiedzi JSON, wyodrębni pomiń token, a następnie wyśle kolejne żądanie, aż wyświetli się liczba wierszy, których potrzebujesz.

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0  
Content-Length: 402  
Preference-Applied: odata.maxpagesize=3  
  
{  
   "@odata.context":"[Organization URI]/api/data/v9.1/$metadata#accounts(name)",
   "value":[  
      {  
         "@odata.etag":"W/\"437194\"",
         "name":"Fourth Coffee (sample)",
         "accountid":"7d51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"437195\"",
         "name":"Litware, Inc. (sample)",
         "accountid":"7f51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"468026\"",
         "name":"Adventure Works (sample)",
         "accountid":"8151925c-cde2-e411-80db-00155d2a68cb"
      }
   ],
   "@odata.nextLink":"[Organization URI]/api/data/v9.1/accounts?$select=name&$skiptoken=%3Ccookie%20pagenumber=%222%22%20pagingcookie=%22%253ccookie%2520page%253d%25221%2522%253e%253caccountid%2520last%253d%2522%257b8151925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520first%253d%2522%257b7D51925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520%252f%253e%253c%252fcookie%253e%22%20/%3E"
}

Identyfikator partycji

Opcja służąca do określania identyfikatora partitionId podczas pobierania danych dla tabel typu NoSQL. Aby dowiedzieć się więcej, zobacz temat Poprawianie wydajności przy użyciu partycji magazynu podczas uzyskiwania dostępu do danych tabeli.

Informacje pokrewne

• Szkolenie: Używanie wyzwalaczy Dataverse i akcji w Power Automate (moduł)
• Szkolenie: Integracja przepływów Power Automate i Dataverse (ścieżka szkoleniowa)