Beschikbare Liquid-objecten

  • Artikel

Notitie

Met ingang van 12 oktober 2022 wordt Power Apps-portals hernoemd tot Power Pages. Meer informatie: Microsoft Power Pages is nu algemeen beschikbaar (blog)
We zullen binnenkort de documentatie voor Power Apps-portals migreren en samenvoegen met Power Pages-documentatie.

Liquid-objecten bevatten kenmerken waarmee dynamische inhoud naar de pagina kan worden uitgevoerd. Het paginaobject heeft bijvoorbeeld een kenmerk met de naam titel waarmee de titel van de huidige pagina kan worden uitgevoerd.

U krijgt toegang tot een objectkenmerk op naam door middel van een punt (.). Als u het kenmerk van een object in een sjabloon wilt weergeven, sluit u het in tussen {{ and }}.

Belangrijk

Om mogelijke XSS-problemen (cross-site scripting) te voorkomen, moet u altijd een escape-filter gebruiken om gegevens in HTML te coderen wanneer u Liquid-objecten gebruikt om niet-vertrouwde gegevens van de gebruiker te lezen.

{{ page.title }}

U hebt ook toegang tot de kenmerken van een object via een tekenreeksnaam en []. Deze indeling is nuttig in gevallen waarin het vereiste kenmerk dynamisch wordt bepaald, of de kenmerknaam tekens spaties, speciale tekens, enzovoort bevat, die niet geldig zijn bij gebruik van een punt (.) binnen de syntaxis.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

U kunt overal, in elke sjabloon, de volgende objecten gebruiken en openen.

Object Beschrijving
entiteiten Hiermee kunt u elke Power Apps-tabel laden door de id te vermelden. Meer informatie: entiteiten
nu Een datum/tijdobject dat verwijst naar de actuele UTC-tijd op het moment dat de sjabloon wordt weergegeven.
Opmerking: deze waarde wordt in cache geplaats door de webapp van de portal en wordt niet elke keer vernieuwd. Meer informatie: Datumfilters
pagina Verwijst naar de huidige aanvraagpagina in de portal. Het object page biedt toegang tot items zoals de breadcrumbs voor de huidige pagina, de titel of URL van de huidige pagina en alle andere kenmerken of gerelateerde entiteiten van de onderliggende Power Apps-record. Meer informatie: pagina
params Een handige snelkoppeling voor request.params. Meer informatie: aanvraag
aanvraag Bevat informatie over het huidige HTTP-verzoek. Meer informatie: aanvraag
instellingen Hiermee kunt u elke Site-instelling op naam laden. Meer informatie: instellingen
siteoverzicht Geeft toegang tot het siteoverzicht van de portal. Meer informatie: sitemap
sitemarkers Hiermee kunt u elke sitemarkering op basis van naam laden. Meer informatie: sitemarkers
snippets Hiermee kunt u contentsnippets op naam laden. Meer informatie: snippets
Gebruiker Verwijst naar de huidige portalgebruiker, en geeft daarmee toegang tot alle kenmerken van de onderliggende Power Apps-contactpersoonrecord. Als er geen gebruiker is aangemeld, is deze variabele null. Meer informatie: gebruiker
weblinks Hiermee kunt u elke webkoppelingsset laden op naam of ID. Meer informatie: weblinks
website Verwijst naar de websiterecord van de portal, en geeft daarmee toegang tot alle kenmerken van de Power Apps-websiterecord (adx_website) van de portal. Meer informatie: website

ads

Biedt de mogelijkheid om een advertentie te openen en weer te geven.

Met het object ads kunt u een specifieke advertentie of de plaatsing van een advertentie selecteren:

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

Kenmerken van advertenties

Kenmerk Beschrijving
placements Retourneert het object adplacement..
[ad name or id] U kunt toegang krijgen tot elke advertentie op basis van de eigenschappen naam of ID.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Kenmerken voor advertentieplaatsingen

Kenmerk Beschrijving
[ad placement name or id] U kunt elke advertentieplaatsing op basis van de eigenschappen naam of ID openen.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Kenmerken voor advertentieplaatsing

Een advertentieplaatsing is een tabelobject met dezelfde algemene kenmerken en de onderstaande kenmerken.

Kenmerk Beschrijving
Advertenties Retourneert de verzameling advertentieobjecten die aan de plaatsing zijn gekoppeld. Iteratiecodes en Matrixfilters kunnen bij deze verzameling worden gebruikt.
Naam Retourneert het veld Naam voor de advertentieplaatsing.
placement_url De URL die kan worden gebruikt om de advertentieplaatsing op te halen die volledig door een sjabloon wordt weergegeven.
random_url De URL die kan worden gebruikt om een willekeurige advertentie van de plaatsing op te halen die volledig door een sjabloon wordt weergegeven.

Kenmerken van advertenties

Notitie

Een advertentie is een tabelobject met alle bijbehorende kenmerken, naast de kenmerken die hieronder worden genoemd.

Kenmerk Beschrijving
ad_url De URL die kan worden gebruikt om de advertentie op te halen die volledig door een sjabloon wordt weergegeven.
Kopie Retourneert het veld Copy voor de advertentieplaatsing.
image Retourneert het afbeeldingsobject (indien van toepassing) voor de advertentie.
Naam Retourneert het veld Naam voor de advertentie.
open_in_new_window Retourneert true als de URL die is opgegeven door redirect_url in een nieuw venster moet worden geopend.
redirect_url De URL waar de gebruiker naartoe wordt geleid als hij of zij de advertentie selecteert.

Kenmerken van advertentieafbeeldingen

Kenmerk Beschrijving
alternate_text Retourneert de tekst die is bedoeld om te worden weergegeven in het kenmerk alt van de tag.
height Retourneert de hoogte in pixels van de afbeelding
URL Retourneert de URL-bron van de afbeelding.
width Retourneert de breedte in pixels van de afbeelding

blogs

Biedt de mogelijkheid om blogs en blogberichten te openen en weer te geven.

Het object blogs stelt u in staat een specifieke blog of blogberichten te selecteren.

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

Object blogs

Het object blogs geeft u toegang tot elke specifieke blog in de beheerportal, of tot alle blogberichten in de portal.

In de volgende tabel wordt uitgelegd welke kenmerken aan het object blogs zijn gekoppeld.

Kenmerk Beschrijving
posts Retourneert een blogposts-object dat alle blogberichten in de portal bevat.
[blog name or id] U kunt elke blog openen op basis van de naam- of id-eigenschappen ervan. 
{% assign blog = blogs["Blog Name"] %}                             

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

Object blog

Met het object blog kunt u werken met één blog, zodat u toegang hebt tot de berichten voor dat blog.

In de volgende tabel wordt uitgelegd welke kenmerken aan het object blog zijn gekoppeld.

