Ετικέτες οντότητας Dataverse

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

γράφημα

Προσθέτει ένα Power Apps γράφημα σε μια ιστοσελίδα. Μπορείτε να προσθέσετε την ετικέτα του γραφήματος στο πεδίο Αντιγραφή σε μια ιστοσελίδα ή στο πεδίο προέλευσης σε ένα πρότυπο Web. Για τα βήματα που πρέπει να ακολουθήσετε για να προσθέσετε ένα Power Apps γράφημα σε μια ιστοσελίδα, ανατρέξτε στο άρθρο Προσθήκη γραφήματος σε μια ιστοσελίδα σε πύλη.

{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}

Παράμετροι

Υπάρχουν δύο παραμέτρους που παρέχονται με την ετικέτα γραφήματος: αναγνωριστικό γραφήματος και viewid.

αναγνωριστικό γραφήματος

Αναγνωριστικό απεικόνισης γραφήματος. Μπορείτε να αποκτήσετε αυτήν τη δυνατότητα αν εξαγάγετε το γράφημα.

viewid

Αναγνωριστικό του πίνακα όταν ανοίγει στην προβολή επεξεργασίας.

powerbi

Προσθέτει πίνακες εργαλείων Power BI και αναφορές σε σελίδες. Μπορείτε να προσθέσετε την ετικέτα του γραφήματος στο πεδίο Αντιγραφή σε μια ιστοσελίδα ή στο πεδίο Προέλευση σε ένα πρότυπο Web. Για τα βήματα για να προσθέσετε μια αναφορά Power BI ή έναν πίνακα εργαλείων σε μια ιστοσελίδα στην πύλη, ανατρέξτε στην ενότητα Προσθήκη αναφοράς Power BI ή πίνακα εργαλείων σε μια ιστοσελίδα σε πύλη.

Σημείωση

Για να λειτουργήσει η ετικέτα, πρέπει να ενεργοποιήσετε την ενοποίηση Power BI από το Κέντρο διαχείρισης πυλών Power Apps. Εάν δεν είναι ενεργοποιημένη η ενοποίηση Power BI, ο πίνακας εργαλείων ή η αναφορά δεν εμφανίζονται.

Παράμετροι

Η ετικέτα powerbi δέχεται τις ακόλουθες παραμέτρους:

διαδρομή

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

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

authentication_type

Τύπος ελέγχου ταυτότητας που απαιτείται για την αναφορά Power BI ή τον πίνακα εργαλείων. Οι έγκυρες τιμές για αυτήν την παράμετρο είναι οι εξής:

  • Ανώνυμη: σάς επιτρέπει να ενσωματώσετε δημοσίευση σε αναφορές web του Power BI. Ο προεπιλεγμένος τύπος ελέγχου ταυτότητας είναι ανώνυμος. Όταν χρησιμοποιείτε τον τύπο ελέγχου ταυτότητας ως ανώνυμο, πρέπει να λάβετε τη διεύθυνση URL της αναφοράς Power BI όπως περιγράφεται στην ενότητα: Δημοσίευση στο Web από το Power BI

  • AAD: σας δίνει τη δυνατότητα να ασφαλίσετε αναφορές Power BI ή πίνακες εργαλείων σε χρήστες του Power BI Azure Active Directory με έλεγχο ταυτότητας.

  • powerbiembedded: σάς επιτρέπει να χρησιμοποιείτε από κοινού τις ασφαλείς αναφορές του Power BI ή πίνακες εργαλείων σε εξωτερικούς χρήστες που δεν έχουν άδεια χρήσης του Power BI ή ρύθμιση ελέγχου ταυτότητας Azure Active Directory. Για πληροφορίες σχετικά την εγκατάσταση υπηρεσιών Power BI Embedded, δείτε Ενεργοποίηση υπηρεσίας Power BI Embedded.

