Etiquetes d’entitat del Dataverse
Microsoft Dataverse etiquetes d'entitat s'utilitzen per carregar i mostrar dades Dataverse, o utilitzar altres serveis marc Power Apps portals. Aquestes etiquetes són extensions específiques del Dataverse al llenguatge Liquid.
gràfic
Afegeix un gràfic Power Apps a una pàgina web. L'etiqueta del gràfic es pot afegir al camp Copia a una pàgina web o al camp Font en una plantilla web. Per obtenir passos per afegir un gràfic Power Apps a una pàgina web, vegeu Afegir un gràfic a una pàgina web del portal.
{% 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.
chart id
Visualització ID del gràfic. Podeu aconseguir-ho si exporteu el gràfic.
viewid
Identificador de la taula quan s'obre en l'editor de visualitzacions.
powerbi
Afegeix els escriptoris digitals i els informes 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 obtenir passos per afegir un informe o un escriptori digital Power BI a una pàgina web del portal, vegeu Afegir un informe o un escriptori digital Power BI a una pàgina web del portal.
Nota
Perquè l'etiqueta funcioni, heu d'habilitar Power BI integració des del centre d'administració de portals Power Apps. Si la integració Power BI no està habilitada, no es mostrarà l'escriptori digital o l'informe.
Paràmetres
L'etiqueta powerbi accepta els següents paràmetres:
ruta d'accés
Camí de l'informe o l'escriptori digital Power BI. Si l'informe Power BI o l'escriptori digital són segurs, heu de proporcionar 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
Tipus d'autenticació necessària per a l'informe o l'escriptori digital Power BI. Els valors vàlids d'aquest paràmetre són:
Anònim : permet incrustar la publicació a la web Power BI informes. El tipus d'autenticació per defecte és Anònim. Quan utilitzeu el tipus d'autenticació com a anònim, heu d'obtenir l'ADREÇA URL de l'informe Power BI tal com es descriu a: Publica al web des de Power BI
AAD : us permet compartir informes o escriptoris digitals segurs Power BI per Power BI Azure Active Directory usuaris autenticats.
powerbiembedded : us permet compartir els informes o escriptoris digitals segurs Power BI a usuaris externs que no tenen llicència Power BI o Azure Active Directory configuració d'autenticació. Per obtenir informació sobre Power BI Embedded configuració del servei, vegeu Habilita Power BI Embedded servei.
Mentre afegiu l'informe o l'escriptori digital de Power BI segurs, assegureu-vos que es comparteixi amb els serveis Azure Active Directory o Power BI Embedded del portal.
Nota
Els valors del paràmetre authentication_type no distingeixen les majúscules de les minúscules.
{% 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 el següent:
?filter=Executives/Executive eq 'Bert Hair'
El codi complet serà:
{% 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.
Nota
L'informe anònim no és compatible amb filtratge.
També podeu crear una ruta dinàmica mitjançant la variable Liquid capture de la manera següent:
{% 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" %}
funcions
Funcions assignades a l'informe Power BI. Aquest paràmetre només funciona quan el paràmetre authentication_type està definit com a powerbiembedded.
Si heu definit funcions a Power BI i 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 funcions a Power BI, vegeu Seguretat a nivell de fila (RLS) amb 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 informe Power BI i no heu especificat el paràmetre de funcions a l'etiqueta Liquid o no heu especificat una funció al paràmetre, es mostrarà un error.
Suggeriment
Si voleu utilitzar les funcions web definides al vostre portal com a funcions Power BI, podeu definir una variable i assignar-hi funcions web. A continuació, podeu utilitzar la variable definida a l'etiqueta Liquid.
Suposem que heu definit dues funcions web com Region_East i Region_West al portal. Podeu unir-les mitjançant el codi següent: {% assign webroles = user.roles | join: ", " %}
Al fragment de codi anterior, webroles és una variable i les funcions web Region_East i Region_West s'emmagatzemaran en aquesta variable.
Utilitzeu la variable webroles a l'etiqueta Liquid com us mostrem a continuació:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}
es pot editar
Renderitza un objecte CMS Power Apps portals com a editable al portal, per als usuaris amb permís d'edició de contingut per a 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 que es pot editar. Per exemple, podria ser 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. Podria ser el nom d'un atribut de taula o d'un fragment, per exemple.
Després d'aquests paràmetres inicials, l'etiqueta admet una sèrie de paràmetres de nom opcionals.
classe
Especifica un valor d'atribut de classe de l'element arrel representat mitjançant aquesta etiqueta.
per defecte
Un valor per defecte que s'ha de representar en el cas que l'element que es pot editar no tingui cap valor.
escape
Un valor booleà que indica si un valor representat mitjançant aquesta etiqueta tindrà codificació HTML. És false per defecte.
liquid
Un valor booleà que indica si es processarà qualsevol codi de plantilla de Liquid que es trobi dins el valor de text representat mitjançant aquesta etiqueta. És true per defecte.
etiqueta
El nom de les etiquetes HTML de contenidor que es representaran mitjançant aquesta etiqueta. Aquesta etiqueta representarà els elements div per defecte. En general, es recomana triar entre div o span com a valor per a aquest paràmetre.
title
Especifica una etiqueta per a aquest element que es pot editar a la interfície d'edició de contingut. Si no es proporciona cap, es generarà una etiqueta favorable automàticament.
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. Es pot accedir a les propietats de la llista mitjançant un objecte entitylist que estarà disponible al bloc d'etiqueta. Per representar els registres de resultat reals de la llista, utilitzeu l'etiqueta entityview del bloc.
Si la llista s'ha carregat correctament, es representarà el contingut del bloc. Si la llista no s'ha trobat, no es representarà el contingut del bloc.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Per defecte, l'objecte entitylist tindrà 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à.
identificador
Carrega una llista per l'identificador GUID. 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'utilitzaran les cadenes GUID literals. Però s'especificarà l'identificador 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 clau proporcionat es pot analitzar com un GUID, la llista es carregarà per identificador. En cas contrari, es carregarà pel nom.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
Un Power Apps codi de llengua entera per seleccionar les etiquetes localitzades de la llista que s'han de carregar. Si no es proporciona cap _ codi d'idioma, s'utilitzarà l'idioma per defecte de l'aplicació del portal Power Apps connexió.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Carrega una visualització de Power Apps determinada, pel nom o l'identificador. Es pot accedir a les propietats de la visualització ߝ per veure les metadades de la columna, els registres de resultat paginats, etc. mitjançant un objecte entityview que estarà disponible al bloc d'etiqueta.
Si la visualització s'ha carregat correctament, es representarà el contingut del bloc. Si la visualització no s'ha trobat, no es representarà el contingut del bloc.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Per defecte, l'objecte entityview tindrà el nom de la 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 s'ha incrustat l'entityview en un bloc entitylist, heretarà la configuració per defecte (mida de pàgina de resultat, opcions de filtre, etc.) de la llista. Si no s'han proporcionat els paràmetres identificador o nom a l'entityview, es carregarà la vista per defecte de l'entitylist de delimitació.
{% 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 un nom d'identificador o de lògica per seleccionar la_ visualització Power Apps que voleu carregar. Si no en proporcioneu cap i l'etiqueta entityview està incrustada a una etiqueta entitylist, es carregarà la visualització per defecte de l'entitylist de delimitació.
identificador
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'utilitzaran les cadenes GUID literals. Però s'especificarà l'identificador 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 Power Apps de la visualització que s'ha de 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 Power Apps de la visualització que s'ha de 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 %}
comanda
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 %}
page
Especifica la pàgina de resultats de la visualització que es carregarà. Si aquest paràmetre no s'especifica, 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 un enter, es carregarà 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 es proporciona cap valor per a aquest paràmetre i l'entityview s'utilitza en un bloc entitylist, s'utilitzarà la mida de pàgina de la llista. Si no s'utilitza en un bloc entitylist, s'utilitzarà 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 un enter, s'utilitzarà 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 %}
cerca
Especifica una expressió de cerca a través de la qual es filtraran els resultats de la visualització. Les expressions simples de cerca de paraules clau filtraran per si els atributs comencen amb 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 Power Apps codi de llengua entera per seleccionar les etiquetes localitzades de visualització d'entitat (etiquetes de capçalera de columna, etc.) que s'han de carregar. Si no es proporciona cap _ codi d'idioma, s'utilitzarà l'idioma per defecte de l'aplicació del portal Power Apps connexió.
Si entityview s'utilitza dins d'un bloc d'entitylist, entityview heretarà la seva configuració de codi d'idioma 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 portal. Es pot accedir als resultats coincidents mitjançant un searchindex que estarà disponible al bloc d'etiqueta.
{% 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 tindrà el nom de la 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 consulta addicional utilitzada per fer coincidir 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.
Nota
La diferència entre filtre i consulta és que mentre ambdós acceptaran la sintaxi Analitzador de consulta Lucene, consulta està dissenyada per ser més flexible amb l'anàlisi sintàctica ߝ ja que s'espera que la majoria dels usuaris finals no siguin conscients d'aquesta sintaxi. Per tant, en cas que la consulta d'anàlisi d'acord amb aquesta sintaxi fallés, tota la consulta s'escaparà i s'enviarà com el text de la consulta. filtre, d'altra banda, s'analitzarà estrictament i retornarà un missatge d'error en cas que la sintaxi no sigui vàlida.
logical_names
Els noms lògics de l'entitat Power Apps als quals es restringiran els resultats coincidents, com a cadena delimitada per comes. Si no es proveeix, totes les entitats es retornaran.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
page
La pàgina de resultats de cerca que es retornarà. Si no es proveeix, es retornarà 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à. S'utilitzarà una mida per defecte de 10 si no se'n proveeix cap.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entityform
Renderitza completament un formulari bàsic configurat pel Power Apps, per nom o identificador.
Nota
L'etiqueta entityform només està disponible per a l'ús en continguts representats en una plantilla de pàgina basada en plantilla de web. Intentar utilitzar l'etiqueta en una plantilla de pàgina basada en la reescriptura no representarà res. Només podeu representar una única etiqueta entityform o webform per pàgina. Les etiquetes entityform o webform no es representaran després de la primera.
{% entityform name: 'My Basic Form' %}
Paràmetres
nom
El nom del formulari bàsic que vulgueu carregar.
{% entityform name:My Basic Form %}
webform
Renderitza completament un formulari avançat configurat pel Power Apps, per nom o 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 en una plantilla de pàgina basada en la reescriptura no representarà res. Només podeu representar una única etiqueta entityform o webform per pàgina. Les etiquetes entityform o webform no es representaran després de la primera.
{% webform name: 'My Advanced Form' %}
Paràmetres
nom
El nom del formulari avançat que vulgueu carregar.
{% webform name:My Advanced 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.
Important
- Aquesta és una característica de visualització prèvia.
- Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.
Paràmetres
nom
L'identificador o el nom del component de codi.
propietat
Els valors de les propietats que el component de codi espera s'han de passar com un parell clau/valor separat per ":" (signe de dos punts), on la clau é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> %}
Nota
Les propietats necessàries poden ser diferents en funció del component que trieu.
Vegeu Utilitzar l'etiqueta de plantilla de Liquid per als components de codi.
Consulteu també
Etiquetes de flux de control
Etiquetes d’iteració
Etiquetes variables
Etiquetes de plantilla