Vorlagentags

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.

Anmerkung

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 Anzahl Seite Seitenabruf-Cookie UTC-Abweichung Aggregat Getrennt Version mit Mindestanzahl an aktiven Zeilen Ausgabeformat returntotalrecordcount no-lock	Reihenfolge Entität
Reihenfolge	Attribut Alias absteigend
Entität	Name Alle Attribute Keine Attribute Attribut	Reihenfolge Filter link-entity
Filter	Typ Hinweis isquickfindfields	Bedingung Filter
link-entity	Name Von Bis Alias Verknüpfungstyp Sichtbar Überschneiden Alle Attribute Keine Attribute Attribut	Reihenfolge Filter link-entity
Bedingung	Spalte Entitätsname Attribut Operator Aggregat Alias Benutzeroberflächenname Benutzeroberflächentyp Benutzeroberfläche ausgeblendet value	value

einschließen

Schließt den Inhalt einer Vorlage in eine andere ein, nach Name. In Power Pages ist die Quelle dieser anderen Vorlage in der Regel eine Webvorlage. Dieser Operator kann die gängigen Vorlagenfragmenten an mehreren Orten wieder verwenden.

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 Parameter werden dann als Variablen in der integrierten Vorlage definiert.

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

block

Wird mit „erweitert“ verwendet, um die Vorlagenvererbung bereitzustellen. Siehe „extends” zur Verwendung.

erweitern

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

In Power Pages 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 Inhalt 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.

Output

Hello. My name is Charles.

raw

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. Dieser Operator ist in Szenarien hilfreich, 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.

Trinkgeld

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
Dataverse Liquid-Tags
Verwendung von Code-Komponenten Liquid template tag