Etiquetas de entidad de Dataverse

Artículo
03/16/2023

Nota

A partir del 12 de octubre de 2022, los portales de Power Apps son Power Pages. Más información: Microsoft Power Pages ya está disponible para el público en general (blog)
Pronto migraremos y fusionaremos la documentación de los portales de Power Apps con la documentación de Power Pages.

Las etiquetas de entidad de Microsoft Dataverse se usan para cargar y mostrar los datos de Dataverse, o usar otros servicios de marco de portales de Power Apps. Estos etiquetas son extensiones específicas de Dataverse del lenguaje Liquid.

Gráfico

Agrega un gráfico Power Apps a una página web. La etiqueta del gráfico puede añadirse en el campo Copiar en una página web o en el campo Origen en una Plantilla web. Para ver los pasos para agregar un gráfico de Power Apps en una página web, consulte Agregar un gráfico a una página web en el portal.

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

Parámetros

Existen dos parámetros que se ofrecerán junto con la etiqueta del gráfico: id. de gráfico y viewid.

Id. de gráfico

Identificador de visualización del gráfico. Puede obtenerlo exportando el gráfico.

viewid

Identificador de la tabla cuando se abre en el editor de vistas.

powerbi

Agrega los paneles e informes de Power BI dentro de las páginas. La etiqueta del gráfico puede añadirse en el campo Copiar en una página web o en el campo Origen en una plantilla web. Para ver los pasos para agregar un informe o una panel de Power BI a una página web en el portal, consulte Adición de informes o paneles de Power BI a una página web en el portal.

Nota

Para que la etiqueta funcione, debe habilitar la integración de Power BI desde el Centro de administración de portales de Power Apps. Si la integración de Power BI no está habilitada, el panel o el informe no se mostrará.

Parámetros

La etiqueta powerbi acepta los siguientes parámetros.

path

Ruta del informe o el panel de Power BI. Si el informe o el panel de Power BI son seguros, debe proporcionar el 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 necesaria para el informe o el panel de Power BI. Los valores válidos para este parámetro son:

Anónimo: Permite insertar publicaciones en informes de Power BI web. El tipo de autenticación predeterminado es Anónimo. Cuando utilice el tipo de autenticación como Anónimo, debe obtener la dirección URL del informe de Power BI como se describe en: Publicar en la web desde Power BI
AAD: Permitir compartir informes Power BI o los paneles Power BI Azure Active Directory a los usuarios autenticados.
powerbiembedded: permite compartir los informes o los paneles seguros de Power BI con usuarios externos que no tienen licencia de Power BI o configuración de autenticación Azure Active Directory. Para obtener información sobre la configuración del servicio Power BI Embedded, consulte Habilitar el servicio Power BI Embedded.

Mientras agrega el informe o el panel seguro de Power BI, asegúrese de que se comparte con servicios Azure Active Directory o Power BI Embedded del portal.

Nota

Los valores del parámetro authentication_type no distinguen entre mayúsculas y minúsculas.

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

También puede filtrar el informe por uno o varios valores. La sintaxis para filtrar un informe es:

URL?filter=Tabla/Campo eq 'valor'

Por ejemplo, supongamos que desea filtrar el informe para ver los datos para un contacto Bert Hair. Debe anexar la dirección URL con los datos siguientes:

?filter=Executives/Executive eq 'Bert Hair'

El código completado 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ón sobre cómo filtrar un informe: Filtrar un informe usando parámetros de cadena de consulta en la dirección URL

Nota

El informe anónimo no admite filtros.

También puede crear una ruta dinámica mediante la variable de Liquid capture como se ve 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ás información sobre la variable de Liquid: Etiquetas de variables

tileid

Muestra la ventana especificada del panel. Debe proporcionar el Id. de la ventana.

