Freigeben über


Verfügbare Liquid-Objekte

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.

Liquid-Objekte enthalten Attribute für die Ausgabe von dynamischem Inhalten auf einer Seite. Beispielsweise hat das Seiten-Objekt ein Attribut namens Titel, mit dem der Titel der aktuellen Seite ausgegeben werden kann.

Um auf ein Objektattribut über den Namen zuzugreifen, verwenden Sie einen Punkt (.). Um ein Objektattribut in einer Vorlage zu rendern, setzen Sie es zwischen {{ and }}.

Wichtig

Damit Sie potenzielle siteübergreifende Skripting(XSS)-Probleme vermeiden können, verwenden Sie immer Maskierungsfilter, um Daten in HTML zu codieren, wenn Liquid-Objekte verwendet werden, um nicht vertrauenswürdige Daten zu lesen, die vom Benutzer bereitgestellt werden.

{{ page.title }}

Auf Attribute eines Objekts kann auch mithilfe eines Zeichenfolgennamens und mit [] zugegriffen werden. Dieses Format ist nützlich in Fällen, in denen das erforderliche Attribut dynamisch bestimmt wird oder der Attributname Zeichen, Leerzeichen, Sonderzeichen usw. enthält, die bei Verwendung eines Punktes (.) innerhalb der Syntax ungültig wären.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Auf die folgenden Objekte kann an beliebiger Stelle, in einer beliebigen Vorlage zugegriffen werden.

Objekt Beschreibung
entities Ermöglicht das Laden einer beliebigen Power Apps-Tabelle nach ID. Weitere Informationen: entities
jetzt Ein Datums-/Uhrzeitobjekt, das auf die aktuelle UTC-Zeit verweist, zum Zeitpunkt des Renderns der Vorlage.
Hinweis: Dieser Wert wird von der Portal Web App zwischengespeichert und wird nicht jedes Mal aktualisiert. Weitere Informationen: Datumsfilter
Seite Verweist auf die aktuelle Portalanforderungsseite. Das Objekt page bietet Zugriff auf Dinge wie die Breadcrumbs für die aktuelle Seite, den Titel oder die URL der aktuellen Seite und alle anderen Attribute oder verbundenen Entität des zugrunde liegenden Power Apps-Datensatzes. Weitere Informationen: Seite
Parameter Eine bequeme Verknüpfung für request.params. Weitere Informationen: Anforderung
Anfrage Enthält Informationen zum aktuellen HTTP-Request. Weitere Informationen: Anforderung
Einstellungen Ermöglicht das Laden einer beliebigen Website-Einstellung nach Namen. Weitere Informationen: Einstellungen
Siteübersicht Ermöglicht Zugriff auf die Portalsiteübersicht. Weitere Informationen: Sitemap
Websitemarkierungen Ermöglicht das Laden einer beliebigen Websitemarkierung nach Namen. Weitere Informationen: Sitemarkers
Ausschnitte Ermöglicht das Laden von Inhaltsausschnitten nach Namen. Weitere Informationen: Ausschnitte
Benutzer Verweist auf den aktuellen Portalbenutzer und ermöglicht Zugriff auf alle Attribute des zugrunde liegenden Power Apps-Kontaktdatensatzes. Wenn kein Benutzer angemeldet ist, ist diese Variable Null. Weitere Informationen: Benutzer
Weblinks Ermöglicht das Laden eines beliebigen Weblinksatzes nach Namen oder ID. Weitere Informationen: Weblinks
Website Verweist auf den Portal-Websitedatensaz und ermöglicht Zugriff auf alle Attribute des Power Apps Website-(adx_website)-Datensatzes für das Portal. Weitere Informationen: Website

Anzeigen

Bietet die Möglichkeit, auf eine Anzeige zuzugreifen und sie zu rendern.

Das Objekt das ermöglicht die Auswahl einer bestimmten Anzeige oder Anzeigenplatzierung:

<div>

{% assign ad = ads[Ad Name] %}

<h4>{{ ad.title }}</h4>

<a href={{ ad.redirect_url }}>

<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />

</a>

</div>

Anzeigenattribute

Attribut Beschreibung
placements Gibt das adplacements-Objekt zurück.
[Anzeigenname oder -ID] Sie können auf jede beliebige Anzeige über ihre Namens- oder ID-Eigenschaften zugreifen.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Attribute von Anzeigenplatzierungen

Attribut Beschreibung
[Anzeigenplatzierungsname oder -ID] Sie können auf jede beliebige Anzeigenplatzierung über ihre Namens- oder ID-Eigenschaften zugreifen.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Attribute von Anzeigenplatzierungen

Eine Anzeigenplatzierung ist ein Tabellenobjekt mit denselben allgemeinen Attributen und den unten aufgeführten Attributen.

Attribut Beschreibung
Anzeigen Gibt die Sammlung von Anzeigenobjekten zurück, die mit der Platzierung verbunden sind. Iterationtags und Arrayfilter werden möglicherweise mit dieser Sammlung verwendet.
Name Gibt das Feld „Name“ für die Anzeigenplatzierung zurück.
placement_url Die URL, mit der die Anzeigenplatzierung abgerufen werden kann, die vollständig über eine Vorlage gerendert wird.
random_url Die URL, mit der eine willkürliche Anzeige aus der Platzierung abgerufen werden kann, die vollständig über eine Vorlage gerendert wird.

Anzeigenattribute

Hinweis

Ein ad ist ein Tabellenobjekt mit allen gleichen Attributen, zusätzlich zu den unten aufgeführten.

Attribut Beschreibung
ad_url Die URL, mit der die Anzeig abgerufen werden kann, die vollständig über eine Vorlage gerendert wird.
Kopieren Gibt das Feld „Kopie“ für die Anzeige zurück.
image Gibt das Bildobjekt für die Anzeige zurück (sofern vorhanden).
Name Gibt das Feld „Name“ für die Anzeige zurück.
open_in_new_window Gibt „True“ zurück, wenn die URL, die von redirect_url angegeben ist, in einem neuen Fenster geöffnet werden soll.
redirect_url Die URL, an die der Benutzer verwiesen wird auf, indem er auf die Anzeige klickt.

Anzeigenbildattribute

Attribut Beschreibung
alternate_text Gibt den Text zurück der im alt-Attribut des Tags angezeigt werden soll.
height Gibt die Höhe für das Bild in Pixeln zurück
URL Gibt die URL-Quelle für das Bild zurück.
width Gibt die Breite für das Bild in Pixeln zurück

Blogs

Stellt die Möglichkeit zur Verfügung, Blogs und Blog-Beiträge aufzurufen und zu rendern.

Das Objekt blogs ermöglicht die Auswahl eines bestimmten Blogs oder Blog-Beitrags.

{% assign posts = blogs.posts | paginate: 0,4 %}

<div class=content-panel panel panel-default>

<div class=panel-heading>

{% assign sitemarker = sitemarkers["Blog Home"] %}

{% assign snippet = snippets[Home Blog Activity Heading] %}

<a class=pull-right href={{sitemarker.url}}> All Blogs </a>

<h4>

<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

<a class=user-avatar href={{ post.author_url }}>

<img src={{ post.user_image_url }} />

</a>

<h4 class=list-group-item-heading>

<a href={{ post.app_relative_path }}>{{ post.title }}</a>

</h4>

<div class=content-metadata>

<abbr class=timeago>{{ post.publish_date }}</abbr>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<a href={{ post.application_path }}#comments>

<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

blogs-Objekt

Das blogs-Objekt lässt den Zugriff auf ein bestimmtes Blog im Portal zu oder auf alle Blog-Einträge im Portal.

In der folgenden Tabelle werden die Attribute zum blogs-Objekt beschrieben.

