Gunakan daftar baris dalam alur kerja

Gunakan tindakan Daftar baris untuk mengambil beberapa baris sekaligus dari Microsoft Dataverse dengan kueri terstruktur.

Dapatkan daftar baris

Ikuti langkah-langkah ini untuk menambahkan tindakan Daftar baris ke alur Anda untuk menampilkan hingga 5.000 akun dari tabel Akun di. Dataverse

Power Automate memungkinkan Anda menggunakan perancang baru atau perancang klasik untuk mengonfigurasi alur cloud Anda. Langkah-langkahnya serupa pada kedua desainer. Pelajari lebih lanjut (dengan contoh) di Identifikasi perbedaan antara desainer baru dan desainer klasik.

Desainer baru

1. Pilih tanda tambah (+)Tambahkan > tindakan.
2. Pada layar Tambahkan tindakan , masukkan baris daftar di bidang Pencarian .
3. Di bawah Microsoft Dataverse, pilih Daftar baris (Pratinjau).
4. Pada tab Parameter di sebelah kiri, pilih Akun di menu tarik-turun Nama Tabel .
5. Tutup layar dengan memilih (<<).

Desainer klasik

1. Pilih Langkah baru untuk menambahkan tindakan ke alur Anda.
2. Masukkan list rows ke dalam kotak pencarian Search connectors and actions pada kartu Choose an operation.
3. Pilih Microsoft Dataverse untuk memfilter hasil pencarian agar hanya menampilkan tindakan dan pemicu untuk Microsoft Dataverse.
4. Pilih Buat daftar baris.
5. Pilih tabel Akun dari daftar nama tabel.
6. Simpan dan jalankan alur Anda untuk mengonfirmasi bahwa tidak lebih dari 5.000 baris ditampilkan.

Aktifkan paginasi untuk meminta lebih dari 5.000 baris

Untuk mendapatkan lebih dari 5.000 baris dari kueri secara otomatis, aktifkan fitur Penomoran halaman dari Pengaturan.

Saat Anda mengatur penomoran halaman dan jumlah baris melebihi ambang yang Anda konfigurasi, respons tidak menyertakan @odata.nextLink parameter untuk meminta kumpulan baris berikutnya. Nonaktifkan penomoran halaman sehingga respons menyertakan @odata.nextLink parameter yang dapat Anda gunakan untuk meminta kumpulan baris berikutnya. Buka Skip token untuk mempelajari cara menggunakannya.

Batas laju pemrosesan konten dan batas ukuran pesan berlaku untuk memastikan jaminan layanan secara umum.

Desainer baru

1. Pilih kartu Daftar baris .

2. Di panel di sebelah kiri, pilih tab Pengaturan >Jaringan.

3. Pindahkan penggerak Pagination ke posisi Aktif jika belum diaktifkan.

4. Di Ambang, masukkan jumlah baris maksimum yang diminta. Ambang batas maksimum yang dapat dikonfigurasi adalah 100.000.

   Secara internal, angka ini dibulatkan dalam kelipatan ukuran halaman default. Misalnya, jika ukuran halaman tersebut adalah 5.000, dan Anda memasukkan 7.000, jumlah baris yang dikembalikan adalah 10.000.

Desainer klasik

1. Di sudut kanan atas kartu Daftar baris , pilih menu (...).

2. Pilih pengaturan.

3. Pindahkan penggerak Pagination ke posisi Aktif jika belum diaktifkan.

4. Di Ambang, masukkan jumlah baris maksimum yang diminta. Ambang batas maksimum yang dapat dikonfigurasi adalah 100.000.

   Secara internal, angka ini dibulatkan dalam kelipatan ukuran halaman default. Misalnya, jika ukuran halaman tersebut adalah 5.000, dan Anda memasukkan 7.000, jumlah baris yang dikembalikan adalah 10.000.

Pilihan tingkat lanjut

Opsi tingkat lanjut untuk tindakan Baris Daftar memungkinkan Anda mengurutkan, memfilter, menyusun, dan memperluas hasil kueri.

Desainer baru

Atur opsi di panel konfigurasi tindakan.

1. Untuk melihat pilihan, pilih kartu Daftar baris .

2. Di tab Parameter , pilih opsi tingkat lanjut di menu dropdown Parameter tingkat lanjut .

   

Desainer klasik

Atur opsi tingkat lanjut langsung pada kartu List rows. Untuk melihat pilihan, pilih Tampilkan pilihan lanjutan. Saat Anda memilihnya, namanya berubah menjadi Sembunyikan opsi lanjutan.

Mengembalikan metadata penuh

Pengaturan ini mengontrol apakah akan memuat semua kolom dari tabel atau hanya kolom penting untuk performa yang lebih baik. Jika Anda tidak mengaturnya, tindakan secara otomatis mengembalikan metadata penuh jika alur Anda menggunakan konten atau ekspresi dinamis yang membutuhkannya.

Pilih kolom

Masukkan daftar kolom yang dipisahkan koma untuk dikembalikan, seperti name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 untuk tabel Akun.

Filter baris

Gunakan bidang ini untuk menentukan ekspresi filter bergaya OData guna mempersempit sekumpulan baris yang dikembalikan oleh Dataverse, seperti createdon ge 2021-01-01T00:00:00-00:00 untuk baris dengan createdon lebih besar dari atau sama dengan 2021.

Pelajari cara memfilter baris untuk membuat ekspresi Kueri Filter .

