Akışlarda 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ırların listesini al

Dataverse'teki Accounts tablosundan en fazla 5.000 hesap döndürmek için akışınıza Satırları listele eylemini eklemek üzere aşağıdaki adımları izleyin.

Power Automate, bulut akışınızı yapılandırmak için yeni tasarımcı veya classic designer 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).

Yeni tasarımcı

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

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 Hesaplar tablosunu seçin.
6. 5.000’den fazla satır döndürülmediğini doğrulamak için akışınızı kaydedip çalıştırı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 ayarladığınızda ve satır sayısı yapılandırdığınız eşiği aştığında, yanıt sonraki satır kümesini istemek için parametresini içermez @odata.nextLink . Yanıtın sonraki satır kümesini istemek için kullanabileceğiniz parametreyi @odata.nextLink 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.

Yeni tasarımcı

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

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

3. Sayfalandırma kaydırıcısını açık değilse 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.

   Dahili olarak bu sayı, varsayılan sayfa boyutunun katlarına yuvarlanır. Örneğin, bu sayfa boyutu 5.000 ise ve 7.000 girerseniz, döndürülen satır sayısı 10.000 olur.

Klasik uygulama tasarımcısı

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

2. Ayarlar'ı seçin.

3. Sayfalandırma kaydırıcısını açık değilse 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.

   Dahili olarak bu sayı, varsayılan sayfa boyutunun katları şeklinde yuvarlanır. Örneğin, sayfa boyutu 5.000 ise ve siz 7.000 değerini girerseniz, döndürülen satır sayısı 10.000 olur.

Gelişmiş seçenekler

Satırları Listele eyleminin gelişmiş seçenekleri bir sorgunun sonuçlarını sıralamanıza, filtrelemenize, düzenlemenize ve genişletmenize olanak verir.

Yeni tasarımcı

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

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

2. Parametreler sekmesinde, Gelişmiş parametreler açılan menüsünde gelişmiş bir seçenek belirleyin.

   

Klasik uygulama tasarımcısı

Gelişmiş seçenekleri doğrudan Liste satırları kartında ayarlayın. 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.

Tam meta verileri döndürme

Bu ayar, daha iyi performans için tablodaki tüm sütunların mı yoksa yalnızca temel sütunların mı yüklenip yüklenmeyeceğini denetler. Bunu ayarlamazsanız, akışınız dinamik içerik veya buna ihtiyaç duyan ifadeler kullanıyorsa eylem otomatik olarak tam meta verileri döndürür.

Sütunları seçin

Hesap tablosu gibi name,createdon,preferredcontactmethodcode,emailaddress1,telephone1 döndürülecek sütunların virgülle ayrılmış bir listesini girin.

Satırları filtrele

Dataverse'in döndürdüğü satır kümesini daraltmak için OData tarzı bir filtre ifadesi tanımlamak üzere bu alanı kullanın; örneğin, createdon değeri 2021 yılına eşit veya daha büyük olan satırlar için createdon ge 2021-01-01T00:00:00-00:00.

Filtre Sorgusu ifadeleri oluşturmak için satırlarıfiltrelemeyi öğrenin.

&#, ve +gibi belirli karakterleri URL ile kodlanmış eşdeğerleriyle değiştirin. Daha fazla bilgi için bkz. URL kodlama özel karakterleri.

Önemli

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

Sırala:

Öğelerin hangi sırayla döndürüleceğini tanımlayan, name desc gibi OData tarzı bir ifadeyi tanımlamak için bu alanı 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 artan sıradadır.

Sorguyu genişletme

Dataverse’in ilişkili tablolardan döndürdüğü verileri tanımlayan OData tarzı bir ifade belirtmek için bu alanı kullanın; örneğin, yanıtta contactid kimliğine sahip ilgili kişiden fullname sütununu almak için hesabın primarycontactid değerini kullanmak üzere primarycontactid($select=contactid,fullname).

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

1. Tek değerli gezinti özellikleri, çoktan bire ilişkilerini destekleyen arama sütunlarına karşılık gelen ve başka bir tabloya başvuru ayarlamanızı sağlayan özelliklerdir.