Attribut Beschreibung
Beiträge Gibt ein blogposts-Objekt zurück, das alle Blog-Beiträge im Portal enthält.
[Blogname oder -ID] Sie können auf jeden Blog über dessen Namens- oder ID-Eigenschaften zugreifen.
{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

blog-Objekt

Das Blog-Objekt ermöglicht Ihnen die Arbeit mit einem einzelnen Blog, wobei Sie auf die Beiträge für dieses Blog zugreifen können.

In der folgenden Tabelle werden die Attribute zum Blog-Objekt beschrieben.

Attribut Beschreibung
posts Gibt ein blogposts-Objekt zurück, das alle Blog-Beiträge enthält.
Name Der Name des Blogs.
title Der Titel des Blogs
URL Die URL des Blogs.

blogposts-Objekt

Das Blogposts-Objekt ermöglicht Ihnen, auf eine Sammlung von blogpost-Objekten zuzugreifen. Sie können auch die Blog-Beiträge sortieren und eine Paginierung mithilfe von Liquid-Filtern umsetzen:

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Andere mögliche Optionen:

  • blogs.posts.all (um alle Blog-Beiträge zu erhalten)
  • blogs.posts | from\_index: 0 | take: 2

In der folgenden Tabelle werden die Attribute zum blogposts-Objekt beschrieben.

Attribut Beschreibung
Alle Gibt alle blogposts-Objekte in der Sammlung zurück.

blogpost-Objekt

Verweist auf einen einzelnen Blog-Beitrag.

In der folgenden Tabelle werden die Attribute zum blogpost-Objekt beschrieben.

Attribut Beschreibung
url Die URL des Beitrags.
Inhalt Gibt das Feld „Content“ für den Beitrag zurück.
Autor Gibt die Autoren für den Beitrag zurück (ein einfaches Kontakttabellenobjekt).
Titel Der Titel des Beitrags.
comment_count Gibt als ganzzahligen Wert die Anzahl an Kommentaren für den Beitrag zurück.
publish_date Das Datum, an dem der Beitrag veröffentlicht wurde.

entities

Achtung

Um potenzielle Cross-Site-Scripting-Probleme (XSS) zu vermeiden, verwenden Sie immer Escape-Filter, um Zeichenfolgendaten in HTML zu codieren, wann immer Sie das Liquid-Objekt Entitäten zum Lesen von Daten verwenden, die vom Benutzer bereitgestellt werden und denen nicht vertraut werden kann.

Hinweis

Einige der Namenskonventionen von Dataverse haben sich geändert, z. B. Dataverse-Entitäten heißen jetzt Tabellen. Die Namensänderungen gelten nicht für Liquid-Objekte. Das Objekt „Liquid-Entitäten“ wird weiterhin als Entitäten bezeichnet.

Ermöglicht das Laden einer beliebigen Power Apps-Tabelle nach ID. Wenn die Tabelle vorhanden ist, wird ein Tabellenobjekt zurückgegeben. Wird eine Tabelle mit der angegebenen ID nicht gefunden, wird Null zurückgegeben.

{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}

{% if account %}

{{ account.name | escape }} ({{ account.statecode.label | escape }})

{% endif %}

{% assign entity_logical_name = 'contact' %}

{% assign contact = entities[entity_logical_name][request.params.contactid] %}

{% if contact %}

{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})

{% endif %}

Entity

Ein Entitätsobjekt bietet Zugriff auf die Attribute eines Power Apps-Tabellendatensatzes.

