AddColumns, DropColumns, RenameColumnsκαι ShowColumns συναρτήσεις

Ισχύει για: Εφαρμογές καμβά Συναρτήσεις του Copilot Studio Desktop

Διαμορφώνει έναν πίνακα ή μια εγγραφή προσθέτοντας, απορρίπτοντας, μετονομάζοντας και επιλέγοντας τις στήλες του.

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

Επισκόπηση

Αυτές οι συναρτήσεις διαμορφώνουν έναν πίνακα ή μια εγγραφή, προσαρμόζοντας τις στήλες τους:

• Μειώστε έναν πίνακα ή μια εγγραφή που περιέχει πολλές στήλες σε μία μόνο στήλη για χρήση με συναρτήσεις μίας στήλης, όπως η Lower ή η Sqrt.
• Προσθέστε μια υπολογιζόμενη στήλη σε έναν πίνακα ή μια εγγραφή (για παράδειγμα, μια στήλη Συνολική τιμή που εμφανίζει τα αποτελέσματα του πολλαπλασιασμού της στήλης Ποσότητα με την Τιμή μονάδας).
• Μετονομάστε μια στήλη σε κάτι πιο χαρακτηριστικό, για εμφάνιση στους χρήστες ή για χρήση σε τύπους.

Ένας πίνακας είναι μια τιμή στο Power Apps, όπως ακριβώς και μια συμβολοσειρά ή ένας αριθμός. Μπορείτε να καθορίσετε έναν πίνακα ως όρισμα σε έναν τύπο και οι συναρτήσεις μπορούν να επιστρέψουν έναν πίνακα ως αποτέλεσμα.

Σημείωμα

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

Δεν μπορείτε να τροποποιήσετε τις στήλες μιας προέλευσης δεδομένων με τη χρήση αυτών των συναρτήσεων. Πρέπει να τροποποιήσετε τα δεδομένα στην προέλευσή τους. Μπορείτε να προσθέσετε στήλες σε μια συλλογή με τη συνάρτηση Collect. Για περισσότερες πληροφορίες δείτε Εργασία με προελεύσεις δεδομένων.

Description

Η AddColumns συνάρτηση προσθέτει μια στήλη σε έναν πίνακα ή εγγραφή και ένας τύπος ορίζει τις τιμές σε αυτή τη στήλη. Οι υπάρχουσες στήλες παραμένουν αμετάβλητες.

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

Στον τύπο είναι διαθέσιμα πεδία της καρτέλας που βρίσκεται υπό επεξεργασία τη δεδομένη στιγμή. Χρησιμοποιήστε τον τελεστή ThisRecord ή απλά πεδία αναφοράς με βάση το όνομα, όπως θα κάνατε με οποιαδήποτε άλλη τιμή. Ο τελεστής As μπορεί επίσης να χρησιμοποιηθεί για το όνομα της καρτέλας που υπόκειται σε επεξεργασία και η οποία μπορεί να σας βοηθήσει να κάνετε τον τύπο σας πιο κατανοητό και να κάνετε προσβάσιμες τις ένθετες καρτέλες. Για περισσότερες πληροφορίες, δείτε τα παρακάτω παραδείγματα και την ενότητα εργασία με πεδίο καρτελών.

Η DropColumns συνάρτηση εξαιρεί στήλες από έναν πίνακα ή μια εγγραφή. Όλες οι άλλες στήλες παραμένουν αμετάβλητες. DropColumns Εξαιρεί στήλες και ShowColumns περιλαμβάνει στήλες.

