Etiquetes de Liquid de Dataverse

Les etiquetes de Liquid del Microsoft Dataverse s'utilitzen per carregar i mostrar les dades del Dataverse o utilitzar altres serveis de marc de portals del Power Pages. Aquestes etiquetes són extensions específiques de Dataverse de la llengua de Liquid.

gràfic

Afegeix un gràfic d'aplicació basat en models del Power Apps a una pàgina web. L'etiqueta del gràfic es pot afegir al camp Copia en una pàgina web o al camp Origen en una plantilla web. Per veure els passos que s'han de dur a terme per afegir un gràfic d'aplicació basat en models del Power Apps a una pàgina web, vegeu Afegir un gràfic a una pàgina web del Power Pages.

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

Paràmetres

Hi ha dos paràmetres que s'han de proporcionar amb l'etiqueta del gràfic: chart id i viewid.

Identificador del gràfic

Visualització ID del gràfic. Podeu obtenir l'identificador exportant el gràfic.

Veure

Identificador de la taula quan s'obre en l'editor de visualitzacions.

powerbi

Afegeix els escriptoris digitals i informes del Power BI a les pàgines. L'etiqueta es pot afegir al camp Copia a una pàgina web o al camp Font en una plantilla web. Per veure els passos per afegir un informe o un escriptori digital del Power BI a una pàgina web al Power Pages, vegeu Afegir un informe o un escriptori digital del Power BI a una pàgina web del Power Pages.

Paràmetres

L'etiqueta powerbi accepta els següents paràmetres:

camí

Camí de l'escriptori digital o informe del Power BI. Si l'informe o escriptori digital del Power BI és segur, heu d'introduir el tipus d'autenticació.

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

authentication_type

El tipus d'autenticació és necessari per a l'informe o escriptori digital del Power BI. Els valors vàlids d'aquest paràmetre són:

• Anònim: permet incrustar informes Publica al web Power BI . El tipus d'autenticació per defecte és Anònim. Quan s'utilitza el tipus d'autenticació com a anònim, heu d'obtenir l'URL de l'informe del Power BI tal com es descriu a: Publicació al web des del Power BI

• AAD: us permet compartir informes o escriptoris digitals segurs Power BI amb Power BI Microsoft Entra usuaris autenticats amb ID.

• powerbiembedded: permet compartir els informes o taulers segurs Power BI amb usuaris externs que no tenen Power BI configuració de llicència o Microsoft Entra autenticació. Per obtenir informació sobre la configuració de servei del Power BI Embedded, vegeu Habilita el servei del Power BI Embedded.

Quan afegiu un informe o un escriptori digital segurs Power BI , assegureu-vos que es comparteixi amb els Power Pages Microsoft Entra serveis o Power BI Embedded .

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

També podeu filtrar l'informe en un o diversos valors. La sintaxi per filtrar un informe és:

URL?filter=Table/Field eq 'value'

Per exemple, voleu filtrar l'informe per veure les dades d'un contacte anomenat Bert Hair. Heu d'annexar l'adreça URL amb les dades següents:

?filter=Executives/Executive eq 'Bert Hair'

El codi complet és:

{% 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'" %}

Més informació sobre el filtrat d'un informe: filtreu un informe mitjançant paràmetres de cadena de consulta a l'adreça URL.

També podeu crear un camí dinàmic mitjançant la capture variable 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 %}

Més informació sobre la variable de Liquid: Etiquetes variables

tileid

Mostra la peça especificada de l'escriptori digital. Heu d'introduir l'identificador de la peça.

