Χρήση λιστών γραμμών σε ροές

Χρησιμοποιήστε την ενέργεια Γραμμές λιστών για την ανάκτηση πολλαπλών γραμμών ταυτόχρονα από το Microsoft Dataverse με ένα δομημένο ερώτημα.

Λήψη λίστας γραμμών

Ακολουθήστε αυτά τα βήματα για να προσθέσετε την ενέργεια Γραμμές λίστας στη ροή σας για επιστροφή έως και 5.000 λογαριασμών από τον πίνακα Λογαριασμοί στο Dataverse.

Σημείωμα

Το Power Automate χρησιμοποιεί είτε την κλασική σχεδίαση ροών cloud είτε τη σχεδίαση ροών cloud με τo Copilot. Για να προσδιορίσετε τη σχεδίαση που χρησιμοποιείτε, μεταβείτε στην ενότητα Σημείωση στην Κατανόηση της νέας σχεδίασης ροών cloud με το Copilot.

Κλασική σχεδίαση

1. Επιλέξτε Νέο βήμα για να προσθέσετε μια ενέργεια στη ροή σας.
2. Εισαγάγετε γραμμές λίστας στο πλαίσιο αναζήτησης για Αναζήτηση συνδέσεων και ενεργειών, στην κάρτα Επιλογή λειτουργίας.
3. Επιλέξτε Microsoft Dataverse για να φιλτράρετε τα αποτελέσματα αναζήτησης ώστε να εμφανίζονται μόνο ενέργειες και εναύσματα για το Microsoft Dataverse.
4. Επιλέξτε Γραμμές λίστας.
5. Επιλέξτε τον πίνακα Λογαριασμοί από τη λίστα Όνομα πίνακα.
6. Αποθηκεύστε και εκτελέστε τη ροή σας για να επιβεβαιώσετε ότι δεν επιστρέφονται περισσότερες από 5.000 γραμμές.

Επεξεργασία με το Copilot

1. Επιλέξτε το σύμβολο συν (+) >Προσθήκη ενέργειας.
2. Στο πεδίο Προσθήκη ενέργειας, εισαγάγετε γραμμές λίστας στο πεδίο Αναζήτηση.
3. Στο Microsoft Dataverse, επιλέξτε Γραμμές λίστας (Έκδοση προεπισκόπησης).
4. Στην καρτέλα Παράμετροι προς τα αριστερά, επιλέξτε Λογαριασμοί στο αναπτυσσόμενο μενού Όνομα πίνακα.
5. Κλείστε την οθόνη επιλέγοντας (<<).

Ενεργοποίηση σελιδοποίησης για αίτηση περισσότερων από 5.000 γραμμών

Για να λάβετε περισσότερες από 5.000 γραμμές από ένα ερώτημα αυτόματα, ενεργοποιήστε τη δυνατότητα Σελιδοποίηση από τις Ρυθμίσεις.

Όταν ορίζεται η σελιδοποίηση και το ποσό των γραμμών υπερβαίνει αυτόν τον αριθμό του ορίου που έχει ρυθμιστεί, η απόκριση δεν θα περιλαμβάνει την παράμετρο @odata.nextLink για να ζητήσει το επόμενο σύνολο γραμμών. Απενεργοποιήστε τη σελιδοποίηση ώστε η απόκριση να περιλαμβάνει την παράμετρο @odata.nextLink που μπορεί να χρησιμοποιηθεί για την αίτηση του επόμενου συνόλου γραμμών. Μεταβείτε στο Διακριτικό παράλειψης για να μάθετε πώς να το χρησιμοποιείτε.

Τα όρια ταχύτητας μετάδοσης περιεχομένου και τα όρια μεγέθους μηνύματος ισχύουν για να διασφαλιστούν γενικές εγγυήσεις υπηρεσίας.

Κλασική σχεδίαση

1. Στην επάνω δεξιά γωνία της κάρτας Παράθεση γραμμών σε λίστα, επιλέξτε το μενού (...).

