Gunakan senarai baris dalam aliran

Gunakan tindakan Senarai baris untuk mendapatkan semula berbilang baris sekaligus daripada Microsoft Dataverse dengan pertanyaan berstruktur.

Dapatkan senarai baris

Ikut langkah ini untuk menambah tindakan Senarai baris pada aliran anda untuk mengembalikan sehingga 5,000 akaun daripada jadual Akaun dalam Dataverse.

Power Automate membolehkan anda menggunakan sama ada pereka baharu atau pereka klasik untuk mengkonfigurasi aliran awan anda. Langkah-langkahnya serupa dalam kedua-dua pereka. Ketahui lebih lanjut (dengan contoh) dalam Kenal pasti perbezaan antara pereka bentuk baharu dan pereka bentuk klasik.

Pereka baru

1. Pilih tanda tambah (+)Tambah > tindakan.
2. Pada skrin Tambah tindakan , masukkan baris senarai dalam medan Carian .
3. Di bawah Microsoft Dataverse, pilih Senarai baris (Pratonton).
4. Pada tab Parameter di sebelah kiri, pilih Akaun dalam menu lungsur turun Nama Jadual .
5. Tutup skrin dengan memilih (<<).

Pereka klasik

1. Pilih Langkah baharu untuk menambah tindakan pada aliran anda.
2. Masukkan baris senarai ke dalam kotak carian Cari penyambung dan tindakan pada kad Pilih operasi .
3. Pilih Microsoft Dataverse untuk menapis hasil carian untuk memaparkan tindakan dan pencetus sahaja untuk Microsoft Dataverse.
4. Pilih Senarai baris.
5. Pilih jadual Akaun daripada senarai nama jadual.
6. Simpan dan jalankan aliran anda untuk mengesahkan bahawa tidak lebih daripada 5,000 baris dikembalikan.

Hidupkan penomboran untuk meminta lebih daripada 5,000 baris

Untuk mendapatkan lebih daripada 5,000 baris daripada pertanyaan secara automatik, hidupkan ciri Penomboran daripada Tetapan.

Apabila anda menetapkan penpaginahan dan bilangan baris melebihi ambang yang anda konfigurasikan, respons tidak termasuk @odata.nextLink parameter untuk meminta set baris seterusnya. Matikan penpaginahan supaya respons termasuk @odata.nextLink parameter yang boleh anda gunakan untuk meminta set baris seterusnya. Pergi ke Langkau token untuk mengetahui cara menggunakannya.

Had pemprosesan kandungan dan had saiz mesej digunakan untuk memastikan jaminan perkhidmatan am.

Pereka baru

1. Pilih kad Senarai baris .

2. Pada anak tetingkap di sebelah kiri, pilih tab Tetapan >Rangkaian.

3. Gerakkan peluncur Pagination ke kedudukan On jika belum dihidupkan.

4. Dalam Ambang, masukkan bilangan baris maksimum yang diminta. Ambang maksimum yang boleh dikonfigurasikan ialah 100,000.

   Secara dalaman, nombor ini dibundarkan dalam kenaikan saiz halaman lalai. Contohnya, jika saiz halaman tersebut ialah 5,000 dan anda memasukkan 7,000, bilangan baris yang dikembalikan ialah 10,000.

Pereka klasik

1. Di penjuru kanan sebelah atas kad Senarai , pilih menu (...).

2. Pilih Tetapan.

3. Gerakkan peluncur Pagination ke kedudukan On jika belum dihidupkan.

4. Dalam Ambang, masukkan bilangan baris maksimum yang diminta. Ambang maksimum yang boleh dikonfigurasikan ialah 100,000.

   Secara dalaman, nombor ini dibundarkan dalam kenaikan saiz halaman lalai. Contohnya, jika saiz halaman tersebut ialah 5,000 dan anda memasukkan 7,000, bilangan baris yang dikembalikan ialah 10,000.

Opsyen lanjutan

Pilihan lanjutan untuk tindakan Baris Senarai membolehkan anda menyusun, menapis, menyusun, dan memperluaskan hasil pertanyaan.

Pereka baru

Tetapkan pilihan dalam panel konfigurasi tindakan.

1. Untuk melihat pilihan, pilih kad Senarai baris .

2. Dalam tab Parameter , pilih pilihan lanjutan dalam menu lungsur Parameter Lanjutan .

   

Pereka klasik

Tetapkan pilihan lanjutan terus pada kad baris Senarai . Untuk melihat pilihan, pilih Tunjukkan opsyen lanjutan. Apabila anda memilihnya, nama bertukar kepada Sembunyikan pilihan lanjutan.

Kembalikan metadata penuh

Tetapan ini mengawal sama ada untuk memuatkan semua lajur dari jadual atau hanya lajur penting untuk prestasi yang lebih baik. Jika anda tidak menetapkannya, tindakan tersebut secara automatik mengembalikan metadata penuh jika aliran anda menggunakan kandungan dinamik atau ekspresi yang memerlukannya.

Pilih lajur

Masukkan senarai lajur yang dipisahkan koma untuk dikembalikan, seperti name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 untuk jadual Akaun.

Tapis baris

Gunakan medan ini untuk mentakrifkan ungkapan penapis gaya OData bagi mengecilkan set baris yang dikembalikan oleh Dataverse, seperti createdon ge 2021-01-01T00:00:00-00:00 untuk baris dengan createdon lebih besar atau sama dengan tahun 2021.

Pelajari cara menapis baris untuk membina ungkapan Pertanyaan Penapis .

Gantikan aksara tertentu, seperti &, #, dan +, dengan setara yang dikodkan URL. Untuk maklumat lanjut, lihat URL encode aksara khas.