Χρησιμοποιήστε τη RenameColumns συνάρτηση για να μετονομάσετε μία ή περισσότερες στήλες ενός πίνακα ή εγγραφής, παρέχοντας τουλάχιστον ένα ζεύγος ορισμάτων που καθορίζουν το όνομα μιας στήλης που περιέχει ο πίνακας ή η εγγραφή (το παλιό όνομα που θέλετε να αντικαταστήσετε) και το όνομα μιας στήλης που δεν περιέχει ο πίνακας ή η εγγραφή (το νέο όνομα, που θέλετε να χρησιμοποιήσετε). Το παλιό όνομα πρέπει να υπάρχει ήδη στον πίνακα ή την εγγραφή και το νέο όνομα δεν πρέπει να υπάρχει. Κάθε όνομα στήλης μπορεί να εμφανίζεται μόνο μία φορά στη λίστα ορισμάτων είτε ως παλιό είτε ως νέο όνομα στήλης. Για να μετονομάσετε μια στήλη σε ένα υπάρχον όνομα στήλης, πρώτα καταργήστε την υπάρχουσα στήλη με DropColumnsή μετονομάστε την υπάρχουσα στήλη, ενσωματώνοντας μια RenameColumns συνάρτηση μέσα σε μια άλλη.

Η ShowColumns συνάρτηση περιλαμβάνει στήλες ενός πίνακα ή εγγραφής και απορρίπτει όλες τις άλλες στήλες. Μπορείτε να χρησιμοποιήσετε ShowColumns το για να δημιουργήσετε έναν πίνακα ή μια εγγραφή μίας στήλης από έναν πίνακα ή μια εγγραφή πολλών στηλών. ShowColumns το περιλαμβάνει στήλες και DropColumns εξαιρεί στήλες.

Για όλες αυτές τις συναρτήσεις, το αποτέλεσμα είναι ένας νέος πίνακας ή εγγραφή όπου έχει εφαρμοστεί ο μετασχηματισμός. Ο αρχικός πίνακας ή εγγραφή δεν τροποποιείται. Δεν μπορείτε να τροποποιήσετε έναν υπάρχοντα πίνακα ή εγγραφή με έναν τύπο. Το SharePoint, το Microsoft Dataverse, ο SQL Server και άλλες προελεύσεις δεδομένων παρέχουν εργαλεία για την τροποποίηση των στηλών λιστών και πινάκων, οι οποίες συχνά αναφέρονται ως σχήμα. Οι συναρτήσεις σε αυτό το θέμα μετασχηματίζουν μόνο έναν πίνακα εισόδου ή μια εγγραφή, χωρίς να τροποποιούν τον αρχικό, σε έναν πίνακα ή εγγραφή εξόδου για περαιτέρω χρήση.

Τα ορίσματα σε αυτές τις συναρτήσεις υποστηρίζουν την ανάθεση. Για παράδειγμα, μια συνάρτηση Filter που χρησιμοποιείται ως όρισμα για την εμφάνιση μιας λίστας σχετικών καρτελών πραγματοποιεί αναζήτηση σε όλες τις καταχωρήσεις, ακόμη και αν η προέλευση δεδομένων '[dbo].[AllListings]' περιέχει ένα εκατομμύριο γραμμές:

AddColumns( RealEstateAgents,
   Listings,
   Filter(  '[dbo].[AllListings]', ListingAgentName = AgentName )
)

Ωστόσο, το αποτέλεσμα αυτών των συναρτήσεων υπόκειται στο όριο καρτέλας μη ανάθεσης. σε αυτό το παράδειγμα, επιστρέφονται μόνο 500 καρτέλες ακόμα και εάν η προέλευση δεδομένων RealEstateAgents έχει 501 ή περισσότερες καρτέλες.