Kenmerk Beschrijving
posts Retourneert een blogposts-object dat alle blogberichten van het betreffende blog bevat.
Naam De naam van het blog.
title De titel van het blog.
URL De URL van het blog.

Object blogposts

Het object blogposts geeft u toegang tot een verzameling blogberichtobjecten. U kunt de blogberichten ordenen en paginering toepassen, maar ook Liquid-filters gebruiken:

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

Andere mogelijke opties:

  • blogs.posts.all (om alle blogberichten op te halen)
  • blogs.posts | from\_index: 0 | take: 2

In de volgende tabel wordt uitgelegd welke kenmerken aan het object blogposts zijn gekoppeld.

Kenmerk Beschrijving
Alle Retourneert alle blogpost-objecten in de verzameling.

Object blogpost

Verwijst naar een enkel blogbericht.

In de volgende tabel wordt uitgelegd welke kenmerken aan het object blogpost zijn gekoppeld.

Kenmerk Beschrijving
url De URL van het bericht.
inhoud Retourneert het veld Inhoud van het bericht.
author Retourneert de auteurs van het bericht (dit is simpelweg een object van de contactpersoontabel).
titel De titel van het bericht.
comment_count Retourneert de waarde (geheel getal) van het aantal opmerkingen voor een bepaald bericht.
publish_date De datum waarop het bericht is gepubliceerd.

entiteiten

Waarschuwing

Maak altijd, om mogelijke problemen bij het uitvoeren van scripts op meerdere sites (XSS) te voorkomen, gebruik van een ontsnappingsfilter om tekenreeksgegevens in HTML te coderen bij gebruik van Liquid-object entiteiten om door de gebruiker verstrekte gegevens te lezen die niet kunnen worden vertrouwd.

Notitie

Enkele van de naamgevingsconventies van Dataverse zijn gewijzigd. Zo worden Dataverse-entiteiten nu tabellen genoemd. De naamswijzigingen zijn niet van toepassing op Liquid-objecten. Het object Liquid-entiteiten wordt verder aangeduid met de term entiteiten.

Hiermee kunt u elke Power Apps-tabel laden door de id te vermelden. Als de tabel bestaat, worden een tabelobject geretourneerd. Als een tabel met de opgegeven ID niet wordt gevonden, wordt null geretourneerd.

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

Een entiteitsobject biedt toegang tot de kenmerken van een Power Apps-tabelrecord.

Kenmerk Beschrijving
ID De GUID ID van de tabel, als een tekenreeks. Bijvoorbeeld 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name De logische Power Apps-naam van de tabel.
Notities Laadt alle notities (annotation) die aan de tabel zijn gekoppeld, gesorteerd van oudste naar nieuwste (createdon). Notities worden geretourneerd als notitieobjecten.
machtigingen Laadt de bevestigingsresultaten van tabelmachtigingen voor de tabel. De resultaten worden geretourneerd als machtigingenobjecten.
url Retourneert het URL-pad voor het inhoudsbeheersysteem van de Power Apps-portal voor de tabel. Als de tabel geen geldige URL heeft in de huidige website, wordt null geretourneerd. Over het algemeen retourneert dit alleen een waarde voor bepaalde tabeltypen die in de van het CMS van de portal zijn geïntegreerd, tenzij u de URL-provider in uw toepassing hebt aangepast.
[attribute or relationship name] Door middel van de logische namen hebt u toegang tot alle kenmerken van een Power Apps-tabel. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
De waarden van de meeste tabelkenmerken zijn rechtstreeks toegewezen aan Liquid-typen: Twee Optie-velden zijn toegewezen aan booleanse waarden, tekstvelden aan tekenreeksen, numerieke velden of valutavelden aan getallen, datum- en tijdvelden aan datumobjecten. Maar bepaalde typen kenmerken worden geretourneerd als objecten:
  • Opzoekvelden (gekoppelde tabelverwijzing) worden geretourneerd als gekoppelde tabelverwijzingsobjecten.
  • Optieset-/selectielijstvelden worden geretourneerd als optiesetwaardeobjecten.
  • U kunt ook alle gerelateerde entiteiten laden via de naam van het relatieschema.
    • {{ page.adx_webpage_entitylist.adx_name }}In het geval dat een relatie reflexief (d.w.z. zelfreferentieel) is, wordt een reflexief relatieobject geretourneerd. Anders zou het resultaat dubbelzinnig zijn.{{ page.adx_webpage_webpage.referencing.adx_name }}
    Opmerking: als u grote aantallen gerelateerde entiteiten laadt, of grote aantallen relaties in een enkele sjabloon opvraagt, kan dit een negatieve invloed hebben op de prestaties van sjabloonweergave. Het wordt afgeraden om gerelateerde entiteiten te laden voor elk item in een matrix, in een lus. Gebruik waar mogelijk Dataverse-tabeltags om verzamelingen van entiteiten te laden.

Verwijzing naar gekoppelde tabel

Waarden van het kenmerk Opzoeken worden geretourneerd als gekoppelde tabelverwijzingsobjecten, met de volgende kenmerken.

Kenmerk Beschrijving
ID De GUID ID van de verwijzingstabel, als een tekenreeks.
Bijvoorbeeld 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name De logische naam in Power Apps van de tabel waarnaar wordt verwezen.
Meetcriterium Het primaire-naamkenmerk van de tabel waarnaar wordt verwezen.

Opmerking

Een notitie is een tabelobject dat toegang biedt aan de kenmerken en relaties van een annotation-record. Naast alle kenmerken van een tabelobject, heeft een notitie de volgende aanvullende kenmerken.

Kenmerk Beschrijving
documentbody Laadt het kenmerk documentbody van de annotation-record van de notitie, als base64-gecodeerde tekenreeks. Aangezien de inhoud van dit kenmerk groot kan zijn, wordt deze niet samen met de overige notitiekenmerken geladen maar alleen op aanvraag.
Opmerking: als u het kenmerk documentbody gebruikt, kan dit een negatieve invloed op de prestaties voor sjabloonweergave hebben. U moet voorzichtig zijn in het toepassen ervan.
Gebruik indien mogelijk in plaats daarvan het kenmerk url om een koppeling naar de notitiebijlage te bieden.
URL Retourneert het URL-pad voor de ingebouwde aantekeningbijlagehandler van de portal. Als de gebruiker de rechten heeft en de notitie een toegevoegd bestand bevat, leidt een aanvraag aan deze URL tot het downloaden van de notitiebestandsbijlage.

Notitie

Aanvullende filters

Optiesetwaarde

Waarden van het kenmerk Optieset/Selectielijst worden geretourneerd als gekoppelde tabelverwijzingsobjecten, met de volgende kenmerken.

Kenmerk Beschrijving
Etiket Het gelokaliseerde label van de waarden van het kenmerk Optieset/Selectielijst. Bijvoorbeeld Actief
Waarde De integerwaarde van het kenmerk Optieset/Selectielijst. Bijvoorbeeld 0