Penting

Ungkapan penapis tidak boleh mengandungi rentetan ini, $filter=, kerana ia hanya digunakan apabila anda menggunakan API secara langsung.

Isih mengikut

Gunakan medan ini untuk mentakrifkan ungkapan gaya OData yang menentukan susunan item dikembalikan, seperti name desc. Gunakan akhiran asc atau desc untuk menunjukkan susunan menaik atau menurun, masing-masing. Tertib lalai menaik.

Kembangkan pertanyaan

Gunakan medan ini untuk menentukan ungkapan gaya OData yang mentakrifkan data yang dikembalikan Dataverse dari jadual berkaitan, seperti primarycontactid($select=contactid,fullname) menggunakan contactid utama akaun untuk mendapatkan lajur nama penuh dari kenalan berkaitan dengan contactid ID dalam respons.

Terdapat dua jenis sifat navigasi yang boleh anda gunakan dalam Kembangkan Pertanyaan:

1. Sifat navigasi bernilai tunggal sepadan dengan mencari lajur yang menyokong perhubungan banyak kepada satu dan membolehkan anda mengesetkan rujukan kepada jadual lain.

2. Sifat navigasi bernilai koleksi sepadan dengan perhubungan satu kepada banyak atau banyak kepada banyak.

Jika anda hanya menyertakan nama sifat navigasi, anda akan menerima semua sifat untuk baris berkaitan. Ketahui lebih lanjut dalam Sertai jadual menggunakan OData.

Untuk menggunakannya dalam langkah aliran, masukkan ungkapan OData ini dalam medan Kembangkan Pertanyaan : primarycontactid(contactid,fullname). Ini ialah cara untuk mendapatkan lajur contactid dan nama penuh untuk contactid utama setiap akaun.

Kiraan baris

Gunakan tetapan Baris kiraan untuk menentukan bilangan baris yang anda mahu Dataverse kembalikan.

Ambil Pertanyaan XML

Pada masa ini, anda tidak boleh menggunakan pertanyaan Pengagregatan apabila menggunakan tindakan Senarai baris dengan pertanyaan FetchXML. Anda boleh guna operator itu distinct .

Pereka baru

Gunakan pertanyaan gaya Dataverse FetchXML, yang menawarkan lebih fleksibiliti untuk membina pertanyaan tersuai. Pertanyaan ini boleh berguna apabila anda bekerja dengan jadual yang mempunyai beberapa jadual berkaitan atau apabila anda mengendalikan penomboran. Tangkapan skrin berikut menunjukkan cara menggunakan FetchXML.

Penting

Tetapan penpaginahan tidak menyokong pertanyaan FetchXML. Untuk meminta lebih daripada 5,000 baris, anda perlu mengurus paging secara langsung dengan pertanyaan FetchXML.

Contoh FetchXML pertanyaan untuk jadual Akaun:

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

Operator ini distinct tidak disokong secara langsung dalam pertanyaan FetchXML dari tindakan Senarai baris , tetapi anda boleh menggunakan fungsi gabungan untuk membuang baris pendua. Sebagai contoh, anda boleh menggunakan tindakan Pilih untuk mengubah respons sambungan baris Senarai kepada format tatasusunan tertentu yang anda perlukan, kemudian mencipta pembolehubah dengan ungkapan union(body('Select'),body('Select')) tersebut untuk mendapatkan tatasusunan dengan baris yang berbeza.

Pereka klasik

Gunakan pertanyaan gaya Dataverse FetchXML, yang menawarkan lebih fleksibiliti untuk membina pertanyaan tersuai. Pertanyaan ini boleh berguna apabila anda bekerja dengan jadual yang mempunyai beberapa jadual berkaitan atau apabila anda mengendalikan penomboran. Tangkapan skrin berikut menunjukkan cara menggunakan FetchXML.

Taip teks berikut dalam medan Ambil Pertanyaan Xml .

Oleh kerana operator distinct tidak disokong secara langsung dalam pertanyaan FetchXML dari tindakan List rows, gunakan fungsi union untuk membuang baris yang berganda. Sebagai contoh, anda boleh menggunakan tindakan Pilih untuk menukar respons sambungan baris Senarai kepada format tatasusunan khusus yang anda perlukan, dan kemudian mencipta pembolehubah dengan ungkapan union(body('Select'),body('Select')) tersebut untuk mendapatkan tatasusunan dengan baris yang berbeza.

Token langkau

Power Automate menggunakan had kadar kandungan dan had saiz mesej untuk memastikan jaminan perkhidmatan umum. Untuk bekerja dalam had ini, gunakan penpaginahan untuk mengembalikan bilangan baris yang lebih kecil dalam satu kumpulan, bukannya had lalai pada bilangan baris jadual yang dikembalikan.

Jika anda tidak menggunakan pendataan, had halaman lalai ialah 5,000 baris.

Untuk menggunakan penpaginahan, laksanakan gelung untuk mengurai \@odata.nextLink nilai dalam respons JSON, ekstrak token langkau, dan kemudian hantar permintaan lain sehingga anda menyenaraikan bilangan baris yang diperlukan.

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"
}

ID Petak

Nyatakan partitionId data semasa mengambil untuk jadual elastik. Untuk maklumat lanjut, lihat Pembahagian dan penskalaan mendatar untuk jadual elastik.

Maklumat berkaitan

• Latihan: Gunakan Dataverse pencetus dan tindakan dalam Power Automate (modul)
• Latihan: Mengintegrasikan Power Automate aliran dan Dataverse (laluan pembelajaran)