Vorlagentags

Hinweis

Ab 12. Oktober 2022 ist Power Apps-Portale Power Pages. Weitere Informationen: Microsoft Power Pages ist jetzt allgemein verfügbar (Blog)
Wir werden die in Kürze migrieren und die Dokumentation für Power Apps-Portale mit der Power Pages-Dokumentation zusammenführen.

Vorlagentags steuern die Ausgabe einer Vorlage auf verschiedene Arten und ermöglichen die Kombinationen mehrerer Vorlagen in einer einzigen Ausgabe.

fetchxml

Ermöglicht es dem Benutzer, Daten aus Microsoft Dataverse abzufragen und die Ergebnisse auf einer Seite darzustellen.

Hinweis

Mehr über die Abfrage der Daten mit fetchxml erfahren Sie unter Daten mit FetchXML abfragen.

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

Wenn Sie „fetchxml” zum Abfragen von Daten verwenden, stellen Sie sicher, dass Sie keine selbstschließenden Tags verwenden. Verwenden Sie zum Beispiel statt <attribute name="title"/> <attribute name="title"></attribute> mit einem explizitem Schließ-Tag </attribute>.

Ergebnis-Attribut

Das Ergebnis-Attribut in der bereitgestellten Variable (wie z. B. 'resultVariable' in obigem Beispiel) enthält FetchXML-Abfrageergebnisse und einige andere Attribute.

• Entitäten

  Dieses Attribut enthält das Ergebnis der fetchxml-Abfrage. Sie können das Ergebnis iterieren und in Ihrer Webvorlage verwenden.

  <table> 
  {% for entityVariable in resultVariable.results.entities %} 
  <tr> 
  <td>Attribut-1: {{ entityVariable.attribute1 }}</td> 
  <td>Attribut-2: {{ entityVariable.attribute2 }}</td> 
  </tr> 
  {% endfor %} 
  </table> 
  

• TableName

  Ruft den logischen Namen der Entität ab.

• ExtensionData

  Ruft die Struktur ab, die zusätzliche Daten enthält.

• MinActiveRowVersion

  Ruft den niedrigsten aktiven Zeilenversionswert ab.

• MoreRecords

  Ruft ab, ob mehr Datensätze verfügbar sind.

• PagingCookie

  Ruft die aktuellen Paging-Informationen ab.

• TotalRecordCount

  Ruft die Gesamtzahl der Datensätze in der Sammlung ab.
  ReturnTotalRecordCount war wahr, als die Abfrage ausgeführt wurde.

• TotalRecordCountLimitExceeded

  Ruft ab, ob das Ergebnis der Abfrage die Gesamtzahl der Datensätze überschreitet.

XML-Attribut

Das XML-Attribut in der bereitgestellten Variable (wie z. B. 'resultVariable' in obigem Beispiel) enthält die resultierende Abfrage, die verwendet werden kann, um Daten von Microsoft Dataverse zu erhalten. Dieses Attribut ist nützlich für Debugging-Zwecke, wenn Sie wissen möchten, wie die Tabellenberechtigung auf dieses fetchxml-Tag angewendet wird.

Andere unterstützte Elemente und Attribute

Das liquid-Tag fetchxml unterstützt die folgenden Attribute und untergeordneten Elemente.

Element/untergeordnetes Element	Attribute	Untergeordnetes Element
fetch	Zuordnung Version count Seite paging-cookie utc-offset Aggregieren distinct min-active-row-version output-format returntotalrecordcount no-lock	Reihenfolge Entität
Reihenfolge	Attribut Alias absteigend
Entität	name all-attributes no-attrs Attribut	Reihenfolge Filter link-entity
Filter	type hint isquickfindfields	Bedingung Filter
link-entity	name from to Alias link-type sichtbar überschneiden all-attributes no-attrs Attribut	Reihenfolge Filter link-entity
Bedingung	Spalte Entitätsname Attribut Operator Aggregieren Alias uiname uitype uihidden value	value