Tabelmachtigingen

Het object met tabelmachtigingen biedt toegang tot de samengevoegde machtigingsbevestigingsresultaten voor een tabel.

Kenmerk Beschrijving
can_append Retourneert true als de huidige gebruiker bevoegd is om records toe te voegen aan relaties van deze record. Retourneert anders false.
can_append_to Retourneert true als de huidige gebruiker bevoegd is om deze record toe te voegen aan een relatie van een andere tabel. Retourneert anders false.
can_create Retourneert true als de huidige gebruiker bevoegd is om nieuwe records te maken van dit tabeltype. Retourneert anders false.
can_delete Retourneert true als de huidige gebruiker bevoegd is om de record te verwijderen. Retourneert anders false.
can_read Retourneert true als de huidige gebruiker bevoegd is om de record te lezen. Retourneert anders false.
can_write Retourneert true als de huidige gebruiker bevoegd is om deze record bij te werken. Retourneert anders false.
rules_exist Retourneert true als de machtigingsresultaten die dit object vertegenwoordigt, het resultaat van uitdrukkelijk gedefinieerde machtigingsregels zijn. Retourneert false als dit de standaardresultaten zijn bij afwezigheid van uitdrukkelijk gedefinieerde machtigingen.

Reflexieve relatie

Pogingen om reflexieve (d.w.z. zelfreferentiele) relaties voor entiteiten te laden, worden geretourneerd als objecten met de volgende kenmerken.

Kenmerk Beschrijving
is_reflexive Retourneert true. Kan worden gebruikt om te testen of een object dat door een relatie wordt geretourneerd, een object van een reflexieve relatie is.
referenced Retourneert een matrix van verwijzingsentiteiten voor de gegeven relatie.
referencing Retourneert een verwijzende tabel voor de gegeven relatie. Retourneert null als geen verwijzende tabel bestaat. Als de relatie veel-op-veel is (N:N), retourneert dit een matrix van verwijzende entiteiten.

entitylist

Het entitylist-object wordt gebruikt binnen de Power Apps Dataverse-tabeltags. Dit object biedt toegang tot alle kenmerken van een bepaalde lijst.

Notitie

De lijst weergeven die is gerelateerd aan de huidige pagina

Kenmerken

Notitie

entities

Kenmerk Beschrijving
create_enabled Retourneert true als aanmaak van nieuwe records voor de lijst is geconfigureerd. Retourneert anders false.
create_url Retourneert het geconfigureerde URL-pad voor een aanmaakkoppeling/-knop voor de lijst.
detail_enabled Retourneert true als een detailweergave voor afzonderlijke records voor de lijst is geconfigureerd. Retourneert anders false.
detail_id_parameter Retourneert de parameternaam van de querytekenreeks die moet worden gebruikt voor de record-ID bij het maken van een recorddetailweergave-URL. Zie URL-filters voor meer informatie over het gebruik van Liquid-filters om URL´s te maken. Bijvoorbeeld id
detail_label Retourneert het geconfigureerde gelokaliseerde label voor detailweergavekoppelingen/-knoppen voor de lijst.
detail_url Retourneert het geconfigureerde URL-pad voor detailweergavekoppelingen/-knoppen voor de lijst.
empty_list_text Retourneert de geconfigureerde gelokaliseerde tekst die moet worden weergegeven wanneer de lijstweergave geen resultaten retourneert.
enable_entity_permissions Retourneert true als filtering voor tabelmachtiging voor deze lijst is ingeschakeld. Retourneert anders false.
entity_logical_name Retourneert de logische naam van de Power Apps-tabel voor records die door deze lijst moeten worden weergegeven. Bijvoorbeeld contact
filter_account_attribute_name Retourneert de logische naam van het kenmerk voor de zoekactie naar account waarmee resultaatrecords worden gefilterd op basis van het bovenliggende account van de huidige portalgebruiker. Bijvoorbeeld accountid
filter_apply_label Retourneert het geconfigureerde gelokaliseerde label dat moet worden gebruikt voor de koppeling/knop die een geavanceerd kenmerkfilter op de lijstresultaten toepast.
filter_definition Retourneert de filterdefinitie van het JSON-kenmerk voor de lijst. Zie Lijstfilters voor meer informatie over het gebruik van het Liquid-filter metafilters om deze definitie te verwerken.
filter_enabled Retourneert true als filtering van geavanceerde kenmerken is ingeschakeld voor de lijst. Retourneert anders false.
filter_portal_user_attribute_name Retourneert de logische naam van het kenmerk voor de zoekactie naar contact waarmee resultaatrecords worden gefilterd op basis van de contactpersoon van de huidige portalgebruiker. Bijvoorbeeld contactid
filter_website_attribute_name Retourneert de logische naam van het kenmerk voor de zoekactie naar adx_website waarmee resultaatrecords worden gefilterd op basis van de huidige portalwebsite. Bijvoorbeeld adx_websiteid
language_code Retourneert de Power Apps-taalcode van gehele getallen die moet worden gebruikt om alle gelokaliseerde labels voor deze lijst te selecteren.
page_size Retourneert de geconfigureerde resultaatpaginagrootte voor de lijst.
primary_key_name Retourneert de logische naam van het primaire sleutelkenmerk voor records die door deze lijst moeten worden weergegeven.
search_enabled Retourneert true als zoeken voor deze lijst is ingeschakeld. Retourneert anders false.
search_placeholder Retourneert de geconfigureerde gelokaliseerde tekst voor de tijdelijke aanduiding van het zoekveld voor de lijst.
search_tooltip Retourneert de geconfigureerde gelokaliseerde tekst voor de knopinfo voor zoeken voor de lijst.
weergaven Retourneert de beschikbare weergaven voor de lijst als weergaveobjecten voor de lijst.
[attribute logical name] U kunt op basis van logische naam op dezelfde manier toegang krijgen tot elk kenmerk van de Power Apps-record van de lijst (adx_entitylist) als een tabelobject. Bijvoorbeeld {{ entitylist.adx_name }}

Kenmerken lijstweergave

Kenmerk Beschrijving
kolommen Retourneert de kolommen van de weergave als kolomobjecten van de lijstweergave.
entity_logical_name Retourneert de logische naam van de Power Apps-tabel voor de records die zijn opgenomen in de weergave. Bijvoorbeeld contact
Id Retourneert de GUID-ID van de weergave.
language_code Retourneert de Power Apps-taalcode van gehele getallen die moet worden gebruikt om alle gelokaliseerde labels (kolomkoppen en dergelijke) te selecteren voor de weergave.
Naam Retourneert de Power Apps-weergavenaam van de weergave.
primary_key_logical_name Retourneert de logische naam van de primaire sleutel van de Power Apps-tabel voor de records die zijn opgenomen in de weergave. Bijvoorbeeld contactid
sort_expression Retourneert de standaardsorteerexpressie voor de weergave. Bijvoorbeeld name ASC, createdon DESC