Ganti karakter tertentu, seperti &, #, dan +, dengan yang setara dengan yang dikodekan URL-nya. Untuk informasi selengkapnya, lihat URL mengodekan karakter khusus.

Penting

Ekspresi filter tidak dapat berisi string ini, $filter=, karena string ini hanya berlaku saat Anda menggunakan API secara langsung.

Urut berdasarkan

Gunakan bidang ini untuk menentukan ekspresi gaya OData yang menentukan urutan pengembalian item, seperti name desc. Gunakan sufiks asc atau desc untuk menunjukkan urutan menaik atau menurun. Urutan default adalah menaik.

Perluas kueri

Gunakan bidang ini untuk menentukan ekspresi bergaya OData yang mendefinisikan data yang dikembalikan Dataverse dari tabel terkait, seperti primarycontactid($select=contactid,fullname) untuk menggunakan primarycontactid akun guna mengambil kolom fullname dari kontak terkait dengan ID contactid di dalam respons.

Ada dua jenis properti navigasi yang dapat Anda gunakan di Perluas Kueri:

1. Properti navigasi bernilai tunggal sesuai dengan kolom lookup yang mendukung hubungan banyak-ke-satu dan memungkinkan Anda menetapkan referensi ke tabel lain.

2. Properti navigasi bernilai koleksi sesuai dengan hubungan satu ke banyak atau banyak ke banyak.

Jika Anda hanya menyertakan nama properti navigasi, Anda akan mendapatkan semua properti untuk baris yang terkait. Pelajari selengkapnya di Menggabungkan tabel menggunakan OData.

Untuk menggunakannya dalam langkah alur, masukkan ekspresi OData ini di bidang Perluas Kueri : primarycontactid(contactid,fullname). Beginilah cara mendapatkan kolom contactid dan fullname untuk primarycontactid setiap akun.

Jumlah baris

Gunakan pengaturan Jumlah baris untuk menentukan berapa banyak baris yang ingin dikembalikan oleh Dataverse.

Mengambil Kueri XML

Saat ini, Anda tidak dapat menggunakan kueri Agregasi saat menggunakan tindakan Daftar baris dengan kueri FetchXML. Anda tetap dapat menggunakan operator distinct.

Desainer baru

Gunakan kueri FetchXML bergaya Dataverse, yang menawarkan lebih banyak fleksibilitas untuk membangun kueri kustom. Kueri ini dapat berguna saat Anda bekerja dengan tabel yang memiliki beberapa tabel terkait atau saat Anda menangani penomoran halaman. Cuplikan layar berikut menunjukkan cara menggunakan FetchXML.

Penting

Pengaturan penomoran halaman tidak mendukung kueri FetchXML. Untuk meminta lebih dari 5.000 baris, Anda perlu mengelola paginasi secara langsung dalam kueri FetchXML.

Contoh FetchXML kueri untuk tabel Akun:

<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 distinct saat ini tidak didukung langsung dalam kueri FetchXML dari tindakan Baris daftar , tetapi Anda dapat menggunakan fungsi gabungan untuk menghapus baris duplikat. Misalnya, Anda dapat menggunakan tindakan Pilih untuk mengubah respons koneksi Baris daftar ke format array tertentu yang Anda butuhkan, lalu membuat variabel dengan ekspresi union(body('Select'),body('Select')) untuk mendapatkan array dengan baris yang berbeda.

Desainer klasik

Gunakan kueri FetchXML bergaya Dataverse, yang menawarkan lebih banyak fleksibilitas untuk membangun kueri kustom. Kueri ini dapat berguna saat Anda bekerja dengan tabel yang memiliki beberapa tabel terkait atau saat Anda menangani penomoran halaman. Cuplikan layar berikut menunjukkan cara menggunakan FetchXML.

Ketik teks berikut ke dalam kolom Fetch Xml Query.

Karena operator distinct saat ini tidak didukung secara langsung dalam kueri FetchXML dari tindakan List rows, gunakan fungsi union untuk menghapus baris duplikat. Misalnya, Anda dapat menggunakan tindakan Pilih untuk mengubah respons koneksi Baris daftar menjadi format array tertentu yang Anda butuhkan, lalu membuat variabel dengan ekspresi union(body('Select'),body('Select')) untuk mendapatkan array dengan baris yang berbeda.

Lewati token

Power Automate menerapkan batas throughput konten dan batas ukuran pesan untuk memastikan jaminan layanan umum. Untuk bekerja dalam batas ini, gunakan penomoran halaman untuk mengembalikan jumlah baris yang lebih kecil dalam batch, bukan batas default pada jumlah baris tabel yang dikembalikan.

Jika Anda tidak menggunakan penomoran halaman, batas halaman default adalah 5.000 baris.

Untuk menggunakan paginasi, terapkan perulangan untuk mengurai nilai \@odata.nextLink dalam respons JSON, mengekstrak token skip, lalu kirimkan permintaan berikutnya hingga Anda mendapatkan jumlah 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 Partisi

Tentukan partitionId saat mengambil data untuk tabel elastis. Untuk mempelajari selengkapnya, lihat Pemartisian dan penskalaan horizontal untuk tabel elastis.

Informasi terkait

• Pelatihan: Menggunakan pemicu dan tindakan Dataverse di Power Automate (modul)
• Pelatihan: Mengintegrasikan flow Power Automate dan Dataverse (jalur pembelajaran)