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.

Power Automate bulut akışınızı yapılandırmak için yeni tasarımcıyı veya klasik tasarımcıyı kullanmanıza olanak tanır. Adımlar her iki tasarımcıda da benzerdir. Yeni tasarımcı ile klasik tasarımcı arasındaki farkları belirleme bölümünden daha fazla bilgi edinin (örneklerle birlikte).

  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.

  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.

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.

    Yapılandırma eylemi bölmesinde Liste satırları eylemi için gelişmiş seçeneklerin ekran görüntüsü.

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 FetchXML sorgularıyla Satırları listele eylemini kullanırken desteklenmiyor. Ancak, ayrı işleç desteklenir.

Özel sorgular oluşturmada daha fazla esneklik sağlayan bir Dataverse stili FetchXML sorgusu 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ü FetchXML uygulamasının nasıl kullanılacağını göstermektedir.

Hesap tablosu için FetchXML sorgusu örneği:

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

Distinct işleci şu anda Satırları listele eylemindeki FetchXML sorgularında doğrudan desteklenmediği için, union işlevi yinelenen satırları kaldırmak için 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.

  • Last updated on