Kolomkenmerken van lijstweergave

Kenmerk Beschrijving
attribute_type Retourneert de naam van het Power Apps-kenmerktype voor de kolom als een tekenreeks. bijvoorbeeld Opzoeken, Selectielijst, Boole-waarde, Datum/tijd
logical_name Retourneert de logische naam van het Power Apps-kenmerk voor de kolom. Bijvoorbeeld createdon
Naam Retourneert de gelokaliseerde Power Apps-weergavenaam voor de kolom. Bijvoorbeeld Gemaakt op
sort_ascending Retourneert een sorteerexpressietekenreeks voor het sorteren van de kolom in oplopende volgorde. Bijvoorbeeld createdon ASC
sort_descending Retourneert een sorteerexpressietekenreeks voor het sorteren van de kolom in aflopende volgorde. Bijvoorbeeld createdon DESC
sort_disabled Retourneert true als sorteren voor de kolom is uitgeschakeld. Retourneert anders false.
sort_enabled Retourneert true als sorteren voor de kolom is ingeschakeld. Retourneert anders false.
width Retourneert de geconfigureerde breedte voor de kolom in pixels.

entityview

Het object entityview wordt gebruikt in de tag entityview en biedt toegang tot de metagegevens voor de weergave, evenals tot records voor weergaveresultaten.

Kenmerken