{% 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" %}

Rols

Funcions assignades a l'informe del Power BI. Aquest paràmetre només funciona quan el paràmetre authentication_type està definit com a powerbiembedded.

Si heu definit funcions i Power BI les heu assignat als informes, heu d'especificar les funcions adequades a l'etiqueta powerbi Liquid. Les funcions us permeten filtrar les dades per tal que es visualitzin en un informe. Podeu especificar diverses funcions separades per una coma. Per obtenir més informació sobre la definició de les funcions al Power BI, vegeu Seguretat a nivell de fila (RLS) amb el 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" %}

Si heu assignat una funció a un Power BI informe i no heu especificat el paràmetre funcions a l'etiqueta Liquid o no heu especificat cap funció al paràmetre, es mostrarà un error.

es pot editar

Representa un determinat objecte de CMS del Power Pages com a editable al lloc, per a usuaris amb permís d'edició de contingut d'aquest objecte. Els objectes que es poden editar inclouen pàgina, fragments i enllaços web.

{% 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 %}

Paràmetres

El primer paràmetre proporcionat a editable és l'objecte editable, com ara un conjunt d'enllaços web, fragments o la pàgina actual. El segon paràmetre opcional és especificar un nom o clau d'atribut de l'objecte que s'ha de representar o editar. Aquest valor pot ser el nom d'un atribut de taula o el nom d'un fragment, per exemple.

Després d'aquests paràmetres inicials, l'etiqueta admet molts paràmetres de nom opcionals.

classe

Especifica un valor d'atribut de classe de l'element arrel representat mitjançant aquesta etiqueta.

Omissió

Un valor per defecte representat en el cas que l'element editable no tingui cap valor.

escapar

Un valor booleà que indica si un valor representat per aquesta etiqueta està codificat en HTML. Per defecte, aquest valor és False.

líquid

Un valor booleà que indica si s'ha de processar qualsevol codi de plantilla de Liquid que es troba dins del valor de text representat per aquesta etiqueta. Per defecte, aquest valor és True.

etiqueta

El nom de les etiquetes HTML del contenidor representades per aquesta etiqueta. Aquesta etiqueta renderitza els elements div per defecte. Es recomana triar entre div o span com a valor per a aquest paràmetre.

El nom de les etiquetes HTML del contenidor representades per aquesta etiqueta. Aquesta etiqueta representa els elements per defecte div . Es recomana triar entre div o span per a aquest paràmetre.

títol

Especifica una etiqueta per a aquest element que es pot editar a la interfície d'edició de contingut. Si no n'hi ha cap, es genera automàticament una etiqueta descriptiva.

tipus

Un valor de cadena que indica el tipus d'interfície d'edició que es presentarà per a valors de text que es poden editar. Els valors vàlids d'aquest paràmetre són html o text. html és el valor per defecte.

entitylist

Carrega una llista determinada, pel nom o identificador. A continuació, es pot accedir a les propietats de la llista mitjançant un objecte entitylist disponible dins del bloc d'etiquetes. Per representar els registres de resultat reals de la llista, utilitzeu l'etiqueta entityview del bloc.

Si la llista es carrega correctament, es renderitza el contingut del bloc. Si no es troba la llista, el contingut del bloc no es renderitzarà.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Per defecte, l'objecte entitylist rep el nom de la variable entitylist. Opcionalment, es pot proporcionar un nom de variable diferent.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Paràmetres

Proporcioneu només un identificador, nom o clau per seleccionar la Llista que es carregarà.

id

Carrega una llista per ID de GUID. L'ID ha de ser una cadena que es pugui analitzar com un GUID.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

En general, no s'utilitzen cadenes GUID literals. En lloc d'això, id s'especifica mitjançant una propietat GUID d'una altra variable.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

nom

Carrega una llista per nom.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

clau

Carrega una llista per ID o nom. Si el valor de la clau proporcionat es pot analitzar com a GUID, la llista es carrega per ID. En cas contrari, es carrega pel nom.

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

{% entitylist key:key_variable %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

language_code

Un codi enter de llengua del Dataverse per seleccionar les etiquetes localitzades de la llista que es carregaran. Si no es proporciona cap language_code, s'utilitza la llengua per defecte de la connexió de l'aplicació Dataverse del lloc.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

entityview

Carrega una visualització del Dataverse determinada, pel nom o l'identificador. A continuació, es pot accedir a les propietats de la visualització, les metadades de la columna de visualització, els registres de resultats paginats, etc., mitjançant un objecte entityview que està disponible dins del bloc d'etiquetes.

Si la visualització es carrega correctament, es renderitza el contingut del bloc. Si no es troba la visualització, el contingut del bloc no es renderitzarà.

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

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

{% endentityview %}

Per defecte, l'objecte entityview rep el nom de variable entityview. Opcionalment, es pot proporcionar un nom de variable diferent.

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

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

{% endentityview %}

Si entityview està imbricat dins d'un bloc entitylist, hereta la seva configuració predeterminada (mida de la pàgina de resultats, opcions de filtre, etc.) de la llista. Si no es proporciona cap paràmetre d'identificador o nom de visualització a entityview, carrega la visualització per defecte des de l'entitylist que l'engloba.

{% 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 %}

Paràmetres

Proporcioneu id o logical_name amb el nom per seleccionar la visualització del Dataverse que voleu carregar. Si no es proporciona cap dels dos i l'etiqueta entityview està imbricada dins d'una etiqueta entitylist, es carrega la visualització per defecte de l'entitylist que l'envolta.

id

id ha de ser una cadena que es pugui analitzar com un GUID.

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

Loaded entity view {{ entityview.name }}.

{% endentityview %}

En general, no s'utilitzen cadenes GUID literals. En lloc d'això, id s'especifica mitjançant una propietat GUID d'una altra variable.

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

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

{% endentityview %}

logical_name

El nom lògic de l'entitat Dataverse de la visualització que es carregarà. S'ha d'utilitzar en combinació amb el nom.

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

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

{% endentityview %}

nom

El nom del Dataverse de la visualització que es carregarà. S'ha d'utilitzar en combinació amb el logical_name.

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

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

{% endentityview %}

filtre

Especifica si voleu filtrar els resultats de la visualització per l'usuari o pel compte. Ha de tenir un valor de cadena d'usuari o compte.

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

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

{% endentityview %}

Un cas habitual és definir aquest paràmetre a partir d'una sol·licitud.

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

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

{% endentityview %}

metafiltre

Especifica la expressió de filtre de metadades de la llista per mitjà de la qual es filtraran els resultats de la visualització. Aquest paràmetre només és vàlid quan l'entityview s'utilitza en combinació amb entitylist. En la majoria dels casos, aquest paràmetre es configura en funció d'una sol·licitud.

{% 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 %}

ordre

Especifica una expressió d'ordenació per ordenar els resultats de la visualització. Una expressió d'ordenació pot contenir un o més noms lògics d'atribut d'entitat, seguits d'una direcció d'ordenació de l'ASC o el DESC.

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

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

{% endentityview %}

Un cas habitual és definir aquest paràmetre a partir d'una sol·licitud.

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

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

{% endentityview %}

pàgina

Especifica la pàgina de resultats de la visualització que es carregarà. Si no s'especifica aquest paràmetre, es carregarà la primera pàgina de resultats.

Aquest paràmetre ha de superar un valor enter o una cadena que es pugui analitzar com un enter. Si es proporciona un valor per a aquest paràmetre, però el valor és nul o no es pot analitzar com a enter, es carrega la primera pàgina de resultats.

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

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

{% endentityview %}

Un cas habitual és definir aquest paràmetre a partir d'una sol·licitud.

{% 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

Especifica el número de resultats que es carregaran de la pàgina de resultats actual. Si no es proporciona cap valor per a aquest paràmetre i s'utilitza entityview dins d'un bloc entitylist , s'utilitza la mida de la pàgina de la llista. Si no es troba dins d'un bloc entitylist, s'utilitza un valor per defecte de 10.

Aquest paràmetre ha de superar un valor enter o una cadena que es pugui analitzar com un enter. Si es proporciona un valor per a aquest paràmetre, però el valor és nul o no es pot analitzar com a enter, s'utilitza la mida de pàgina per defecte.

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

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

{% endentityview %}

Un cas habitual és definir aquest paràmetre a partir d'una sol·licitud.

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

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

{% endentityview %}

buscar

Especifica una expressió de cerca a través de la qual es filtraran els resultats de la visualització. Les expressions de cerca de paraules clau simples filtren per si els atributs comencen per la paraula clau. Els comodins * també es poden incloure en l'expressió.

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

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

{% endentityview %}

Un cas comú és definir aquest paràmetre en funció d'una sol·licitud, de manera que el filtre de cerca es pot definir en base a l'entrada d'usuari.

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

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

{% endentityview %}

language_code

Un codi enter de llengua del Dataverse per seleccionar les etiquetes localitzades de la visualització de l'entitat (etiquetes de la capçalera de la columna, etc.) per carregar. Si no es proporciona cap language_code, s'utilitza l'idioma predeterminat de la connexió de l'aplicació Dataverse web.

Si entityview s'utilitza dins d'un bloc entitylist, entityview hereta la configuració del codi de llengua d'entitylist.

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

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

searchindex

Realitza una consulta a l'índex de cerca del lloc web. A continuació, es pot accedir als resultats coincidents mitjançant un searchindex que està disponible dins del bloc d'etiquetes.

{% 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>

Per defecte, l'objecte d'índex de cerca rep el nom de variable searchindex. Opcionalment, es pot proporcionar un nom de variable diferent.

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

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

...

{% endif %}

{% endsearchindex %}

Paràmetres

L'etiqueta searchindex accepta els següents paràmetres.

consulta

La consulta utilitzada per fer coincidir resultats. Aquest paràmetre està dissenyat per acceptar la part especificada per l'usuari de la consulta d'índex (si escau).

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Un cas habitual és definir aquest paràmetre a partir d'una sol·licitud.

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

...

{% endsearchindex %}

Aquest paràmetre és compatible amb la sintaxi Analitzador de consulta Lucene.

filtre

Una altra consulta utilitzada per fer coincidir els resultats. Aquest paràmetre està dissenyat per acceptar un filtre especificat pel desenvolupador per obtenir resultats segons convingui.

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

...

{% endsearchindex %}

Aquest paràmetre és compatible amb la sintaxi Analitzador de consulta Lucene.

logical_names

Els noms lògics de l'entitat Dataverse als quals es restringeixen els resultats coincidents, com una cadena delimitada per comes. Si no es proporciona, es retornen totes les entitats coincidents.

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

...
>
{% endsearchindex %}

pàgina

La pàgina de resultats de cerca que es retornarà. Si no es proporciona, es retorna la primera pàgina (1).

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

...

{% endsearchindex %}

Un cas habitual és definir aquest paràmetre a partir d'una sol·licitud.

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

...

{% endsearchindex %}

page_size

La mida de la pàgina de resultats que es retornarà. Si no es proporciona, s'utilitza una mida predeterminada de 10.

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

...

{% endsearchindex %}

entityform

Representa completament un formulari pel nom o l'ID.

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

Paràmetres

nom

El nom del formulari bàsic que vulgueu carregar.

{% entityform name:My Basic Form %}

webform

Representa completament un formulari de diversos passos pel nom o l'ID. L'etiqueta webform només està disponible per a l'ús en continguts representats en una plantilla de pàgina basada en plantilla web. Intentar utilitzar l'etiqueta dins d'una plantilla de pàgina basada en reescriptura no renderitza res. Només podeu representar un únic formulari d'entitat o etiqueta de formulari web per pàgina. Les etiquetes d'entitat o de formulari web després de la primera no es representen.

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

Paràmetres

nom

El nom del formulari de diversos passos que vulgueu carregar.

{% webform name:My Multistep Form %}

codecomponent

Us permet incrustar els components de codi mitjançant una etiqueta Liquid. Per exemple, afegir un control personalitzat de visualització de mapa a una pàgina web.

Paràmetres

nom

L'ID o el nom del component de codi.

propietat

Els valors de les propietats que espera el component de codi s'han de passar com un parell clau/valor separat per dos punts (:), on key és el nom de la propietat i el valor és el valor de la cadena JSON.

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

Vegeu Utilitzar l'etiqueta de plantilla de Liquid per als components de codi.

Consulteu també

• Controlar les etiquetes de flux
• Etiquetes d'iteració
• Etiquetes variables
• Etiquetes de plantilla