2. Επιλέξτε Ρυθμίσεις.

3. Μετακινήστε το ρυθμιστικό Σελιδοποίηση στη θέση Ενεργό εάν δεν έχει ήδη ενεργοποιηθεί.

4. Στο Όριο, πληκτρολογήστε τον μέγιστο αριθμό σειρών που ζητήθηκε. Το μέγιστο όριο με δυνατότητα ρύθμισης παραμέτρων είναι 100.000.

   Εσωτερικά, ο αριθμός αυτός στρογγυλοποιείται κατά πολλαπλάσια του προεπιλεγμένου μεγέθους σελίδας. Για παράδειγμα, εάν αυτό το μέγεθος σελίδας είναι 5.000 και καταχωρήσετε 7.000, ο αριθμός των γραμμών που επιστρέφονται είναι 10.000.

Επεξεργασία με το Copilot

1. Επιλέξτε την κάρτα Γραμμές λίστας.

2. Στο τμήμα παραθύρου στα αριστερά, επιλέξτε την καρτέλα Ρυθμίσεις>Δικτύωση.

3. Μετακινήστε το ρυθμιστικό Σελιδοποίηση στη θέση Ενεργό εάν δεν έχει ήδη ενεργοποιηθεί.

4. Στο Όριο, πληκτρολογήστε τον μέγιστο αριθμό σειρών που ζητήθηκε. Το μέγιστο όριο με δυνατότητα ρύθμισης παραμέτρων είναι 100.000.

   Εσωτερικά, ο αριθμός αυτός στρογγυλοποιείται κατά πολλαπλάσια του προεπιλεγμένου μεγέθους σελίδας. Για παράδειγμα, εάν αυτό το μέγεθος σελίδας είναι 5.000 και καταχωρήσετε 7.000, ο αριθμός των γραμμών που επιστρέφονται είναι 10.000.

Επιλογές για προχωρημένους

Οι επιλογές για προχωρημένους για την ενέργεια Γραμμές λίστας σάς επιτρέπουν να ταξινομείτε, να φιλτράρετε, να ταξινομείτε και να επεκτείνετε τα αποτελέσματα ενός ερωτήματος.

Κλασική σχεδίαση

Μπορείτε να ορίσετε επιλογές για προχωρημένους απευθείας στην κάρτα Γραμμές λίστας. Για να δείτε τις επιλογές για προχωρημένους, επιλέξτε Εμφάνιση επιλογών για προχωρημένους. Όταν το επιλέξετε, το όνομα αλλάζει σε Απόκρυψη σύνθετων επιλογών.

Επεξεργασία με το Copilot

Μπορείτε να ορίσετε επιλογές στο τμήμα παραθύρου ρύθμισης παραμέτρων ενέργειας.

1. Για να δείτε τις επιλογές, επιλέξτε την κάρτα Γραμμές λίστας.

2. Στην καρτέλα Παράμετροι, επιλέξτε μια σύνθετη επιλογή στο αναπτυσσόμενο μενού Προσθήκη νέων παραμέτρων.

   

Επιλογή στηλών

Εισαγάγετε μια λίστα στηλών διαχωρισμένων με κόμματα προς επιστροφή, όπως "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" για τον πίνακα "Λογαριασμός".

Φιλτράρισμα γραμμών

Χρησιμοποιήστε για να καθορίσετε μια παράσταση φίλτρου τύπου OData ώστε να περιορίσετε το σύνολο των γραμμών που επιστρέφονται από το Dataverse, όπως "createdon ge 2021-01-01T00:00:00-00:00" για γραμμές με createdon μεγαλύτερο ή ίσο με το έτος 2021.

Μάθετε πώς να χρησιμοποιείτε τυπικούς τελεστές φίλτρου και συναρτήσεις ερωτήματος για την κατασκευή παραστάσεων φίλτρου ερωτήματος.

