Menggunakan daftar baris dalam alur

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

Mendapatkan 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 desainer baru atau desainer 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 sceen 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 baris daftar ke dalam kotak pencarian Pencarian konektor dan tindakan pada kartu Pilih operasi .
3. Pilih Microsoft Dataverse untuk memfilter hasil pencarian untuk hanya menampilkan tindakan dan pemicu untuk. Microsoft Dataverse
4. Pilih 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.

Mengaktifkan penomoran halaman 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 penomoran halaman diatur dan jumlah baris melebihi jumlah ambang batas yang dikonfigurasi, respons tidak akan menyertakan parameter @odata.nextLink untuk meminta kumpulan baris berikutnya. Nonaktifkan penomoran halaman sehingga respons menyertakan parameter @odata.nextLink yang dapat digunakan untuk meminta kumpulan baris berikutnya. Buka Lewati token untuk mempelajari cara menggunakannya.

Batas throughput konten dan batas ukuran pesan berlaku untuk memastikan jaminan layanan umum.

Desainer baru

1. Pilih kartu Daftar baris .

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

3. Pindahkan penggeser 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 penggeser 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 lanjutan untuk tindakan Daftar Baris memungkinkan Anda mengurutkan, memfilter, mengatur, dan memperluas hasil kueri.

Desainer baru

Anda dapat mengatur opsi di panel konfigurasi tindakan.

1. Untuk melihat pilihan, pilih kartu Daftar baris .

2. Di tab Parameter , pilih opsi lanjutan di menu tarik-turun Tambahkan parameter baru .

   

Desainer klasik

Anda dapat mengatur opsi lanjutan langsung pada kartu Daftar baris . Untuk melihat pilihan, pilih Tampilkan pilihan lanjutan. Saat Anda memilihnya, namanya berubah menjadi Sembunyikan opsi lanjutan.

Pilih kolom

Masukkan daftar kolom yang dipisahkan dengan koma untuk dikembalikan, seperti "nama, dibuat pada, kode metode kontak pilihan, alamat email1, telepon1" untuk tabel Akun.

Filter baris

Digunakan untuk menentukan ekspresi filter bergaya OData guna mempersempit kumpulan baris yang Dataverse dikembalikan, seperti "createdon ge 2021-01-01T00:00:00-00:00" untuk baris dengan createdon lebih besar dari atau sama dengan tahun 2021.

Pelajari cara menggunakan operator filter standar dan fungsi kueri untuk membuat ekspresi Kueri Filter .

Karakter tertentu, seperti &, #, dan + perlu diganti dengan padanannya yang dikodekan URL. Informasi lebih lanjut: URL mengkodekan karakter khusus

Penting

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

Urut berdasarkan

Digunakan untuk menentukan ekspresi gaya OData yang menentukan urutan pengembalian item, seperti "nama deskripsi". Gunakan sufiks asc atau desc untuk menunjukkan urutan menaik atau menurun. Urutan default adalah menaik.

Perluas kueri

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

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

1. Properti navigasi bernilai tunggal sesuai untuk mencari kolom 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 menerima semua properti untuk baris terkait. Untuk mempelajari lebih lanjut, lihat Mengambil baris tabel terkait dengan kueri.

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 untuk menunjukkan jumlah baris tertentu untuk Dataverse dikembalikan. Berikut adalah contoh yang menunjukkan cara meminta 10 baris.

Kueri Ambil XML

Kueri agregasi saat ini tidak didukung saat menggunakan tindakan Daftar baris dengan FetchXML kueri. Namun, operator yang berbeda didukung.

Desainer baru

Gunakan kueri Dataverse gaya FetchXML a, yang memungkinkan lebih banyak fleksibilitas dalam membuat kueri kustom. Kueri ini dapat berguna saat Anda bekerja dengan tabel yang memiliki beberapa tabel terkait, atau menangani paginasi. Cuplikan layar berikut menunjukkan cara menggunakan 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>

Karena operator yang berbeda saat ini tidak didukung langsung dalam FetchXML kueri dari tindakan Daftar baris, fungsi gabungan dapat digunakan untuk menghapus baris duplikat. Misalnya, Anda dapat menggunakan tindakan Pilih untuk mengubah respons koneksi Daftar baris 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 Dataverse gaya FetchXML a, yang memungkinkan lebih banyak fleksibilitas dalam membuat kueri kustom. Kueri ini dapat berguna saat Anda bekerja dengan tabel yang memiliki beberapa tabel terkait, atau menangani paginasi. Cuplikan layar berikut menunjukkan cara menggunakan FetchXML.

Ketik yang berikut ini di bidang Ambil Kueri Xml.

Karena operator yang berbeda saat ini tidak didukung langsung dalam FetchXML kueri dari tindakan Daftar baris, fungsi gabungan dapat digunakan untuk menghapus baris duplikat. Misalnya, Anda dapat menggunakan tindakan Pilih untuk mengubah respons koneksi Daftar baris ke format array tertentu yang Anda butuhkan, lalu membuat variabel dengan ekspresi union(body('Select'),body('Select'))) untuk mendapatkan array dengan baris yang berbeda.

Token lewati

Karena menerapkan batas throughput konten dan Power Automate batas ukuran pesan untuk memastikan jaminan layanan umum, seringkali berguna untuk menggunakan penomoran halaman untuk mengembalikan jumlah baris yang lebih kecil dalam batch, daripada batas default pada jumlah baris tabel yang ditampilkan ....

Batas halaman default 5.000 baris berlaku jika Anda tidak menggunakan penomoran halaman.

Untuk menggunakannya, terapkan perulangan untuk mengurai nilai @odata.nextLink dalam respons JSON, ekstrak token lewati, lalu kirim permintaan lain hingga Anda mencantumkan jumlah baris yang Anda butuhkan.

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

Opsi untuk menentukan partitionId saat mengambil data untuk tabel NoSQL. Untuk mempelajari selengkapnya, lihat Meningkatkan performa menggunakan partisi penyimpanan saat mengakses data tabel.

Informasi terkait

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