Ετικέτες Liquid Dataverse
Οι ετικέτες Liquid Microsoft Dataverse χρησιμοποιούνται για τη φόρτωση και την εμφάνιση δεδομένων Dataverse ή για τη χρήση άλλων υπηρεσιών πλαισίου Power Pages. Οι ετικέτες αυτές είναι επεκτάσεις ειδικά για το Dataverse στη γλώσσα Liquid.
γράφημα
Προσθέτει ένα γράφημα εφαρμογής βάσει μοντέλου του Power Apps σε ιστοσελίδα. Μπορείτε να προσθέσετε την ετικέτα του γραφήματος στο πεδίο Αντιγραφή σε μια ιστοσελίδα ή στο πεδίο Προέλευση σε ένα πρότυπο Web. Για τα βήματα που πρέπει να ακολουθήσετε για να προσθέσετε ένα γράφημα εφαρμογής βάσει μοντέλου Power Apps σε μια ιστοσελίδα, ανατρέξτε στο άρθρο Προσθήκη γραφήματος σε μια ιστοσελίδα στο Power Pages.
{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}
Παράμετροι
Υπάρχουν δύο παραμέτρους που παρέχονται με την ετικέτα γραφήματος: αναγνωριστικό γραφήματος και viewid.
αναγνωριστικό γραφήματος
Αναγνωριστικό απεικόνισης γραφήματος. Μπορείτε να αποκτήσετε το αναγνωριστικό αν εξαγάγετε το γράφημα.
viewid
Αναγνωριστικό του πίνακα όταν ανοίγει στην προβολή επεξεργασίας.
powerbi
Προσθέτει πίνακες εργαλείων Power BI και αναφορές σε σελίδες. Μπορείτε να προσθέσετε την ετικέτα του γραφήματος στο πεδίο Αντιγραφή σε μια ιστοσελίδα ή στο πεδίο Προέλευση σε ένα πρότυπο Web. Για τα βήματα για να προσθέσετε μια αναφορά Power BI ή έναν πίνακα εργαλείων σε μια ιστοσελίδα στο Power Pages, ανατρέξτε στην ενότητα Προσθήκη αναφοράς Power BI ή πίνακα εργαλείων σε μια ιστοσελίδα στο Power Pages.
Σημείωμα
Για να λειτουργήσει η ετικέτα, πρέπει να ενεργοποιήσετε την ενοποίηση Power BI από το Κέντρο Power Pages στο κέντρο διαχείρισης Power Platform. Εάν δεν είναι ενεργοποιημένη η ενοποίηση 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 Microsoft Entra ID με έλεγχο ταυτότητας.
powerbiembedded: σάς επιτρέπει να χρησιμοποιείτε από κοινού τις ασφαλείς αναφορές του Power BI ή πίνακες εργαλείων σε εξωτερικούς χρήστες που δεν έχουν άδεια χρήσης του Power BI ή ρύθμιση ελέγχου ταυτότητας Microsoft Entra. Για πληροφορίες σχετικά την εγκατάσταση υπηρεσιών Power BI Embedded, δείτε Ενεργοποίηση υπηρεσίας Power BI Embedded.
Κατά την προσθήκη ασφαλούς αναφοράς Power BI ή πίνακα εργαλείων, βεβαιωθείτε ότι γίνεται κοινή χρήση με υπηρεσίες Power Pages Microsoft Entra ή 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 και τους έχετε αναθέσει σε αναφορές, πρέπει να καθορίσετε τους κατάλληλους ρόλους στην ετικέτα Liquidpowerbi. Οι ρόλοι σάς επιτρέπουν να φιλτράρετε τα δεδομένα που θα εμφανίζονται σε μια αναφορά. Μπορείτε να καθορίσετε πολλαπλούς ρόλους που διαχωρίζονται με κόμμα. Για περισσότερες πληροφορίες σχετικά με τον καθορισμό 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 Pages ως επεξεργάσιμο στην τοποθεσία για τους χρήστες με δικαίωμα επεξεργασίας περιεχομένου για αυτό το αντικείμενο. Τα αντικείμενα με δυνατότητα επεξεργασίας περιλαμβάνουν σελίδα, τμήματα, και 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 %}
Παράμετροι
Η πρώτη παράμετρος που παρέχεται για επεξεργασία είναι το επεξεργάσιμο αντικείμενο, όπως ένα σύνολο συνδέσμων web, τμήματα περιεχομένου ή η τρέχουσα σελίδα. Η προαιρετική δεύτερη παράμετρος είναι να καθορίσετε ένα όνομα για το χαρακτηριστικό ή ένα κλειδί μέσα σε αυτό το αντικείμενο προς απόδοση και επεξεργασία. Αυτή η τιμή μπορεί να είναι το όνομα ενός χαρακτηριστικού ενός πίνακα ή ένα όνομα τμήματος, για παράδειγμα.
Μετά από αυτές τις αρχικές παραμέτρους, η ετικέτα υποστηρίζει έναν αριθμό προαιρετικών παραμέτρων με όνομα.
κλάση
Καθορίζει μια τιμή χαρακτηριστικού κλάσης για το στοιχείο ρίζας που αποδίδεται από αυτήν την ετικέτα.
προεπιλογή
Μια προεπιλεγμένη τιμή που αποδίδεται σε περίπτωση που το στοιχείο με δυνατότητα επεξεργασίας δεν έχει τιμή.
escape
Μια δυαδική τιμή που δηλώνει το αν η τιμή που αποδίδεται από αυτήν την ετικέτα έχει κωδικοποίηση HTML. Αυτή η τιμή είναι ψευδής από προεπιλογή.
liquid
Μια δυαδική τιμή που υποδεικνύει το αν θα πρέπει να γίνει επεξεργασία ενός κωδικού προτύπου Liquid που βρέθηκε σε μια τιμή κειμένου που αποδίδεται από αυτήν την ετικέτα. Αυτή η τιμή είναι αληθής από προεπιλογή.
ετικέτα
Το όνομα των ετικετών του κοντέινερ 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. Το αναγνωγριστικό πρέπει να είναι συμβολοσειρά που μπορεί να αναλυθεί ως 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
Πρέπει να φορτωθεί ένας κωδικός γλώσσας ακέραιων Dataverse για να επιλέξετε τη λίστα μεταφρασμένων ετικετών για φόρτωση. Εάν δεν παρέχεται language_code, χρησιμοποιείται η προεπιλεγμένη γλώσσα της σύνδεσης Dataverse εφαρμογής τοποθεσίας.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Φορτώνει μια δεδομένη προβολή Dataverse με βάση το όνομα ή το αναγνωριστικό. Οι ιδιότητες της προβολής ߝ, τα μετα-δεδομένα στήλης προβολής, οι καρτέλες σελιδοποιημένων αποτελεσμάτων, κ.λπ., μπορούν κατόπιν να προσπελαστούν χρησιμοποιώντας ένα στοιχείο 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 ή λογικό όνομα με όνομα για να επιλέξετε την προβολή Dataverse προς φόρτωση. Εάν δεν παρέχεται τίποτα και η ετικέτα 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
Το λογικό όνομα της οντότητας Dataverse της προβολής που θα φορτωθεί. Πρέπει να χρησιμοποιείται σε συνδυασμό με το όνομα.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
όνομα
Το όνομα Dataverse της προβολής που θα φορτωθεί. Πρέπει να χρησιμοποιείται σε συνδυασμό με το λογικό όνομα.
{% 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
Ένας κωδικός γλώσσας ακέραιου Dataverse για να επιλέξετε τις μεταφρασμένες ετικέτες της προβολής οντότητας (ετικέτες κεφαλίδας στήλης, κ.λπ.) που θα φορτωθούν. Εάν δεν παρέχεται language_code, χρησιμοποιείται η προεπιλεγμένη γλώσσα της σύνδεσης Dataverse εφαρμογής τοποθεσίας web.
Εάν χρησιμοποιείται ένα entityview εντός ενός μπλοκ entitylist, το entityview λαμβάνει τη διαμόρφωση κωδικού γλώσσας από το entitylist.
{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}
Loaded entity view {{ entityview.name }}.
{% endentitylist %}
searchindex
Εκτελεί ένα ερώτημα σε σχέση με το ευρετήριο αναζήτησης τοποθεσίας web. Τα αντίστοιχα αποτελέσματα μπορούν κατόπιν να προσπελαστούν χρησιμοποιώντας ένα 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
Τα λογικά ονόματα της οντότητας Dataverse στα οποία θα περιορίζονται τα αντίστοιχα αποτελέσματα, όπως μια συμβολοσειρά οριοθετημένη με κόμμα. Εάν δεν παρέχεται, επιστρέφονται όλες οι οντότητες που ταιριάζουν.
{% 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
Αποδίδει πλήρως μια φόρμα, κατά όνομα ή αναγνωριστικό.
Σημείωμα
Η ετικέτα entityform είναι μόνο διαθέσιμη για χρήση στο περιεχόμενο που αποδίδεται μέσα σε ένα πρότυπο web–με βάση το πρότυπο σελίδας. Η προσπάθεια να χρησιμοποιήσετε την ετικέτα μέσα σε ένα πρότυπο σελίδας με βάση την επανεγγραφή δεν θα αποδώσει τίποτα. Μπορεί μόνο να αποδώσει μια μεμονωμένη ετικέτα entityform ή webform ανά σελίδα. Οι ετικέτες entityform ή webform μετά την πρώτη δεν θα αποδοθούν.
{% entityform name: 'My Basic Form' %}
Παράμετροι
όνομα
Το όνομα της βασικής φόρμας που θέλετε να φορτωθεί.
{% entityform name:My Basic Form %}
webform
Αποδίδει πλήρως μια φόρμα πολλών βημάτων, κατά όνομα ή αναγνωριστικό. Η ετικέτα webform είναι μόνο διαθέσιμη για χρήση στο περιεχόμενο που αποδίδεται μέσα σε ένα πρότυπο web με βάση το πρότυπο σελίδας. Η προσπάθεια να χρησιμοποιήσετε την ετικέτα μέσα σε ένα πρότυπο σελίδας με βάση την επανεγγραφή δεν θα αποδώσει τίποτα. Μπορείτε μόνο να αποδώσετε μια μεμονωμένη ετικέτα entityform ή webform ανά σελίδα. Οι ετικέτες entityform ή webform μετά την πρώτη δεν θα αποδοθούν.
{% webform name: 'My Multistep Form' %}
Παράμετροι
όνομα
Το όνομα της φόρμας πολλών βημάτων που θέλετε να φορτωθεί.
{% webform name:My Multistep Form %}
codecomponent
Σας επιτρέπει να ενσωματώσετε στοιχεία κώδικα χρησιμοποιώντας μια ετικέτα Liquid. Για παράδειγμα, η προσθήκη ενός προσαρμοσμένου στοιχείου ελέγχου εμφάνισης αντιστοίχισης σε μια ιστοσελίδα.
Παράμετροι
όνομα
Το αναγνωριστικό ή το όνομα του στοιχείου κώδικα.
ιδιότητα
Οι τιμές των ιδιοτήτων που αναμένει το στοιχείο κώδικα πρέπει να μεταβιβαστούν ως κλειδί/ζεύγος τιμής, διαχωρισμένο με το σύμβολο “:” (σύμβολο άνω και κάτω τελείας), όπου κλειδί είναι το όνομα της ιδιότητας και η τιμή είναι η τιμή της συμβολοσειράς JSON.
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
Σημείωμα
Οι απαιτούμενες ιδιότητες ενδέχεται να διαφέρουν ανάλογα με το στοιχείο που επιλέγετε.
Ανατρέξτε στο Χρήση ετικέτας προτύπου Liquid στοιχείων κώδικα.