Auf Dataverse-Daten zugreifen

  • 5 Minuten

Power Pages-Entwickler können eine HTML verwenden, um die Ausgabe zu erstellen, die statischen Inhalt umfasst. Ebenso können Entwickler Liquid verwenden, wenn sie mit mehreren Seiten und dynamischen Inhalten arbeiten, die von Microsoft Dataverse stammen, und Änderungen von einer Seite zur nächsten vornehmen. Die Liquid-Elemente fungieren als Platzhalter: Bevor die Ausgabe an den Browser gesendet wird, werden die Liquid-Elemente durch Daten aus dem Dataverse ersetzt.

Power Pages implementiert viele Erweiterungen, die zur Verwendung mit Dataverse konzipiert sind. Einige verfügbare Dataverse-spezifischen Liquid-Objekte sind in der folgenden Tabelle beschrieben.

Objekt Beschreibung
page Verweist auf die aktuelle Websiteanforderungsseite. Das page-Objekt bietet Zugriff auf Komponenten wie die Breadcrumbs für die aktuelle Seite, den Titel oder die URL der aktuellen Seite, z. B. {{ page.title }}, und alle anderen Spalten oder zugehörigen Tabellen des Basiswerts der Power Apps-Zeile.
user Bezieht sich auf den aktuellen Websitebenutzer und ermöglicht den Zugriff auf alle Spalten der zugrunde liegenden Power Apps-Kontaktzeile. Wenn kein Benutzer angemeldet ist, wird diese Variable null sein.
website Verweist auf die Website und ermöglicht den Zugriff auf alle Spalten der Zeile für die Power Apps-Website (adx_website).
Generische Tabellen Ein Tabellenobjekt bietet Zugriff auf die Zeilen und Spalten in einer Dataverse-Tabelle. Eine Sammlung von allen Tabellen wird als entities bezeichnet. Zum Beispiel bezieht sich {{ entities.contact[request.params.contactid].firstname }} auf die Vornamensspalte in der Kontaktzeile, gekennzeichnet durch contactid-Anforderungsparameter.

Sie können Microsoft Dataverse-spezifische Tags zum Laden und Anzeigen von Dataverse-Daten oder anderen Power Pages-Framework-Services verwenden. Diese Tags sind Dataverse-spezifische Erweiterungen der Liquid-Sprache. Einige dieser Tags werden in der folgenden Tabelle beschrieben.

Tag Beschreibung
chart Fügt einer Webseite ein Power Apps-Diagramm hinzu. Schritte zum Hinzufügen eines Power Apps-Diagramms zu einer Webseite, siehe Einer Webseite im Portal ein Diagramm hinzufügen.
powerbi Fügt Microsoft Power BI-Dashboards und Berichte innerhalb von Seiten hinzu. Schritte zum Hinzufügen eines Power BI-Berichts oder Dashboards einer Webseite auf der Website, Einen Power BI-Bericht oder ein ‑Dashboard einer Webseite hinzufügen.
entitylist Ein Liquid-Block-Tag, das eine bestimmte Liste nach Name oder ID lädt. Der Inhalt innerhalb des Blocks wird gerendert, wenn die Liste erfolgreich geladen wurde.
entityview Ein Liquid-Block-Tag, der eine Dataverse-Ansicht nach Name oder ID lädt. Der Inhalt innerhalb des Blocks wird gerendert, wenn die Ansicht erfolgreich geladen wurde.
fetchxml Ermöglicht Benutzern, Daten von Dataverse abzufragen und rendert die Ergebnisse auf einer Seite.
codecomponent Ermöglicht das Einbetten von Codekomponenten mit einem Liquid-Tag. Weitere Informationen finden Sie unter Das Liquid-Vorlage-Tag für Codekomponenten verwenden.

Im folgenden Beispiel wird die Ansicht Aktive Währungen geladen, und alle zurückgegebenen Zeilen werden angezeigt. Im Power Pages-Designstudio erzeugt dieser Code aufgrund der impliziten Rechte zur Entwurfszeit des Entwicklers eine Ausgabe. Auf der Website müsste der Benutzer jedoch über ein Leserecht für die Tabelle Währung verfügen, damit das Fragment Daten zurückgibt.

{% 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 %}

Die Ausgabe würde wie im folgenden Beispiel aussehen:

Wir unterstützen vier Währungen.

  • Australische Dollar
  • Kanadische Dollar
  • Euro
  • US-Dollar

Mit Liquid in Power Pages können Sie:

In diesen Szenarien haben Sie dynamischen Zugriff auf Power Pages-Funktionen, z. B. Websiteeinstellungen, Inhaltsausschnitte, Listen, Basisformulare usw.

Wichtig

Liquid-Anweisungen werden nur als Ausgabe verarbeitet. Liquid ist nicht in der Lage, serverseitigen Code zu erweitern, der sich mit Benutzerinteraktionen wie Formularübermittlungen befasst.