Συνάρτηση DataSourceInfo
Ισχύει σε:
Εφαρμογές καμβά Εφαρμογές βάσει μοντέλου
Παρέχει πληροφορίες για μια προέλευση δεδομένων.
Επισκόπηση
Οι προελεύσεις δεδομένων μπορούν να παρέχουν πληθώρα πληροφοριών για τη βελτιστοποίηση της εμπειρίας του χρήστη.
Μπορείτε να χρησιμοποιήσετε πληροφορίες επιπέδου στήλης για την επικύρωση των στοιχείων που εισάγονται από τον χρήστη και να παρέχετε άμεσα σχόλια στον χρήστη πριν από τη χρήση της συνάρτησης Patch. Η συνάρτηση Validate χρησιμοποιεί αυτές τις ίδιες πληροφορίες.
Μπορείτε να χρησιμοποιήσετε πληροφορίες σε επίπεδο προέλευσης δεδομένων, για παράδειγμα, για να απενεργοποιήσετε ή να αποκρύψετε τα κουμπιά Επεξεργασία και Δημιουργία για τους χρήστες που δεν διαθέτουν δικαιώματα επεξεργασίας ή δημιουργίας καρτελών.
Οι προελεύσεις δεδομένων ποικίλλουν ως προς τον όγκο των πληροφοριών που παρέχουν και ενδέχεται να μην παρέχουν καθόλου πληροφορίες. Οι Συλλογές δεν παρέχουν καμία πληροφορία. Εάν δεν παρέχεται κάποια πληροφορία, χρησιμοποιείται η προεπιλογή ή επιστρέφεται κενό.
Σημείωμα
Προς το παρόν, η λειτουργία DataSourceInfo δεν υποστηρίζεται στις Λίστες Microsoft.
Περιγραφή
Πληροφορίες στήλης
Μπορείτε να χρησιμοποιήσετε τη συνάρτηση DataSourceInfo για να λάβετε πληροφορίες για μια συγκεκριμένη στήλη μιας προέλευσης δεδομένων:
| Όρισμα πληροφοριών | Τύπος αποτελεσμάτων | Περιγραφή |
|---|---|---|
| DataSourceInfo.DisplayName | Συμβολοσειρά | Το εμφανιζόμενο όνομα για τη στήλη. Εάν δεν ορίζεται εμφανιζόμενο όνομα, επιστρέφει το όνομα στήλης. |
| DataSourceInfo.MaxLength | Αριθμός | Ο μέγιστος αριθμός χαρακτήρων που μπορεί να περιέχει η στήλη. Ισχύει μόνο σε στήλες που περιέχουν συμβολοσειρές. Εάν δεν έχει οριστεί μέγιστη τιμή, επιστρέφει κενό. |
| DataSourceInfo.MaxValue | Αριθμός | Η μέγιστη αριθμητική τιμή που μπορεί να περιέχει μια στήλη. Ισχύει μόνο σε στήλες που περιέχουν αριθμούς. Εάν δεν έχει οριστεί μέγιστη τιμή, επιστρέφει κενό. |
| DataSourceInfo.MinValue | Αριθμός | Η ελάχιστη αριθμητική τιμή που μπορεί να περιέχει μια στήλη. Ισχύει μόνο σε στήλες που περιέχουν αριθμούς. Εάν δεν έχει οριστεί ελάχιστη τιμή, επιστρέφει κενό. |
| DataSourceInfo.Required | Δυαδικός | Απαιτείται μια τιμή για αυτήν τη στήλη; Εάν δεν ορίζεται από την προέλευση δεδομένων, επιστρέφει false. |
Το τρίτο όρισμα είναι το όνομα μιας στήλης ως συμβολοσειρά. Για παράδειγμα, η στήλη Τηλέφωνο στη συλλογή Άτομα θα διαβιβαστεί ως "Τηλέφωνο" μαζί με τα διπλά εισαγωγικά.
Πληροφορίες προέλευσης δεδομένων
Μπορείτε επίσης να χρησιμοποιήσετε τη συνάρτηση DataSourceInfo για να λάβετε πληροφορίες σχετικά με μια προέλευση δεδομένων ως σύνολο:
| Όρισμα πληροφοριών | Τύπος αποτελεσμάτων | Περιγραφή |
|---|---|---|
| DataSourceInfo.AllowedValues | Δυαδικός | Ποιοι τύποι δικαιωμάτων μπορούν να εκχωρηθούν στους χρήστες για αυτήν την προέλευση δεδομένων; Εάν δεν ορίζεται από την προέλευση δεδομένων, επιστρέφει κενό. |
| DataSourceInfo.CreatePermission | Δυαδικός | Διαθέτει ο τρέχων χρήστης δικαιώματα για να δημιουργεί καρτέλες σε αυτήν την προέλευση δεδομένων; Εάν δεν ορίζεται από την προέλευση δεδομένων, επιστρέφει true. |
| DataSourceInfo.DeletePermission | Δυαδικός | Διαθέτει ο τρέχων χρήστης δικαιώματα για να διαγράφει καρτέλες σε αυτήν την προέλευση δεδομένων; Εάν δεν ορίζεται από την προέλευση δεδομένων, επιστρέφει true. |
| DataSourceInfo.EditPermission | Δυαδικός | Διαθέτει ο τρέχων χρήστης δικαιώματα για να επεξεργάζεται καρτέλες σε αυτήν την προέλευση δεδομένων; Εάν δεν ορίζεται από την προέλευση δεδομένων, επιστρέφει true. |
| DataSourceInfo.ReadPermission | Δυαδικός | Διαθέτει ο τρέχων χρήστης δικαιώματα για να διαβάζει καρτέλες σε αυτήν την προέλευση δεδομένων; Εάν δεν ορίζεται από την προέλευση δεδομένων, επιστρέφει true. |
Σημείωμα
Το DataSourceInfo επιστρέφει true αν δεν μπορεί να προσδιορίσει αν ο τρέχων χρήστης έχει το απαιτούμενο δικαίωμα. Τα δικαιώματα θα ελεγχθούν ξανά από τον διακομιστή όταν πραγματοποιηθεί η τρέχουσα λειτουργία και εμφανιστεί ένα σφάλμα εάν δεν επιτρέπεται. Προς το παρόν, ο έλεγχος δικαιωμάτων με το DataSourceInfo είναι δυνατός μόνο κατά τη χρήση του Microsoft Dataverse.
Σύνταξη
DataSourceInfo( DataSource, Information [, ColumnName] )
- DataSource – Υποχρεωτικό. Η προέλευση δεδομένων που θα χρησιμοποιηθεί.
- Πληροφορίες – Υποχρεωτικό. Ο τύπος των πληροφοριών που θέλετε να ανακτήσετε.
- ColumnName – Προαιρετικό. Το όνομα στήλης για την οποία θα ανακτηθούν πληροφορίες επιπέδου στήλης. Για πληροφορίες επιπέδου προέλευσης δεδομένων, το όρισμα ColumnName δεν μπορεί να χρησιμοποιηθεί.
Σημείωμα
Στο Power Apps πριν από την έκδοση 3.24042, τα ονόματα στηλών καθορίστηκαν με μια συμβολοσειρά κειμένου με τη χρήση διπλών εισαγωγικών και, αν συνδεθούν σε μια προέλευση δεδομένων θα ήταν απαραίτητα για να είναι λογικά ονόματα. Για παράδειγμα, χρησιμοποιήθηκε το λογικό όνομα "cr43e_name" με διπλά εισαγωγικά αντί για το εμφανιζόμενο όνομα Name χωρίς εισαγωγικά. Για τις προελεύσεις δεδομένων SharePoint και Excel που περιέχουν ονόματα στηλών με διαστήματα, κάθε διάστημα καθορίστηκε με "_x0020_", για παράδειγμα "Όνομα στήλης" ως "Column_x0020_Name". Μετά από αυτήν την έκδοση, όλες οι εφαρμογές ενημερώθηκαν αυτόματα με τη νέα σύνταξη που περιγράφεται σε αυτό το άρθρο.
Παραδείγματα
Τα παραδείγματα σε αυτήν την ενότητα χρησιμοποιούν αυτήν την προέλευση δεδομένων, με το όνομα IceCream:
Η προέλευση δεδομένων παρέχει επίσης αυτές τις πληροφορίες:
- Το εμφανιζόμενο όνομα για τη στήλη Quantity είναι "Quantity on Hand".
- Το μέγιστο μήκος της στήλης Flavor είναι 30 χαρακτήρες.
- Η στήλη Flavor πρέπει να περιέχει μια τιμή. Η στήλη Quantity δεν απαιτείται.
- Η ελάχιστη τιμή για τη στήλη Quantity είναι 0.
- Η μέγιστη τιμή για τη στήλη Quantity είναι 100.
- Ο τρέχων χρήστης μπορεί να διαβάσει και να επεξεργαστεί τις καρτέλες της προέλευσης δεδομένων IceCream, αλλά δεν μπορεί να δημιουργήσει ή να διαγράψει καρτέλες.
| Τύπος | Περιγραφή | Αποτέλεσμα |
|---|---|---|
| DataSourceInfo( IceCream, DataSourceInfo.DisplayName, Quantity ) | Επιστρέφει το εμφανιζόμενο όνομα για τη στήλη Quantity της προέλευσης δεδομένων IceCream. | "Διαθέσιμη ποσότητα" |
| DataSourceInfo( IceCream, DataSourceInfo.MaxLength, Flavor ) | Επιστρέφει το μέγιστο μήκος της συμβολοσειράς για τη στήλη Flavor της προέλευσης δεδομένων IceCream. | 30 |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Flavor ) | Είναι υποχρεωτική η στήλη Flavor της προέλευσης δεδομένων IceCream; | αληθές |
| DataSourceInfo( IceCream, DataSourceInfo.Required, Quantity ) | Είναι υποχρεωτική η στήλη Quantity της προέλευσης δεδομένων IceCream; | ψευδής |
| DataSourceInfo( IceCream, DataSourceInfo.MaxValue, Quantity ) | Επιστρέφει τη μέγιστη αριθμητική τιμή για τη στήλη Quantity της προέλευσης δεδομένων IceCream. | 100 |
| DataSourceInfo( IceCream, DataSourceInfo.MinValue, Quantity ) | Επιστρέφει την ελάχιστη αριθμητική τιμή για τη στήλη Quantity της προέλευσης δεδομένων IceCream. | 0 |
| DataSourceInfo( IceCream, DataSourceInfo.ReadPermission) | Μπορεί ο τρέχων χρήστης να διαβάσει καρτέλες στην προέλευση δεδομένων IceCream; | true |
| DataSourceInfo( IceCream, DataSourceInfo.EditPermission) | Μπορεί ο τρέχων χρήστης να επεξεργαστεί καρτέλες στην προέλευση δεδομένων IceCream; | true |
| DataSourceInfo( IceCream, DataSourceInfo.CreatePermission) | Μπορεί ο τρέχων χρήστης να δημιουργήσει καρτέλες στην προέλευση δεδομένων IceCream; | false |
| DataSourceInfo( IceCream, DataSourceInfo.DeletePermission) | Μπορεί ο τρέχων χρήστης να διαγράψει καρτέλες στην προέλευση δεδομένων IceCream; | false |