Kenmerk Beschrijving
kolommen Retourneert de kolommen in de weergave als kolomobjecten van de tabelweergave.
entity_permission_denied Retourneert true als toegang tot de weergaveresultaten is geweigerd vanwege onvoldoende tabelmachtigingen voor de huidige gebruiker. Retourneert false als leestoegang tot de weergaveresultaten is toegekend.
entity_logical_name De logische naam van de Power Apps-tabel van de weergaveresultaatrecords. Bijvoorbeeld contact
first_page Het paginanummer van de eerste pagina van de weergaveresultaten. Dit is 1, tenzij er geen resultaten zijn geretourneerd; in dat geval is het null.
Id De GUID-ID van de Power Apps-weergave die deze entityview definieert.
language_code De Power Apps-taalcode als een geheel getal, die wordt gebruikt om lokaliseerde labels voor de huidige weergave te laden.
last_page Het paginanummer van de laatste pagina van de weergaveresultaten. Als er geen resultaten zijn geretourneerd, is dit null.
naam De naam van de Power Apps-weergave waarmee deze dit entityview wordt gedefinieerd, bijvoorbeeld Actieve contactpersonen.
next_page Het paginanummer van de volgende pagina van de weergaveresultaten. Als er geen is volgende pagina met resultaten is, is dit null.
Pagina Het paginanummer van de huidige pagina van de weergaveresultaten.
pages Retourneert een matrix van paginanummers, die alle pagina's met resultaten voor de huidige weergave bevat.
page_size Het aantal resultaten dat per pagina wordt geretourneerd voor de huidige weergave.
previous_page Het paginanummer van de volgende pagina van de weergaveresultaten. Als er geen vorige pagina met resultaten is, is dit null.
primary_key_logical_name De logische naam in Power Apps van het primaire-sleutelkenmerk van de resultaattabel voor deze weergave. Bijvoorbeeld contactid.
records De huidige pagina met resultaatrecords voor de weergave, als tabelobjecten.
sort_expression De standaardsorteerexpressie voor de weergave. Bijvoorbeeld nameASC, createdon DESC.
total_pages Het totale aantal resultaatpagina's van de weergave.
total_records Het totale aantal resultaten s van de weergave (van alle pagina's).

gebeurtenissen

Biedt de mogelijkheid om gebeurtenissen te openen en weer te geven. Het object events stelt u in staat een specifieke gebeurtenis of alle gebeurtenissen te selecteren.

Object events

Het object events geeft u toegang tot elke specifieke gebeurtenis in de portal, of tot alle gebeurtenissen in de portal (ongeacht de gebeurtenis).

Het object events heeft de volgende kenmerken:

Kenmerk Beschrijving
occurences Retourneert een eventoccurencesobject dat alle gebeurtenisexemplaren in de portal bevat
[naam of id van gebeurtenis] U kunt elke gebeurtenis openen op basis van de eigenschappen voor naam of id.
{% assign event = events["Naam gebeurtenis"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Object event

Door middel van het object event kunt u werken met één gebeurtenis, zodat u toegang hebt tot de planningen en exemplaren van die gebeurtenis.

Het object event heeft de volgende kenmerken:

Kenmerk Beschrijving
aantal keer Retourneert een eventoccurencesobject dat alle gebeurtenisexemplaren bevat.
naam De naam van de gebeurtenis.
URL De URL van de gebeurtenis.

Object eventoccurences

Het object eventoccurrences geeft u toegang tot een verzameling objecten van gebeurtenisexemplaren. U kunt de gebeurtenisexemplaren sorteren en datumbereik voor de exemplaren opgeven die u wilt laten ophalen, en ook paginering laten uitvoeren en Liquid-filters gebruiken

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

houd er rekening mee dat

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

ook mogelijk is.

De volgende kenmerken zijn gekoppeld aan het object eventoccurrences

Kenmerk Beschrijving
Alle Retourneert alle eventoccurrence-objecten in de verzameling.

Object eventoccurence

Vertegenwoordigt een enkel gebeurtenisexemplaar. De bijbehorende kenmerken worden hieronder opgegeven:

Kenmerk Beschrijving
URL De URL van het exemplaar.
is_all_day_event Is dit een gebeurtenis die een hele dag duurt?
start_time De begintijd van de gebeurtenis.
end_time De eindtijd van de gebeurtenis.

forloop

Bevat eigenschappen die nuttig zijn in een for-lusblok.

Notitie

forloop kan alleen binnen een for-code worden gebruikt.

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

Uitvoer

This is the first child page!

This is child page number 2.

This is child page number 3.

Kenmerken

Kenmerk Beschrijving
Eerste Retourneert true als dit de eerste iteratie in de lus is. Retourneert false als dit niet de eerste iteratie is.
index De positie van het huidige item in de verzameling, waarbij het eerste item de positie 1 heeft.
index0 De positie van het huidige item in de verzameling, waarbij het eerste item de positie 0 heeft.
Laatste Retourneert true als dit de laatste iteratie in de lus is. Retourneert false als dit niet de laatste iteratie is.
length Retourneert het aantal iteraties voor de lus ߝ het aantal items in de verzameling waarover de iteratie plaatsvindt.
rindex Aantal resterende items in de lus (lengte - index) waar 1 de index van het laatste item is.
rindex0 Aantal resterende items in de lus (lengte - index) waar 0 de index van het laatste item is.

forums

Biedt de mogelijkheid om forums en forumthreads te openen en weer te geven. U kunt forumgegevensuitbreidingen naar berichten weergeven met Liquid, maar om een nieuw bericht of een nieuwe thread te maken moet u een ASP.NET-paginasjabloon voor formulieren voor meerdere stappen met genoemde ingebouwde functies gebruiken (zoals de standaardforumthread en de forumberichtpaginasjablonen).

Met het forumobject kunt u een forum of forumthreads selecteren:

<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-object

Met het forums-object kunt u toegang krijgen tot elk specifiek forum in de portal of toegang tot alle forumthreads in de portal (ongeacht het forum).

Met het object forum kunt u werken met één forum, zodat u toegang kunt krijgen tot de threads voor dat forum.

Met het forumthreads-object kunt u toegang krijgen tot een verzameling forumthreadobjecten. U kunt de forumthreads ordenen en paginering toepassen, maar u kunt ook Liquid-filters gebruiken.

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

Eén forumthread

Met het forumposts-object hebt u toegang tot een verzameling forumberichtobjecten.

Kenmerken

Kenmerk Beschrijving
threads Retourneert een forumthreads-object dat alle forumthread-objecten in de portal bevat.
Alle Retourneert alle forum-objecten in de portal. website.forums is ook een equivalent.
thread_count Retourneert het gehele getal voor het aantal threads in de gehele website.
post_count Retourneert het gehele getal van het totale aantal berichten in de portal.
[forum name or id] U kunt elke forum openen op basis van de eigenschappen voor naam of id.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Object forum

Kenmerken

Notitie

entities

Kenmerk Omschrijving
threads Retourneert een forumthreads-object dat alle forumthreads voor het forum bevat.
Naam De naam van het forum.
thread_count Retourneert het gehele getal voor het aantal threads in het forum.
post_count Retourneert het gehele getal voor het aantal berichten in het gehele forum.

Object forumthreads

Kenmerken

Kenmerk Beschrijving
Alle Retourneert alle forumthread-objecten in de verzameling.

Object forumthread

Kenmerken

Notitie

entities

Kenmerk Beschrijving
posts Retourneert een forumposts-object dat alle forumberichten voor de thread bevat.
author Retourneert de auteur van de thread (dit is simpelweg een object van de contactpersoontabel).
latest_post Retourneert het laatste bericht in de thread.
first_post Retourneert het eerste bericht in de thread.
post_count Retourneert het gehele getal voor het aantal berichten in de thread.
is_answered Is de thread beantwoord of niet?
is_sticky Is de thread een sticky thread?

Object forumposts

Kenmerken

Kenmerk Beschrijving
Alle Retourneert alle forumthread-objecten in de verzameling.

Eén forumbericht

Kenmerken

Notitie

entities

Kenmerk Beschrijving
author Retourneert de auteur van het bericht (dit is simpelweg een object van de contactpersoontabel).
content De inhoud van het bericht.
is_answer Is dit bericht een antwoord op de thread?

knowledge

Biedt toegang tot Power Apps-records voor Knowledge Base-artikelen en categorietabellen om artikelen en categorieën in een portal weer te geven.

Kenmerken

Kenmerk Beschrijving
artikelen Retourneert een articles-object met artikelobjecten voor de tabelrecords voor Knowledge Base-artikelen die beschikbaar zijn in de portal.
categorieën Retourneert een categories-object met categorieobjecten voor de tabelrecords voor categorieën die beschikbaar zijn in de portal.

articles-object

Met het articles-object hebt u toegang tot een verzameling artikelobjecten. U kunt de artikelen ordenen en paginering toepassen, maar u kunt ook Liquid-filters gebruiken.

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

Kenmerken

Kenmerk Beschrijving
popular Retourneert een verzameling artikelobjecten die de meeste weergaven bevatten. {% assign popular_articles = knowledge.articles.popular %}
recent Retourneert een verzameling artikelobjecten die de laatste wijzigingsdatum bevatten. {% assign recent_articles = knowledge.articles.recent %}
top Retourneert een verzameling artikelobjecten die de hoogste beoordeling bevatten. {% assign top_articles = knowledge.articles.top %}

Filters

De volgende filters kunnen optionele parameters voor paginaformaat en taal accepteren. De eerste parameter is het aantal records dat moet worden opgehaald. Het standaardpaginaformaat is 5. De tweede parameter is de code van een taal om artikelen voor een bepaalde taal op te halen. Filters kunnen worden gecombineerd met andere Liquid-filters.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Kenmerk Beschrijving
popular Retourneert een verzameling artikelobjecten die de meeste weergaven bevatten. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recent Retourneert een verzameling artikelobjecten die de laatste wijzigingsdatum bevatten. {% assign recent_articles = knowledge.articles \| recent: 5 %}
top Retourneert een verzameling artikelobjecten die de hoogste beoordeling bevatten. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

categories-object

Met het categories-object kunt u toegang krijgen tot een verzameling categorieobjecten. U kunt de categorieën ordenen en paginering toepassen, maar ook Liquid-filters gebruiken.

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

Kenmerken

Kenmerk Beschrijving
recent Retourneert een verzameling categorieobjecten die de laatste wijzigingsdatum bevatten.
top_level Retourneert een verzameling categorieobjecten die geen bovenliggende categorie hebben.

Filters

De volgende filters kunnen een optionele parameter accepteren waarmee het paginaformaat wordt aangegeven. Het standaardpaginaformaat is 5. Filters kunnen worden gecombineerd met andere Liquid-filters.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Kenmerk Beschrijving
recent Retourneert een verzameling categorieobjecten die de laatste wijzigingsdatum bevatten. U kunt ook parameters {% assign recent_categories = knowledge.categories \| recent: 10 %} opgeven
top_level Retourneert een verzameling categorieobjecten die geen bovenliggende categorie hebben. {% assign root_categories = knowledge.categories \| top_level %}

article-object

Met het artikelobject kunt u werken met één Knowledge Base-artikel om details van dat artikel in de portal weer te geven.

Kenmerken

article is een entity-object, met alle zelfde kenmerken, naast de kenmerken die hieronder worden genoemd.

Kenmerk Beschrijving
article_public_number Het openbare nummer van het artikel.
comment_count Retourneert de waarde (geheel getal) van het aantal opmerkingen voor een bepaald artikel.
content De inhoud van het artikel.
current_user_can_comment Retourneert een Booleaanse waarde waarmee wordt aangegeven of de huidige gebruiker opmerkingen in het artikel kan toevoegen.
is_rating_enabled Retourneert een Booleaanse waarde waarmee wordt aangegeven of beoordeling voor een artikel is ingeschakeld.
keywords De trefwoorden in het artikel.
naam Een alternatieve alias voor de titel van het artikel.
rating De decimale beoordelingswaarde in het artikel.
title De titel van het artikel.
view_count Het gehele getal voor het aantal keren dat het artikel is weergegeven.

category object

Met het categorieobject kunt u werken met één categorie om details van die categorie in de portal weer te geven.

Kenmerken

category is een entity-object, met alle zelfde kenmerken, naast de kenmerken die hieronder worden genoemd.

Kenmerk Beschrijving
categorynumber Het categorienummer van de categorie.
naam Een alternatieve alias voor de titel van de categorie.
titel De titel van de categorie.

taal

Biedt de huidige taalnaam en taalcode als ondersteuning in meerdere talen is ingeschakeld.

Kenmerken

Kenmerk Beschrijving
url De huidige aanvraag-URL, voorafgegaan door de huidige taalcode.
url_substitution De huidige aanvraag-URL, voorafgegaan door de huidige taalcode, omzeilt de pagina-uitvoercache.
naam Titel van de huidige taal.
code De taalcode van de taal.

Bijvoorbeeld de websjabloon Vervolgkeuzelijst voor talen gebruikt standaard dit Liquid-object om de beschikbare talen weer te geven wanneer er meerdere talen beschikbaar zijn.

pagina

Verwijst naar de huidige aanvraagpagina in de portal. Dit object combineert de kenmerken van het siteoverzicht en de huidige aanvraag entiteiten (gewoonlijk een webpagina).

Het object page biedt toegang tot items zoals de breadcrumbs voor de huidige pagina, de titel of URL van de huidige pagina en alle andere kenmerken of gerelateerde entiteiten van de onderliggende Power Apps-record.

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

Paginakenmerken

Notitie

entities

Kenmerk Beschrijving
breadcrumbs Retourneert de breadcrumb-knooppuntobjecten van het siteoverzicht voor de pagina, te beginnen bij het hoofdknooppunt van het siteoverzicht en eindigend bij het bovenliggende knooppunt.
children Retourneert de onderliggende knooppuntobjecten van het siteoverzicht van de pagina.
bovenliggende Retourneert het bovenliggende siteoverzichtknooppunt van de pagina. Als de pagina de startpagina is, is het bovenliggende element null.
title De titel van de pagina.
URL Typ de URL van de .
[attribute or relationship name] U kunt toegang krijgen tot elk kenmerk van de onderliggende Power Apps-record van de pagina op basis van logische naam.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
De waarden van de meeste tabelkenmerken zijn rechtstreeks toegewezen aan Liquid-typen: Twee Optie-velden zijn toegewezen aan booleanse waarden, tekstvelden aan tekenreeksen, numerieke velden of valutavelden aan getallen, datum- en tijdvelden aan datumobjecten. Maar bepaalde typen kenmerken worden geretourneerd als objecten:
  • Opzoekvelden (gekoppelde tabelverwijzing) worden geretourneerd als gekoppelde tabelverwijzingsobjecten.
  • Optieset-/selectielijstvelden worden geretourneerd als optiesetwaardeobjecten.
    • U kunt ook alle gerelateerde entiteiten laden via de naam van het relatieschema.
    {{ page.adx_webpage_entitylist.adx_name }}
    In het geval van een reflexieve relatie (dat wil zeggen: zelfverwijzend) wordt een entities-object geretourneerd. Anders zou het resultaat dubbelzinnig zijn.{{ page.adx_webpage_webpage.referencing.adx_name }}
    Opmerking: als u grote aantallen gerelateerde entiteiten laadt, of grote aantallen relaties in een enkele sjabloon opvraagt, kan dit een negatieve invloed hebben op de prestaties van sjabloonweergave. Het wordt afgeraden om gerelateerde entiteiten te laden voor elk item in een matrix, in een lus. Gebruik waar mogelijk de Power Apps Dataverse-tabeltags om verzamelingen van entiteiten te laden.

polls

Biedt de mogelijkheid om een peiling te openen en weer te geven.

Met het object polls kunt u een specifieke peiling of de plaatsing van een peiling selecteren:

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

Kenmerken voor peilingen

Kenmerk Beschrijving
placements Retourneert het object pollplacements.
[poll name or id] U kunt elke peiling openen op basis van de naam- of ID-eigenschappen ervan. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Kenmerken voor peilingsplaatsingen

Kenmerk Beschrijving
[poll placement name or id] U kunt elke peilingsplaatsing op basis van naam- of id-eigenschappen openen.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Kenmerken voor peilingsplaatsingen

Notitie

entities

Kenmerk Beschrijving
Naam Retourneert het veld Naam voor de peilingsplaatsing.
placement_url De URL die kan worden gebruikt om de peilingsplaatsing op te halen die volledig door een sjabloon wordt weergegeven.
polls Retourneert de verzameling peilingsobjecten die aan de plaatsing zijn gekoppeld. Iteratiecodes en Matrixfilters kunnen bij deze verzameling worden gebruikt.
random_url De URL die kan worden gebruikt om een willekeurige peiling van de plaatsing op te halen die volledig door een sjabloon wordt weergegeven.
submit_url De URL waarnaar een voltooide peiling wordt verzonden.

Kenmerken voor peilingen

Notitie

entities

Kenmerk Beschrijving
has_user_voted Retourneert waar als de huidige gebruiker (aangemeld of anoniem) al een stem heeft uitgebracht in deze peiling.
Naam Retourneert het veld Naam voor de peiling.
Opties Retourneert de verzameling peilingsoptieobjecten die aan de peiling zijn gekoppeld. Iteratie-codes en entiteiten kunnen bij deze verzameling worden gebruikt.
poll_url De URL die kan worden gebruikt om de peiling op te halen die volledig door een sjabloon wordt weergegeven.
-vraag Retourneert het veld Vraag voor de peilingen.
submit_button_label Retourneert een tekenreeks die kan worden gebruikt om het label van de knop Indienen voor de peiling te negeren.
submit_url De URL waarnaar een voltooide peiling wordt verzonden.
user_selected_option Retourneert het peilingsoptieobject dat door gebruikers is geselecteerd (als ze al hebben gestemd).
votes Retourneert het aantal stemmen dat in tabellen voor de peiling wordt weergegeven.

Kenmerken voor peilingsopties

Notitie

entities

Kenmerk Beschrijving
answer Retourneert het veld Antwoord voor de peiling.
percentage Retourneert het percentage stemmen in de peiling voor de optie als decimaal getal van 0 t/m 100.
votes Retourneert het aantal stemmen dat in tabellen voor de optie wordt weergegeven.

aanvraag

Bevat informatie over het huidige HTTP-verzoek.

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

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

Notitie

  • U kunt URL's dynamisch maken in Liquid met URL-filters.
  • De URL die in request.url wordt gebruikt, kan elke gevraagde waarde zijn en wordt opgehaald in de cache voor volgende aanvragen. Om de juiste waarde bij request.url te garanderen, overweeg dan vervangende tag te gebruiken, een gedeeltelijke URL, zoals ~{WebFile path} of de portal-URL op te slaan in Site-instellingen.
  • Power Apps-portalsversie 9.3.8.x of later zal standaard escape-Liquid-filter hebben afgedwongen voor gebruiker en aanvraag-Liquid-objecten. Om deze standaardconfiguratie uit te schakelen en deze Liquid-objecten toe te staan zonder escape-Liquid-filter, zie portalsite-instellingen - Site/EnableDefaultHtmlEncoding.

Kenmerken

Kenmerk Beschrijving
params Benoemde parameterwaarden voor het huidige verzoek. params is een combinatie van URL-querytekenreeksparameters, POST-parameters voor formulieren en cookies.
Pad Het pad van de huidige aanvraag-URL.
/profile/
path_and_query Het pad en de query van de huidige aanvraag-URL.
/profile/?foo=1&bar=something
query Het query-gedeelte van de huidige aanvraag-URL.
?foo=1&bar=something
URL De volledige URL van de huidige aanvraag.
https://www.example.com/profile/?foo=1&bar=something

searchindex

Het object searchindex wordt in de Power Apps Dataverse-tabeltags gebruikt en biedt toegang tot de resultaten van een query.

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

Kenmerken

Kenmerk Beschrijving
approximate_total_hits Retourneert een telling bij benadering van het totale aantal treffers die overeenkomen met de indexquery. Als gevolg van de manier waarop de zoekindex werkt met betrekking tot beveiligingsfiltering en met betrekking tot andere ontwerpfactoren, is dit aantal slechts een benadering en komt het mogelijk niet exact overeen met het totale aantal resultaten dat in sommige situaties beschikbaar is voor de huidige gebruiker.
Pagina Retourneert het paginanummer van de huidige query.
page_size Retourneert de maximale paginagrootte van de huidige query. Als u wilt dat het werkelijke aantal resultaten wordt geretourneerd voor de huidige pagina (aangezien dit minder kan zijn dan de opgegeven maximale paginagrootte), moet u results.size gebruiken.
Resultaten Retourneert de pagina met queryresultaten, als resultaatobjecten van de zoekindex.

Zoekindexresultaten

Kenmerk Beschrijving
entiteit De onderliggende entities voor het resultaat.
fragment Een relevant kort tekstfragment voor het resultaat met voorwaarden die overeenkomen met de opgegeven query gemarkeerd met de HTML-tag van <em>. Bepaalde typen van query's ondersteunen geen gemarkeerde fragmenten, zoals fuzzy query's (~) en jokertekenquery´s (*). Deze eigenschap is null in deze gevallen.
ID De id van de Power Apps-tabel van de onderliggende record voor het resultaat in de vorm van een tekenreeks. Bijvoorbeeld 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name De logische naam van de Power Apps-tabel van de onderliggende record voor het resultaat. Bijvoorbeeld adx_webpage
Nummer Het nummer van het resultaat voor alle resultaatpages, beginnend met 1. Voor het eerste resultaat van de tweede pagina met resultaten met een paginagrootte van 10, is deze waarde bijvoorbeeld 11.
score De Lucene-score van het resultaat in de vorm van een waarde met een drijvende komma. Resultaten worden geretourneerd in de volgorde bepaald door deze waarde.
title De titel van het resultaat.
URL De URL voor het resultaat. Dit is meestal—maar niet noodzakelijkerwijs—een absoluut pad voor de huidige toepassing in plaats van een volledige URL. Bijvoorbeeld: /articles/article1/

instellingen

Hiermee kunt u elke site-instelling op naam laden. Als een instelling met de opgegeven naam niet wordt gevonden, wordt null geretourneerd.

Notitie

Instellingen worden geretourneerd als tekenreeksen, maar u kunt Typefilters gebruiken om ze naar andere typen te converteren.

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

Notitie

Een websitekoptekst en een primaire navigatiebalk weergeven

siteoverzicht

Geeft toegang tot het siteoverzicht van de portal.

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

Siteoverzichtkenmerken

Kenmerk Beschrijving
Huidig Retourneert het knooppuntobject van het siteoverzicht voor de huidige pagina.
Hoofdniveau Retourneert het knooppuntobject van het siteoverzicht voor de hoofdpagin (startpagina) van de website.

Kenmerken van het siteoverzichtknooppunt

Kenmerk Beschrijving
Broodkruimels Retourneert de breadcrumb-knooppuntobjecten van het siteoverzicht voor het knooppunt, te beginnen bij het hoofdknooppunt van het siteoverzicht en eindigend bij het bovenliggende knooppunt.
Onderliggend Retourneert de onderliggende knooppuntobjecten van het siteoverzicht van het knooppunt.
Beschrijving De inhoud van de beschrijving/samenvatting van het knooppunt. (Dit veld kan HTML bevatten).
Entiteit Retourneert de onderliggende entities van het knooppunt. Als het knooppunt geen onderliggende tabel heeft, wordt deze waarde null.
is_sitemap_ancestor Retourneert true als het siteoverzichtknooppunt een bovenliggend element van het huidige knooppunt is, anders wordt false geretourneerd.
is_sitemap_current Retourneert true als het siteoverzichtknooppunt het huidige knooppunt is, anders wordt false geretourneerd.
Bovenliggend Retourneert het bovenliggende siteoverzichtknooppunt van het knooppunt. Als het knooppunt het hoofdknooppunt is, dan is het bovenliggende knooppunt null.
Functie De titel van het knooppunt.
URL De URL van het knooppunt.

sitemarkers

Hiermee kunt u elke sitemarkering op basis van naam laden. Als de sitemarkering bestaat, wordt een sitemarkeringsobject geretourneerd. Als een sitemarker met de opgegeven naam niet wordt gevonden, wordt null geretourneerd.

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

Notitie

Een websitekoptekst en een primaire navigatiebalk weergeven

Sitemarkeringskenmerken

Kenmerk Beschrijving
URL De URL van het sitemarkeringsdoel.
[attribute logical name] U kunt toegang krijgen tot elk kenmerk van de Power Apps-doelrecord van de sitemarkering op basis van logische naam. Bijvoorbeeld {{ sitemarker.adx_name }}

snippets

Hiermee kunt u inhoudfragmenten op basis van naam laden. Als een fragment met de opgegeven naam niet wordt gevonden, wordt null geretourneerd.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Bevat eigenschappen die nuttig zijn in een Iteratiecodes-lusblok.

Notitie

tablerowloop kan alleen binnen een Iteratiecodes-code worden gebruikt.

Kenmerken

Kenmerk Beschrijving
Col Retourneert de index van de huidige rij die begint met 1.
col0 Retourneert de index van de huidige rij die begint met 0.
col_first Retourneert true als de huidige kolom de eerste kolom in een rij is, en retourneert false als dat niet het geval is.
col_last Retourneert true als de huidige kolom de laatste kolom in een rij is, en retourneert false als dat niet het geval is.
Eerste Retourneert true als dit de eerste iteratie in de lus is. Retourneert false als dit niet de eerste iteratie is.
Index De positie van het huidige item in de verzameling, waarbij het eerste item de positie 1 heeft.
index0 De positie van het huidige item in de verzameling, waarbij het eerste item de positie 0 heeft.
Laatste Retourneert true als dit de laatste iteratie in de lus is. Retourneert false als dit niet de laatste iteratie is.
Lengte Retourneert het aantal iteraties voor de lus ߝ het aantal items in de verzameling waarover de iteratie plaatsvindt.
Rindex Aantal resterende items in de lus (lengte - index) waar 1 de index van het laatste item is.
rindex0 Aantal resterende items in de lus (lengte - index) waar 0 de index van het laatste item is.

Gebruiker

Verwijst naar de huidige portalgebruiker, en geeft daarmee toegang tot alle kenmerken van de onderliggende Power Apps-contactpersoonrecord. Als er geen gebruiker is aangemeld, is deze variabele null.

user is een entiteit object.

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

Notitie

Power Apps-portalsversie 9.3.8.x of later zal standaard escape-Liquid-filter hebben afgedwongen voor gebruiker en aanvraag-Liquid-objecten. Om deze standaardconfiguratie uit te schakelen en deze Liquid-objecten toe te staan zonder escape-Liquid-filter, zie portalsite-instellingen - Site/EnableDefaultHtmlEncoding.

Kenmerken

Naast alle kenmerken van een entity-object heeft user de volgende kenmerken.

Kenmerk Beschrijving
rollen Retourneert de rollen waartoe de gebruiker behoort, als een matrix.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Notitie: U kunt het filter ook has_role gebruiken om te testen op individule lidmaatschappen van rollen.
basic_badges_url Retourneert de service-url voor het ophalen van gebruikersbadges.
Om badges te renderen voor een gebruiker, moet u een code opnemen met de kenmerken "data-badge" en "data-uri". Badges van de huidige gebruiker renderen:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
De badges van een gebruiker renderen op id (variabele user-ID):
`<div data-badge data-uri='{{user.basic_badges_url

Hiermee kunt u alle weblinks laden op naam of id.

Als de webkoppelingsset bestaat, wordt een webkoppelingssetobject geretourneerd. Als een webkoppelingsset met de opgegeven naam of id niet wordt gevonden, wordt null geretourneerd.

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

Notitie

Een websitekoptekst en een primaire navigatiebalk weergeven |

Kenmerken van webkoppelingssets

Notitie

Een webkoppelingset is een entity-object, met alle zelfde kenmerken, naast de kenmerken die hieronder worden genoemd.

Kenmerk Beschrijving
Kopie De HTML-berichttekst van de webkoppelingsset.
Naam De naam van de webkoppelingsset.
Functie De titel van de webkoppelingsset.
Webkoppelingen De matrix van de objecten uit de webkoppelingsset die zijn gekoppeld aan de webkoppelingsset.
[attribute logical name] U krijgt toegang tot elk kenmerk van de Power Apps-record van de webkoppelingsset op basis van logische naam. Bijvoorbeeld {{ weblinkset.createdon }}

Kenmerken van webkoppelingen

Notitie

Een webkoppeling is een entity-object, met alle zelfde kenmerken, naast de kenmerken die hieronder worden genoemd.

Kenmerk Beschrijving
Beschrijving De HTML-beschrijving van de webkoppelingsset.
display_image_only Een booleaans kenmerk dat aangeeft of de webkoppeling alleen moet worden weergegeven als afbeelding, zonder koppelingstekst.
display_page_child_links Een booleaans kenmerk dat aangeeft of de webkoppeling koppelingen moet weergeven naar de onderliggende sitemap-pagina´s van de gekoppelde pagina, zoals subkoppelingen.
Afbeelding Het webkoppelingafbeeldingsobject voor deze koppeling. Dit kenmerk is null als geen afbeelding aanwezig is.
is_external Een booleaans kenmerk dat aangeeft of de doel-URL van de webkoppeling leidt naar een externe site, in plaats van naar een interne portalpagina.
is_sitemap_ancestor Retourneert true als de URL van de webkoppeling verwijst naar een bovenliggend element van het huidige siteoverzichtknooppunt, anders wordt false geretourneerd.
is_sitemap_current Retourneert true als de URL van de webkoppeling verwijst naar het huidige siteoverzichtknooppunt, anders wordt false geretourneerd.
Naam De naam/titel van de webkoppeling.
Nofollow Een booleaans kenmerk dat aangeeft of de webkoppeling moet worden gemarkeerd als rel=nofollow.
open_in_new_window Een booleaans kenmerk dat aangeeft of de webkoppeling moet worden geopend in een nieuw browservenster/-tabblad wanneer deze wordt geselecteerd.
Knopinfo Knopinfotekst voor de webkoppeling.
URL De URL van de webkoppeling.
Webkoppelingen De matrix van de onderliggende webkoppelingobjecten die zijn gerelateerd aan de webkoppeling.
[attribute logical name] U krijgt toegang tot elk kenmerk van de Power Apps-record van de webkoppeling op basis van logische naam. Bijvoorbeeld {{ weblink.createdon }}

Kenmerken van webkoppelingsafbeeldingen

alternate_text De Alt-tekst voor de afbeelding.
Hoogte Geheel getal dat de opgegeven hoogte van de afbeelding bevat. Als er geen waarde voor de hoogte is opgegeven, is dit kenmerk null.
URL De URL van de afbeelding.
Breedte Geheel getal dat de opgegeven breedte van de afbeelding bevat. Als er geen waarde voor de breedte is opgegeven, is dit kenmerk null.

website

Verwijst naar de website van de portal, en geeft daarmee toegang tot alle kenmerken van de Power Apps-websiterecord (adx_website) voor de portal.

Notitie

Website is een entiteit-object met allemaal dezelfde kenmerken.

Code

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

Uitvoer

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

Kenmerken

De volgende tabel geeft een overzicht van de kenmerken voor deze code die kunnen worden gebruikt om de standaardwaarden te vervangen om caching te voorkomen.

Standaardinstelling Substitute (voorkomt caching) Voorbeeld
sign_in_url sign_in_url_substitution Standaard: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Substitution (voorkomt caching): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("substitute-page" in dit voorbeeld vervangt de standaard gecachte URL.)
sign_out_url sign_out_url_substitution Standaard: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Substitution (voorkomt caching): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("substitute-page" in dit voorbeeld vervangt de standaard gecachte URL.)

Zie ook

Liquid-typen
Liquid-codes
Liquid-filters

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).