Κατά την προσθήκη ασφαλούς αναφοράς Power BI ή πίνακα εργαλείων, βεβαιωθείτε ότι γίνεται κοινή χρήση με υπηρεσίες Azure Active Directory ή Power BI Embedded πύλης.

Σημείωση

Οι τιμές για την παράμετρο authentication_type δεν κάνει διάκριση πεζών-κεφαλαίων.

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

Μπορείτε επίσης να φιλτράρετε την αναφορά με βάση μία ή περισσότερες τιμές. Η σύνταξη για το φιλτράρισμα αναφοράς είναι:

URL?filter=Table/Field eq 'value'

Για παράδειγμα, ας υποθέσουμε ότι θέλετε να φιλτράρετε την αναφορά για να δείτε τα δεδομένα για μια επαφή με το όνομα Bert Hair. Πρέπει να προσαρτήσετε τη διεύθυνση URL με τα εξής:

?filter=Executives/Executive eq 'Bert Hair'

Ο πλήρης κωδικός θα είναι:

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq 'Bert Hair'" %}

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

Σημείωση

Η ανώνυμη αναφορά δεν υποστηρίζει το φιλτράρισμα.

Μπορείτε επίσης να δημιουργήσετε μια δυναμική διαδρομή χρησιμοποιώντας τη μεταβλητή capture Liquid ως εξής:

{% capture pbi_path %}https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq '{{user.id}}'{% endcapture %}
{% powerbi authentication_type:"AAD" path:pbi_path %}

Περισσότερες πληροφορίες σχετικά με τη μεταβλητή Liquid: Ετικέτες μεταβλητών

tileid

Εμφανίζει το καθορισμένο πλακίδιο του πίνακα εργαλείων. Πρέπει να δώσετε το αναγνωριστικό του πλακιδίου.

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/dashboards/00000000-0000-0000-0000-000000000001" tileid:"00000000-0000-0000-0000-000000000002" %}

ρόλοι

Ρόλοι που έχουν ανατεθεί σε αναφορά Power BI. Αυτή η παράμετρος λειτουργεί μόνο όταν η παράμετρος authentication_type έχει οριστεί σε powerbiembedded.

Εάν έχετε ορίσει ρόλους στο Power BI και τους έχετε αναθέσει σε αναφορές, πρέπει να καθορίσετε τους κατάλληλους ρόλους στην ετικέτα Liquid powerbi. Οι ρόλοι σάς επιτρέπουν να φιλτράρετε τα δεδομένα που θα εμφανίζονται σε μια αναφορά. Μπορείτε να καθορίσετε πολλαπλούς ρόλους που διαχωρίζονται με κόμμα. Για περισσότερες πληροφορίες σχετικά με τον καθορισμό Power BIρόλων δείτε Ασφάλεια σε επίπεδο γραμμής (RLS) με Power BI.

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:"Region_East,Region_West" %}

Εάν έχετε αναθέσει ένα ρόλο σε μια Power BI αναφορά και δεν έχετε καθορίσει την παράμετρο ρόλοι στην ετικέτα Liquid ή δεν έχετε καθορίσει κάποιο ρόλο στην παράμετρο, εμφανίζεται ένα σφάλμα.

Συμβουλή

Εάν θέλετε να χρησιμοποιήσετε τους ρόλους Web που ορίζονται στην πύλη σας ως ρόλοι Power BI, μπορείτε να ορίσετε μια μεταβλητή και να αναθέσετε ρόλους Web σε αυτήν. Στη συνέχεια, μπορείτε να χρησιμοποιήσετε την καθορισμένη μεταβλητή στην ετικέτα Liquid.

Ας υποθέσουμε ότι έχετε ορίσει δύο ρόλους Web ως Region_East και Region_West στην πύλη σας. Μπορείτε να συμμετάσχετε σε αυτά χρησιμοποιώντας τον κωδικό: {% assign webroles = user.roles | join: ", " %}

