Acceder a datos de Dataverse

  • 5 minutos

Los creadores de Power Pages pueden usar HTML para compilar la salida que incluye contenido estático. Igualmente, los creadores pueden usar Liquid cuando trabajan con varias páginas y contenido dinámico que procede de Microsoft Dataverse y cuando introducen cambios de una página a la siguiente. Los elementos de Liquid actúan como marcadores y antes de enviar la salida al navegador, los elementos de Liquid se reemplazan por datos de Dataverse.

Power Pages implementa numerosas extensiones diseñadas para funcionar con Dataverse. En la siguiente tabla se describen algunos objetos de Liquid específicos de Dataverse disponibles.

Objeto Descripción
page Hace referencia a la página de solicitud del sitio web actual. El objeto page proporciona acceso a componentes como la ruta de navegación de la página actual, el título o la dirección URL de la página actual, como {{ page.title }}, y cualquier otra columna o tabla relacionada de la fila de Power Apps subyacente.
user Hace referencia al usuario del sitio web actual, lo que permite el acceso a todas las columnas de la fila de contacto de Power Apps subyacente. Si ningún usuario ha iniciado sesión, esta variable es null.
website Hace referencia al sitio web que permite el acceso a todas las columnas de la fila de sitio web de Power Apps (adx_website).
Tablas genéricas Un objeto de tabla proporciona acceso a las filas y columnas de una tabla de Dataverse. Una colección de todas las tablas se conoce como entities. Por ejemplo, {{ entities.contact[request.params.contactid].firstname }} hace referencia a la columna de nombre de pila de la fila de contacto, identificada por el parámetro de solicitud contactid.

Puede utilizar etiquetas específicas de Microsoft Dataverse para cargar y mostrar datos de Dataverse o utilizar otros servicios marco de Power Pages. Estas etiquetas son extensiones específicas de Dataverse del lenguaje Liquid. En la tabla siguiente se describen algunas de estas etiquetas.

Etiqueta Descripción
chart Agrega un gráfico de Power Apps a una página web. Para conocer los pasos para agregar un gráfico de Power Apps a una página web, consulte Agregar un gráfico a una página web en un portal.
powerbi Agrega los paneles y los informes de Microsoft Power BI dentro de las páginas. Para conocer los pasos para agregar un informe o un panel de información de Power BI a una página web del sitio web, consulte Agregar un informe o un panel de información de Power BI a una página web.
entitylist Una etiqueta de bloque de Liquid que carga una lista determinada por nombre o por id. Si la lista se carga correctamente, se representa el contenido de dentro del bloque.
entityview Una etiqueta de bloque de Liquid que carga una vista de Dataverse determinada por nombre o por id. Si la vista se carga correctamente, se representa el contenido de dentro del bloque.
fetchxml Permite a los usuarios consultar datos de Dataverse y muestra los resultados en una página.
codecomponent Le permite insertar componentes de código usando una etiqueta de Liquid. Para obtener más información, consulte Usar etiqueta de plantilla de Liquid para los componentes de código.

En el siguiente ejemplo se está cargando la vista Divisas activas y se muestran todas las filas devueltas. En el estudio de diseño de Power Pages, este código produce resultados debido a los privilegios de tiempo de diseño implícitos del creador. Sin embargo, en el sitio web, el usuario necesita tener privilegios de lectura asignados en la tabla Divisas para que el fragmento devuelva datos.

{% entityview logical_name:'transactioncurrency', name:'Active Currencies' %}
<p>We support {{ entityview.total_records }} currencies.</p>
<ul>
  {% for cur in entityview.records -%}
  <li>{{ cur.currencyname }}</li>
  {% endfor %}
</ul>
{% endentityview %}

El resultado sería similar al mostrado en el siguiente ejemplo:

Admitimos 4 divisas.

  • Dólar australiano
  • Dólar canadiense
  • Euro
  • Dólar estadounidense

Al usar Liquid en Power Pages, puede:

En estos escenarios, usted tiene acceso dinámico a las características de Power Pages, como la configuración del sitio, los fragmentos de contenido, las listas y formularios básicos, etc.

Importante

Las instrucciones de Liquid solo se procesan como salida. Liquid no tiene la capacidad de extender el código orientado al servidor que se ocupa de las interacciones del usuario, como los envíos de formularios.