Etiquetas Liquid de Dataverse
As etiquetas Liquid de Microsoft Dataverse utilízanse para cargar e mostrar os datos de Dataverse, ou utilizan outros servizos de marcos de Power Pages. Estas etiquetas son extensións específicas de Dataverse ao idioma Liquid.
Gráfica
Engade unha gráfica de aplicación controlada por modelo de Power Apps a unha páxina web. A etiqueta da gráfica pódese engadir no campo Copia ou nunha páxina web ou no campo Orixe nun modelo web. Para saber os pasos necesarios para engadir unha gráfica de aplicación controlada por modelo de Power Apps a unha páxina web, consulte Engadir unha gráfica a unha páxina web en Power Pages.
{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}
Parámetros
Hai dous parámetros para fornecer coa etiqueta da gráfica: chart id e viewid.
chart id
Identificador de visualización da gráfica. Podes obter o dni exportando o gráfico.
viewid
Identificador da táboa ao abrir no editor de visualización.
powerbi
Engade os paneis de Power BI e informes dentro de páxinas. A etiqueta pódese engadir no campo Copia ou nunha páxina web ou no campo Orixe nun modelo web. Para obter información sobre os pasos para engadir un informe de Power BI ou un panel para unha páxina web en Power Pages, consulte Engadir un informe de Power BI ou un panel a unha páxina web en Power Pages.
Nota
Para que a etiqueta funcione, debe activar a integración de Power BI desde a plataforma común de Power Pages no centro de administración de Power Platform. Se non está activada a integración de Power BI, o panel ou o informe non se mostrarán.
Parámetros
A etiqueta powerbi acepta os seguintes parámetros:
path
Camiño do informe ou panel de Power BI. Se o informe de Power BI ou o panel é seguro, debe indicar o tipo de autenticación.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
authentication_type
Tipo de autenticación necesario para o informe ou o panel de Power BI. Valores válidos para este parámetro son:
Anónimo: Permite incorporar publicacións a web informes de Power BI. O tipo de autenticación predefinido é Anónimo. Ao usar o tipo de autenticación como Anónimo, debe obter o URL do informe de Power BI como se describe en: Publicar na web desde Power BI
AAD: Permite compartir informes seguros Power BI ou paneles de control para usuarios autenticados de Power BI Microsoft Entra identificación.
Powerbiembeddeded: Permítelle compartir os informes seguros Power BI ou paneles de control a usuarios externos que non teñan Power BI licenza ou Microsoft Entra configuración de autenticación. Para máis información sobre a configuración do servizo de Power BI Embedded, consulte Activar servizo de Power BI Embedded.
Ao engadir o informe seguro ou panel de control, asegúrese de Power BI que sexa compartido cos Power Pages Microsoft Entra Power BI Embedded ou servizos.
Nota
Os valores do parámetro authentication_type non diferencias miúsculas de minúsculas.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Tamén pode filtrar o informe nun ou máis valores. A sintaxe para filtrar un informe é:
URL?filter=Table/Field eq 'value'
Por exemplo, se desexa filtrar o informe para ver os datos dun contacto chamado Bert Hair. Debe anexar o URL cos seguintes datos:
?filter=Executives/Executive eq 'Bert Hair'
O código completo é:
{% 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áis información acerca de filtrar un informe: Filtrar un informe utilizando parámetros da cadea de consulta no URL
Nota
O informe anónimo non admite filtros.
Tamén se pode crear un camiño dinámico mediante a 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áis información sobre a variable de Liquid: Etiquetas da variable
tileid
Mostra o mosaico especificado do panel. Debe fornecer o ID do mosaico.
{% 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" %}
roles
Roles asignados ao informe de Power BI. Este parámetro funciona só cando o parámetro tipo de autenticación está definido como powerbiembedded.
Se definiu funcións en Power BI e as asignou a informes, debe especificar as funcións axeitadas na etiqueta Liquid powerbi. Os roles permiten filtrar os datos que se mostrarán nun informe. Pode especificar varios roles separados por comas. Para máis información sobre a definición de roles en Power BI, vea Seguridade a nivel de fila (RLS) con 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" %}
Se asignou un rol a un informe de Power BI e non especificou o parámetro roles na etiqueta Liquid ou non especificou un rol no parámetro, móstrase un erro.
Suxestión
Se quere empregar os roles web definidos no seu sitio como roles Power BI, pode definir unha variable e asignarlle funcións web. Pode entón usar a variable definida na etiqueta Liquid.
Digamos que definiu dúas funcións web como Region_East e Region_West no seu sitio. Pode unilas usando o código: {% assign webroles = user.roles | join: ", " %}
No fragmento de código anterior, webroles é unha variable e os roles web Region_East e Region_West serán almacenados nela.
Use a variable webroles como segue na etiqueta 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%}
editable
Procesa un determinado obxecto de CMS de Power Pages editable no sitio, para os usuarios que teñen permiso de edición de contido para ese obxecto. Os obxectos editables inclúen páxina, fragmentos de código e ligazóns 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ámetros
O primeiro parámetro que se proporciona para editar é o obxecto editable, como un conxunto de ligazóns web, fragmentos ou a páxina actual. O segundo parámetro opcional é para especificar un nome de atributo de ou clave dentro dese obxecto que se vai procesar e editar. Este valor pode ser o nome dun atributo da táboa, ou un nome fragmento, por exemplo.
Despois destes parámetros iniciais, a etiqueta admite un número de parámetros nomeados opcionais.
class
Especifica un valor de atributo de clase para o elemento raíz procesado por esta etiqueta.
default
Un valor por defecto renderizado no caso de que o elemento editable non teña valor.
escape
Un valor booleano que indica se un valor renderizado por esta etiqueta está codificado en HTML. Este valor é falso por defecto.
liquid
Un valor booleano que indique se debe procesar calquera código de modelo líquido que se atope dentro do valor de texto presentado por esta etiqueta. Este valor está predefinido en Verdadeiro por defecto.
tag
O nome das etiquetas HTML de contedores renderizadas por esta etiqueta. Esta etiqueta converte os elementos de mergullo por defecto. Recoméndase que escolla entre div ou span como un valor para este parámetro.
title
Especifica unha etiqueta para este elemento editable dentro da interface de edición de contido. Se non se fornece ningunha, xérase automaticamente unha etiqueta amigable.
tipo
Un valor de cadea que indica o tipo de interface de edición para mostrarse, para valores de texto editables. Valores válidos para este parámetro son html ou texto. O valor predefinido é html.
entitylist
Carga unha lista determinada, por nome ou ID. As propiedades da lista poden ser accedidas usando un obxecto de lista de entidades dispoñible dentro do bloque de etiquetas. Para procesar os rexistros de resultados reais da lista, utilice a etiqueta entityview no bloque.
Se a lista se carga correctamente, o contido dentro do bloque é renderizado. Se a lista non se atopa, o contido do bloque non se renderiza.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Por defecto, o obxecto da lista de entidades recibe a lista de entidades de nome variable. Opcionalmente, pódese fornecer un nome variable diferente.
{% entitylist my_list = name:My List %}
Loaded list {{ my_list.adx_name }}.
{% endentitylist %}
Parámetros
Forneza sé un: id, nome ou clave para seleccionar la lista que desexe cargar.
ID
Carga unha lista por ID de GUID. ID ten que ser unha cadea que poida ser analizada como un GUID.
{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Xeralmente, non se usan cadeas GUID literais. No seu lugar, o id especifícase usando unha propiedade GUID doutra variable.
{% entitylist id:page.adx_entitylist.id %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
nome
Carga unha lista por nome.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
key
Carga unha lista por ID ou nome. Se o valor da clave proporcionada pode ser analizado como GUID, a lista cárgase por DNI. En caso contrario, está cargado de nome.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
Un código de idioma de número enteiro de Dataverse para seleccionar as etiquetas localizadas da lista que se vai cargar. Se non se fornece language_code, utilízase o idioma predeterminado da conexión de aplicación Dataverse do sitio.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Carga unha visualización de Dataverse eterminada, por nome ou ID. As propiedades da vista ߝ ver metadatos da columna, rexistros de resultados paxinados, etc. poden ser accedidos usando un obxecto de visión de entidade que está dispoñible dentro do bloque de etiquetas.
Se a vista se carga correctamente, faise o contido dentro do bloque. Se non se atopa a vista, o contido do bloque non se renderiza.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Por defecto, o obxecto de visualización da entidade recibe a visión de entidade de nome variable. Opcionalmente, pódese fornecer un nome variable diferente.
{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ my_view.total_records }} total records.
{% endentityview %}
Se a visión de entidade está aniñada dentro dun bloque de entidades, herda a súa configuración predeterminada (tamaño da páxina de resultados, opcións de filtro, etc.) da lista. Se non se fornecen parámetros de identificación ou nome de visualización á visión de entidade, carga a vista predeterminada desde a lista de entidades que se aveciñan.
{% 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ámetros
Proporcione ou id ou logical_name cun nome para seleccionar la vista de Dataverse para cargar. Se non se fornece ningunha, e a etiqueta de visión da entidade está aniñada dentro dunha etiqueta de entidades, cárgase a vista por defecto da lista de entidades que se achegan.
ID
ID ten que ser unha cadea que poida ser analizada como un GUID.
{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded entity view {{ entityview.name }}.
{% endentityview %}
Xeralmente, non se usan cadeas GUID literais. No seu lugar, o id especifícase usando unha propiedade GUID doutra variable.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
logical_name
O nome lóxico da entidade de Dataverse da visualización que se vai cargar. Debe utilizarse en combinación con nome.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
nome
O nome de Dataverse da visualización que se vai cargar. Debe utilizarse en combinación con logical_name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
filter
Especifica se se filtran os resultados da visualización por usuario ou conta. Debe ter un valor de cadea de usuario ou conta.
{% entityview id:request.params.view, filter:'user' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Un caso de uso común é definir este parámetro baseado nunha solicitude.
{% entityview id:request.params.view, filter:request.params.filter %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
metafilter
Especifica a expresión de filtro de metadatos da Lista pola que filtrar os resultados da visualización. Este parámetro só é válido cando entityview se utiliza en combinación con entitylist. Na maioría dos casos, este parámetro defínese segundo unha solicitude.
{% 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 %}
order
Especifica unha expresión de clasificación para ordenar os resultados da visualización. Unha expesión de clasificación pode conter un ou máis nomes lóxicos de atributo de entidade, seguidos por unha dirección de clasificación de ASC ou DESC.
{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Un caso de uso común é definir este parámetro baseado nunha solicitude.
{% entityview id:request.params.view, order:request.params.order %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
page
Especifica a páxina de resultados de visualización que se vai cargar. Se este parámetro non se especifica, cárgase a primeira páxina de resultados.
Esta parámetro debe pasar a un valor de número enteiro ou unha cadea que se pode analizar como un número enteiro. Se se proporciona un valor para este parámetro, pero o valor é nulo ou doutro xeito non se pode analizar como enteiro, cárgase a primeira páxina de resultados.
{% entityview id:request.params.view, page:2 %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Un caso de uso común é definir este parámetro baseado nunha solicitude.
{% 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 o número de resultados a cargar para páxina de resultados actual. Se non se fornece ningún valor para este parámetro, e a visión de entidade úsase dentro dun bloque de lista de entidades, utilízase o tamaño da páxina de lista. Se non está dentro dun bloque de entidades, utilízase un valor predeterminado de 10.
Esta parámetro debe pasar a un valor de número enteiro ou unha cadea que se pode analizar como un número enteiro. Se se prevé un valor para este parámetro, pero o valor é nulo ou doutro xeito non se pode analizar como enteiro, utilízase o tamaño da páxina por defecto.
{% entityview id:request.params.view, page_size:20 %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Un caso de uso común é definir este parámetro baseado nunha solicitude.
{% entityview id:request.params.view, page_size:request.params.pagesize %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
search
Especifica unha expresión de busca pola que filtrar os resultados da visualización. As expresións de busca de palabras clave simples filtran se os atributos comezan coa palabra clave. Os comodíns * tamén se poden incluír na expresión.
{% entityview id:request.params.view, search:'John\*' %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
Un caso de uso común é definir este parámetro segundo unha solicitude, e xeito que o filtro de busca se poida definir segundo a información do usuario.
{% entityview id:request.params.view, search:request.params.search %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
language_code
Un código de idioma de número enteiro de Dataverse para seleccionar as etiquetas localizadas da visualización da entidade (cabeceira de columna de etiquetas, etc.) que se van cargar. Se non se fornece language_code, utilízase o idioma predeterminado da conexión de aplicación Dataverse do sitio web.
Se se utiliza unha visión de entidade dentro dun bloque de entidades, a visión de entidade herda a configuración do seu código de idioma da lista de entidades.
{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}
Loaded entity view {{ entityview.name }}.
{% endentitylist %}
searchindex
Realiza unha consulta no índice de busca do sitio web. Os resultados coincidentes poden ser accedidos usando un searchindex que está dispoñible dentro do bloque de etiquetas.
{% 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>
Por defecto, o obxecto do índice de busca recibe o nome variable searchindex. Opcionalmente, pódese fornecer un nome variable diferente.
{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}
{% if liquid_search.results.size > 0 %}
...
{% endif %}
{% endsearchindex %}
Parámetros
A etiqueta searchindex acepta os seguintes parámetros.
query
A consulta utilizada para que coincidan os resultados. Este parámetro pode aceptar o usuario a parte especificada poo usuario da consulta do índice (se existe).
{% searchindex query: 'support' %}
...
{% endsearchindex %}
Un caso de uso común é definir este parámetro baseado nunha solicitude.
{% searchindex query: request.params.query %}
...
{% endsearchindex %}
Este parámetro admite la a sintaxe de analizador de consultas Lucene.
filter
Outra consulta adoitaba coincidir cos resultados. Este parámetro pode aceptar especificado un filtraxe especificado polo programador para os resultados, se así o desexa.
{% searchindex query: request.params.query, filter: '+statecode:0' %}
...
{% endsearchindex %}
Este parámetro admite la a sintaxe de analizador de consultas Lucene.
Nota
A diferenza entre filtro e consulta é que mentres que ambos os dous aceptan a sintaxe de Analizador de consultas Lucene, consulta está destinado a perdoar máis como se analiza esa sintaxe ߝ xa que se espera que a maioría dos usuarios finais non noten esta sintaxe. Así, no caso de que a análise de consulta falle segundo esta sintaxe, toda a consulta escaparase e enviarase como o texto de consulta. filtro, por outra banda, analizarase estritamente e devolverá un erro en caso de sintaxe non válida.
logical_names
Os nomes lóxicos da entidade de Dataverse para os que se restrinxirán os resultados coincidentes, como unha cadea separada por comas. En caso de non facilitarse, devólvese a todas as entidades coincidentes.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
page
A páxina de resultados da busca que se van devolver. En caso de non facilitarse, devólvese a primeira páxina (1).
{% searchindex query: request.params.query, page: 2 %}
...
{% endsearchindex %}
Un caso de uso común é definir este parámetro baseado nunha solicitude.
{% searchindex query: request.params.query, page: request.params.page %}
...
{% endsearchindex %}
page_size
O tamaño da páxina de resultados que se vai devolver. Se non se fornece, utilízase un tamaño predeterminado de 10.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entityform
Procesa completamente un formulario por nome ou ID.
Nota
A etiqueta entityform só está dispoñible para a súa utilización en contido procesado nun modelo de páxina baseado nun modelo web. Tentar utilizar a etiqueta dentro dun Modelo de Páxina basado en Volver a escribir non procesará nada. Só é posible procesar unha única etiqueta de entityform ou webform por páxina. As etiquetas entityform ou webform despois do primeiro non se compilará.
{% entityform name: 'My Basic Form' %}
Parámetros
nome
O nome do formulario básico que desexa cargar.
{% entityform name:My Basic Form %}
webform
Procesa completamente un formulario con varios pasos por nome ou ID. A etiqueta webform só está dispoñible para a súa utilización en contido procesado nun modelo de páxina baseado nun modelo web. Tentar utilizar a etiqueta dentro dun Modelo de Páxina basado en Volver a escribir non procesará nada. Só pode renderizar unha única forma de entidade ou etiqueta de forma web por páxina. As etiquetas entityform ou webform despois do primeiro non se compilará.
{% webform name: 'My Multistep Form' %}
Parámetros
nome
O nome do formulario de varios pasos avanzado que desexa cargar.
{% webform name:My Multistep Form %}
codecomponent
Permítelle incorporar compoñentes de código mediante unha etiqueta Liquid. Por exemplo, engadir un control personalizado de visualización de mapas a unha páxina web.
Parámetros
nome
O DNI ou nome do compoñente do código.
property
Os valores das propiedades que espera o compoñente de código deben pasarse como un par clave/valor separados por ":" (signo de dous puntos), onde a clave é o nome da propiedade e o valor é o valor da cadea JSON.
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
Nota
As propiedades necesarias poden ser diferentes dependendo do compoñente que escolla.
Vexa Usar etiqueta de modelo Liquid de compoñentes de código.