Attribut Beschreibung
Kennung Die GUID-ID einer Tabelle als Zeichenfolge. Beispielsweise 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Der logische Name der Tabelle in Power Apps.
Hinweise Lädt alle Notizen (Anmerkungen), die der Tabelle zugeordnet sind, von der ältesten zur neuesten (createdon). Notizen werden als Notizenobjekte zurückgegeben.
Berechtigungen Lädt Tabellenberechtigungsassertions-Ergebnisse für die Tabelle. Ergebnisse werden als Berechtigungsobjekt zurückgegeben.
URL Liefert den URL-Pfad des Content-Management-Systems für die Tabelle in Power Apps-Portalen. Wenn die Tabelle in der aktuellen Website keine gültige URL hat, wird Null zurückgegeben. Im Allgemeinen wird nur ein Wert für bestimmte Tabellentypen zurückgegeben, die in das Portal-CMS integriert wurden, solange Sie den URL-Anbieter in Ihrer Anwendung angepasst haben.
[Attribut- oder Beziehungsname] Sie können auf ein beliebiges Attribut der Power Apps-Tabelle nach logischem Namen zugreifen. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Die Werte der meisten Tabellenattribute werden direkt zu Liquid-Typen zugeordnet: Felder mit zwei Optionsmöglichkeiten werden booleschen Werten zugeordnet, Textfelder werden Zeichenfolgen zugeordnet, nummerische Felder/Währungsfelder werden Zahlen zugeordnet und Datum/Uhrzeit-Felder werden Datum-Objekten zugeordnet. Einige Attributtypen werden jedoch als Objekte zurückgegeben:
  • Suchfelder (Associated Table Reference) werden als zugeordnete Tabellenreferenzobjekte zurückgegeben.
  • Optionssatz-/Auswahllistenfelder werden als Optionssatzwertobjekte zurückgegeben.
  • Sie können beliebigen verknüpfte Entitäten über den Beziehungsschemanamen laden.
  • {{ page.adx_webpage_entitylist.adx_name }}Wenn eine Beziehung reflexiv ist (d.h. auf sich selbst verweist), wird ein Reflexivbeziehungsobjekt zurückgegeben. (Andernfalls wäre das Ergebnis mehrdeutig.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Hinweis: Das Laden großer Mengen von verknüpfte Entitäten oder der Zugriff auf viele Beziehungen in einer einzigen Vorlage können negative Auswirkungen auf die Renderleistung der Vorlage haben. Vermeiden Sie das Laden verknüpfte Entitäten für jeden Artikel in einem Array innerhalb einer Schleife. Wenn möglich, verwenden Sie Dataverse-Tabellen-Tags, um Sammlungen von Entitäten zu laden.

Zugeordnete Tabellenreferenz

Suchattributwerte werden mit den folgenden Attributen als zugeordnete Tabellenreferenzobjekte zurückgegeben.

Attribut Beschreibung
Kennung Die GUID-ID einer referenzierten Tabelle als Zeichenfolge.
Beispielsweise 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Der logische Power Apps-Name der referenzierten Tabelle.
Name Das primäre Namensattribut der referenzierten Tabelle.

Notiz

Eine Notiz ist ein Tabellenobjekt, das Zugriff auf die Attribute und Beziehungen eines Anmerkungs-Datensatzes bereitstellt. Neben allen Attributen eines Tabellenobjektes hat es die folgende zusätzlichen Attribute.

Attribut Beschreibung
documentbody Lädt das documentbody Attribut des Notiz-Anmerkung-Datensatzes als Base-64-codierte Zeichenfolge. Da der Inhalt dieses Attributs sehr umfangreich sein kann, wird es nicht mit dem Rest der Notizattribute geladen, sondern nur bei Bedarf.
Hinweis: Die Nutzung des documentbody-Attributs kann negative Auswirkungen auf die Renderleistung der Vorlage haben und sollte mit Vorsicht ausgeführt werden.
Verwenden Sie stattdessen das URL-Attribut, um wenn möglich eine Verknüpfung zu einer Notizenanlage bereitzustellen.
URL Gibt den URL-Pfad für den integrierten Portal-Notizanhang-Handler zurück. Wenn der Benutzer über die Berechtigung verfügt, und die Notiz einen Dateianhang hat, lädt die Anforderung dieser URL den Notizendateianhang herunter.

Optionssatzwert

Optionssatz-/Auswahllisten-Attributwerte werden mit den folgenden Attribute als zugeordnete Tabellenreferenzobjekte zurückgegeben.

Attribut Beschreibung
Bezeichnung Die lokalisierte Beschriftung des Optionssatz-/Auswahllistenattributwerts. Beispiele, Aktiv
Wert Der Integer-Wert des Optionssatz-/Auswahllistenattributwerts. Zum Beispiel 0

Tabellenberechtigungen

Das Tabellenberechtigungsobjekt bietet Zugriff auf zusammengefasste Berechtigungsassertionsergebnisse für eine Tabelle.

Attribut Beschreibung
can_append Gibt „True“ zurück, wenn der aktuelle Benutzer die Berechtigung zum Anfügen von Datensätzen an Beziehungen dieses Datensatzes hat. Andernfalls wird „False“ ausgegeben.
can_append_to Gibt „True“ zurück, wenn der aktuelle Benutzer die Berechtigung zum Anfügen dieses Datensatzes an eine Beziehung einer anderen Tabelle hat. Andernfalls wird „False“ ausgegeben.
can_create Gibt „True“ zurück, wenn der aktuelle Benutzer die Berechtigung zum Erstellen neuer Datensätze dieses Tabellentyps hat. Andernfalls wird „False“ ausgegeben.
can_delete Gibt „True“ zurück, wenn der aktuelle Benutzer die Berechtigung zum Löschen dieses Datensatzes hat. Andernfalls wird „False“ ausgegeben.
can_read Gibt „True“ zurück, wenn der aktuelle Benutzer die Berechtigung zum Lesen dieses Datensatzes hat. Andernfalls wird „False“ ausgegeben.
can_write Gibt „True“ zurück, wenn der aktuelle Benutzer die Berechtigung zum Aktualisieren dieses Datensatzes hat. Andernfalls wird „False“ ausgegeben.
rules_exist Gibt „True“ zurück, wenn die Berechtigungsergebnisse dieses Objekts auf explizit definierten Berechtigungsregeln basieren. Gibt „False“ zurück, wenn die Standardergebnisse nicht auf explizit definierten Berechtigungen basieren.

Reflexive Beziehung

Der Versuch reflexive (d.h. auf sich selbst verweisend) Beziehungen oder Entitäten zu laden gibt Objekte mit den folgenden Attributen zurück.

Attribut Beschreibung
is_reflexive Gibt „True“ zurück. Kann verwendet werden, um zu testen, ob ein Objekt, das über eine Beziehungen zurückgegeben wird, ist Reflexivbeziehungsobjekt ist.
referenced Gibt ein Array referenzierter Entitäten für die jeweilige Beziehung zurück.
referencing Gibt eine referenzierende Tabelle für die jeweilige Beziehung zurück. Gibt Null zurück, wenn keine verweisende Tabelle vorhanden ist. Bei einer n: n-Beziehung wird ein Array aus referenzierenden Entitäten zurückgegeben.

entitylist

Das entitylist-Objekt wird innerhalb von Power Apps Dataverse-Tabellen-Tags verwendet. Es bietet Zugriff auf alle Attribute einer bestimmten Liste.

Attribute

Hinweis

Entitäten

Attribut Beschreibung
create_enabled Gibt „True“ zurück, wenn das Erstellen neuer Datensätze für die Liste konfiguriert ist. Andernfalls wird „False“ ausgegeben.
create_url Gibt den konfigurierten URL-Pfad für eine/n Erstellungslink/-schaltfläche für die Liste zurück.
detail_enabled Gibt „True“ zurück, wenn eine Detailansicht für einzelne Datensätze für die Liste konfiguriert ist. Andernfalls wird „False“ ausgegeben.
detail_id_parameter Gibt den Abfragezeichenfolgen-Parameternamen zurück, der für die Datensatz-ID verwendet werden soll, wenn eine Datensatzdetailansichts-URL erstellt wird. Siehe URL-Filter für Details zur Verwendung von Liquid-Filtern zur URL-Erstellung. Beispiel: id
detail_label Gibt die konfigurierte lokalisierte Beschriftung für Detailansichtslinks/-schaltflächen für die Liste zurück.
detail_url Gibt den konfigurierten URL-Pfad für Detailansichtslinks/-schaltflächen für die Liste zurück.
empty_list_text Gibt den konfigurierten lokalisierten Text zurück, der angezeigt werden soll, wenn die Listenansicht keine Ergebnisse zurückgibt.
enable_entity_permissions Gibt „True“ zurück, wenn die Tabellenberechtigungsfilterung für diese Liste aktiviert ist. Andernfalls wird „False“ ausgegeben.
entity_logical_name Gibt den logischen Power Apps-Tabellennamen für Datensätze zurück, die von dieser Liste angezeigt werden sollen. Beispiel: contact
filter_account_attribute_name Gibt den logischen Attributsnamen für die Suche in Firmen zum Filtern von Ergebnisdatensätzen nach der übergeordneten Firma des aktuellen Portal-Benutzers zurück. Zum Beispiel: accountid
filter_apply_label Gibt die konfigurierte lokalisierte Beschriftung zurück, die für den Link/die Schaltfläche verwendet werden soll, der/die einen erweiterten Attributfilter für die Listenergebnisse anwendet.
filter_definition Gibt die JSON-Attributfilterdefinition für die Liste zurück. Siehe Listenfilter für Details zum Verwenden des metafilters-Liquid-Filters zur Verarbeitung dieser Definition.
filter_enabled Gibt „True“ zurück, wenn die erweiterte Attributfilterung für die Liste aktiviert ist. Andernfalls wird „False“ ausgegeben.
filter_portal_user_attribute_name Gibt den logischen Attributsnamen für die Suche an Kontakten zum Filtern von Ergebnisdatensätzen nach dem Kontakt des aktuellen Portal-Benutzers zurück. Beispiel: contactid
filter_website_attribute_name Gibt den logischen Attributsnamen für die Suche an adx_website zum Filtern von Ergebnisdatensätzen nach der Website des aktuellen Portals zurück. Beispiel: adx_websiteid
language_code Gibt den ganzzahligen Power Apps-Sprachcode zurück, der verwendet wird, um alle lokalisierten Bezeichnungen für diese Liste auszuwählen.
page_size Gibt die Größe der konfigurierten Ergebnisseite für die Liste zurück.
primary_key_name Gibt den logischen Primärschlüsselattributnamen für Datensätze zurück, die von dieser Liste angezeigt werden sollen.
search_enabled Gibt „True“ zurück, wenn die Suche für diese Liste aktiviert ist. Andernfalls wird „False“ ausgegeben.
search_placeholder Gibt den konfigurierten lokalisierten Text für den Listen-Suchfeldplatzhalter zurück.
search_tooltip Gibt den konfigurierten lokalisierten Text für die Listensuch-QuickInfo zurück.
Ansichten Gibt die verfügbaren Ansichten für die Liste als Listen-Ansichtsobjekte zurück.
[Logischer Attributname] Sie können ein beliebiges Attribut des Power Apps-Datensatzes der Liste (adx_entitylist) nach logischem Namen aufrufen, genau wie einem Tabellen-Objekt. Beispielsweise {{ entitylist.adx_name }}

Listenansichtsattribute

Attribut Beschreibung
Spalten Gibt die Spalten der Ansicht als Listen-Ansichtsspaltenobjekte zurück.
entity_logical_name Gibt den logischen Power Apps-Tabellennamen für die Datensätze zurück, die in der Ansicht enthalten sind. Beispiel: contact
Kennung Gibt die GUID-ID der Ansicht zurück.
language_code Gibt den ganzzahligen Power Apps-Sprachcode zurück, der verwendet wird, um alle lokalisierten Bezeichnungen (Spaltenüberschriften usw.) für die Ansicht auszuwählen.
Name Gibt den Power Apps-Anzeigenamen der Ansicht zurück.
primary_key_logical_name Gibt den logischen Power Apps-Tabellen-Primärschlüsselnamen für die Datensätze zurück, die in der Ansicht enthalten sind. Beispiel: contactid
sort_expression Gibt den Standardsortierausdruck für die Ansicht zurück. Beispielsweise name ASC, createdon DESC

Listen-Ansichtsspaltenattribute

Attribut Beschreibung
attribute_type Gibt den Power Apps-Attributtypnamen als Zeichenfolge für die Spalte zurück. Beispielsweise Lookup, Picklist, Zeichenfolge, Boolean, DateTime
logical_name Gibt den logischen Power Apps-Attributnamen für die Spalte zurück. Beispielsweise createdon
Name Gibt den lokalisierten Power Apps-Anzeigenamen für die Spalte zurück. Beispielsweise Created On
sort_ascending Gibt eine Sortierausdruckszeichenfolge für die Sortierung der Spalte in aufsteigender Reihenfolge zurück. Beispielsweise createdon ASC
sort_descending Gibt eine Sortierausdruckszeichenfolge für die Sortierung der Spalte in absteigender Reihenfolge zurück. Beispielsweise createdon DESC
sort_disabled Gibt „True“ zurück, wenn die Sortierung für die Spalte deaktiviert ist. Andernfalls wird „False“ ausgegeben.
sort_enabled Gibt „True“ zurück, wenn die Sortierung für die Spalte aktiviert ist. Andernfalls wird „False“ ausgegeben.
width Gibt die konfigurierte Breite für die Spalte in Pixeln zurück.

entityview

Das entityview-Objekt wird innerhalb des entityview-Tags verwendet und bietet Zugriff auf die Metadaten für die Ansicht sowie die Anzeigeergebnisdatensätze.

Attribute

Attribut Beschreibung
Spalten Gibt die Spalten in der Ansicht als Tabellen-Ansichtsspaltenobjekte zurück.
entity_permission_denied Gibt „True“ zurück, wenn der Zugriff auf die Ansichtsergebnisse aufgrund unzureichender Tabelle-Berechtigungen für den aktuellen Benutzer verweigert wurde. Gibt „False“ zurück, wenn der Lesezugriff auf Ansichtsergebnisse erteilt wurde.
entity_logical_name Der logische Name der Power Apps-Tabelle der Ansichtsergebnisdatensätze. Beispiel: contact
first_page Die Seitenzahl der ersten Seite der Ansichtsergebnisse. Das ist 1, es sei denn, es wurden keine Ergebnisse zurückgegeben. In diesem Fall ist es Null.
Kennung Die GUID-ID der Power Apps-Ansicht, die diese entityview definiert.
language_code Der Sprachcode für Ganzzahlen von Power Apps, der verwendet wird, um lokalisierte Bezeichnungen für die aktuelle Ansicht zu laden.
last_page Die Seitenzahl der letzten Seite der Ansichtsergebnisse. Wenn keine Ergebnisse zurückgegeben wurden, ist dies Null.
Name Der Name der Power Apps-Ansicht, die diese entityview definiert, beispielsweise Active Contacts
next_page Die Seitenzahl der nächsten Seite der Ansichtsergebnisse. Ist keine nächste Seite mit Ergebnissen vorhanden, ist dies Null.
Seite Die Seitenzahl der aktuellen Seite der Ansichtsergebnisse.
pages Gibt ein Array von Seitenzahlen zurück, die alle Ergebnisseiten der aktuellen Ansicht enthalten.
page_size Die Anzahl an Ergebnissen, die pro Seite für die aktuelle Ansicht zurückgegeben werden.
previous_page Die Seitenzahl der nächsten Seite der Ansichtsergebnisse. Ist keine vorherige Seite mit Ergebnissen vorhanden, ist dies Null.
primary_key_logical_name Der logische Power Apps-Name des Primärschlüsselattributs der Ergebnistabelle für diese Ansicht. Beispiel: contactid
Einträge Die aktuelle Seite der Ergebnisdatensätze für die Ansicht als Tabellenobjekte.
sort_expression Der Standardsortierausdruck für die Ansicht. Beispielsweise nameASC, createdon DESC.
total_pages Die Gesamtanzahl an Ergebnisseiten für die Ansicht.
total_records Die Gesamtanzahl an Ergebnissen für die Ansicht (über alle Seiten).

ereignisse

Bietet die Möglichkeit, auf Ereignisse zuzugreifen und sie zu rendern. Das events-Objekt ermöglicht die Auswahl eines bestimmten Ereignisses oder alle Ereignisse.

events-Objekt

Das events-Objekt ermöglicht Ihnen den Zugriff auf spezielle Ereignisse im Portal oder auf alle Ereignisse im Portal (unabhängig vom Ereignis).

Das events-Objekt hat die folgenden Attribute:

Attribut Beschreibung
occurences Gibt ein eventoccurancessobject zurück, das alle Ereignisse im Portal enthält
[Ereignisname oder -ID] Sie können auf jedes Ereignis über dessen Namens- oder ID-Eigenschaften zugreifen.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

event-Objekt

Das event-Objekt ermöglicht Ihnen die Arbeit an einem einzelnen Ereignis, wobei Sie auf die Zeitpläne und Vorkommen für dieses Ereignis zugreifen können.

Das event-Objekt hat die folgenden Attribute:

Attribut Beschreibung
Vorkommen Gibt ein eventoccurrencesobject zurück, das alle Vorkommnisse für das Ereignis enthält.
Name Der Name des Ereignisses.
URL Die URL des Ereignisses.

eventoccurences-Objekt

Das eventoccurrences -Objekt ermöglicht Ihnen, auf eine Sammlung von Ereignis-Instanz-Objekten zuzugreifen. Sie können die Ereignisvorkommen sortieren und einen Datumsbereich angeben, sodass eine Paginierung erreicht wird und Liquid-Filtern verwendet werden können,

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

beachten Sie, dass

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

auch möglich ist.

Nachfolgende Attribute sind dem eventoccurrences-Objekt zugeordnet

Attribut Beschreibung
Alle Gibt alle eventoccurance-Objekte in der Sammlung zurück.

eventoccurence-Objekt

Stellt ein einzelnes Ereignisvorkommen dar. Die zugeordnete Attribute:

Attribut Beschreibung
URL Die URL des Vorkommens.
is_all_day_event Betriff das Ereignis einen ganzen Arbeitstag?
start_time Die Startzeit für das Ereignis.
end_time Die Endzeit für das Ereignis.

forloop

Enthält Eigenschaften, die mit einem für-Loop-Block nützlich sind.

Hinweis

forloop kann nur innerhalb eines for-Tags verwendet werden.

Code

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

Ausgabe

This is the first child page!

This is child page number 2.

This is child page number 3.

Attribute

Attribut Beschreibung
erste Gibt „True“ zurück, wenn es sich um den ersten Schleifendurchlauf handelt. Gibt „False“ zurück, wenn es sich nicht um den ersten Schleifendurchlauf handelt.
index Die Position des aktuellen Elements in der Sammlung (das ersten Element hat die Position 1).
index0 Die Position des aktuellen Elements in der Sammlung (das ersten Element hat die Position 0).
Letzter Gibt „True“ zurück, wenn es sich um den letzten Schleifendurchlauf handelt. Gibt „False“ zurück, wenn es sich nicht um den letzten Schleifendurchlauf handelt.
length Gibt die Anzahl der Durchlaufe der Schleife zurück ߝ Die Anzahl der Elemente in der Sammlung, die durchlaufen werden.
rindex Anzahl der Elemente, die noch in der Schleife verbleiben (Länge - Index), wobei 1 der Index des letzten Elements ist.
rindex0 Anzahl der Elemente, die noch in der Schleife verbleiben (Länge - Index), wobei 0 der Index des letzten Elements ist.

forums

Stellt die Möglichkeit zur Verfügung, Foren und Forenthreads aufzurufen und zu rendern. Die Möglichkeit, Liquid zu verwenden, um Forumsdaten zu rendern, erstreckt sich auf Beiträge. Um aber einen neuen Beitrag oder Thread zu erstellen, müssen Sie eine ASP.NET-mehrstufiges-Formular-Seitenvorlage mit besagter integrierter Funktion verwenden (z. B. standardmäßige Forenthread- und Forenbeitrags-Seitenvorlagen).

Das Foren-Objekt lässt die Auswahl eines Forums oder von Forum-Threads zu:

<div class=content-panel panel panel-default>

<div class=panel-heading>

<h4>

<span class=fa fa-comments aria-hidden=true></span>

{{ snippets[Home Forum Activity Heading] | default: Forum Activity | h }}

</h4>

</div>

{% for forum in website.forums %}

<ul class=list-group>

<li class=list-group-item>

<div class=row>

<div class=col-sm-6>

<h4 class=list-group-item-heading><a href="{{ forum.url | h }}"> {{ forum.name | h }}</a></h4>

<div class=list-group-item-text content-metadata>{{ forum.adx_description | h }}</div>

</div>

<div class=col-sm-3 content-metadata>{{ forum.thread_count }} threads</div>

<div class=col-sm-3 content-metadata>{{ forum.post_count }} posts</div>

</div>

</li>

</ul>

{% endfor %}

</div>

forums-Objekt

Das forums-Objekt ermöglicht Ihnen den Zugriff auf spezielle Foren im Portal oder auf alle Forenthreads im Portal (unabhängig vom Forum).

Das forum-Objekt ermöglicht Ihnen die Arbeit an einem einzelnen Forum, wobei Sie auf die Threads für dieses Forum zugreifen können.

Das forumthreads-Objekt ermöglicht Ihnen, auf eine Sammlung von forumthread-Objekten zuzugreifen. Sie können auch die Forenthreads sortieren und eine Paginierung erzielen mithilfe von Liquid-Filtern.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

Ein einzelner Forenthread

Das forumposts-Objekt ermöglicht Ihnen, auf eine Sammlung von forumposts-Objekten zuzugreifen.

Attribute

Attribut Beschreibung
threads Gibt ein forumthreads-Objekt zurück, das alle forumthreads-Objekte im Portal enthält.
Alle Gibt alle forum-Objekte im Portal zurück. Beachten Sie, dass website.forums auch eine Entsprechung ist.
thread_count Gibt den ganzzahligen Wert der Anzahl an Threads der gesamten Website zurück.
post_count Gibt den ganzzahligen Wert der Gesamtanzahl der Beiträge im Portal zurück.
[Forumname oder -ID] Sie können auf jedes Forum über dessen Namens- oder ID-Eigenschaften zugreifen.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

forum-Objekt

Attribute

Hinweis

entities

Attribute Beschreibung
threads Gibt ein forumthreads-Objekt zurück, das alle Forenthreads für das Forum enthält.
Name Der Name des Forums.
thread_count Gibt den ganzzahligen Wert der Anzahl an Threads im Forum zurück.
post_count Gibt den ganzzahligen Wert der Anzahl an Beiträgen im gesamten Forum zurück.

forumthreads-Objekt

Attribute

Attribut Beschreibung
Alle Gibt alle forumthread-Objekte in der Sammlung zurück.

forumthread-Objekt

Attribute

Hinweis

Entitäten

Attribut Beschreibung
posts Gibt ein forumposts-Objekt zurück, das alle Forenbeiträge für den Thread enthält.
author Gibt den Autor für den Thread zurück (ein einfaches Kontakttabellenobjekt).
latest_post Gibt den aktuellen Beitrag im Thread zurück.
first_post Gibt den ersten Beitrag im Thread zurück.
post_count Gibt den ganzzahligen Wert der Anzahl an Beiträgen im Thread zurück.
is_answered Wurde der Thread beantwortet oder nicht?
is_sticky Ist der Thread ein angehefteter Thread?

forumposts-Objekt

Attribute

Attribut Beschreibung
Alle Gibt alle forumthread-Objekte in der Sammlung zurück.

Ein einzelner Forenbeitrag

Attribute

Hinweis

Entitäten

Attribut Beschreibung
author Gibt den Autoren für den Beitrag zurück (ein einfaches Kontakttabellenobjekt).
Inhalt Der Textinhalt des Beitrags.
is_answer Ist dieser Beitrag eine Antwort zum Thread?

knowledge

Bietet Zugriff auf Power Apps-knowledgearticle und Kategorietabellendatensätze, um Artikel und Kategorien in einem Portal zu rendern.

Attribute

Attribut Beschreibung
Artikel Gibt ein Artikelobjekt zurück, das Artikelobjekte für die knowledgearticle-Tabellendatensätze enthält, die im Portal verfügbar sind.
Kategorien Gibt ein Kategorieobjekt zurück, das Kategorieobjekte für die Kategorietabellendatensätze enthält, die im Portal verfügbar sind.

articles-Objekt

Mit dem Objekt articles können Sie auf eine Sammlung von article-Objekten zugreifen. Sie können die Artikel sortieren und paginieren sowie Liquid-Filter verwenden.

{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode  %}
{% if popular_articles %}
    <div class=list-group>
    {% for article in popular_articles %}
      <div class=list-group-item clearfix>
        <a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
        <p class=description>{{ article.description | escape }}</p>
      </div>
    {% endfor %}
    </div>
{% endif %}

Attribute

Attribut Beschreibung
popular Gibt eine Sammlung von Artikelobjekten zurück, die die meisten Aufrufe enthalten. {% assign popular_articles = knowledge.articles.popular %}
recent Gibt eine Sammlung von Artikelobjekten zurück, die das Datum der letzten Änderung enthalten. {% assign recent_articles = knowledge.articles.recent %}
Oben Gibt eine Sammlung von Artikelobjekten zurück, die die höchsten Bewertungen enthalten. {% assign top_articles = knowledge.articles.top %}

Filter

Die folgenden Filter können optionale Parameter für Seitengröße und Sprache akzeptieren. Der erste Parameter ist die Zahl der Datensätze, die abgerufen werden sollen. Die Standardseitengröße ist 5. Der zweite Parameter ist der Code einer Sprache, um Artikel für eine bestimmte Sprache abzurufen. Die Filter können mit anderen Liquid-Filtern kombiniert werden.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Attribut Beschreibung
popular Gibt eine Sammlung von Artikelobjekten zurück, die die meisten Aufrufe enthalten. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recent Gibt eine Sammlung von Artikelobjekten zurück, die das Datum der letzten Änderung enthalten. {% assign recent_articles = knowledge.articles \| recent: 5 %}
Oben Gibt eine Sammlung von Artikelobjekten zurück, die die höchsten Bewertungen enthalten. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

categories-Objekt

Das categories-Objekt ermöglicht Ihnen, auf eine Sammlung von Kategorieobjekten zuzugreifen. Sie können die Kategorien sortieren und paginieren sowie Liquid-Filter verwenden.

{% assign category_url = sitemarkers['Category'].url %}
  {% assign count = count | default: 0 %}  
  {% assign categories = knowledge.categories | top_level: count %}
  {% if categories %}
    <div class=list-group unstyled>
    {% for category in categories %}
      <a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
        {{ category.title }}
      </a>
    {% endfor %}
    </div>
  {% endif %}

Attribute

Attribut Beschreibung
recent Gibt eine Sammlung von Kategorieobjekten zurück, die das Datum der letzten Änderung enthalten.
top_level Gibt eine Sammlung von Kategorie-Objekten zurück, die keine übergeordnete Kategorie haben.

Filter

Die folgenden Filter können einen optionalen Parameter für die Seitengröße akzeptieren. Die Standardseitengröße ist 5. Die Filter können mit anderen Liquid-Filtern kombiniert werden.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Attribut Beschreibung
recent Gibt eine Sammlung von Kategorieobjekten zurück, die das Datum der letzten Änderung enthalten. Sie können Parameter {% assign recent_categories = knowledge.categories \| recent: 10 %} angeben
top_level Gibt eine Sammlung von Kategorie-Objekten zurück, die keine übergeordnete Kategorie haben. {% assign root_categories = knowledge.categories \| top_level %}

article-Objekt

Mit dem Artikelobjekt können Sie mit einem einzelnen knowledgearticle arbeiten, um Details dieses Artikels im Portal anzuzeigen.

Attribute

article ist ein entity-Objekt mit den gleichen Attributen zusätzlich zu den unten aufgelisteten.

Attribut Beschreibung
article_public_number Die öffentliche Artikelnummer des Artikels.
comment_count Der ganzzahlige Wert für die Anzahl der Kommentare für einen bestimmten Artikel.
content Der Inhalt des Artikels.
current_user_can_comment Gibt einen booleschen Wert zurück, der angibt, ob der aktuelle Benutzer dem Artikel Kommentare hinzufügen kann.
is_rating_enabled Gibt einen booleschen Wert zurück, der angibt, ob für einen Artikel Bewertungen aktiviert sind.
keywords Die Schlüsselwörter für den Artikel.
Name Ein alternativer Alias für den Titel des Artikels.
rating Der Dezimalbewertungswert für den Artikel.
title Der Titel des Artikels.
view_count Der ganzzahlige Wert für die Häufigkeit, mit der der Artikel angezeigt wurde.

category-Objekt

Mit dem Kategorieobjekt können Sie mit einer einzelnen category arbeiten, um Details im Portal anzuzeigen.

Attribute

category ist ein entity-Objekt mit den gleichen Attributen zusätzlich zu den unten aufgelisteten.

Attribut Beschreibung
categorynumber Die Kategorienummer der Kategorie.
Name Ein alternativer Alias für den Titel der Kategorie.
Titel Der Titel der Kategorie.

Sprache

Liefert den aktuellen Sprachnamen und den Sprachcode, wenn Mehrsprachenunterstützung aktiviert ist.

Attribute

Attribut Beschreibung
URL Die aktuelle Anfrage-URL mit vorangestelltem aktuellem Sprachcode.
url_substitution Die aktuelle Anfrage-URL, der der aktuelle Sprachcode vorangestellt ist, umgeht den Seitenausgabe-Cache.
Name Titel der aktuellen Sprache.
Code Der Sprachcode der Sprache.

Zum Beispiel verwendet das Languages Dropdown Web-Template standardmäßig dieses Liquid-Objekt, um die verfügbaren Sprachen aufzulisten, wenn mehrere Sprachen verfügbar sind.

Seite

Verweist auf die aktuelle Portalanforderungsseite. Dieses Objekt kombiniert die Attribute der Siteübersicht und der aktuellen Anfrage Entitäten (in der Regel eine Webseite).

Das Objekt page bietet Zugriff auf Dinge wie die Breadcrumbs für die aktuelle Seite, den Titel oder die URL der aktuellen Seite und alle anderen Attribute oder verbundenen Entität des zugrunde liegenden Power Apps-Datensatzes.

<ul class=breadcrumb>

{% for crumb in page.breadcrumbs %}

<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>

{% endfor %}

<li class=active>{{ page.title | escape }}</li>

</ul>

<div class=page-header>

<h1>{{ page.title | escape }}</h1>

</div>

<div class=page-copy>

{{ page.adx_copy }}

</div>

<div class=list-group>

{% for child in page.children %}

<a class=list-group-item href={{ child.url | escape }}>

{{ child.title | escape }}

</a>

{% endfor %}

</div>

<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->

Seitenattribute

Hinweis

Entitäten

Attribut Beschreibung
breadcrumbs Gibt die Breadcrumb-Siteübersichtsknotenobjekte für die Seite zurück, beginnend ab dem Knotenpunkt für die Siteübersicht und endent bei übergeordnet
children Gibt die untergeordneten Siteübersichtsknotenobjekte der Seite zurück
parent Gibt den übergeordneten Siteübersichtsknoten der Seite zurück. Wenn die Seite die Homepage ist, ist das übergeordnete Element Null.
title Der Titel der Seite.
URL Die URL der Seite.
[Attribut- oder Beziehungsname] Sie können auf ein beliebiges Attribut des der Seite zugrundeliegenden Power Apps-Datensatzes nach logischem Namen zugreifen.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Die Werte der meisten Tabellenattribute werden direkt zu Liquid-Typen zugeordnet: Felder mit zwei Optionsmöglichkeiten werden booleschen Werten zugeordnet, Textfelder werden Zeichenfolgen zugeordnet, nummerische Felder/Währungsfelder werden Zahlen zugeordnet und Datum/Uhrzeit-Felder werden Datum-Objekten zugeordnet. Einige Attributtypen werden jedoch als Objekte zurückgegeben:
  • Suchfelder (Associated Table Reference) werden als zugeordnete Tabellenreferenzobjekte zurückgegeben.
  • Optionssatz-/Auswahllistenfelder werden als Optionssatzwertobjekte zurückgegeben.
  • Sie können beliebigen verknüpfte Entitäten über den Beziehungsschemanamen laden.
    {{ page.adx_webpage_entitylist.adx_name }}
    Wenn eine Beziehung reflexiv ist (z. B. auf sich selbst verweist), wird ein Entitätsobjekt zurückgegeben. (Andernfalls wäre das Ergebnis mehrdeutig.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Hinweis: Das Laden großer Mengen von verknüpfte Entitäten oder der Zugriff auf viele Beziehungen in einer einzigen Vorlage können negative Auswirkungen auf die Renderleistung der Vorlage haben. Vermeiden Sie das Laden verknüpfte Entitäten für jeden Artikel in einem Array innerhalb einer Schleife. Wenn möglich, verwenden Sie Power Apps Dataverse-Tabellen-Tags, um Sammlungen von Entitäten zu laden.

Umfragen

Bietet die Möglichkeit, auf eine Umfrage zuzugreifen und sie zu rendern.

Das polls-Objekt ermöglicht die Auswahl einer bestimmten Umfrage oder Umfragenplatzierung:

<div>

{% assign poll = polls[Poll Name] %}

<h4>{{ poll.question }}</h4>

{% for option in poll.options %}

<div>

<input type=radio name={{ poll.name }} id={{ option.id }} />

<label for={{ option.id }}>{{ option.answer }}</label>

</div>

{% endfor %}

<button type=button>{{ poll.submit_button_label }}</button>

</div>

Umfrageattribute

Attribut Beschreibung
placements Gibt das Umfrageplatzierungs-Objekt zurück.
[Umfragenname oder -ID] Sie können auf jede beliebige Umfrage über ihre Namens- oder ID-Eigenschaften zugreifen. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Attribute von Umfragenplatzierungen

Attribut Beschreibung
[Umfragenplatzierungsname oder -ID] Sie können auf jede beliebige Umfragenplatzierung über ihre Namens- oder ID-Eigenschaften zugreifen.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Attribute von Umfragenplatzierungen

Hinweis

entities

Attribut Beschreibung
Name Gibt das Feld „Name“ für die Umfragenplatzierung zurück.
placement_url Die URL, mit der die Umfragenplatzierung abgerufen werden kann, die vollständig über eine Vorlage gerendert wird.
Umfragen Gibt die Sammlung von Umfrageobjekten zurück, die mit der Platzierung verbunden sind. Iterationtags und Arrayfilter werden möglicherweise mit dieser Sammlung verwendet.
random_url Die URL, mit der eine willkürliche Umfrage aus der Platzierung abgerufen werden kann, die vollständig über eine Vorlage gerendert wird.
submit_url Die URL, an die eine abgeschlossene Umfrage gesendet wird.

Umfrageattribute

Hinweis

Entitäten

Attribut Beschreibung
has_user_voted Gibt „True“ zurück, wenn der aktuelle Benutzer (angemeldet oder anonym) bereits an dieser Umfrage teilgenommen hat.
Name Gibt das Feld „Name“ für die Umfrage zurück.
Optionen Gibt die Sammlung von Umfrageoptionsobjekten zurück, die mit der Umfrage verbunden sind. Iterationstags und Entitäten können mit dieser Sammlung verwendet werden.
poll_url Die URL, mit der die Umfrage abgerufen werden kann, die vollständig über eine Vorlage gerendert wird.
-Frage Gibt das Feld „Frage“ für die Umfrage zurück.
submit_button_label Gibt eine Zeichenfolge an, die verwendet werden kann, um die Schaltflächen-Beschriftung für die Übermittlung zu überschreiben.
submit_url Die URL, an die eine abgeschlossene Umfrage gesendet wird.
user_selected_option Gibt das Objekt Umfrageoption zurück, das vom Benutzer ausgewählt wurde (falls er bereits gewählt hat.)
votes Gibt die Anzahl der getätigten Stimmen zurück, die für die Umfrage tabelliert wurden.

Umfrageoptionsattribute

Hinweis

Entitäten

Attribut Beschreibung
answer Gibt das Feld „Antwort“ für die Umfrage zurück.
percentage Gibt den Prozentsatz der Stimmen in der Umfrage für die entsprechende Option als Dezimalstelle zwischen 0 und 100 zurück.
votes Gibt die Anzahl der getätigten Stimmen zurück, die für die Umfrage tabelliert wurden.

Anfrage

Enthält Informationen zum aktuellen HTTP-Request.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Hinweis

  • Sie können URLs in Liquid mithilfe von URL-Filtern dynamisch erstellen.
  • 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.
  • Power Apps Portale Releaseversion 9.3.8.x oder später haben standardmäßig markierte Flüssigkeitsfilter verstärkt für Benutzer und Anfrage Liquid-Objekte. Um diese Standardkonfiguration zu deaktivieren und diese Liquid-Objekte ohne Escape-Liquid-Filter zuzulassen, siehe Portalseiteneinstellungen – Site/EnableDefaultHtmlEncoding.

Attribute

Attribut Beschreibung
params Benannte Parameterwerte für die aktuelle Anforderung. params ist eine Kombination aus URL-Abfragezeichenfolgenparametern, Formular-Post-Parametern und Cookies.
Pfad Der Pfad der aktuellen Anforderungs-URL.
/profile/
path_and_query Der Pfad und die Abfrage der aktuellen Anforderungs-URL.
/profile/?foo=1&bar=something
query Der Abfragepfad der aktuellen Anforderungs-URL.
?foo=1&bar=something
URL Der vollständige Pfad der aktuellen Anforderungs-URL.
https://www.example.com/profile/?foo=1&bar=something

searchindex

Das Suchindex-Objekt wird innerhalb der Power Apps Dataverse-Tabellen-Tags verwendet und ermöglicht den Zugriff auf die Ergebnisse einer Abfrage.

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

Attribute

Attribut Beschreibung
approximate_total_hits Gibt eine ungefähre Gesamtanzahl der Treffer zurück, welche mit der Indexabfrage übereinstimmen. Aufgrund der Art und Weise, wie der Suchindex in Bezug auf die Sicherheitsfilterung und andere Designfaktoren funktioniert, ist diese Zahl nur ein Näherungswert und entspricht in manchen Situationen nicht genau der Gesamtzahl der Ergebnisse, die dem aktuellen Benutzer zur Verfügung stehen.
Seite Gibt die Seitenzahl der aktuellen Abfrage zurück.
page_size Gibt die maximale Seitengröße der aktuellen Abfrage zurück. Wenn Sie die tatsächliche Anzahl der zurückgegebenen Ergebnisse für die aktuelle Seite haben wollen (weil diese möglicherweise kleiner ist als die angegebene maximale Seitengröße), verwenden Sie results.size.
Ergebnisse Gibt die Abfrageergebnisseite als Suchenindex-Ergebnisobjekte zurück.

Suchindexergebnisse

Attribut Beschreibung
Entität Die zugrunde liegenden Entitäten für das Ergebnis.
fragment Ein relevantes kurzes Textfragment für das Ergebnis mit Begriffen, die der angegebenen Abfrage entsprechen und mit dem <em>-HTML-Tag markiert sind. Bestimmte Arten von Abfragen unterstützen keine hervorgehobenen Fragmente, z. B. Fuzzy-Abfragen (~) und Platzhalter-Abfragen (*). Diese Eigenschaft ist in diesen Fällen null.
Kennung Die Power Apps-Tabellen-ID des zugrunde liegenden Datensatzes für das Ergebnis als Zeichenfolge. Beispielsweise 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Der logische Name der Power Apps-Tabelle des zugrunde liegenden Datensatzes für das Ergebnis. Beispiel: adx_webpage
Anzahl Die Nummer des Ergebnisse auf allen Ergebnisseiten, beginnend bei 1. Für das erste Ergebnis der zweiten Ergebnisseite bei einer Seitengröße von 10 wäre dieser Wert 11.
score Die Lucene-Punktzahl des Ergebnisses als Gleitkommawert. Ergebnisse werden nach diesem Wert geordnet zurückgegeben.
title Der Titel des Ergebnisses.
URL Die URL für das Ergebnis. Dies ist eigentlich—aber nicht notwendigerweise—eher ein absoluter Pfad für die aktuelle Anwendung, statt eine vollständige URL. Beispiel: /articles/article1/

Einstellungen

Ermöglicht das Laden einer beliebigen Website-Einstellung nach Namen. Wenn eine Einstellung mit dem angegebenen Namen nicht gefunden wird, wird null zurückgegeben.

Hinweis

Einstellungen werden als Zeichenfolgen zurückgegeben, aber Sie können Type-Filter verwenden, um sie in andere Typen zu konvertieren.

{{ settings[My Setting] }}

{% assign search_enabled = settings[Search/Enabled] | boolean %}

{% if search_enabled %}

Search is enabled.

{% endif %}

{% assign pagesize = settings['page size'] | integer | default: 10 %}

{% if pagesize > 10 %}

Page size is greater than 10.

{% endif %}

Siteübersicht

Ermöglicht Zugriff auf die Portalsiteübersicht.

<h1>{{ sitemap.root.title }}</h1>

<ul class=breadcrumb>

{% for crumb in sitemap.current.breadcrumbs %}

<li><a href={{ crumb.title }}>{{ crumb.title }}</a></li>

{% endfor %}

<li class=active>{{ sitemap.current.title }}</li>

</ul>

{% for child in sitemap.current.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

It's also possible to load a site map node by URL path:

{% assign node = sitemap[/content/page1/] %}

{% if node %}

{% for child in node.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

{% endif %}

Siteübersichtsattribute

Attribut Beschreibung
Aktuell Gibt das Siteübersichtsknotenobjekt für die aktuelle Seite zurück.
Stamm Gibt das Siteübersichtsknotenobjekt für die Startseite der Website zurück.

Siteübersichtsknotenattribute

Attribut Beschreibung
Breadcrumbs Gibt die Breadcrumb-Siteübersichtsknotenobjekte für den Knoten zurück, beginnend ab dem Knotenpunkt für die Siteübersicht und endend bei dem übergeordneten.
Kinder Gibt die Siteübersichtsknotenobjekte des untergeordneten Knotens zurück.
Beschreibung Die Beschreibung/der Inhalt des Knotens. (Dieses Feld enthält möglicherweise HTML.)
Entität Gibt die zugrunde liegenden Entitäten des Knotens zurück. Wenn der Konten keine zugrunde liegende Tabelle aufweist, ist dieser Wert Null.
is_sitemap_ancestor Gibt „True“ zurück, wenn der Siteübersichtsknoten ein Vorgänger des aktuellen Knoten ist, andernfalls „False“.
is_sitemap_current Gibt „True“ zurück, wenn der Siteübersichtsknoten der aktuelle Knoten ist, andernfalls „False“.
Übergeordnetes Element Gibt das übergeordneten Siteübersichtsknoten des Knotens zurück. Wenn der Konten der Stammknoten ist, ist das übergeordnete Element Null.
Position Der Titel des Knotens.
URL Die URL des Knotens.

Websitemarkierungen

Ermöglicht das Laden einer beliebigen Websitemarkierung nach Namen. Wenn die Websitemarkierung vorhanden ist, wird ein Websitemarkierungsobjekt zurückgegeben. Wenn ein Sitemarker mit dem angegebenen Namen nicht gefunden wird, wird null zurückgegeben.

{{ sitemarkers[Login].url }}

{% assign my_sitemarker = sitemarkers["My Site Marker"] %}

{% if my_sitemarker %}

<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>

{% else %}

Site marker My Site Marker does not exist.

{% endif %}

Websitemarkierungsattribute

Attribut Beschreibung
URL Die URL des Websitemarkierungsziels.
[Logischer Attributname] Sie können auf ein beliebiges Attribut des Power Apps-Datensatzes des Websitemarkierungsziels nach logischem Namen zugreifen. Beispielsweise {{ sitemarker.adx_name }}

Ausschnitte

Ermöglicht das Laden von Inhaltsausschnitten nach Namen. Wenn ein Snippet mit dem angegebenen Namen nicht gefunden wird, wird null zurückgegeben.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Enthält Eigenschaften, die in einem Iterationstags-Loop-Block nützlich sind.

Hinweis

tablerowloop kann nur innerhalb eines Iterationstag-Tags Tag verwendet werden.

Attribute

Attribut Beschreibung
Col Gibt den Index der aktuellen Zeile wieder, beginnend bei 1.
col0 Gibt den Index der aktuellen Zeile wieder, beginnend bei 0.
col_first Gibt true zurück, wenn die aktuelle Spalte die erste Spalte in einer Zeile ist, und false, wenn sie es nicht ist.
col_last Gibt true zurück, wenn die aktuelle Spalte die letzte Spalte in einer Zeile ist, gibt false zurück, wenn sie es nicht ist.
Erste Gibt „True“ zurück, wenn es sich um den ersten Schleifendurchlauf handelt. Gibt „False“ zurück, wenn es sich nicht um den ersten Schleifendurchlauf handelt.
Index Die Position des aktuellen Elements in der Sammlung (das ersten Element hat die Position 1).
index0 Die Position des aktuellen Elements in der Sammlung (das ersten Element hat die Position 0).
Letzter Gibt „True“ zurück, wenn es sich um den letzten Schleifendurchlauf handelt. Gibt „False“ zurück, wenn es sich nicht um den letzten Schleifendurchlauf handelt.
Länge Gibt die Anzahl der Durchlaufe der Schleife zurück ߝ Die Anzahl der Elemente in der Sammlung, die durchlaufen werden.
Rindex Anzahl der Elemente, die noch in der Schleife verbleiben (Länge - Index), wobei 1 der Index des letzten Elements ist.
rindex0 Anzahl der Elemente, die noch in der Schleife verbleiben (Länge - Index), wobei 0 der Index des letzten Elements ist.

Benutzer

Verweist auf den aktuellen Portalbenutzer und ermöglicht Zugriff auf alle Attribute des zugrunde liegenden Power Apps-Kontaktdatensatzes. Wenn kein Benutzer angemeldet ist, ist diese Variable Null.

Benutzer ist ein Entität-Objekt.

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

Hinweis

Power Apps Portale Releaseversion 9.3.8.x oder später haben standardmäßig markierte Flüssigkeitsfilter verstärkt für Benutzer und Anfrage Liquid-Objekte. Um diese Standardkonfiguration zu deaktivieren und diese Liquid-Objekte ohne Escape-Liquid-Filter zuzulassen, siehe Portalseiteneinstellungen – Site/EnableDefaultHtmlEncoding.

Attribute

Neben der Verfügbarkeit aller Attribute eines Entitätsobjekts, hat der Benutzer folgende Attribute.

Attribut Beschreibung
Rollen Gibt die Rollen, denen der Benutzer angehört, als „Array“ wieder.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Hinweis: Sie können den has_role Filter auch nutzen, um einzelne Rollen Mitgliedschaften zu testen.
basic_badges_url Gibt die Service-URL zurück, um die Ausweise eines Benutzers abzurufen.
Um Ausweise für Benutzer zu rendern, müssen Sie ein Tag für die Attribute „Datenausweis“ und „Daten-URI“ enthalten. Wenn Sie die Ausweise des Benutzers rendern:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Wenn Sie die Ausweise eines Benutzers nach ID rendern (variable Benutzer-ID):
`<div data-badge data-uri='{{user.basic_badges_url

Ermöglicht das Laden eines beliebigen Weblinks nach Namen oder ID.

Wenn der Weblinksatz vorhanden ist, wird ein Weblinksatz-Objekt zurückgegeben. Wenn ein festgelegter Weblink mit dem angegebenen Namen oder der ID nicht gefunden wird, wird null zurückgegeben.

<!-- Load web link set by ID -->

{{ weblinks[page.adx_navigation.id].name }}

<!-- Load web link set by name -->

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

{% if nav %}

<h1>{{ nav.title | escape }}</h1>

<ul>

{% for link in nav.weblinks %}

<li>

<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>

{% if link.image %}

<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />

{% endif %}

{{ link.name | escape }}

</a>

</li>

{% endfor %}

</ul>

{% endif %}

Weblinksatz-Attribute

Hinweis

Ein Weblink-Set ist ein Entitäts-Objekt mit den gleichen Attributen zusätzlich zu den unten aufgelisteten.

Attribut Beschreibung
Kopieren Der HTML-Text des Weblinksatzes.
Name Der Name des Weblinksatzes.
Position Der Titel des Weblinksatzes.
Weblinks Das Array der Weblinkobjekte, die dem Weblinksatz zugeordnet sind.
[Logischer Attributname] Sie können auf ein beliebiges Attribut des Power Apps-Datensatzes des Weblinksatzes nach logischem Namen zugreifen. Beispiel: {{ weblinkset.createdon }}

Weblinkattribute

Hinweis

Ein Weblink-Set ist ein Entitäts-Objekt mit den gleichen Attributen zusätzlich zu den unten aufgelisteten.

Attribut Beschreibung
Beschreibung Die HTML-Beschreibung des Weblinks.
display_image_only Das boolesche Attribut gibt an, ob der Weblink lediglich als Bild und ohne Linktext angezeigt werden soll.
display_page_child_links Das boolesche Attribut gibt an, ob der Weblink Links zu untergeordneten Siteübersicht-Seiten der verlinkten Seite als Sublinks anzeigen soll.
Bild Das Weblink-Bildobjekt für diesen Link. Dieses Attribut ist null, falls kein Bild vorhanden ist.
is_external Das boolesche Attribut gibt an, ob die Ziel-URL des Weblinks auf eine externe Website verweist(und nicht zu einer internen Portalseite).
is_sitemap_ancestor Gibt „True“ zurück, wenn die URL des Weblinks auf einen Vorgänger des aktuellen Siteübersichtsknoten verweist, andernfalls „False“.
is_sitemap_current Gibt „True“ zurück, wenn die URL des Weblinks auf den aktuellen Siteübersichtsknoten verweist, andernfalls „False“.
Name Der Name/Titel des Weblinks.
Nofollow Das boolesche Attribut gibt an, ob der Weblink als „rel=nofollow“ gekennzeichnet werden soll.
open_in_new_window Das boolesche Attributgibt an, ob der Weblink in einem neuen Browserfenster/in einer neuen Registerkarte geöffnet werden soll, sobald er angeklickt wird.
QuickInfo QuickInfo-Text für den Weblink.
URL Die URL des Weblinks.
Weblinks Das Array der untergeordneten Weblinkobjekte, die dem Weblink zugeordnet sind.
[Logischer Attributname] Sie können auf ein beliebiges Attribut des Power Apps-Datensatzes des Weblinks nach logischem Namen zugreifen. Beispiel: {{ weblink.createdon }}
alternate_text Alternativer Text für das Bild.
Höhe Ganze Zahl, die die angegebene Höhe des Bildes enthält. Wenn kein Wert für die Höhe bereitgestellt wurde, ist dieses Attribut null.
URL Geben Sie die URL des Bildes ein.
Breite Ganze Zahl, die die angegebene Breite des Bildes enthält. Wenn kein Wert für die Breite bereitgestellt wurde, ist dieses Attribut null.

Website

Verweist auf die Portal-Website und ermöglicht Zugriff auf alle Attribute des Power Apps-Websitedatensatz (adx_website) für das Portal.

Hinweis

Website ist ein Entität-Objekt, mit all den gleichen Attributen.

Code

{{ website.adx_name }} ({{ website.id }})

Ausgabe

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Attribute

Die folgende Tabelle listet die Attribute für dieses Tag auf, die anstelle der Standardwerte verwendet werden können, um Zwischenspeichern zu vermeiden.

Standard Stellvertreter (vermeidet Zwischenspeichern) Beispiel
sign_in_url sign_in_url_substitution Standard: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Substitution (vermeidet Zwischenspeichern): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(„substitute-page“ ersetzt in diesem Beispiel die standardmäßig zwischengespeicherte URL.)
sign_out_url sign_out_url_substitution Standard: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Substitution (vermeidet Zwischenspeichern): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(„substitute-page“ ersetzt in diesem Beispiel die standardmäßig zwischengespeicherte URL.)

Siehe auch

Liquid-Typen
Liquid-Tags
Liquid-Filter

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).