Στο παραπάνω απόσπασμα κώδικα, το webroles είναι μια μεταβλητή και οι ρόλοι Web Region_East και Region_West θα αποθηκευτούν σε αυτήν.

Χρησιμοποιήστε τη μεταβλητή webroles στην ετικέτα Liquid:

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}

επεξεργάσιμο

Αποδίδει ένα δεδομένο αντικείμενο CMS πυλών Power Apps ως επεξεργάσιμο στην πύλη για τους χρήστες με δικαίωμα επεξεργασίας περιεχομένου για αυτό το αντικείμενο. Τα αντικείμενα με δυνατότητα επεξεργασίας περιλαμβάνουν σελίδα, τμήματα, και weblinks.

{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}

{% editable snippets Header type: 'html' %}

<!--

An editable web link set required a specific DOM structure, with

certain classes on the containing element, as demonstrated here.

-->

{% assign primary_nav = weblinks[Primary Navigation] %}

{% if primary_nav %}

<div {% if primary_nav.editable %}class=xrm-entity xrm-editable-adx_weblinkset{% endif %}>

<ul>

<!-- Render weblinks... -->

</ul>

{% editable primary_nav %}

</div>

{% endif %}

Παράμετροι

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

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

κλάση

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

προεπιλογή

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

escape

Μια δυαδική τιμή που δηλώνει το αν η τιμή που αποδίδεται από αυτήν την ετικέτα θα έχει κωδικοποίηση HTML. Είναι false κατά προεπιλογή.

liquid

Μια δυαδική τιμή που υποδεικνύει το αν θα γίνει επεξεργασία ενός κωδικού προτύπου Liquid που βρέθηκε σε μια τιμή κειμένου που αποδίδεται από αυτήν την ετικέτα. Είναι true κατά προεπιλογή.

ετικέτα

Το όνομα των ετικετών του κοντέινερ HTML που εμφανίζονται από αυτήν την ετικέτα. Αυτή η ετικέτα θα αποδώσει div στοιχεία από προεπιλογή. Εν γένει, συνιστάται να επιλέξετε μεταξύ div ή span ως τιμή για αυτήν την παράμετρο.

τίτλος

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

τύπος

Μια τιμή συμβολοσειράς που δηλώνει τον τύπο διασύνδεσης επεξεργασίας που θα παρουσιαστεί για τιμές κειμένου με δυνατότητα επεξεργασίας. Οι έγκυρες τιμές για αυτήν την παράμετρο είναι html ή text. html είναι η προεπιλογή.

entitylist

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

Εάν η λίστα φορτώθηκε με επιτυχία, θα αποδοθεί το περιεχόμενο μέσα από το μπλοκ. Εάν η λίστα δεν βρέθηκε, δεν θα αποδοθεί το περιεχόμενο του μπλοκ.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Από προεπιλογή, το αντικείμενο entitylist θα έχει το όνομα της μεταβλητής entitylist. Προαιρετικά, μπορεί να δοθεί ένα διαφορετικό όνομα μεταβλητής.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Παράμετροι

Δώστε μόνο ένα από τα αναγνωριστικό, όνομα ή κλειδί για να επιλέξετε τη λίστα που θα φορτώσετε.

αναγνωριστικό

Φορτώνει μια λίστα κατά αναγνωριστικό GUID. Το id (αναγνωριστικό) πρέπει να είναι μια συμβολοσειρά που μπορεί να αναλυθεί ως GUID.

