Verfügbare Liquid-Objekte
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.
| Object | Beschreibung |
|---|---|
| entities | Ermöglicht das Laden einer beliebigen Microsoft Dataverse-Tabelle nach ID. Weitere Informationen: Entitäten |
| 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 Dataverse-Datensatzes. Weitere Informationen: Seite |
| Parameter | Eine bequeme Verknüpfung für request.params. Weitere Informationen: Anforderung |
| request | 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: Siteübersicht |
| Websitemarkierungen | Ermöglicht das Laden einer beliebigen Websitemarkierung nach Namen. Weitere Informationen: Websitemarkierungen |
| 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 Dataverse-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 Dataverse 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
| Attribute | 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 des Dataflows | 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
Anmerkung
Ein ad ist ein Tabellenobjekt mit allen gleichen Attributen, zusätzlich zu den unten aufgeführten.
| Attribute | 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. |
| Bild | Gibt das Bildobjekt für die Anzeige zurück (sofern vorhanden). |
| Name des Dataflows | Gibt das Feld „Name“ für die Anzeige zurück. |
| open_in_new_window | Gibt „wahr“ 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
| Attribute | 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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<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
Vorsicht
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.
Anmerkung
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 Dataverse-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 Dataverse-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 Dataverse. |
| Anmerkungen | 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 | Gibt den URL-Pfad des Content-Management-Systems für die Tabelle in Power Pages zurück. 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 Dataverse-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:
{{ 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 Dataverse-Name der referenzierten Tabelle. |
| Name des Dataflows | 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. |
Anmerkung
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.
| Attribute | 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.
| Attribute | 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 Dataverse-Tabellen-Tags verwendet. Es bietet Zugriff auf alle Attribute einer bestimmten Liste.
Attribute
Anmerkung
| Attribute | 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 Dataverse-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. Zum Beispiel: adx_websiteid |
| Sprachcode | Gibt den ganzzahligen Dataverse-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 Name des Attributs] | Sie können ein beliebiges Attribut des Dataverse-Datensatzes der Liste (adx_entitylist) nach logischem Namen aufrufen, genau wie einem Tabellen-Objekt. Zum Beispiel {{ entitylist.adx_name }} |
Listenansichtsattribute
| Attribute | Beschreibung |
|---|---|
| Spalten | Gibt die Spalten der Ansicht als Listen-Ansichtsspaltenobjekte zurück. |
| entity_logical_name | Gibt den logischen Dataverse-Tabellennamen für die Datensätze zurück, die in der Ansicht enthalten sind. Beispiel: contact |
| Id | Gibt die GUID-ID der Ansicht zurück. |
| Sprachcode | Gibt den ganzzahligen Dataverse-Sprachcode zurück, der verwendet wird, um alle lokalisierten Bezeichnungen (Spaltenüberschriften usw.) für die Ansicht auszuwählen. |
| Name des Dataflows | Gibt den Dataverse-Anzeigenamen der Ansicht zurück. |
| primary_key_logical_name | Gibt den logischen Dataverse-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
| Attribute | Beschreibung |
|---|---|
| attribute_type | Gibt den Dataverse-Attributtypnamen als Zeichenfolge für die Spalte zurück. Beispielsweise Lookup, Picklist, Zeichenfolge, Boolean, DateTime |
| logical_name | Gibt den logischen Dataverse-Attributnamen für die Spalte zurück. Beispielsweise createdon |
| Name | Gibt den lokalisierten Dataverse-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 Dataverse-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 Dataverse-Ansicht, die diese entityview definiert. |
| Sprachcode | Der Sprachcode für Ganzzahlen von Dataverse, 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 Dataverse-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 Dataverse-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:
| Attribute | 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.
Anmerkung
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 %}
Output
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
Anmerkung
| Attribute | Beschreibung |
|---|---|
| threads | Gibt ein forumthreads-Objekt zurück, das alle Forenthreads für das Forum enthält. |
| Name des Dataflows | 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
Anmerkung
| Attribute | 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
Anmerkung
| Attribute | Beschreibung |
|---|---|
| Autor | 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 Dataverse-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. |
| Bewertung | 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 Unterstützung für mehrere Sprachen 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 Dataverse-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
Anmerkung
| Attribute | 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. |
| Titel | Der Titel der Seite. |
| url | Die URL der Seite. |
| [Attribut- oder Beziehungsname] | Sie können auf ein beliebiges Attribut des der Seite zugrundeliegenden Dataverse-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:
{{ 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 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
| Attribute | 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
Anmerkung
| Attribute | Beschreibung |
|---|---|
| Name des Dataflows | 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
Anmerkung
| Attribute | 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
Anmerkung
| Attribute | 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. |
request
Enthält Informationen zum aktuellen HTTP-Request.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
Anmerkung
- 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.
- In der endgültigen Power Pages Version 9.3.8.x oder später werden standardmäßig geschützte Liquid-Filter für Benutzer- und Anfrage-Liquid-Objekte durchgesetzt. 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. |
| Path | 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 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
| Attribute | 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. |
| Id | Die Dataverse-Tabellen-ID des zugrunde liegenden Datensatzes für das Ergebnis als Zeichenfolge. Beispielsweise 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Der logische Name der Dataverse-Tabelle des zugrunde liegenden Datensatzes für das Ergebnis. Beispiel: adx_webpage |
| Zahl | 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.
Anmerkung
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
| Attribute | Beschreibung |
|---|---|
| url | Die URL des Websitemarkierungsziels. |
| [Logischer Name des Attributs] | Sie können auf ein beliebiges Attribut des Dataverse-Datensatzes des Websitemarkierungsziels nach logischem Namen zugreifen. Zum Beispiel {{ 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.
Anmerkung
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 Dataverse-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 %}
Anmerkung
In der endgültigen Power Pages Version 9.3.8.x oder später werden standardmäßig geschützte Liquid-Filter für Benutzer- und Anfrage-Liquid-Objekte durchgesetzt. 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 |
Weblinks
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
Anmerkung
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 Name des Attributs] | Sie können auf ein beliebiges Attribut des Dataverse-Datensatzes des Weblinksatzes nach logischem Namen zugreifen. Beispiel: {{ weblinkset.createdon }} |
Weblinkattribute
Anmerkung
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 Name des Attributs] | Sie können auf ein beliebiges Attribut des Dataverse-Datensatzes des Weblinks nach logischem Namen zugreifen. Beispiel: {{ weblink.createdon }} |
Weblink-Bildattribute
| alternate_text | Alternativer Text für das Bild. |
|---|---|
| Height | 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 Dataverse-Websitedatensatz (adx_website) für das Portal.
Anmerkung
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.) |