2. Koleksiyon değerine sahip gezinme özellikleri, bire çok veya çoka çok ilişkilere karşılık gelir.

Yalnızca gezinti özelliğinin adını eklerseniz, ilgili satırların tüm özelliklerini alırsınız. OData kullanarak tabloları birleştirme bölümünde daha fazla bilgi edinin.

Bunu bir akış adımında kullanmak için Sorguyu Genişlet alanına şu OData ifadesini girin: primarycontactid(contactid,fullname). contactid ve fullname sütunlarını, her account kaydının primarycontactid değeri için şu şekilde alabilirsiniz.

Satır sayısı

Dataverse'in döndürmesini istediğiniz satır sayısını belirtmek için Satır sayısı ayarını kullanın.

XML Sorgusunu Getir

Şu anda Satırları listele eylemini FetchXML sorguları ile kullanırken Toplama sorgularını kullanamazsınız. Ancak distinct işlecini kullanabilirsiniz.

Yeni tasarımcı

Özel sorgular oluşturmak için daha fazla esneklik sunan Dataverse stili fetchxml sorgusu kullanın. Bu sorgular, birden çok ilişkili tablo içeren bir tabloyla çalışırken veya sayfalandırmayı işlerken yararlı olabilir. Aşağıdaki ekran görüntüsü FetchXML uygulamasının nasıl kullanılacağını göstermektedir.

Önemli

Sayfalandırma ayarı FetchXML sorgularını desteklemez. 5.000'den fazla satır istemek için sayfalandırmayı doğrudan FetchXML sorgusuyla yönetmeniz gerekir.

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>

İşleç distinct şu anda Liste satırları eyleminden FetchXML sorgularında doğrudan desteklenmiyor, ancak yinelenen satırları kaldırmak için union işlevini kullanabilirsiniz. Örneğin, Select eylemini kullanarak Liste satırları bağlantısının yanıtını ihtiyacınız olan belirli bir dizi biçimine dönüştürebilir ve ardından farklı satırlara sahip bir dizi almak için ifadeyle union(body('Select'),body('Select')) bir değişken oluşturabilirsiniz.

Klasik uygulama tasarımcısı

Özel sorgular oluşturmak için daha fazla esneklik sunan Dataverse stili fetchxml sorgusu kullanın. Bu sorgular, birden çok ilişkili tablo içeren bir tabloyla çalışırken veya sayfalandırmayı işlerken yararlı olabilir. Aşağıdaki ekran görüntüsü FetchXML uygulamasının nasıl kullanılacağını göstermektedir.

Xml Sorgusunu Getir alanına aşağıdaki metni yazın.

Ayrı işleç şu anda Liste satırları eyleminden FetchXML sorgularında doğrudan desteklenmediğinden, yinelenen satırları kaldırmak için union işlevini kullanın. Örneğin, Liste satırları bağlantısının yanıtını ihtiyacınız olan belirli bir dizi biçimine dönüştürmek için Seç eylemini kullanabilir ve ardından farklı satırlara sahip bir dizi almak için ifadeyle union(body('Select'),body('Select')) bir değişken oluşturabilirsiniz.

Atlama belirteci

Power Automate genel hizmet garantileri sağlamak için içerik aktarım hızı sınırları ve ileti boyutu sınırları uygular. Bu sınırlar dahilinde çalışmak için, varsayılan döndürülen tablo satırı sayısı sınırları yerine, bir toplu işlemde daha az sayıda satır döndürmek üzere sayfalandırmayı kullanın.

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

Sayfalandırmayı kullanmak için, JSON yanıtındaki \@odata.nextLink değerini ayrıştıracak, atlama belirtecini çıkaracak ve gereksinim duyduğunuz satır sayısını listeleyene kadar başka bir istek gönderecek bir döngü oluşturun.

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

Elastik tablolar için veri alırken partitionId öğesini belirtin. Daha fazla bilgi edinmek için bkz . Elastik tablolar için bölümleme ve yatay ölçeklendirme.

İlgili bilgiler

• Eğitim: Power Automate (modül) içindeki Dataverse tetikleyiciyi ve eylemi kullanın
• Eğitim: Power Automate akışını ve Dataverse (öğrenme yolu) entegre edin