Ετικέτα προτύπου Liquid για στοιχεία κώδικα

  • Άρθρο

Σημείωση

Από τις 12 Οκτωβρίου 2022, οι πύλες του Power Apps είναι Power Pages. Περισσότερες πληροφορίες: Το Microsoft Power Pages είναι πλέον γενικά διαθέσιμο (ιστολόγιο)
Σύντομα θα μετεγκαταστήσουμε και θα συγχωνεύσουμε την τεκμηρίωση των πυλών Power Apps με την τεκμηρίωση Power Pages.

Το Power Apps component framework παρέχει σε επαγγελματίες προγραμματιστές και κατασκευαστές εφαρμογών τη δυνατότητα να δημιουργούν στοιχεία κώδικα για εφαρμογές που καθορίζονται μοντέλο και εφαρμογές καμβά. Αυτά τα στοιχεία κώδικα μπορούν να παρέχουν μια βελτιωμένη εμπειρία για χρήστες που εργάζονται με δεδομένα σε φόρμες, προβολές και πίνακες εργαλείων. Περισσότερες πληροφορίες: Χρήση στοιχείων κώδικα σε πύλες

Σημαντικό

Η ετικέτα προτύπου Liquid για τα στοιχεία κώδικα απαιτεί έκδοση για πύλες 9.3.10.x ή μεταγενέστερη.

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

Τα στοιχεία κώδικα μπορούν να προστεθούν με τη χρήση της ετικέτας προτύπου Liquid codecomponent. Το κλειδί για το σχόλιο του στοιχείου κώδικα που πρέπει να φορτωθεί περνά με χρήση του χαρακτηριστικού name. Το κλειδί μπορεί να είναι το GUID (το οποίο είναι το αναγνωριστικό στοιχείου κώδικα) ή το όνομα του στοιχείου κώδικα που εισάγεται μέσα στο Microsoft Dataverse.

Οι τιμές των ιδιοτήτων που αναμένει το στοιχείο κώδικα πρέπει να μεταβιβαστούν ως κλειδί/ζεύγος τιμής, διαχωρισμένο με το σύμβολο ":" (σύμβολο άνω και κάτω τελείας), όπου το κλειδί είναι το όνομα της ιδιότητας και η τιμή είναι η τιμή της συμβολοσειράς JSON.

{% codecomponent name: <ID or name> <property1:value> <property2:value> %}

Για παράδειγμα, για να προσθέσετε ένα στοιχείο που αναμένει μια παράμετρο εισόδου με όνομα controlValue, χρησιμοποιήστε την εξής ετικέτα προτύπου Liquid:

{% codecomponent name:abc_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value>%}

Φιλοδώρημα

Σε αυτό το παράδειγμα χρησιμοποιούνται παράμετροι που ονομάζονται controlvalue και controlApiKey, ωστόσο το στοιχείο που χρησιμοποιείτε ενδέχεται να απαιτεί διαφορετικά ονόματα παραμέτρων.

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

Σημείωση

Οι πόροι που δημιουργούνται από την κοινότητα δεν υποστηρίζονται από τη Microsoft. Αν έχετε ερωτήσεις ή αντιμετωπίζετε ζητήματα με τους πόρους της κοινότητας, επικοινωνήστε με τον εκδότη του πόρου. Πριν χρησιμοποιήσετε αυτούς τους πόρους, πρέπει να βεβαιωθείτε ότι πληρούν τις οδηγίες του Power Apps component framework και θα πρέπει να χρησιμοποιούνται μόνο για λόγους αναφοράς.

Πρόγραμμα εκμάθησης: Χρήση στοιχείων κώδικα σε σελίδες με ετικέτα προτύπου Liquid

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

Πριν να ξεκινήσετε

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

Προϋποθέσεις

Για προϋποθέσεις και για να μάθετε για στοιχεία κώδικα που υποστηρίζονται/δεν υποστηρίζονται στις πύλες, ανατρέξτε στο Χρήση στοιχείων κώδικα σε πύλες.

Σημείωση