{% 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 al informe Power BI. Este parámetro funciona únicamente cuando el parámetro authentication_type se establece en powerbiembedded.

Si ha definido roles en Power BI y los ha asignado a informes, se deben especificar los roles apropiados en la etiqueta Liquid powerbi . Los roles le permite filtre los datos que se mostrarán en un informe. Puede especificar varios roles separados por comas. Para obtener más información sobre la definición de roles en Power BI, consulte Seguridad de 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" %}

Si ha asignado un rol a un informe de Power BI, y no especificó el parámetro roles en la etiqueta Liquid ni especificó un rol del parámetro, se mostrará un error.

Sugerencia

Si desea usar los roles web definidos en el portal como roles Power BI, puede definir una variable y asignarla roles web. Puede usar posteriormente la variable definido en la etiqueta Liquid.

Digamos que ha definido dos roles web como Region_East y Region_West en el portal. Puede unirlos con el código: {% assign webroles = user.roles | join: ", " %}

En el fragmento de código anterior, webroles es una variable y los roles web de Region_East y de Region_West se almacenarán en ella.

Use la variable webroles como sigue en la 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

Representa un objeto CMS de portales de Power Apps como editable en el portal, para usuarios con permiso de edición de contenido para ese objeto. Los objetos editables son página, fragmentos y weblinks.

{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}

{% editable snippets Header type: 'html' %}

<!--

An editable web link set required a specific DOM structure, with

certain classes on the containing element, as demonstrated here.

-->

{% assign primary_nav = weblinks[Primary Navigation] %}

{% if primary_nav %}

<div {% if primary_nav.editable %}class=xrm-entity xrm-editable-adx_weblinkset{% endif %}>

<ul>

<!-- Render weblinks... -->

</ul>

{% editable primary_nav %}

</div>

{% endif %}

Parámetros

El primer parámetro proporcionado a editable es el objeto editable, como un conjunto de vínculos web, fragmentos o la página actual. El segundo parámetro opcional es para especificar un nombre de atributo o una clave dentro de ese objeto que se debe representar y editar. Este valor puede ser el nombre de un atributo de tabla o un nombre de fragmento, por ejemplo.

Después de estos parámetros iniciales, la etiqueta admite varios parámetros opcionales con nombre.

clase

Especifica un valor de atributo class para el elemento raíz representado por esta etiqueta.

default

Un valor predeterminado que se representará en caso de que el elemento editable no tenga ningún valor.

escape

Un valor booleano que indica si un valor generado por esta etiqueta se codificará como HTML. De forma predeterminada, el valor es False.

liquid

Un valor booleano que indica si se procesará algún código de plantilla Liquid encontrado dentro del valor de texto representado por esta etiqueta. Este valor es True de forma predeterminada.

tag

El nombre de las etiquetas HTML contenedoras que representará esta etiqueta. Esta etiqueta representará elementos div de forma predeterminada. Se recomienda elegir entre div o span como valor de este parámetro.

title

Especifica una etiqueta para este elemento editable en la interfaz de edición de contenido. Si no se ofrece ninguna, una etiqueta descriptiva se generará automáticamente.

type

Un valor de cadena que indica el tipo de interfaz de edición que se mostrará, para valores del texto modificables. Los valores válidos para este parámetro son html o texto. html es la opción predeterminada.

entitylist

Carga una determinada lista, por nombre o Id. Puede obtener acceso a las propiedades de la lista de tablas utilizando un objeto entitylist que esté disponible en el bloque de etiqueta. Para representar los registros de resultados reales de la lista, use la etiqueta entityview en el bloque.

Si la lista se carga correctamente, el contenido del bloque se representará. Si la lista no se encuentra, el contenido del bloque no se representará.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

De forma predeterminada, el objeto entitylist recibirá el nombre de variable entitylist. Opcionalmente, puede proporcionar otro nombre de variable.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Parámetros

Proporcione solo uno: id, name o key para seleccionar la lista que desea cargar.

Carga una lista por id. de GUID. id debe ser una cadena que se puede analizar como GUID.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Normalmente, las cadenas GUID literales no se usarán. En su lugar, se especificará id mediante una propiedad GUID de otra variable.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

name

Carga una lista por nombre.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

key

Carga una lista por ID o nombre. Si el valor de clave proporcionado se puede analizar como GUID, la lista se cargará por Id. De lo contrario, se cargará por nombre.

<!-- 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 entero de Power Apps para seleccionar las etiquetas localizadas de la lista que se cargarán. Si no se proporciona un language_code, el idioma predeterminado de la conexión de Power Apps de la aplicación del portal se usará.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

entityview

Carga una vista de Power Apps dada, por nombre o Id. A continuación se puede acceder a las propiedades de la vista ߝ de metadatos de columna de la vista, registros paginados de resultados, etc. utilizando un objeto entityview que estará disponible en el bloque de etiquetas.

Si la vista se carga correctamente, el contenido del bloque se representará. Si la lista no se encuentra, el contenido del bloque no se representará.

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

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

{% endentityview %}

De forma predeterminada, el objeto entityview recibirá el nombre de variable entityview. Opcionalmente, puede proporcionar otro nombre de variable.

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

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

{% endentityview %}

Si entityview se anida en un bloque de entitylist, heredará su configuración predeterminada (tamaño de la página de resultados, opciones de filtrado, etc.) de la lista. Si no se proporcionan parámetros id o name de vista a entityview, cargará la vista predeterminada desde la entitylist asociada.

{% 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 bien ido bien logical_name con el nombre para seleccionar la vista de Power Apps para cargar. Si no se proporciona ninguna, y la etiqueta entityview está anidada en una etiqueta entitylist, se cargará la vista predeterminada de la entitylist asociada.

id debe ser una cadena que se puede analizar como GUID.

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

Loaded entity view {{ entityview.name }}.

{% endentityview %}

Normalmente, las cadenas GUID literales no se usarán. En su lugar, se especificará id mediante una propiedad GUID de otra variable.

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

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

{% endentityview %}

logical_name

Nombre lógico de la entidad de Power Apps de la vista que se va a cargar. Deben usarse junto con name.

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

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

{% endentityview %}

name

El nombre de Power Apps de la vista que se cargará. Deben usarse junto con logical_name.

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

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

{% endentityview %}

filter

Especifica si filtrar los resultados de la vista por usuario o cuenta. Debe tener un valor de cadena de usuario o cuenta.

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

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

{% endentityview %}

Un caso de uso común es establecer este parámetro basado en una solicitud.

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

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

{% endentityview %}

metafilter

Especifica la expresión del filtro de metadatos de la lista por la que se filtrarán los resultados de la vista. Este parámetro solo es válido cuando entityview se utiliza junto con entitylist. En la mayoría de los casos, este parámetro se basa en una solicitud.

{% 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 una expresión de ordenación para ordenar los resultados de la vista. Una expresión de ordenación puede contener uno o varios nombres lógicos del atributo de entidad, seguido de una dirección de orden de ASC o 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 es establecer este parámetro basado en una solicitud.

{% 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 resultados de la vista para cargar. Si no se especifica este parámetro, la primera página de resultados se cargará.

Este parámetro se debe pasar como un valor entero, o una cadena que se pueda analizar como un entero. Si se proporciona un valor para este parámetro, pero el valor es nulo o no se puede analizar de otro modo como entero, la primera página de resultados se cargará.

{% 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 es establecer este parámetro basado en una solicitud.

{% 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 resultados para cargar para la página de resultados actual. Si no se proporciona un valor para este parámetro, y entityview se usa en un bloque entitylist, se usará el tamaño de página de la lista. Si no se encuentra en un bloque de entitylist, se usará un valor predeterminado de 10.

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

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

{% endentityview %}

Un caso de uso común es establecer este parámetro basado en una solicitud.

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

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

{% endentityview %}

search

Especifica una expresión de búsqueda por la que filtrar los resultados de la vista. Expresiones simples de búsqueda de palabras clave filtrarán en función de si los atributos empiezan por la palabra clave. Los comodines * también se pueden incluir en la expresión.

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

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

{% endentityview %}

Un caso de uso compartido es establecer este parámetro basado en una solicitud, para poder establecer el filtro de búsqueda basado en la entrada del 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 entero de Power Apps para seleccionar las etiquetas localizadas de vista de la entidad (etiquetas de encabezado de columna, etc.) para cargar. Si no se proporciona un language_code, el idioma predeterminado de la conexión de Power Apps de la aplicación del portal se usará.

Si entityview se usa dentro de un bloque entitylist, entityview heredará su 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 una consulta en el índice de búsqueda del portal. Puede obtener acceso a los resultados que coincidan utilizando un searchindex que esté disponible en el bloque de 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>

De forma predeterminada, el objeto de índice de búsqueda recibirá el nombre de variable searchindex. Opcionalmente, puede proporcionar otro nombre de variable.

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

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

...

{% endif %}

{% endsearchindex %}

Parámetros

La etiqueta searchindex acepta los siguientes parámetros.

query

La consulta usada para que coincidan los resultados. Este parámetro se usa para aceptar la parte especificada por el usuario de la consulta de índice (si la hay).

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Un caso de uso común es establecer este parámetro basado en una solicitud.

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

...

{% endsearchindex %}

Este parámetro admite la sintaxis de analizador de consultas de Lucene.

filter

Consulta adicional usada para que coincidan los resultados. Este parámetro se usa para aceptar un filtro especificado por el desarrollador para los resultados, si lo desea.

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

...

{% endsearchindex %}

Este parámetro admite la sintaxis de analizador de consultas de Lucene.

Nota

La diferencia entre filter y query es aunque ambos aceptarán la sintaxis de analizador de consultas de Lucene, query está pensada para ser más indulgente sobre la sintaxis es ߝ analizada, pues se espera que la mayoría de los usuarios finales no conozcan esta sintaxis. Por lo tanto, en caso de que el análisis de query según la sintaxis genere un error, la consulta completa se incluirá con caracteres de escape y enviará como texto de la consulta. filter, por otro lado, se analizará estrictamente y devolverá un error en el caso de sintaxis no válida.

logical_names

Los nombres lógicos de entidad de Power Apps a los que los resultados coincidentes estarán restringidos, como una cadena delimitada por comas. Si no se proporcionan, se devolverán todas las entidades que coincidan.

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

...
>
{% endsearchindex %}

page

La página de resultados de búsqueda que se devolverá. Si no se proporciona, la primera página (1) será devuelta.

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

...

{% endsearchindex %}

Un caso de uso común es establecer este parámetro basado en una solicitud.

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

...

{% endsearchindex %}

page_size

El tamaño de la página de resultados que se devolverá. Si no se proporciona, se usará un tamaño predeterminado de 10.

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

...

{% endsearchindex %}

entityform

Representa completamente formularios básicos configurados por Power Apps, por nombre o Id.

Nota

La etiqueta entityform sólo está disponible para su uso en el contenido representado en una plantilla de página basada en plantilla web–. Intentar usar la etiqueta en una plantilla de página basada en reescritura no representará nada. Solo puede representar una sola etiqueta entityform o webform por página. Las etiquetas entityform o webform después de la primera no se representarán.

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

Parámetros

name

El nombre del formulario básico que desea cargar.

{% entityform name:My Basic Form %}

webform

Representa completamente un formulario de varios pasos configurado por Power Apps, por nombre o Id. La etiqueta webform solo está disponible para su uso en el contenido representado en una plantilla de página basada en plantilla web. Intentar usar la etiqueta en una plantilla de página basada en reescritura no representará nada. Solo puede representar una sola etiqueta entityform o webform por página. Las etiquetas entityform o webform después de la primera no se representarán.

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

Parámetros

name

El nombre del formulario de varios pasos que desea cargar.

{% webform name:My Multistep Form %}

codecomponent

Le permite incrustar componentes de código mediante una etiqueta Liquid. Por ejemplo, agregar un control personalizado de visualización de mapa a una página web.

Importante

Esta es una Característica de vista previa (GB).
Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Parámetros

name

Nombre o id. del componente de código.

property

Los valores de las propiedades que espera el componente de código deben pasarse como un par clave / valor separados por ":" (signo de dos puntos), donde clave es el nombre de la propiedad y el valor es el valor de la cadena JSON.

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

Nota

Las propiedades requeridas pueden ser diferentes según el componente que elija.

Consulte Usar componentes de código en etiqueta de plantilla de Liquid.

Consulte también

Etiquetas de flujo de control
Etiquetas de iteración
Etiquetas variables
Etiquetas de plantilla

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).

Etiquetas de entidad de Dataverse

Gráfico

Parámetros

powerbi

Parámetros

editable

Parámetros

entitylist

Parámetros

entityview

Parámetros

searchindex

Parámetros

entityform

Parámetros

webform

Parámetros

codecomponent

Parámetros

Consulte también

Comentarios

Recursos adicionales