Ορισμένοι χαρακτήρες, όπως &, # και + πρέπει να αντικατασταθούν με το ισοδύναμο τους με κωδικοποίηση URL. Περισσότερες πληροφορίες: Η διεύθυνση URL κωδικοποιεί ειδικούς χαρακτήρες

Σημαντικό

Οι παραστάσεις φίλτρου δεν είναι δυνατό να περιέχουν αυτήν τη συμβολοσειρά $filter=, επειδή ισχύει μόνο όταν χρησιμοποιείτε τα API απευθείας.

Ταξινόμηση κατά

Χρησιμοποιήστε για να καθορίσετε μια παράσταση τύπου OData που καθορίζει τη σειρά με την οποία επιστρέφονται τα στοιχεία, όπως το "name desc". Χρησιμοποιήστε το επίθημε asc ή desc για να υποδείξετε αύξουσα ή φθίνουσα σειρά, αντίστοιχα. Η προεπιλεγμένη σειρά είναι αύξουσα.

Επέκταση ερωτήματος

Χρησιμοποιήστε για να καθορίσετε μια παράσταση τύπου OData που καθορίζει τα δεδομένα που επιστρέφονται από το Dataverse από τους σχετικούς πίνακες, όπως primarycontactid($select=contactid,fullname) για να χρησιμοποιήσετε το primarycontactid του λογαριασμού για την ανάκτηση της στήλης fullname από τη σχετική επαφή με contactid αναγνωριστικού στην απόκριση.

Υπάρχουν δύο τύποι ιδιοτήτων πλοήγησης που μπορείτε να χρησιμοποιήσετε στην Ανάπτυξη ερωτήματος:

1. Ο ιδιότητες πλοήγησης μίας τιμής αντιστοιχούν σε στήλες αναζήτησης που υποστηρίζουν σχέσεις πολλά προς ένα και σας επιτρέπουν να ορίσετε μια αναφορά σε έναν άλλο πίνακα.

2. Οι ιδιότητες πλοήγησης εκτίμησης ως συλλογής αντιστοιχούν σε σχέσεις "ένα προς πολλά" ή "πολλά προς πολλά".

Εάν συμπεριλάβετε μόνο το όνομα της ιδιότητας πλοήγησης, θα λάβετε όλες τις ιδιότητες για τις σχετικές γραμμές. Για να μάθετε περισσότερα, ανατρέξτε στο θέμα Ανάκτηση σχετικών γραμμών πίνακα με ένα ερώτημα.

Για χρησιμοποιηθεί στο βήαμ ροής, εισαγάγετε μια παράσταση Odata στο πεδίο Επέκταση ερωτήματος: primarycontactid(contactid,fullname). Αυτό δείχνει πώς μπορείτε να λάβετε τις στήλες contactid και fullname για το primarycontactid κάθε λογαριασμού.

Πλήθος γραμμών

Χρησιμοποιήστε για να υποδείξετε έναν συγκεκριμένο αριθμό γραμμών για να επιστρέψει το Dataverse. Ακολουθεί ένα παράδειγμα που δείχνει τον τρόπο αίτησης 10 γραμμών.

Λήψη ερωτήματος XML

Τα ερωτήματα συνάθροισης δεν υποστηρίζονται αυτή τη στιγμή κατά τη χρήση της ενέργειας γραμμών λίστας με ερωτήματα FetchXML. Ωστόσο, υποστηρίζεται ο διακριτός τελεστής.

Κλασική σχεδίαση

Χρησιμοποιήστε ένα ερώτημα FetchXML στύλ Dataverse που παρέχει καμία ευελιξία στη δημιουργία προσαρμοσμένων ερωτημάτων. Αυτά τα ερωτήματα μπορούν να είναι χρήσιμα όταν εργάζεστε με έναν πίνακα που έχει πολλούς σχετικούς πίνακες ή όταν χειρίζεστε σελιδοποίηση. Το παρακάτω στιγμιότυπο οθόνης δείχνει τον τρόπο χρήσης του FetchXML.