Αυτό το εκπαιδευτικό βοήθημα χρησιμοποιεί ένα στοιχείο δείγματος κώδικα που έχει δημιουργηθεί με χρήση του Power Apps component framework για την επίδειξη ενός στοιχείου ελέγχου αντιστοίχισης σε μια ιστοσελίδα. Μπορείτε, επίσης, να χρησιμοποιήσετε οποιοδήποτε υπάρχον ή νέο δικό σας στοιχείο και οποιαδήποτε άλλη ιστοσελίδα για αυτό το εκπαιδευτικό βοήθημα. Σε αυτή την περίπτωση, φροντίστε να χρησιμοποιείτε το στοιχείο και την ιστοσελίδα σας όταν ακολουθείτε τα βήματα σε αυτό το εκπαιδευτικό βοήθημα. Για περισσότερες πληροφορίες σχετικά με τον τρόπο δημιουργίας στοιχείων κώδικα, μεταβείτε στο θέμα Δημιουργία του πρώτου σας στοιχείου.

Βήμα 1. Προσθήκη του στοιχείου κώδικα σε μια ιστοσελίδα από το Studio

  1. Ανοίξτε την πύλη σας στο  Studio για πύλες Power Apps.

  2. Στην επάνω αριστερή γωνία, επιλέξτε  Νέα σελίδα.

  3. Επιλέξτε  Κενό.

  4. Στο τμήμα παραθύρου ιδιοτήτων της δεξιάς πλευράς, ενημερώστε το όνομα της ιστοσελίδας. Για παράδειγμα, "Προβολή αντιστοίχισης".

  5. Ενημέρωση μερικής διεύθυνσης URL. Για παράδειγμα, "mapviewer".

  6. Αναπτύξτε τα Δικαιώματα.

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

  8. Επιλέξτε τους ρόλους web που θα πρέπει να έχουν δικαίωμα πρόσβασης σε αυτήν τη σελίδα.

  9. Επιλέξτε την επεξεργάσιμη περιοχή στη σελίδα για να επεξεργαστείτε τον κωδικό προέλευσης Liquid.

  10. Ανοίξτε το πρόγραμμα επεξεργασίας κώδικα του studio.

  11. Προσθέστε το στοιχείου ελέγχου με την ετικέτα προτύπου Liquid με χρήση της παρακάτω σύνταξης:

    {% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}

    Φιλοδώρημα

    Για να ανακτήσετε τις λεπτομέρειες όλων των στοιχείων που έχουν εισαχθεί και για να αναζητήσετε ένα όνομα στοιχείου, ανατρέξτε στο CustomControl Web API.

    Για παράδειγμα:

    • Για να αναζητήσετε ένα στοιχείο:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$select=ContosoCustomControlName

    • Για ανάκτηση παραμέτρων εισόδου για ένα στοιχείο:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$filter=name eq 'ContosoCustomControlName' &$select=manifest

  12. Αποθηκεύστε και κλείστε το πρόγραμμα επεξεργασίας κώδικα.

  13. Στην επάνω δεξιά γωνία, επιλέξτε  Περιήγηση στην τοποθεσία web.

  14. Τώρα στην ιστοσελίδα θα εμφανίζεται το στοιχείο ελέγχου που προστέθηκε σε αυτήν.

Επόμενα βήματα

Επισκόπηση: Χρήση των στοιχείων κώδικα στις πύλες

Δείτε επίσης

Ετικέτα οντότητας Codecomponent Dataverse
Ετικέτα προτύπου Codecomponent
Επισκόπηση Power Apps component framework
Δημιουργία του πρώτου σας στοιχείου
Προσθήκη στοιχείων κώδικα σε μια στήλη ή έναν πίνακα σε εφαρμογές που καθορίζονται από μοντέλο
Εφαρμογή δείγματος στοιχείου API Web πύλης

Σημείωση

Μπορείτε να μας πείτε ποια γλώσσα προτιμάτε για την τεκμηρίωση; Πάρτε μέρος σε μια σύντομη έρευνα. (σημειώνεται ότι αυτή η έρευνα είναι στα Αγγλικά)

Η έρευνα θα διαρκέσει περίπου επτά λεπτά. Δεν συλλέγονται προσωπικά δεδομένα (δήλωση προστασίας προσωπικών δεδομένων).