{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

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

{% entitylist id:page.adx_entitylist.id %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

όνομα

Φορτώνει μια λίστα κατά όνομα.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

κλειδί

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

<!-- key_variable can hold an ID or name -->

{% entitylist key:key_variable %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

language_code

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

{% entitylist name:"My List", language_code:1033 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

entityview

Φορτώνει μια δεδομένη προβολή Power Apps με βάση το όνομα ή το αναγνωριστικό. Οι ιδιότητες της προβολής ߝ, τα μετα-δεδομένα στήλης προβολής, οι καρτέλες σελιδοποιημένων αποτελεσμάτων, κ.λπ., μπορούν κατόπιν να προσπελαστούν χρησιμοποιώντας ένα στοιχείο entityview που θα είναι διαθέσιμο μέσα από το μπλοκ ετικετών.

Εάν η προβολή φορτώθηκε με επιτυχία, θα αποδοθεί το περιεχόμενο μέσα από το μπλοκ. Εάν η προβολή δεν βρέθηκε, δεν θα αποδοθεί το περιεχόμενο του μπλοκ.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Από προεπιλογή, το αντικείμενο entityview θα έχε το όνομα της μεταβλητής entityview. Προαιρετικά, μπορεί να δοθεί ένα διαφορετικό όνομα μεταβλητής.

{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ my_view.total_records }} total records.

{% endentityview %}

Εάν το entityview είναι ένθετο εντός ενός μπλοκ entitylist, θα μεταβιβάσει τις προεπιλεγμένες του ρυθμίσεις (μέγεθος σελίδας αποτελεσμάτων, επιλογές φίλτρου, κ.λπ.) από τη λίστα. Εάν δεν υπάρχουν παράμετροι προβολής αναγνωριστικό ή όνομα στο entityview, θα φορτώνεται η προεπιλεγμένη προβολή από το entityview.

{% entitylist id:page.adx_entitylist.id %}

{% entityview %}

Loaded default view of the list associated with the current page, with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

Παράμετροι

Δώστε είτε id ή logical_name με όνομα για να επιλέξετε την προβολή Power Apps προς φόρτωση. Εάν δεν παρέχεται τίποτα και η ετικέτα entityview είναι ένθετη μέσα σε μια ετικέτα entitylist, θα φορτωθεί η προεπιλεγμένη προβολή της entitylist.

αναγνωριστικό

Το id (αναγνωριστικό) πρέπει να είναι μια συμβολοσειρά που μπορεί να αναλυθεί ως GUID.

{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded entity view {{ entityview.name }}.

{% endentityview %}

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

{% entityview id:request.params.view %}

Loaded entity view {{ entityview.name }} using view query string request parameter.

{% endentityview %}

logical_name

Το λογικό όνομα της οντότητας Power Apps της προβολής που θα φορτωθεί. Πρέπει να χρησιμοποιείται σε συνδυασμό με το όνομα.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

όνομα

Το όνομα Power Apps της προβολής που θα φορτωθεί. Πρέπει να χρησιμοποιείται σε συνδυασμό με το logical_name.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

φίλτρο

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

{% entityview id:request.params.view, filter:'user' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Μια συνηθισμένη περίπτωση χρήσης είναι να ρυθμίσετε αυτήν την παράμετρο με βάση ένα αίτημα.

{% entityview id:request.params.view, filter:request.params.filter %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

metafilter

Καθορίζει την παράσταση φίλτρου μετα-δεδομένων λίστας με βάση την οποία θέλετε να φιλτράρετε τα αποτελέσματα προβολής. Αυτή η παράμετρος είναι έγκυρη μόνο όταν το entityview χρησιμοποιείται σε συνδυασμό με το entitylist. Στις περισσότερες περιπτώσεις, αυτή η παράμετρος έχει οριστεί με βάση ένα αίτημα.

{% entitylist id:page.adx_entitylist.id %}

{% entityview id:request.params.view, metafilter:request.params.mf %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

παραγγελία

Καθορίζει μια έκφραση ταξινόμησης για ταξινόμηση των αποτελεσμάτων προβολής. Μια έκφραση ταξινόμησης μπορεί να περιέχει ένα ή περισσότερα λογικά ονόματα χαρακτηριστικών οντότητας ακολουθούμενα από μια κατεύθυνση ταξινόμησης ASC ή DESC.

{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Μια συνηθισμένη περίπτωση χρήσης είναι να ρυθμίσετε αυτήν την παράμετρο με βάση ένα αίτημα.

{% entityview id:request.params.view, order:request.params.order %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

σελίδα

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

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

{% entityview id:request.params.view, page:2 %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Μια συνηθισμένη περίπτωση χρήσης είναι να ρυθμίσετε αυτήν την παράμετρο με βάση ένα αίτημα.

{% entityview id:request.params.view, page:request.params.page %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

page_size

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

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

{% entityview id:request.params.view, page_size:20 %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Μια συνηθισμένη περίπτωση χρήσης είναι να ρυθμίσετε αυτήν την παράμετρο με βάση ένα αίτημα.

{% entityview id:request.params.view, page_size:request.params.pagesize %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

αναζήτηση

Καθορίζει μια έκφραση αναζήτησης με βάση την οποία θέλετε να φιλτράρετε τα αποτελέσματα προβολής. Οι απλές εκφράσεις αναζήτησης λέξεων-κλειδιών θα φιλτραριστούν με βάση το αν τα χαρακτηριστικά αρχίζουν με τη λέξη-κλειδί. Οι χαρακτήρες μπαλαντέρ * μπορούν επίσης να συμπεριλαμβάνονται στην έκφραση.

{% entityview id:request.params.view, search:'John\*' %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

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

{% entityview id:request.params.view, search:request.params.search %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

language_code

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

Εάν χρησιμοποιείται ένα entityview εντός ενός μπλοκ entitylist, το entityview θα λάβει τη διαμόρφωση κωδικού γλώσσας από το entitylist.

{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

searchindex

Εκτελεί ένα ερώτημα σε σχέση με το ευρετήριο αναζήτησης πύλης. Τα αντίστοιχα αποτελέσματα μπορούν κατόπιν να προσπελαστούν χρησιμοποιώντας ένα searchindex που θα είναι διαθέσιμο μέσα από το μπλοκ ετικετών.

{% searchindex query: 'support', page: params.page, page_size: 10 %}

{% if searchindex.results.size > 0 %}

<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>

<ul>

{% for result in searchindex.results %}

<li>

<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>

<p>{{ result.fragment }}</p>

</li>

{% endfor %}

</ul>

{% else %}

<p>Your query returned no results.</p>

{% endif %}

{% endsearchindex %}

<style>

    .highlight {background-color: #FFFCAC;}

</style>

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

{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}

{% if liquid_search.results.size > 0 %}

...

{% endif %}

{% endsearchindex %}

Παράμετροι

Η ετικέτα searchindex δέχεται τις ακόλουθες παραμέτρους.

ερώτημα

Το ερώτημα που χρησιμοποιήθηκε για την αντιστοίχιση των αποτελεσμάτων. Αυτή η παράμετρος έχει σκοπό να αποδεχτεί το τμήμα καθορίζεται από το χρήστη του ερωτήματος ευρετηρίου (εάν υπάρχει).

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Μια συνηθισμένη περίπτωση χρήσης είναι να ρυθμίσετε αυτήν την παράμετρο με βάση ένα αίτημα.

{% searchindex query: request.params.query %}

...

{% endsearchindex %}

Αυτή η παράμετρος υποστηρίζει τη σύνταξη ανάλυσης ερωτήματος Lucene.

φίλτρο

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

{% searchindex query: request.params.query, filter: '+statecode:0' %}

...

{% endsearchindex %}

Αυτή η παράμετρος υποστηρίζει τη σύνταξη ανάλυσης ερωτήματος Lucene.

Σημείωση

Η διαφορά μεταξύ του φίλτρου και του ερωτήματος είναι ότι, ενώ και τα δύο θα αποδέχονται τη σύνταξη ανάλυσης ερωτήματος Lucene, το ερώτημα προορίζεται να είναι πιο ανεκτικό σχετικά με το πώς αυτή η σύνταξη αναλύθηκε ߝ καθώς αναμένεται ότι οι περισσότεροι τελικοί χρήστες δεν θα γνωρίζουν αυτήν τη σύνταξη. Έτσι, στην περίπτωση που η ανάλυση του ερωτήματος σύμφωνα με αυτή τη σύνταξη αποτύχει, ολόκληρο το ερώτημα θα διαφύγει και θα υποβληθεί ως κείμενο ερωτήματος. Το φίλτρο από την άλλη πλευρά, θα αναλυθεί αυστηρά και θα επιστρέψει ένα σφάλμα εάν η σύνταξη δεν είναι έγκυρη.

logical_names

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

{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}

...
>
{% endsearchindex %}

σελίδα

Η σελίδα αποτελεσμάτων αναζήτησης που θα επιστραφεί. Εάν δεν παρέχεται, θα επιστραφεί η πρώτη σελίδα (1).

{% searchindex query: request.params.query, page: 2 %}

...

{% endsearchindex %}

Μια συνηθισμένη περίπτωση χρήσης είναι να ρυθμίσετε αυτήν την παράμετρο με βάση ένα αίτημα.

{% searchindex query: request.params.query, page: request.params.page %}

...

{% endsearchindex %}

page_size

Το μέγεθος της σελίδας αποτελεσμάτων που θα επιστραφεί. Εάν δεν παρέχεται, θα χρησιμοποιηθεί το προεπιλεγμένο μέγεθος των 10.

{% searchindex query: request.params.query, page_size: 20 %}

...

{% endsearchindex %}

entityform

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

Σημείωση

Η ετικέτα entityform είναι μόνο διαθέσιμη για χρήση στο περιεχόμενο που αποδίδεται μέσα σε ένα πρότυπο webμε βάση το πρότυπο σελίδας. Η προσπάθεια να χρησιμοποιήσετε την ετικέτα μέσα σε ένα πρότυπο σελίδας με βάση την επανεγγραφή δεν θα αποδώσει τίποτα. Μπορεί μόνο να αποδώσει μια μεμονωμένη ετικέτα entityform ή webform ανά σελίδα. Οι ετικέτες entityform ή webform μετά την πρώτη δεν θα αποδοθούν.

{% entityform name: 'My Basic Form' %}

Παράμετροι

όνομα

Το όνομα της βασικής φόρμας που θέλετε να φορτωθεί.

{% entityform name:My Basic Form %}

webform

Αποδίδει πλήρως μια ρυθμισμένη με Power Apps σύνθετη φόρμα, κατά όνομα ή αναγνωριστικό. Η ετικέτα webform είναι μόνο διαθέσιμη για χρήση στο περιεχόμενο που αποδίδεται μέσα σε ένα πρότυπο web με βάση το πρότυπο σελίδας. Η προσπάθεια να χρησιμοποιήσετε την ετικέτα μέσα σε ένα πρότυπο σελίδας με βάση την επανεγγραφή δεν θα αποδώσει τίποτα. Μπορεί μόνο να αποδώσει μια μεμονωμένη ετικέτα entityform ή webform ανά σελίδα. Οι ετικέτες entityform ή webform μετά την πρώτη δεν θα αποδοθούν.

{% webform name: 'My Advanced Form' %}

Παράμετροι

όνομα

Το όνομα της σύνθετης φόρμας που θέλετε να φορτωθεί.

{% webform name:My Advanced Form %}

codecomponent

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

Σημαντικό

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

Παράμετροι

όνομα

Το αναγνωριστικό ή το όνομα του στοιχείου κώδικα.

ιδιότητα

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

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

Σημείωση

Οι απαιτούμενες ιδιότητες ενδέχεται να διαφέρουν ανάλογα με το στοιχείο που επιλέγετε.

Ανατρέξτε στο Χρήση ετικέτας προτύπου Liquid στοιχείων κώδικα.

Δείτε επίσης

Ετικέτες ροής ελέγχου
Ετικέτες επανάληψης
Ετικέτες μεταβλητής
Ετικέτες προτύπου

Σημείωση

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

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