Πληκτρολογήστε το παρακάτω στο πεδίο Λήψη ερωτήματος XML.

Καθώς ο διακριτός τελεστής δεν υποστηρίζεται αυτή τη στιγμή απευθείας στα ερωτήματα FetchXML από την ενέργεια "Γραμμές λίστας", η συνάρτηση ένωσης μπορεί να χρησιμοποιηθεί για την κατάργηση διπλότυπων γραμμών. Για παράδειγμα, μπορείτε να χρησιμοποιήσετε την Επιλογή ενέργειας για να μετασχηματίσετε την απόκριση της σύνδεσης γραμμών λίστας στη συγκεκριμένη μορφή πίνακα που χρειάζεστε και, στη συνέχεια, να δημιουργήσετε μια μεταβλητή με την παράσταση union(body(‘Select’),body(‘Select’)) για να λάβετε έναν πίνακα με διακριτές γραμμές.

Επεξεργασία με το Copilot

Χρησιμοποιήστε ένα ερώτημα FetchXML στύλ Dataverse που παρέχει καμία ευελιξία στη δημιουργία προσαρμοσμένων ερωτημάτων. Αυτά τα ερωτήματα μπορούν να είναι χρήσιμα όταν εργάζεστε με έναν πίνακα που έχει πολλούς σχετικούς πίνακες ή όταν χειρίζεστε σελιδοποίηση. Το παρακάτω στιγμιότυπο οθόνης δείχνει τον τρόπο χρήσης του FetchXML.

Παράδειγμα ερωτήματος FetchXML για τον πίνακα Λογαριασμός:

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

Καθώς ο διακριτός τελεστής δεν υποστηρίζεται αυτή τη στιγμή απευθείας στα ερωτήματα FetchXML από την ενέργεια "Γραμμές λίστας", η συνάρτηση ένωσης μπορεί να χρησιμοποιηθεί για την κατάργηση διπλότυπων γραμμών. Για παράδειγμα, μπορείτε να χρησιμοποιήσετε την Επιλογή ενέργειας για να μετασχηματίσετε την απόκριση της σύνδεσης γραμμών λίστας στη συγκεκριμένη μορφή πίνακα που χρειάζεστε και, στη συνέχεια, να δημιουργήσετε μια μεταβλητή με την παράσταση union(body(‘Select’),body(‘Select’)) για να λάβετε έναν πίνακα με διακριτές γραμμές.

Παράλειψη διακριτικού

Επειδή το Power Automate εφαρμόζει όρια ταχύτητας απόδοσης περιεχομένου και όρια μεγέθους μηνυμάτων για τη διασφάλιση εγγυήσεις γενικής εξυπηρέτησης, συχνά είναι χρήσιμο να χρησιμοποιήσετε τη σελιδοποίηση για να επιστρέψετε ένα μικρότερο αριθμό γραμμών σε μια δέσμη, αντί των προεπιλεγμένων ορίων στον αριθμό των γραμμών πίνακα που επιστρέφονται.

Το προεπιλεγμένο όριο σελίδας των 5.000 γραμμών ισχύει εάν δεν χρησιμοποιείτε σελιδοποίηση.

Για να το χρησιμοποιήσετε, εφαρμόστε έναν βρόχο για ανάλυση της τιμής odata.nextLink στην απόκριση JSON, εξαγάγετε το διακριτικό παράλειψης και, στη συνέχεια, στείλτε μια άλλη αίτηση μέχρι να παρατίθενται οι γραμμές που χρειάζεστε.

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

Αναγνωριστικό διαμερίσματος

Μια επιλογή για τον καθορισμό του αναγνωριστικού διαμερίσματος κατά την ανάκτηση δεδομένων για τους πίνακες NoSQL. Για να μάθετε περισσότερα, ανατρέξτε στο θέμα Βελτίωση απόδοσης χρησιμοποιώντας διαμερίσματα χώρου αποθήκευσης κατά την πρόσβαση σε δεδομένα πίνακα.