ColumnNamesσυναρτήσεις και Column

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

Ανακτά ονόματα στηλών και τιμές από μια δυναμική τιμή.

Περιγραφή

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

Η Column συνάρτηση επιστρέφει την τιμή μιας ιδιότητας από μια δυναμική εγγραφή με το δεδομένο όνομα στήλης. Η τιμή επιστρέφεται ως δυναμική τιμή.

Οι ColumnNames συναρτήσεις και Column επιστρέφουν σφάλματα εάν η δυναμική τιμή δεν αντιπροσωπεύει μια εγγραφή (δηλαδή, εάν αντιπροσωπεύει έναν πίνακα ή μια ανυσματική ή στοιχειώδη τιμή).

Σύνταξη

ColumnNames( DynamicRecord )

• DynamicRecord – Υποχρεωτικό. Μια δυναμική τιμή που αντιπροσωπεύει μια εγγραφή.

Column( DynamicRecord, ColumnName )

• DynamicRecord – Υποχρεωτικό. Μια δυναμική τιμή που αντιπροσωπεύει μια εγγραφή.
• ColumnName - Απαιτείται. Το όνομα της στήλης που θα ανακτηθεί από τη δεδομένη καρτέλα.

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

Πρόσβαση σε τιμές πεδίου

Δεδομένης της παρακάτω συμβολοσειράς JSON σε μια μεταβλητή με όνομα JsonString

{ "name": "Seattle", "population": 737000 }

1. Ο παρακάτω τύπος επιστρέφει έναν πίνακα μίας στήλης με μια Value στήλη που περιέχει τις ακόλουθες τιμές: "name", "population":

   ColumnNames( ParseJSON( JsonString ) )
   

2. Ο παρακάτω τύπος επιστρέφει τον αριθμό 737000:

   Value( Column( ParseJSON( JsonString ), "population" ) )
   

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

3. Ο παρακάτω τύπος επιστρέφει την τιμή κειμένου "name: Seattle, population: 737000":

   With(
       { untyped: ParseJSON( JsonString ) },
       Concat(
           ColumnNames( untyped ),
           $"{Value}: {Column( untyped, Value )}",
           ", "))
   

Κενά

Δεδομένης της παρακάτω συμβολοσειράς JSON σε μια μεταβλητή με όνομα JsonString

{ "text": "text value" , "number": 567, "empty": null }

1. Η προσπάθεια πρόσβασης σε πεδία που δεν υπάρχουν, επιστρέφει Blank(). Ο παρακάτω τύπος επιστρέφει true:

   IsBlank( Column( ParseJSON( JsonString ), "does not exist" ) )
   

2. Οι τιμές null JSON θεωρούνται Blank(). Ο παρακάτω τύπος επιστρέφει true:

   IsBlank( Column( ParseJSON( JsonString ), "empty" ) )
   

Nonrecords

Η κλήση των Column συναρτήσεων or ColumnNames με δυναμικές τιμές που δεν αντιπροσωπεύουν εγγραφές επιστρέφουν σφάλμα. Όλες αυτές οι παραστάσεις στην παρακάτω λίστα είναι λανθασμένες:

Τύπος	Αιτία για σφάλμα
ColumnNames( ParseJSON ( "[1, 2, 3]" ) )	Η δυναμική τιμή αντιπροσωπεύει έναν πίνακα
Column( ParseJSON ( "23.45" ), "Value" )	Η δυναμική τιμή αντιπροσωπεύει έναν αριθμό
ColumnNames( ParseJSON ( """hello""" ) )	Η δυναμική τιμή αντιπροσωπεύει ένα κείμενο
Column( ParseJSON ( "{""a""":false}" ).a, "a" )	Η δυναμική τιμή αντιπροσωπεύει μια δυαδική τιμή