Εάν χρησιμοποιείτε AddColumns με αυτόν τον τρόπο, η συνάρτηση Filter πρέπει να κάνει ξεχωριστές κλήσεις στην προέλευση δεδομένων για κάθε μία από αυτές τις πρώτες εγγραφές στο RealEstateAgents, το οποίο προκαλεί μεγάλη κίνηση δικτύου. Εάν το [dbo](.[AllListings] είναι αρκετά μικρό και δεν αλλάζει συχνά. Μπορείτε να καλέσετε τη συνάρτηση Collect στο OnStart για να προσθέσετε προσωρινά την προέλευση δεδομένων στην εφαρμογή σας μόλις ξεκινήσει. Εναλλακτικά, θα μπορούσατε να αναδομήσετε την εφαρμογή σας, ώστε να τραβάτε τις σχετικές καρτέλες μόνο όταν ο χρήστης τις ζητήσει.

Σημείωμα

Στο Power Apps πριν από την έκδοση 3.24042, τα ονόματα στηλών καθορίστηκαν με μια συμβολοσειρά κειμένου με τη χρήση διπλών εισαγωγικών και, αν συνδεθούν σε μια προέλευση δεδομένων θα ήταν απαραίτητα για να είναι λογικά ονόματα. Για παράδειγμα, χρησιμοποιήθηκε το λογικό όνομα "cr43e_name" με διπλά εισαγωγικά αντί για το εμφανιζόμενο όνομα Name χωρίς εισαγωγικά. Για τις προελεύσεις δεδομένων SharePoint και Excel που περιέχουν ονόματα στηλών με διαστήματα, κάθε διάστημα καθορίστηκε με "_x0020_", για παράδειγμα "Όνομα στήλης" ως "Column_x0020_Name". Μετά από αυτήν την έκδοση, όλες οι εφαρμογές ενημερώθηκαν αυτόματα με τη νέα σύνταξη που περιγράφεται σε αυτό το άρθρο.

Σύνταξη

AddColumns( TableOrRecord, ColumnName1, Formula1 [, ColumnName2, Formula2, ... ] )

• TableOrRecord - Υποχρεωτικό. Ο πίνακας ή η εγγραφή που θα λειτουργήσει.
• ColumnNames - Απαιτείται. Τα ονόματα των στηλών που θα προστεθούν.
• Τύποι- Απαιτείται. Οι τύποι για την αξιολόγηση κάθε καρτέλας. Το αποτέλεσμα θα προστίθεται ως η τιμή της αντίστοιχης νέας στήλης. Μπορείτε να αναφέρετε άλλες στήλες του πίνακα ή της εγγραφής σε αυτόν τον τύπο.

DropColumns( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

• TableOrRecord - Υποχρεωτικό. Ο πίνακας ή η εγγραφή που θα λειτουργήσει.
• ColumnNames - Απαιτείται. Τα ονόματα των στηλών που θα απορριφθούν.

RenameColumns( TableOrRecord, OldColumnName1, NewColumnName1 [, OldColumnName2, NewColumnName2, ... ] )

• TableOrRecord - Υποχρεωτικό. Ο πίνακας ή η εγγραφή που θα λειτουργήσει.
• OldColumnNames - Απαιτείται. Τα ονόματα των στηλών για μετονομασία από τον αρχικό πίνακα ή εγγραφή. Αυτό το στοιχείο εμφανίζεται πρώτο στο ζεύγος ορισμάτων (ή πρώτο σε κάθε ζεύγος ορισμάτων αν ο τύπος περιλαμβάνει περισσότερα από ένα ζεύγη).
• NewColumnNames - Απαιτείται. Ονόματα αντικατάστασης. Αυτό το στοιχείο εμφανίζεται τελευταίο στο ζεύγος ορισμάτων (ή τελευταίο σε κάθε ζεύγος ορισμάτων αν ο τύπος περιλαμβάνει περισσότερα από ένα ζεύγη).

ShowColumns( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

• TableOrRecord - Υποχρεωτικό. Ο πίνακας ή η εγγραφή που θα λειτουργήσει.
• ColumnNames - Απαιτείται. Τα ονόματα των στηλών που θα συμπεριληφθούν.

Παραδείγματα

Τα παραδείγματα σε αυτή την ενότητα χρησιμοποιούν την προέλευση δεδομένων IceCreamSales, η οποία περιέχει τα δεδομένα σε αυτόν τον πίνακα:

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

Τύπος	Description	Result
AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )	Προσθέτει μια στήλη Revenue στο αποτέλεσμα. Για κάθε εγγραφή, υπολογίζεται το γινόμενο UnitPrice * QuantitySold και το αποτέλεσμα τοποθετείται στη νέα στήλη.
DropColumns( IceCreamSales, UnitPrice )	Εξαιρεί τη στήλη UnitPrice στήλη από το αποτέλεσμα. Χρησιμοποιήστε αυτήν τη συνάρτηση για να εξαιρέσετε στήλες και χρησιμοποιήστε ShowColumns την για να τις συμπεριλάβετε.
ShowColumns( IceCreamSales, Flavor )	Περιλαμβάνει μόνο τη στήλη Flavor στήλης στο αποτέλεσμα. Χρησιμοποιήστε αυτήν τη συνάρτηση για να συμπεριλάβετε στήλες και χρησιμοποιήστε DropColumns τις για να τις εξαιρέσετε.
RenameColumns( IceCreamSales, UnitPrice, Price)	Μετονομάζει τη στήλη UnitPrice στο αποτέλεσμα.
RenameColumns( IceCreamSales, UnitPrice, Price, QuantitySold, Number)	Μετονομάζει τις στήλες UnitPrice και QuantitySold στο αποτέλεσμα.
DropColumns( RenameColumns( AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold ), UnitPrice, Price ), Quantity )	Εκτελεί τους ακόλουθους μετασχηματισμούς πίνακα με τη σειρά, ξεκινώντας από το εσωτερικό του τύπου: Προσθέτει μια στήλη Revenue με βάση τον υπολογισμό του γινομένου UnitPrice * Quantity ανά εγγραφή. Μετονομάζει τη στήλη UnitPrice σε Price. Εξαιρεί τη στήλη Quantity. Η παραγγελία είναι σημαντική, για παράδειγμα, δεν είναι δυνατό να γίνουν υπολογισμοί με τη στήλη UnitPrice μετά τη μετονομασία της.

Βήμα προς βήμα

Ας δοκιμάσουμε ορισμένα από τα παραδείγματα που προηγήθηκαν σε αυτό το άρθρο.

1. Δημιουργήστε μια συλλογή προσθέτοντας ένα στοιχείο ελέγχου Button και ορίζοντας την ιδιότητά του OnSelect σε αυτόν τον τύπο:

   ClearCollect( IceCreamSales,
      Table(
          { Flavor: "Strawberry", UnitPrice: 1.99, QuantitySold: 20 },
          { Flavor: "Chocolate", UnitPrice: 2.99, QuantitySold: 45 },
          { Flavor: "Vanilla", UnitPrice: 1.50, QuantitySold: 35 }
      )
   )
   

2. Εκτελέστε τον τύπο επιλέγοντας το κουμπί, ενώ κρατάτε πατημένο το πλήκτρο Alt.

3. Προσθέστε ένα δεύτερο στοιχείο ελέγχου Button ορίστε στην ιδιότητα OnSelect αυτόν τον τύπο και μετά εκτελέστε το:

   ClearCollect( FirstExample,
      AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
   )
   

4. Στο μενού Αρχείο, επιλέξτε Συλλογές και μετά επιλέξτε IceCreamSales για να εμφανίσετε αυτήν τη συλλογή.

   Όπως δείχνει αυτό το γραφικό, ο δεύτερος τύπος δεν τροποποίησε αυτήν τη συλλογή. Η AddColumns συνάρτηση χρησιμοποίησε τον πίνακα IceCreamSales ως όρισμα μόνο για ανάγνωση. Η συνάρτηση δεν τροποποίησε τον πίνακα στον οποίο αναφέρεται αυτό το όρισμα.

   

5. Επιλέξτε FirstExample.

   Όπως δείχνει αυτό το γραφικό, ο δεύτερος τύπος επέστρεψε ένα νέο πίνακα με την προσθήκη της στήλης. Η συνάρτηση ClearCollect κατέγραψε τον νέο πίνακα στη συλλογή FirstExample, προσθέτοντας κάτι στον αρχικό πίνακα, καθώς περνούσε από τη συνέρτηση χωρίς να τροποποιήσει την προέλευση:

   

Αντιστοίχιση στηλών σε ένα στοιχείο

Δέιτε Αντιστοίχιση στηλών.