Akışlardaki satır listelerini kullanma

Yapılandırılmış sorguyla Microsoft Dataverse'ten tek seferde birden fazla satır almak için Satırları listele eylemini kullanın.

Satır listesi alma

Dataverse Uygulamasındaki firmalar tablosundan en fazla 5000 hesabı almak için akışlarınıza liste satırları eylemi eklemek üzere aşağıdaki adımları izleyin.

Not

Power Automate klasik bulut akışı tasarımcıyı veya Copilot ile bulut akışı tasarımcısını kullanır. Hangi tasarımcıyı kullandığınızı belirlemek için Yardımcı pilot özellikleriyle bulut akışı tasarımcısını anlama bölümündeki Not bölümüne gidin.

Klasik uygulama tasarımcısı

1. Akışınıza bir eylem eklemek için Yeni adım'ı seçin.
2. Bir işlem seç kartında Arama bağlayıcıları ve eylemler arama kutusuna liste satırlarını girin.
3. Arama sonuçlarını yalnızca Microsoft Dataverse ile ilgili eylemleri ve tetikleyicileri görüntüleyecek şekilde filtrelemek için Microsoft Dataverse'i seçin.
4. Satırları listele'yi seçin.
5. Tablo adı listesinden Firmalar tablosunu seçin.
6. 5.000 satırdan daha fazla satır döndürülmeyeceğini doğrulamak için akışınızı kaydedin ve çalıştırın.

Copilot ile düzenleme

1. Artı (+) >Bir eylem ekleyin işaretini seçin.
2. Bir eylem ekle ekranında, Arama alanına liste satırlarını girin.
3. Microsoft Dataverse altında Liste satırları (Önizleme) öğesini seçin.
4. Parametreler sekmesinde, soldaki Tablo Adı açılır menüsünden Firmalar öğesini seçin.
5. (<<) seçeneğini belirleyerek ekranı kapatın.

5000 satırdan fazla istekte bulunmak için sayfalandırmayı açma

Bir sorgudan otomatik olarak 5.000'den fazla satır almak için Ayarlar'dan Sayfalandırma özelliğini açın.

Sayfalandırma ayarlandığında ve satır miktarı, yapılandırılan eşik sayısını aştığında yanıt bir sonraki satır kümesini istemek için @odata.nextLink parametresini içermez. Yanıtın bir sonraki satır kümesini istemek için kullanılabilen @odata.nextLink parametresini içermesi için sayfalandırmayı kapatın. Nasıl kullanılacağını öğrenmek için Atlama belirteci bölümüne gidin.

Genel servis garantisini güvence altına almak için içerik aktarım hızı sınırları ve ileti boyutu sınırları uygulanır.

Klasik uygulama tasarımcısı

1. Liste satırları kartının sağ üst köşesindeki üç nokta (...) menüsü seçin.

2. Ayarlar'ı seçin.

3. Açık değilse Sayfalandırma kaydırıcısını Açık konumuna getirin.

4. Eşik'te, istenen maksimum satır sayısını girin. Maksimum yapılandırılabilir eşik 100.000'dir.

   Bu sayı, varsayılan olarak sayfa boyutunun artırımlarıyla yuvarlanır. Örneğin, Bu sayfa büyüklüğü 5.000 ve 7.000 girerseniz, döndürülen satır sayısı 10.000.

Copilot ile düzenleme

1. Liste satırları kartını seçin.

2. Sol bölmede Ayarlar sekmesi >Ağ oluşturma seçeneğini belirleyin.

3. Açık değilse Sayfalandırma kaydırıcısını Açık konumuna getirin.

4. Eşik'te, istenen maksimum satır sayısını girin. Maksimum yapılandırılabilir eşik 100.000'dir.

   Bu sayı, varsayılan olarak sayfa boyutunun artırımlarıyla yuvarlanır. Örneğin, Bu sayfa büyüklüğü 5.000 ve 7.000 girerseniz, döndürülen satır sayısı 10.000.

Gelişmiş seçenekler

Satırları Listele eylemi için gelişmiş seçenekler, bir sorgunun sonuçlarını sıralamanızı, filtrelemenize, düzenlemenizi ve genişletmenizi sağlar.

Klasik uygulama tasarımcısı

Gelişmiş seçenekleri doğrudan Liste satırları kartı üzerinde ayarlayabilirsiniz. Seçenekleri görmek için Gelişmiş seçenekleri göster'i seçin. Seçtiğinizde, ad Gelişmiş seçenekleri gizle olarak değişir.

Copilot ile düzenleme

Eylem yapılandırma bölmesinde seçenekleri ayarlayabilirsiniz.

1. Seçenekleri görmek için Liste satır kartı seçin.

2. Parametreler sekmesinde, Yeni parametreler ekle açılır menüsünden gelişmiş bir seçeneği belirleyin.

   

Sütunları seçin

Firma tablosu için "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" örneğinde olduğu gibi döndürülecek sütunların virgülle ayrılmış bir listesini girin.

Satırları filtrele

createdon değeri 2021 yılından büyük veya ona eşit olan satırlar için "createdon ge 2021-01-01T00:00:00-00:00" örneğinde olduğu gibi Dataverse uygulamasının döndürdüğü satır kümesini daraltmak üzere bir OData stili filtre ifadesi tanımlamak için kullanın.

Sorguyu Filtrele ifadeleri oluşturmak için standart filtre işleçlerini ve sorgu işlevlerini nasıl kullanacağınızı öğrenin.