einschließen

Schließt den Inhalt einer Vorlage in eine andere ein, nach Name. In Power Apps-Portalen ist die Quelle dieser anderen Vorlage in der Regel eine Webvorlage. Dadurch können die gängigen Vorlagenfragmenten an mehreren Orten wieder verwendet werden.

Wenn eine Vorlage in einer anderen enthalten ist, hat die integrierte Vorlage Zugang zu Variablen, die in der übergeordneten Vorlage definiert sind.

{% include 'My Template' %}

Es ist ebenfalls möglich, eine beliebige Zahl von benannten Parametern im Tag einzuschließen. Diese werden dann als Variablen in der integrierten Vorlage definiert.

{% include 'My Template' a:x, b:y %}

Block

Wird in Verbindung mit „extends” verwendet, um den Vorlagen-Vererbungsstatus bereitzustellen. Siehe „extends” zur Verwendung.

erweitern

Wird in Verbindung mit dem „block”-Tag verwendet, stellt die Vorlagenvererbung bereit. Dadurch können mehrere Vorlagen ein freigegebenes Layout verwenden, während spezifische Bereiche des übergeordneten Layouts überschrieben werden.

In Power Apps-Portalen bezieht sich der für den Tag angegebene Name der übergeordneten Vorlage im Allgemeinen auf einen Namen für eine Webvorlage.

Wenn „extends” verwendet wird, muss es der erste Inhalt in der Vorlage sein und kann nur von einem oder mehreren „block”-Tags gefolgt werden.

Wenn ein in der übergeordneten Vorlage definierter Block nicht überschrieben wird, wird der Inhalt in der übergeordneten Vorlage (sofern vorhanden) gerendert.

Kommentar

Ermöglicht es Ihnen, ungerenderte Codes in einer Liquid-Vorlage zu belassen. Der Content innerhalb des Blocks wird nicht gerendert und der Liquid-Code darin wird nicht ausgeführt.

Code

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Ausgabe

Hello. My name is Charles.

unformatiert

Ermöglicht die Ausgabe von Liquid-Code auf einer Seite, ohne dass diese analysiert und ausgeführt wird.

Ausgabe

Hello, {{ user.fullname }}. My name is Charles.

Ersatz

Wenn Sie das Zwischenspeichern von Kopf- und Fußzeilen aktivieren und das Zwischenspeichern bestimmter Abschnittsausgaben vermeiden möchten, können Sie dieses Tag verwenden. Dieses Tag stellt den Inhaltsblock in der Kopf- oder Fußzeile bereit, in der die Ausgabe des umbrochenen Inhaltsblocks nicht zwischengespeichert wird. Dies ist hilfreich in Szenarien, in denen der Benutzer ein Objekt verwendet, das häufig aktualisiert werden kann, z. B. Anforderung, Seite, Sprache und Datum. In den Szenarien zur Aktualisierung des Quellcodes von Webvorlagen für Kopf- und Fußzeilen wird beispielsweise angegeben, wenn das Zwischenspeichern von Kopf- und Fußzeilen aktiviert ist.

Tipp

Die in request.url verwendete URL kann ein beliebiger angeforderter Wert sein und wird für nachfolgende Anforderungen zwischengespeichert. Um sicherzustellen, dass der Wert in request.url korrekt ist, sollten Sie die Verwendung eines Ersatz-Tags, einer Teil-URL wie ~{WebFile-Pfad} oder die Speicherung der Portal-URL in Seiteneinstellungen in Betracht ziehen.

Codekomponente

Siehe Verstehen Sie Codekomponente Dataverse Entität Tag, Verwenden Sie Codekomponenten Liquid Template Tag.

Siehe auch

Ablaufsteuerungstags
Iterationstags
Variablentags
Power Apps Dataverse-Entitätstags
Verwendung von Code-Komponenten Liquid template tag

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).