Etiquetas de entidade de Dataverse
Nota
A partir do 12 de outubro de 2022, Portais de Power Apps é Power Pages. Máis información: Microsoft Power Pages xa está dispoñible de forma xeral (blog)
Proximamente migraremos e uniremos a documentación de Portais de Power Apps coa documentación de Power Pages.
As etiquetas de entidade de Microsoft Dataverse utilízanse para cargar e mostrar os datos de Dataverse, ou utilizan outros servizos de marcos de portais de Power Apps. Estas etiquetas son extensións específicas de Dataverse ao idioma Liquid.
Gráfica
Engade unha gráfica de Power Apps nunha 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 Power Apps a unha páxina web, consulte Engadir unha gráfica a unha páxina web no portal.
{% 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. Pode obter isto exportando a gráfica.
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 no portal, consulte Engadir un informe de Power BI ou un panel a unha páxina web no portal.
Nota
Para que a etiqueta funcione active a integración de Power BI no centro de administración de portais de Power Apps. 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:
camiño
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" %}
tipo_autenticación.
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: Permítelle compartir informes ou paneis de Power BI seguros con usuarios autenticados de Azure Active Directory de Power BI.
powerbiembedded: Permítelle compartir os paneis e informes seguros de Power BI con usuarios externos que non teñen unha licenza de Power BI ou configuración de autenticación de Azure Active Directory. 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 ou o panel seguro de Power BI, asegúrese de que se comparte cos servizos de portal Azure Active Directory ou Power BI Embedded.
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 sería:
{% 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 pode crear un camiño dinámico utilizando a variable capture de Liquid como se mostra a continuación:
{% 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 portal 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 portal. 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 portais de Power Apps editable no portal, 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 de táboa ou un nome de fragmento, por exemplo.
Despois destes parámetros iniciais, a etiqueta admite un número de parámetros nomeados opcionais.
clase
Especifica un valor de atributo de clase para o elemento raíz procesado por esta etiqueta.
predefinido
Un valor predefinido para procesar no caso de que o elemento editable non teña ningún valor.
escape
Un valor Booleano que indica se un valor procesado por esta etiqueta terá codificación HTML. Este valor é falso por defecto.
liquid
Un valor Booleano que indica se algún código do modelo Liquid atopado no valor do texto procesado por esta etiqueta será procesado. Este valor está predefinido en Verdadeiro por defecto.
etiqueta
Nome das etiquetas HTML de contedor que serán procesadas por esta etiqueta. Esta etiqueta procesará elementos div de maneira predefinida. Recoméndase que escolla entre div ou span como un valor para este parámetro.
título
Especifica unha etiqueta para este elemento editable dentro da interface de edición de contido. Se non se fornece ningún, unha etiqueta amigable xerarase automaticamente.
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. Pode obter acceso ás propiedades da lista utilizando un obxecto de entitylist que estea dispoñible no bloque de etiquetas. Para procesar os rexistros de resultados reais da lista, utilice a etiqueta entityview no bloque.
Se a lista está cargada correctamente, procesarase o contido no bloque. Se a lista non se atopa, non se procesará o contido no bloque.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
De maneira predefinida, o obxecto entitylist recibirá o nome variable entitylist. 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 usarán cadeas GUID literais. En vez diso, especificarase ID utilizando 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 %}
chave
Carga unha lista por ID ou nome. Se o valor de clave fornecido pode ser analizado como GUID, a lista cargarase por ID. En caso contrario, cargarase por nome.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
idioma_código
Un código de idioma de número enteiro de Power Apps para seleccionar as etiquetas localizadas da lista que se vai cargar. Se non se fornece un _código de idioma,usarase o idioma predefinido da conexión de Power Apps da aplicación do portal.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Carga unha visualización de Power Apps eterminada, por nome ou ID. As propiedades da visualización ߝ de metadatos de columna de visualización, rexistros paxinados de resultados, etc. estarán accesibles utilizando unha obxecto de entityview que estará dispoñible no bloque de etiqueta.
Se a lvisualización está cargada correctamente, procesarase o contido no bloque. Se a vista non se atopa, non se procesará o contido no bloque.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
De maneira predefinida, o obxecto entityview recibirá o nome variable entityview. 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 entityview está aniñada dentro dun bloque de entitylist, herdará a configuración predefinida (tamaño da páxina de resultados, opcións de filtro, etc.) da lista. Se os parámetros ID ou nome non se fornecen para entityview, cargará a visualización predefinida da entitylist.
{% 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
Forneza ben idou nome_lóxico co nome para seleccionar a visualización de Power Apps para cargar. Se non se fornece ningunha, e a etiqueta de entityview está aniñada nunha etiqueta entitylist, cargarase a visualización predefinida de entitylist.
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 usarán cadeas GUID literais. En vez diso, especificarase ID utilizando unha propiedade GUID doutra variable.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
nome_lóxico
O nome lóxico da entidade de Power Apps 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 Power Apps da visualización que se vai cargar. Debe utilizarse en combinación con nome_lóxico.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
filtro
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 %}
pedido
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 %}
páxina
Especifica a páxina de resultados de visualización que se vai cargar. Se este parámetro non está especificado, cargarase 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 fornece un valor para este parámetro, pero o valor é nulo ou non se pode analizar como un número enteiro, cargarase 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 %}
páxina_tamaño
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 entityview utilízase dentro dun bloque de entitylist, utilizarase o tamaño de páxina de lista. Se non está nun bloque de entitylist, usarase un valor predefinido 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 fornece un valor para este parámetro, pero o valor é nulo ou non se pode analizar como un número enteiro, usarase o tamaño de páxina predefinida.
{% 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 %}
busca
Especifica unha expresión de busca pola que filtrar os resultados da visualización. As expresións de busca de palabras clave simples filtrarase segundo se os atributos comezan pola 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 %}
idioma_código
Un código de idioma de número enteiro de Power Apps para seleccionar as etiquetas localizadas da visualización da entidade (cabeceira de columna de etiquetas, etc.) que se van cargar. Se non se fornece un _código de idioma,usarase o idioma predefinido da conexión de Power Apps da aplicación do portal.
Se se usa entityview dentro dunha bloque entitylist, entityview herdará a súa configuración de código de idioma de entitylist.
{% 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 portal. Os resultados coincidentes estarán accesibles agora utilizando un searchindex que estará dispoñible no 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>
De maneira predefinida, o obxecto de índice de busca recibirá 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.
consulta
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.
filtro
Unha consulta adicional utilizada para que coincidan os 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.
nomes_lóxicos
Os nomes lóxicos da entidade de Power Apps para os que se restrinxirán os resultados coincidentes, como unha cadea separada por comas. Se non se fornece, todas as entidades coincidentes será devoltas.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
páxina
A páxina de resultados da busca que se van devolver. Se non se fornece, primeira páxina (1) será devolta.
{% 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 %}
páxina_tamaño
O tamaño da páxina de resultados que se vai devolver. Se non se fornece, usarase o tamaño predefinido de 10.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entityform
Procesa completamente un formulario básico configurado por Power Apps, 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 de varios pasos configurado de Power Apps 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ó é posible procesar unha única etiqueta de entityform ou webform 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.
Importante
- Esta é unha funcionalidade de vista previa.
- As funcionalidades de vista previa non se deseñaron para uso de produción e poden ter funcionalidade restrinxida. Estas funcionalidades están dispoñibles antes da versión oficial para que os clientes poidan obter acceso a elas rápido e fornecer comentarios.
Parámetros
nome
O ID ou o nome do compoñente de código.
propiedade
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.
Consulte tamén
Etiquetas de fluxo de control
Etiquetas de iteración
Etiquetas variables
Etiquetas do modelo
Nota
Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)
Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).
Comentarios
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte: https://aka.ms/ContentUserFeedback.
Enviar e ver os comentarios