&, # ve + gibi belirli karakterlerin URL kodlu eşdeğerleriyle değiştirilmesi gerekir. Daha fazla bilgi: URL kodlu özel karakterler

Önemli

Filtre ifadeleri, yalnızca doğrudan API'leri kullandığınızda uygulandığından, $filter= bu dizeyi içeremez.

Sıralama ölçütü

"Ad desc" gibi, öğelerin döndürülme sırasını tanımlayan OData stili bir ifade tanımlamak için kullanın. Sırasıyla artan veya azalan düzende olduğunu belirtmek için asc veya desc son eklerini kullanın. Varsayılan sıralama artandır.

Sorguyu genişletme

Yanıtta contactid kimliği olan ilgili kişiden fullname sütununu almak üzere firmanın primarycontactid'sini kullanmak için primarycontactid($select=contactid,fullname) gibi, Dataverse'ün ilgili tablolardan getirdiği verileri tanımlayan OData stilinde bir ifade belirtmek için kullanın.

Sorguyu Genişlet'te kullanabileceğiniz iki tür gezinti özelliği bulunur:

1. Tek değerli gezinti özellikleri, çok-bir ilişkileirni destekleyen arama sütunlarına karşılık gelir ve başka bir tabloya başvuru ayarlamanıza olanak sağlar.

2. Koleksiyon değerli gezinme özellikleri, bir-çok veya çok-çok ilişkilerine karşılık gelir.

Gezinme özelliğinin yalnızca adını eklerseniz ilgili satırlar için tüm özellikleri alırsınız. Daha fazla bilgi için bkz. Sorguyla ilgili tablo satırlarını alma.

Bir akış adımında kullanmak için, bu Odata ifadesini Sorguyu Genişlet alanına girin: primarycontactid(contactid,fullname). Bu, her firmanınprimarycontactid özelliği için contactid ve fullname sütunlarını alma işlemidir.

Satır sayısı

Dataverse uygulamasının döndüreceği belirli satır sayısını belirtmek için kullanın. Aşağıda, 10 satırın nasıl isteneceğini gösteren bir örnek görebilirsiniz.

Fetch Xml Sorgusu

Toplama sorguları şu anda sorgularla Satırları FetchXML listele eylemi kullanılırken desteklenmemektedir. Ancak, ayrı işleç desteklenir.

Klasik uygulama tasarımcısı

Özel sorgular oluşturmada daha fazla esneklik sağlayan a Dataverse stili FetchXML sorgu kullanın. Bu sorgular birden çok ilgili tabloya sahip veya sayfalandırma işlemi gerçekleştiren bir tabloyla çalışırken yararlı olabilir. Aşağıdaki ekran görüntüsünde nasıl kullanılacağı gösterilmektedir FetchXML.

Fetch Xml Sorgusu alanına aşağıdakini yazın.

Ayrı işleç şu anda Satırları listele eylemindeki sorgularda FetchXML doğrudan desteklenmediğinden, yinelenen satırları kaldırmak için birleşim işlevi kullanılabilir. Örneğin, Satırları listele bağlantısının yanıtını gereksinim duyduğunuz belirli bir dizi biçimine dönüştürmek için Seç eylemini kullanabilir ve daha sonra, ayrı satırları olan bir dizi elde etmek için union(body(‘Select’),body(‘Select’)) ifadesiyle bir değişken oluşturun.

Copilot ile düzenleme

Özel sorgular oluşturmada daha fazla esneklik sağlayan a Dataverse stili FetchXML sorgu kullanın. Bu sorgular birden çok ilgili tabloya sahip veya sayfalandırma işlemi gerçekleştiren bir tabloyla çalışırken yararlı olabilir. Aşağıdaki ekran görüntüsünde nasıl kullanılacağı gösterilmektedir FetchXML.

Firma tablosu için örnek FetchXML sorgu:

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

Ayrı işleç şu anda Satırları listele eylemindeki sorgularda FetchXML doğrudan desteklenmediğinden, yinelenen satırları kaldırmak için birleşim işlevi kullanılabilir. Örneğin, Satırları listele bağlantısının yanıtını gereksinim duyduğunuz belirli bir dizi biçimine dönüştürmek için Seç eylemini kullanabilir ve daha sonra, ayrı satırları olan bir dizi elde etmek için union(body(‘Select’),body(‘Select’)) ifadesiyle bir değişken oluşturun.

Atlama belirteci

Power Automate, genel hizmet garantilerini sağlamak üzere içerik aktarım hızı sınırları ve ileti boyutu sınırları uyguladığından bir toplu işte daha az sayıda satır döndürmek için varsayılan döndürülen tablo satırı sayısı sınırları yerine sayfalandırma kullanmak genellikle yararlıdır.

Sayfalandırma kullanmıyorsanız varsayılan sayfa sınırı 5.000 satırdır.

Kullanmak için JSON yanıtında odata.nextLink değerini ayrıştırmaya yönelik bir döngü kullanın, atlama belirtecini ayıklayın ve ihtiyacınız olan satır sayısını listeleyene kadar başka bir istek gönderin.

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

Bölüm Kimliği

NoSQL tabloları için veriler alınırken partitionId belirtme seçeneği. Daha fazla bilgi edinmek için Tablo verilerine erişirken depolama bölümlerini kullanma performansını artırma konusuna bakın.