Κοινοποίηση μέσω


στοιχείο ελέγχου

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

Διαθέσιμο για

Εφαρμογές βάσει μοντέλου και καμβά

Παράμετροι

Ονομασία Περιγραφή Τύπος Απαραίτητο Διαθέσιμο για
namespace Ορίζει το πρωτότυπο αντικείμενο του στοιχείου Μόνο γράμματα ή αριθμοί Yes Εφαρμογές βάσει μοντέλου και καμβά
constructor Μια μέθοδος προετοιμασίας του αντικειμένου Μόνο γράμματα ή αριθμοί Yes Εφαρμογές βάσει μοντέλου και καμβά
control-type Εάν το στοιχείο ελέγχου είναι ένα τυπικό στοιχείο ελέγχου ή ένα στοιχείο ελέγχου React. Η τιμή virtual υποδεικνύει ένα στοιχείο ελέγχου React χρησιμοποιώντας τη βιβλιοθήκη React πλατφόρμας. Τα εικονικά στοιχεία ελέγχου είναι μια δυνατότητα σε δημόσια προεπισκόπηση. Περισσότερες πληροφορίες: Στοιχεία ελέγχου React και βιβλιοθήκες πλατφόρμας standard|virtual No Εφαρμογές βάσει μοντέλου και καμβά
description-key Καθορίζει την περιγραφή του στοιχείου που είναι ορατό στο περιβάλλον εργασίας χρήστη. string No Εφαρμογές βάσει μοντέλου και καμβά
display-name-key Καθορίζει το όνομα του στοιχείου ελέγχου που είναι ορατό στο περιβάλλον εργασίας χρήστη. string Yes Εφαρμογές βάσει μοντέλου και καμβά
preview-image Εικόνα που χρησιμοποιείται στις οθόνες προσαρμογής για την εμφάνιση μιας προεπισκόπησης του στοιχείου. string No Εφαρμογές βάσει μοντέλου
version Καθορίζει την έκδοση του στοιχείου που ορίζεται στη Διαχείριση σημασιολογικών εκδόσεων string Yes Εφαρμογές βάσει μοντέλου και καμβά

Γονικά στοιχεία

Στοιχείο Περιγραφή
φανερός Η διακήρυξη είναι το αρχείο μετα-δεδομένων που ορίζει ένα στοιχείο. Είναι ένα XML αρχείο που περιγράφει:
  • Ο χώρος ονομάτων του στοιχείου.
  • Το είδος των δεδομένων που μπορούν να ρυθμιστούν, είτε πεδίο είτε σύνολο δεδομένων.
  • Οποιεσδήποτε ιδιότητες που μπορούν να ρυθμιστούν στην εφαρμογή κατά την προσθήκη του στοιχείου.
  • Μια λίστα αρχείων πόρων που χρειάζεται το στοιχείο.
    • Ένας από αυτούς πρέπει να είναι ένας πόρος web TypeScript. Αυτό το TypeScript πρέπει να περιλαμβάνει μια συνάρτηση που θα ξεκινήσει ένα αντικείμενο. Υλοποιεί μια διασύνδεση που εκθέτει μεθόδους που είναι απαραίτητες για τη λειτουργία του στοιχείου. Αυτή ονομάζεται βιβλιοθήκη υλοποίησης στοιχείων.
  • Το όνομα μιας συνάρτησης TypeScript στη βιβλιοθήκη υλοποίησης στοιχείων που θα επιστρέψει ένα αντικείμενο που εφαρμόζει την απαιτούμενη διασύνδεση στοιχείου.
Όταν ο χρήστης ρυθμίζει ένα προσαρμοσμένο στοιχείο σε μια εφαρμογή καμβά ή μια εφαρμογή βάσει μοντέλου, τα δεδομένα στη διακήρυξη φιλτράρουν τα διαθέσιμα στοιχεία, έτσι ώστε μόνο τα έγκυρα στοιχεία για το περιβάλλον να είναι διαθέσιμα για ρύθμιση παραμέτρων. Οι ιδιότητες που ορίζονται στη διακήρυξη για ένα στοιχείο αποδίδονται ως πεδία ρύθμισης παραμέτρων, έτσι ώστε ο χρήστης που ρυθμίζεται το στοιχείο να μπορεί να καθορίσει τιμές. Στη συνέχεια, αυτές οι τιμές ιδιοτήτων είναι διαθέσιμες στη συνάρτηση στοιχείου κατά τον χρόνο εκτέλεσης.

Θυγατρικά στοιχεία

Στοιχείο Περιγραφή Εμφανίσεις
σύνολο δεδομένων Ο κόμβος συνόλου δεδομένων στη διακήρυξη στοιχείου αντιπροσωπεύει μια συγκεκριμένη αναπαράσταση με δυνατότητα ρύθμισης παραμέτρων ενός συνόλου εγγραφών πίνακα. 0 ή περισσότερα
εξωτερική-υπηρεσία-χρήση Υποδεικνύει εάν αυτό το στοιχείο ελέγχου χρησιμοποιεί εξωτερική υπηρεσία ή όχι. Εάν είναι, ορίστε τη σημαία του ενεργοποιημένες χαρακτηριστικού ως true και προσθέστε τον εξωτερικό τομέα υπηρεσίας στην <domain> ιδιότητα . Ένα στοιχείο ελέγχου που χρησιμοποιεί οποιαδήποτε εξωτερική υπηρεσία είναι ένα στοιχείο ελέγχου Premium και ο τελικός χρήστης θα χρειαστεί μια άδεια χρήσης Power Apps για να ανοίξει μια εφαρμογή με ένα στοιχείο ελέγχου Premium. Περισσότερες πληροφορίες: Εκχώρηση αδειών χρήσης 0 ή 1
ιδιοκτησία Ο κόμβος ιδιότητας ορίζει ένα συγκεκριμένο τμήμα δεδομένων με δυνατότητα ρύθμισης παραμέτρων, το οποίο αναμένει το στοιχείο από το Microsoft Dataverse. 0 ή περισσότερα
πόροι Ο κόμβος πόρων στη διακήρυξη στοιχείου αναφέρεται στα αρχεία πόρων που απαιτεί το στοιχείο για την υλοποίηση της απεικόνισής του. 1
type-group Ο κόμβος type-group ορίζει ένα σύνολο τύπων που προσδιορίζονται από ένα μοναδικό όνομα. Αυτές οι πληροφορίες μπορούν να χρησιμοποιηθούν για τον προσδιορισμό των τύπων δεδομένων που υποστηρίζονται από μια συγκεκριμένη ιδιότητα. 0 ή περισσότερα
εξαρτήσεις ιδιοτήτων Καθορίζει μια ομάδα εξαρτήσεων-ιδιοτήτων. 0 ή περισσότερα
ενέργεια πλατφόρμας Χρησιμοποιείται για να καθορίσετε ότι οι εξαρτήσεις στοιχείων ελέγχου φορτώνονται κατά απαίτηση αντί κατά τη φόρτωση του στοιχείου ελέγχου. 0 ή 1

Παράδειγμα

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

Αναφορά σχήματος διακήρυξης πλαισίου εργασίας στοιχείων του Power Apps
Αναφορά API για το πλαίσιο εργασίας στοιχείων του Power Apps
Επισκόπηση πλαισίου εργασίας στοιχείων του Power Apps