Liquid-objekter

Liquid-objekter indeholder attributter til at producere dynamisk indhold til siden. For eksempel har pageobject har en attribut med navnet title, der kan bruges til at udskrive titlen på den aktuelle side.

Brug et punkttegn til at få adgang til en objektattribut efter navn. For at gengive et objekts attribut i en skabelon skal du ombryde den i {{ og }}.

{{ page.title }}

Du kan også få adgang til attributterne for et objekt ved hjælp af et strengnavn og []. Dette er nyttigt i tilfælde, hvor den ønskede attribut bestemmes dynamisk, eller attributnavnet indeholder tegn, mellemrum, specialtegn osv., der ville være ugyldige ved brug af . syntaksen.

{{ page["title"] }}

{% assign attribute_name = "Name with spaces" %}

{{ object[attribute_name] }}

Følgende objekter kan bruges og bruges overalt i enhver skabelon.

Objekt Beskrivelse
entities Gør det muligt at indlæse ethvert Dynamics 365-objekt efter id. Flere oplysninger: entities
now Dato og klokkeslætsobjekt, der refererer til den aktuelle UTC-tid, på tidspunktet, hvor skabelonen blev gengivet. Flere oplysninger: Datofiltre
page Refererer til den aktuelle anmodningsside i portalen. Objektet page giver adgang til ting som brødkrummerne for den aktuelle side, titel eller URL-adresse på den aktuelle side og eventuelle andre attributter eller relaterede objekter i den underliggende Dynamics 365-post. Flere oplysninger: page
params En nem genvej til request.params. Flere oplysninger: request
request Indeholder oplysninger om den aktuelle HTTP-anmodning. Flere oplysninger: request
settings Gør det muligt at indlæse en webstedsindstilling efter navn. Flere oplysninger: settings, Konfigurere webstedsindstillinger for portaler
sitemap Giver adgang til oversigten over portalwebstedet. Flere oplysninger: sitemap
sitemarkers Gør det muligt at indlæse webstedsmærker efter navn. Flere oplysninger: sitemarkers
snippets Gør det muligt at indlæse alle indholdskodestykker efter navn. Flere oplysninger: Tilpasse indhold ved hjælp af indholdskodestykker
user Refererer til den aktuelle portalbruger og giver adgang til alle attributter i den underliggende kontaktpersonpost i Dynamics 365. Hvis ingen bruger er logget på, er denne variabel null. Flere oplysninger: Liquid-typer
weblinks Gør det muligt at indlæse et weblinksæt efter navn eller id. Flere oplysninger: weblinks
website Refererer til portalens webstedspost og giver adgang til alle attributter på Dynamics 365-webstedsposten (adx_website) for portalen. Flere oplysninger: website

Alle Liquid-objekter

ads

blogs

entities

entitylist

entityview

events

forloop

forums

page

polls

request

searchindex

settings

sitemap

sitemarkers

snippets

tablerowloop

user

weblinks

website

ads

Giver mulighed for at få adgang til og gengive en reklame.

Med ads-objektet kan du vælge en bestemt reklame eller reklameplacering.

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

Reklameattributter

Attribut Beskrivelse
placements Returnerer objektet adplacements.
[ad-navn eller -id] Du kan få adgang til enhver reklame ud fra dens navn eller id-egenskaber.
{% assign ad = ads["Ad Name"] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Attributter for reklameplaceringer

Attribut Beskrivelse
[ad placement-navn eller -id] Du kan få adgang til en adplacement ud fra dets navn eller id-egenskaber.
{% assign placement = ads.placements["Placement Name or Id"] %}
{% assign placement = ads.placements["2423d713-abb3-44c3-8a7d-c445e16fccad"] %}

Attributter for reklameplacering

En ad placement er et objekt med de samme attributter samt dem, der er angivet nedenfor.

Attribut Beskrivelse
Ads Returnerer samlingen af reklameobjekter, der er knyttet til placeringen. Gentagelsesmærker og Matrixfiltre kan bruges sammen med denne samling.
Name Returnerer feltet Navn for reklameplaceringen.
placement_url Den URL-adresse, der kan bruges til at hente reklameplaceringen fuldt gengivet af en skabelon.
random_url Den URL-adresse, der kan bruges til at hente en vilkårlig reklame fra placeringen, der er fuldt gengivet af en skabelon.

Reklameattributter

Bemærk

En ad er et objekt af typen entity med de samme attributter samt dem, der er angivet nedenfor.

Attribut Beskrivelse
ad_url Den URL-adresse, der kan bruges til at hente reklamen fuldt gengivet af en skabelon.
Kopier Returnerer feltet Kopiér for reklamen.
image Returnerer billedobjektet (hvis relevant) for reklamen.
Navn Returnerer feltet Navn for reklamen.
open_in_new_window Returnerer true, hvis den URL-adresse, der er angivet af redirect_url, skal åbnes i et nyt vindue.
redirect_url Den URL-adresse, som brugeren videresendes til ved at klikke på reklamen.

Attributter for reklamebillede

Attribut Beskrivelse
alternate_text Returnerer den tekst, der skal vises i mærkets alt-attribut.
height Returnerer højden i pixel på billedet
url Returnerer URL-adressen på kilden til billedet.
width Returnerer bredden i pixel på billedet

blogs

Giver mulighed for at få adgang til og gengive Blogs og Blogopslag.

Med blogs-objektet kan du vælge en bestemt blog eller blogopslag.

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

Objektet blogs

Objektet blogs giver dig adgang til en bestemt blog på portalen eller til alle blogopslag på portalen (uanset bloggen).

I følgende tabel beskrives de attributter, der er knyttet til blogs-objektet.

Attribut Beskrivelse
posts Returnerer et blogposts-objekt, der indeholder alle blogopslag på portalen.
[blog-navn eller -id] Du kan få adgang til enhver blog ud fra dens navn eller id-egenskaber.
{% assign blog = blogs["Blog Name"] %}                             

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

Objektet blog

Objektet blog gør det muligt at arbejde med en enkelt blog, så du kan få adgang til opslagene for denne blog.

I følgende tabel beskrives de forskellige attributter, der er knyttet til blog-objektet.

Attribut Beskrivelse
posts Returnerer et blogposts-objekt, der indeholder alle blogopslag for bloggen.
Name Navnet på bloggen.
title Titlen på bloggen.
url URL-adressen til bloggen.

Objektet blogposts

Objektet blogposts giver dig adgang til en samling af blogopslagsobjekter. Du kan bestille blogopslagene og gennemføre sideinddeling samt ved hjælp af flydende filtre:

{% assign blogposts = blogs.posts | order_by “adx_name”, “desc” | paginate: 0,4 | all %} Bemærk, at blogs.posts.all også er en gyldig måde at få alle blogopslag blogs.posts | fra_index: 0 | take: 2 er også mulig

I følgende tabel beskrives de forskellige attributter, der er knyttet til blogposts-objektet.

Attribut Beskrivelse
All Returnerer alle blogpost-objekter i samlingen.

Objektet blogposts

Refererer til et enkelt blogopslag.

I følgende tabel beskrives de forskellige attributter, der er knyttet til blogpost-objektet.

Attribut Beskrivelse
url Opslagets URL-adresse.
content Returnerer indholdsfeltet for opslaget.
content Returnerer feltet Indhold for opslaget.
author Returnerer forfatteren til opslaget (som blot er et objekt af typen kontaktobjekt).
title Titlen på opslaget.
comment_count Returnerer heltalsværdien for optællingen af, hvor mange kommentarer der er for et givet opslag.
publish_date Den dato, hvor opslaget blev publiceret.

entities

Gør det muligt at indlæse ethvert Dynamics 365-objekt efter id. Hvis objektet findes, returneres et objekt af typen entity. Hvis et objekt med det angivne id ikke findes, returneres Liquid-typer.

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

{% if account %}

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

{% endif %}

{% assign entity_logical_name = 'contact' %}

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

{% if contact %}

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

{% endif %}

Objekt

Et objekt af typen entity giver adgang til attributterne for en objektpost i Dynamics 365.

Attribut Beskrivelse
Id GUID-id'et for et objekt som en streng. f.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Det logiske navn på objektet i Dynamics 365.
Notes Indlæser noter (anmærkninger), der er knyttet til objektet, sorteret fra ældste til nyeste (createdon). Noter returneres som noteobjekter.
permissions Indlæser objekttilladelse-assertionsresultater for objektet. Resultaterne returneres som et tilladelsesobjekt.
URL-adresse Returnerer URL-stien til indholdsstyringssystemet på Dynamics 365-portaler for objektet. Hvis objektet ikke har en gyldig URL-adresse på det aktuelle websted, returneres null. Generelt returnerer dette kun en værdi for bestemte objekttyper, som er blevet integreret i portal-CMS , medmindre du har tilpasset URL-provideren i programmet.
[navn på attribut eller relation] Du kan få adgang til en attribut i Dynamics 365-objektet efter logisk navn. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Værdierne for de fleste objektattributter knyttes direkte til Liquid-typer: To grupperede felter tilknyttes booleske værdier, tekstfelter til strenge og numeriske felter/valutafelter til tal, dato og klokkeslæt-felter til dato-objekter. Men nogle attributtyper returneres som objekter:
  • Opslagsfelter (objektreference) returneres som objektreferenceobjekter.
  • Felter for grupperede indstillinger/valglistefelter returneres som værdiobjekter af typen grupperet indstilling.
  • Du kan også indlæse relaterede objekter efter relationsskemanavn.
  • {{ page.adx_webpage_entitylist.adx_name }}I tilfælde af, at en relation er refleksiv (dvs. refererer til sig selv), returneres et refleksivt relationsobjekt. (Ellers ville det ønskede resultat være flertydigt).{{ page.adx_webpage_webpage.referencing.adx_name }}
    Bemærk! Indlæsning af et stort antal relaterede objekter eller åbning af et stort antal relationer i en enkelt skabelon kan have en negativ indvirkning på skabelonens gengivelsesydeevne. Undgå at indlæse relaterede objekter for hvert element i en matrix i en løkke. Hvor det er muligt, skal du bruge Dynamics 365-objektmærker til at indlæse samlinger af objekter.

Objektreference

Opslagsattributværdier returneres som objektreferenceobjekter med følgende attributter.

Attribut Beskrivelse
Id GUID-id'et for det objekt, der refereres til, som en streng.
f.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Det logiske navn i Dynamics 365 på det objekt, der refereres til.
Name Den primære navneattribut for referenceobjektet.

Note

En note er et objekt, der giver adgang til attributter og relationer i en anmærkningspost. Ud over alle attributterne for et objekt har en note følgende yderligere attributter.

Attribut Beskrivelse
documentbody Indlæser attributten documentbody for noteanmærkningsposten som en Base64-kodet streng. Eftersom indholdet af denne attribut kan være omfattende, indlæses det ikke med resten af noteattributterne og indlæses kun på anmodning.
Bemærk! Brug af documentbody-attributten kan have en negativ effekt på skabelonens ydeevne og skal ske med forsigtighed.
Brug url-attributten til at angive et link til den fil, der er vedhæftet noten, i stedet, hvis det er muligt.
url Returnerer URL-sti til den indbyggede portalfunktion til håndtering af vedhæftet filer i anmærkninger. Hvis brugeren har tilladelse, og noten har en vedhæftet fil, henter en anmodning til denne URL-adresse den vedhæftede fil til noten.
Bemærk

Flere filtre

Værdi for grupperet indstilling

Attributværdier for grupperet indstilling/valglister returneres som objektreferenceobjekter med følgende attributter.

Attribut Beskrivelse
Label Den lokaliserede etiket for attributværdien for grupperet indstilling/valgliste. f.eks. Aktiv
Value Heltalsværdien for attributværdien for grupperet indstilling/valgliste. f.eks. 0

Objekttilladelser

Objektet Objekttilladelser giver adgang til samlede tilladelsesassertionsresultater for et objekt.

Attribut Beskrivelse
can_append Returnerer true, hvis den aktuelle bruger har tilladelse til at føje poster til relationer for denne post. Ellers returneres false.
can_append_to Returnerer true, hvis den aktuelle bruger har tilladelse til at føje denne post til en relation for en anden post. Ellers returneres false.
can_create Returnerer true, hvis den aktuelle bruger har tilladelse til at oprette nye poster for denne objekttype. Ellers returneres false.
can_delete Returnerer true, hvis den aktuelle bruger har tilladelse til at slette denne post. Ellers returneres false.
can_read Returnerer true, hvis den aktuelle bruger har tilladelse til at læse denne post. Ellers returneres false.
can_write Returnerer true, hvis den aktuelle bruger har tilladelse til at opdatere denne post. Ellers returneres false.
rules_exist Returnerer true, hvis tilladelsesresultaterne, som repræsenteres af dette objekt, er resultatet af de udtrykkeligt definerede tilladelsesregler. Returnerer false, hvis de er standardresultaterne, og der ikke foreligger eksplicit definerede tilladelser.

Refleksiv relation

Forsøg på at indlæse refleksive relationer (dvs. relationer, der refererer til sig selv) i objekter returneres som objekter med følgende attributter.

Attribut Beskrivelse
is_reflexive Returnerer true. Kan bruges til at afprøve, om et objekt, der returneres af en relation, er et refleksivt relationsobjekt.
referenced Returnerer en matrix af refererede objekter for den angivne relation.
referencing Returnerer et referenceobjekt for den angivne relation. Returnerer null, hvis der ikke findes et referenceobjekt. Hvis forholdet er mange-til-mange (N:N), returneres en matrix af referenceobjekter.

entitylist

Objektet entitylist bruges i Dynamics 365-objektmærkerne. Det giver adgang til alle attributterne for en bestemt objektliste.

Attributter

Bemærk

entities

Attribut Beskrivelse
create_enabled Returnerer true, hvis oprettelse af nye poster er konfigureret til objektlisten. Ellers returneres false.
create_url Returnerer den konfigurerede URL-adresse for et oprettelseslink/-knap til objektlisten.
detail_enabled Returnerer true, hvis en detaljeret visning til de enkelte poster er konfigureret for objektlisten. Ellers returneres false.
detail_id_parameter Returnerer forespørgselsstrengens parameternavn, som skal bruges til post-id'et under oprettelsen af en URL-adresse til en postdetaljevisning. Se URL-filtre for at få oplysninger om brug af Liquid-filtre til konstruktion af URL-adresser, f.eks. id
detail_label Returnerer den konfigurerede lokaliserede etiket for detaljevisningslinks/-knapper til objektlisten.
detail_url Returnerer den konfigurerede URL-adresse for detaljevisningslinks/-knapper til objektlisten.
empty_list_text Returnerer den konfigurerede oversatte tekst, der skal vises, når objektlistevisningen ikke returnerer nogen resultater.
enable_entity_permissions Returnerer true, hvis filtrering af objekttilladelser er aktiveret for denne objektliste. Ellers returneres false.
entity_logical_name Returnerer Dynamics 365-objektets logiske navn for poster, der skal vises af denne objektliste, f.eks. kontakt
filter_account_attribute_name Returnerer det logiske attributnavnet for det opslag i account, der skal bruges til at filtrere resultatposter efter den aktuelle portalbrugers overordnede firma, f.eks. accountid
filter_apply_label Returnerer den konfigurerede oversatte etiket, der skal bruges til linket/knappen, der anvender et avanceret attributfilter på objektlistens resultater.
filter_definition Returnerer JSON-attributtens filterdefinitionen til objektlisten. Se Objektlistefiltre for at få oplysninger om, hvordan du kan bruge metafilters Liquid-filter til at behandle denne definition.
filter_enabled Returnerer true, hvis avanceret attributfiltrering er aktiveret for objektlisten. Ellers returneres false.
filter_portal_user_attribute_name Returnerer det logiske attributnavnet for det opslag i contact, der skal bruges til at filtrere resultatposter af den aktuelle portalbrugers kontaktperson, f.eks. contactid
filter_website_attribute_name Returnerer det logiske attributnavn for opslaget i adx_website, der skal bruges til at filtrere resultatposter af det aktuelle portalwebsted, f.eks. adx_websiteid
language_code Returnerer den Dynamics 365-sprogkode i heltal, der skal bruges til at vælge alle oversatte etiketter for denne objektliste.
page_size Returnerer størrelsen på den konfigurerede resultatside for objektlisten.
primary_key_name Returnerer den primær nøgleattributs logiske navn for poster, der skal vises af denne objektliste.
search_enabled Returnerer true, hvis søgning er aktiveret for denne objektliste. Ellers returneres false.
search_placeholder Returnerer den konfigurerede oversatte tekst til objektlistens søgefeltpladsholder.
search_tooltip Returnerer den konfigurerede oversatte tekst til objektlistens søgeværktøjstip.
visninger Returnerer de tilgængelige visninger for objektlisten som visningsobjekter for objektlisten.
[logisk navn for attribut] Du kan få adgang til en attribut i objektlistens (adx_entitylist) Dynamics 365-post efter logisk navn på samme måde som et entities, f.eks. {{ entitylist.adx_name }}

Attributter for objektlistevisning

Attribut Beskrivelse
columns Returnerer kolonnerne i visningen som objektlistevisningens kolonneobjekter.
entity_logical_name Returnerer Dynamics 365-objektets logiske navn for de poster, der er medtaget i visningen. f.eks. kontakt
Id Returnerer visningens GUID-id.
language_code Returnerer den Dynamics 365-sprogkode i heltal, der skal bruges til at vælge alle oversatte etiketter (kolonneoverskrifter osv.) til visningen.
Name Returnerer det viste Dynamics 365-navn for visningen.
primary_key_logical_name Returnerer det logiske navn for Dynamics 365-objektets primære nøgle for de poster, der er medtaget i visningen, f.eks. contactid
sort_expression Returnerer standardsorteringsudtrykket for visningen. f.eks. name ASC, createdon DESC

Attributter for kolonner i objektlistevisning

Attribut Beskrivelse
attribute_type Returnerer Dynamics 365-attributtens typenavn for kolonnen som en streng, f.eks. opslag, valgliste, streng, boolesk værdi, DateTime
logical_name Returnerer Dynamics 365-attributtens logiske navn for kolonnen, f.eks. createdon
Name Returnerer det oversatte viste Dynamics 365-navn for kolonnen, f.eks. Oprettet
sort_ascending Returnerer en sorteringsstreng til sortering af kolonnen i stigende rækkefølge. f.eks. createdon ASC
sort_descending Returnerer en sorteringsstreng til sortering af kolonnen i faldende rækkefølge. f.eks. createdon DESC
sort_disabled Returnerer true, hvis sortering er deaktiveret for kolonnen. Ellers returneres false.
sort_enabled Returnerer true, hvis sortering er aktiveret for kolonnen. Ellers returneres false.
bredde Returnerer den konfigurerede bredde for kolonnen i pixel.

entityview

Objektet entityview bruges i entityview-mærket og giver adgang til metadataene for visningen samt til at få vist resultatposter.

Attributter

Attribut Beskrivelse
columns Returnerer kolonnerne i visningen som entitylist-visningens kolonneobjekter.
entity_permission_denied Returnerer true, hvis der blev nægtet adgang til at få vist resultater på grund af utilstrækkelige objekttilladelser for den aktuelle bruger. Returnerer false, hvis der er givet læseadgang til visningsresultater.
entity_logical_name Det logiske navn for Dynamics 365-objektet i visningsresultatposter. For eksempel contact
first_page Sidetallet på den første side i visningsresultater. Det er 1, medmindre der blev ikke returneret nogen resultater, og så er det null.
Id GUID-id'et for den Dynamics 365-visning, der definerer denne entityview.
language_code Sprogkoden for det Dynamics 365-heltal, der bruges til at indlæse oversatte etiketter for den aktuelle visning.
last_page Sidetallet på den sidste side i visningsresultater. Hvis der blev ikke returneret nogen resultater, er dette null.
name Navnet på den Dynamics 365-visning, der definerer denne entityview, f.eks. Aktive kontakter.
next_page Sidetallet på den næste side i visningsresultater. Hvis der ikke er nogen næste side med resultater, er dette null.
Page Sidetallet på den aktuelle side i visningsresultater.
pages Returnerer en matrix af sidetal, der indeholder alle sider med resultater for den aktuelle visning.
page_size Antallet af resultater, der returneres pr. side for den aktuelle visning.
previous_page Sidetallet på den næste side i visningsresultater. Hvis der ikke er nogen forrige side med resultater, er dette null.
primary_key_logical_name Det logiske navn i Dynamics 365 på den primære nøgleattribut for resultatobjektet for denne visning. For eksempel contactid.
records Den aktuelle side i resultatposten for visningen, som objekter af typen entity.
sort_expression Standardsorteringsudtrykket for visningen. For eksempel nameASC, createdon DESC.
total_pages Det samlede antal sider med resultater for visningen.
total_records Det samlede antal resultater for visningen (på tværs af alle sider).

events

Giver mulighed for at få adgang til og gengive hændelser. Med objektet events kan du vælge en bestemt hændelse eller alle hændelser.

Objektet events

Objektet events giver dig adgang til en bestemt hændelse på portalen eller til alle hændelser på portalen (uanset hændelsen).

Objektet events har følgende attributter:

Attribut Beskrivelse
occurences Returnerer et eventoccurrences-objekt, der indeholder alle hændelsesforekomster på portalen.
[hændelsesnavn eller -id] Du kan få adgang til enhver hændelse ud fra dens navn eller id-egenskaber.
{% assign event = events["Hændelsesnavn"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objektet event

Objektet event gør det muligt at arbejde med en enkelt hændelse, så du kan få adgang til tidsplaner og forekomster for hændelsen.

Objektet event har følgende attributter:

Attribut Beskrivelse
occurences Returnerer et eventoccurrences-objekt, der indeholder alle forekomster for hændelsen.
name Navnet på hændelsen.
url URL-adressen for hændelsen.

Objektet eventoccurrences

Objektet eventoccurrences giver dig adgang til en samling af hændelsesforekomstobjekter. Du kan ændre rækkefølgen af hændelsesforekomster og angive et datointerval for de hændelser, der skal hentes, og gennemføre sideinddeling samt med bruge flydende filtre

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

Bemærk, at

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

også er muligt.

Følgende attributter er knyttet til eventoccurrences-objekt

Attribut Beskrivelse
All Returnerer alle eventoccurrence-objekter i samlingen.

Objektet eventoccurrence

Repræsenterer en enkelt hændelsesforekomst. Nedenfor angives de tilknyttede attributter:

Attribut Beskrivelse
URL-adresse URL-adressen til forekomsten.
is_all_day_event Er dette en hændelse, der varer hele dagen?
start_time Starttidspunktet for hændelsen.
end_time Sluttidspunktet for hændelsen.

forloop

Indeholder egenskaber, der er nyttige i en Gentagelsesmærker-løkkeblok.

Bemærk

forloop kan kun bruges i et mærke af typen Gentagelsesmærker.

Kode

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Resultat

This is the first child page!

This is child page number 2.

This is child page number 3.

Attributter

Attribut Beskrivelse
first Returnerer true, hvis det er den første gentagelse af løkken. Returnerer false, hvis det ikke er den første gentagelse.
index Det aktuelle elements position i samlingen, hvor det første element har positionen 1.
index0 Det aktuelle elements position i samlingen, hvor det første element har positionen 0.
Last Returnerer true, hvis det er den sidste gentagelse af løkken. Returnerer false, hvis det ikke er den sidste gentagelse.
length Returnerer antallet af gentagelser for løkken ߝ, som antallet af elementer i samlingen gentages over.
rindex Antallet af elementer, der er tilbage i løkken (længde - indeks), hvor 1 er indekset for det sidste element.
rindex0 Antallet af elementer, der er tilbage i løkken (længde - indeks), hvor 0 er indekset for det sidste element.

forums

Giver mulighed for at få adgang til og gengive forummer og forumtråde. Bemærk, at muligheden for at bruge Liquid til at gengive forumdata også omfatter opslag, men hvis du vil oprette et ny opslag i tråden, skal du bruge en ASP.NET-webformularer sideskabelon med de nævnte funktioner indbygget (som standard f.eks. sideskabeloner for forumtråde og forumopslag).

Med objektet forum kan du vælge et forum eller forumtråde:

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

Objektet forums

Objektet forums giver dig adgang til et bestemt forum på portalen eller til alle forumtråde på portalen (uanset forummet).

Objektet forum gør det muligt at arbejde med et enkelt forum, så du kan få adgang til trådene for dette forum.

Objektet forumthreads giver dig adgang til en samling af forumthread-objekter. Du kan bestille forumtråde og gennemføre sideinddeling samt ved hjælp af Liquid-filtre.

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

En enkelt forumtråd

Objektet forumposts giver dig adgang til en samling af forumposts-objekter.

Attributter

Attribut Beskrivelse
threads Returnerer et forumthreads-objekt, der indeholder alle forumthread-objekter på portalen.
All Returnerer alle forum-objekter på portalen. Bemærk, at website.forums også er en ækvivalent.
thread_count Returnerer heltalsværdien af en optælling af, hvor mange tråde der er på hele webstedet.
post_count Returnerer heltalsværdien af det samlede antal opslag på portalen.
[forumnavn eller -id] Du kan få adgang til ethvert forum ud fra dets navn eller id-egenskaber.
`{% assign forum = forums["Navn på forum"] %}
{% assign forum = forums["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objektet forum

Attributter

Bemærk

entities

Attribut Beskrivelse
threads Returnerer et forumthreads-objekt, der indeholder alle forumtråde for forummet.
Name Navnet på forummet.
thread_count Returnerer heltalsværdien af en optælling af, hvor mange tråde der er på forummet.
post_count Returnerer heltalsværdien af en optælling af, hvor mange opslag i alt der er på hele forummet.

Objektet forumthreads

Attributter

Attribut Beskrivelse
Alle Returnerer alle forumthread-objekter i samlingen.

Objektet forumthread

Attributter

Bemærk

entities

Attribut Beskrivelse
posts Returnerer et forumposts-objekt, der indeholder alle forumopslag for tråden.
author Returnerer forfatteren til tråden (som blot er et objekt af typen kontaktobjekt).
latest_post Returnerer det nyeste opslag i tråden.
first_post Returnerer det første opslag i tråden.
post_count Returnerer heltalsværdien af en optælling af, hvor mange opslag der er på tråden.
is_answered Er tråden besvaret eller ej?
is_sticky Er tråden selvklæbende?

Objektet forumposts

Attributter

Attribut Beskrivelse
Alle Returnerer alle forumthread-objekter i samlingen.

Et enkelt forumopslag

Attributter

Bemærk

entities

Attribut Beskrivelse
author Returnerer forfatteren til opslaget (som blot er et objekt af typen kontaktobjekt).
content Opslagets indhold.
is_answer Er dette opslag et svar til tråden?

page

Refererer til den aktuelle anmodningsside i portalen. Dette objekt kombinerer attributterne for sitemap og den aktuelle anmodning om entities (normalt en webside).

Objektet page giver adgang til ting som brødkrummerne for den aktuelle side, titel eller URL-adresse på den aktuelle side og eventuelle andre attributter eller relaterede objekter i den underliggende Dynamics 365-post.

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

Sideattributter

Bemærk

entities

Attribut Beskrivelse
breadcrumbs Returnerer brødkrummenodeobjekter for oversigt over websted for siden, og starter fra rodnoden i webstedsoversigten og slutter ved den overordnede node.
children Returnerer de underordnede nodeobjekter i webstedsoversigten for siden.
parent Returnerer den overordnede node i webstedsoversigten for siden. Hvis siden er startsiden, er parent null.
title Titlen på siden.
url ULR-adressen for siden.
[navn på attribut eller relation] Du kan få adgang til en attribut for sidens underliggende Dynamics 365-post efter logisk navn.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Værdierne for de fleste objektattributter knyttes direkte til Liquid-typer: To grupperede felter tilknyttes booleske værdier, tekstfelter til strenge og numeriske felter/valutafelter til tal, dato og klokkeslæt-felter til dato-objekter. Men nogle attributtyper returneres som objekter:
  • Opslagsfelter (objektreference) returneres som entities.
  • Felter for grupperet indstilling/valglistefelter returneres som entities.
  • Du kan også indlæse relaterede objekter efter relationsskemanavn.
    {{ page.adx_webpage_entitylist.adx_name }}
    I tilfælde af, at en relation er refleksiv (dvs. refererer til sig selv), returneres et entities-objekt. (Ellers ville det ønskede resultat være flertydigt).{{ page.adx_webpage_webpage.referencing.adx_name }}
    Bemærk! Indlæsning af et stort antal relaterede objekter eller åbning af et stort antal relationer i en enkelt skabelon kan have en negativ indvirkning på skabelonens gengivelsesydeevne. Undgå at indlæse relaterede objekter for hvert element i en matrix i en løkke. Hvor det er muligt, brug fortrinsvis Dynamics 365-objektmærker til at indlæse samlinger af objekter.

polls

Giver mulighed for at få adgang til og gengive en afstemning.

Med polls-objektet kan du vælge en bestemt afstemning eller afstemningssted.

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

Afstemningsattributter

Attribut Beskrivelse
placements Returnerer objektet pollplacements.
[afstemningsnavn eller -id] Du kan få adgang til en afstemning ud fra dens navn eller id-egenskaber. {% assign poll = polls["Poll Name"] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Attributter for afstemningssteder

Attribut Beskrivelse
[navn eller id for afstemningssted] Du kan få adgang til et afstemningssted ud fra dets navn eller id-egenskaber.{% assign placement = polls.placements["Placement Name or Id"] %}
{% assign placement = polls.placements["7677c5d4-406e-4b6c-907c-916ac17dba0f"] %}

Attributter for afstemningssted

Bemærk

entities

Attribut Beskrivelse
Name Returnerer feltet Navn for afstemningsstedet.
placement_url Den URL-adresse, der kan bruges til at hente afstemningsstedet fuldt gengivet af en skabelon.
polls Returnerer samlingen af afstemningsobjekter, der er knyttet til stedet. Gentagelsesmærker og Matrixfiltre kan bruges sammen med denne samling.
random_url Den URL-adresse, der kan bruges til at hente en vilkårlig afstemning fra stedet, der er fuldt gengivet af en skabelon.
submit_url Den URL-adresse, som en fuldført afstemning sendes til.

Afstemningsattributter

Bemærk

entities

Attribut Beskrivelse
has_user_voted Returnerer true, hvis den aktuelle bruger (logget ind eller anonym) allerede har stemt ved denne afstemning.
Name Returnerer feltet Navn for afstemningen.
options Returnerer samlingen af poll option-objekter, der er knyttet til afstemningen. Gentagelsesmærker og entities kan bruges sammen med denne samling.
poll_url Den URL-adresse, der kan bruges til at hente afstemningen fuldt gengivet af en skabelon.
question Returnerer feltet Spørgsmål for afstemningen.
submit_button_label Returnerer en streng, der kan bruges til at tilsidesætte etiketten på afsendelsesknappen for afstemningen.
submit_url Den URL-adresse, som en fuldført afstemning sendes til.
user_selected_option Returnerer objektet polloption, der er valgt af brugeren (hvis de har allerede stemt).
votes Returnerer antallet af stemmer, der har været i tabelformat ved afstemningen.

Attributter for afstemningsmulighed

Bemærk

entities

Attribut Beskrivelse
answer Returnerer feltet Svar for afstemningen.
percentage Returnerer procentdelen af stemmer i afstemningen for valgmuligheden som et decimaltal mellem 0 og 100.
votes Returnerer antallet af stemmer, der har været i tabelformat for valgmuligheden.

request

Indeholder oplysninger om den aktuelle HTTP-anmodning.

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

<a href="{{ request.url | add_query: 'foo', 1 }}">Link</a>
Bemærk

Du kan oprette URL-adresser dynamisk i Liquid ved hjælp af URL-filtre.

Attributter

Attribut Beskrivelse
params Navngivne parameterværdier for den aktuelle anmodning. params er en kombination af URL-forespørgselsstrengparametre, formularopslagsparametre og cookies.
Path Stien for den aktuelle URL-adresse til anmodningen.
/profile/
path_and_query Stien og forespørgslen for den aktuelle URL-adresse til anmodningen.
/profile/?foo=1&bar=something
query Forespørgselsdelen af den aktuelle URL-adresse til anmodningen.
?foo=1&bar=something
url Den fuldstændige URL-adresse til den aktuelle anmodning.
http://www.example.com/profile/?foo=1&bar=something

searchindex

Objektet searchindex bruges i Dynamics 365-objektmærker og giver adgang til resultaterne af en forespørgsel.

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

Attributter

Attribut Beskrivelse
approximate_total_hits Returnerer et omtrentligt samlet antal hit, der stemmer overens med indeksforespørgslen. Bemærk at på grund af den måde, søgeindekset fungerer på med hensyn til sikkerhedsfiltrering og andre designfaktorer, er dette tal er kun omtrentligt og er ikke nødvendigvis identisk med det samlede antal resultater, der er tilgængelige for den aktuelle bruger i nogle situationer.
Page Returnerer sidetallet for den aktuelle forespørgsel.
page_size Returnerer den maksimale sidestørrelse for den aktuelle forespørgsel. Bemærk, at hvis du ønsker det faktiske antal resultater returneret for den aktuelle side (fordi det kan være mindre end den angivne maksimale sidestørrelse), skal du bruge results.size.
results Returnerer forespørgslens resultatside som resultatobjekter for søgeindekset.

Søgeindeksresultater

Attribut Beskrivelse
entity De underliggende entities for resultatet.
fragment Et relevant kort tekstfragment for resultatet med betingelser, der svarer til den angivne forespørgsel, der er fremhævet ved hjælp af <em>-HTML-mærket. Bemærk, at visse typer af forespørgsler ikke understøtter fremhævede fragmenter, som f.eks. fuzzy-forespørgsler (~) og forespørgsler med jokertegn (*). Denne egenskab er null i disse tilfælde.
Id Dynamics 365-objektets id for den underliggende post for resultatet, som en streng, f.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Dynamics 365-objektets logiske navn for den underliggende post for resultatet, f.eks. adx_webside
number Antallet af resultatet på tværs af alle sider med søgeresultater, startende med 1. For eksempel for det første resultat af den anden side med resultater, med en sidestørrelse på 10, er denne værdi 11.
score Lucene-scoren af resultatet, som en flydende værdi. Resultaterne bliver returneret i rækkefølge efter denne værdi.
title Titlen på resultatet.
url URL-adressen for resultatet. Dette vil som regel ߝ, men ikke nødvendigvis ߝ være en absolut sti til det aktuelle program i stedet for en fuldstændig URL-adresse. For eksempel: /articles/article 1/

settings

Bruges til at indlæse en Konfigurer webstedsindstillinger for portaler efter navn. Hvis en indstilling med det angivne navn ikke findes, returneres Liquid-typer.

Bemærk

Indstillinger returneres som Liquid-typer, men du kan bruge Type-filtre til at konvertere dem til andre typer.

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

sitemap

Giver adgang til oversigten over portalwebstedet.

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

Attributter for oversigt over websted

Attribut Beskrivelse
Current Returnerer nodeobjektet for oversigten over webstedet for den aktuelle side.
Root Returnerer nodeobjektet for oversigten over webstedet for rodsiden (startsiden) på webstedet.

Nodeattributter for oversigt over websted

Attribut Beskrivelse
Breadcrumbs Returnerer brødkrummenodeobjekter for oversigt over websted for noden, og starter fra rodnoden i webstedsoversigten og slutter ved den overordnede node.
Children Returnerer de underordnede nodeobjekter i webstedsoversigten for noden.
Description Beskrivelse/resume af indholdet af noden. (Feltet kan indeholde HTML).
Entity Returnerer de underliggende entities for noden. Hvis noden ikke har et underliggende objekt, bliver denne værdi null.
is_sitemap_ancestor Returnerer true, hvis noden i webstedsoversigten er et overordnet element til den aktuelle node, ellers false. Tilføjet 7.0.0008
is_sitemap_current Returnerer true, hvis noden i webstedsoversigten er den aktuelle node, ellers false. Tilføjet 7.0.0008
Parent Returnerer den overordnede node i webstedsoversigten for noden. Hvis noden er rodnoden, bliver parent null.
Title Titlen på noden.
url URL-adressen til noden.

sitemarkers

Gør det muligt at indlæse ethvert webstedsmærke efter navn. Hvis sitemarker findes, returneres et sitemarker-objekt. Hvis en sitemarker med det angivne navn ikke findes, returneres Liquid-typer.

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

Sitemarker-attributter

Attribut Beskrivelse
url URL-adressen på sitemarker-målet.
[logisk navn for attribut] Du kan få adgang til en attribut for sitemarker-målets Dynamics 365-post efter logisk navn, f.eks. {{ sitemarker.adx_name }}

snippets

Gør det muligt at indlæse alle indholdskodestykker efter navn. Hvis et kodestykke med det angivne navn ikke blev fundet, returneres Null.

{{ snippets["Header"] }}

{% assign footer = snippets["Footer"] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Indeholder egenskaber, der er nyttige i en Gentagelsesmærker-løkkeblok.

Bemærk

tablerowloop kan kun bruges i et mærke af typen Gentagelsesmærker.

Attributter

Attribut Beskrivelse
Col Returnerer indekset for den aktuelle række startende ved 1.
col0 Returnerer indekset for den aktuelle række startende ved 0.
col_first Returnerer true, hvis den aktuelle kolonne er den første i en række. Hvis ikke returneres false.
col_last Returnerer true, hvis den aktuelle kolonne er den sidste i en række. Hvis ikke returneres false.
First Returnerer true, hvis det er den første gentagelse af løkken. Returnerer false, hvis det ikke er den første gentagelse.
Index Det aktuelle elements position i samlingen, hvor det første element har positionen 1.
index0 Det aktuelle elements position i samlingen, hvor det første element har positionen 0.
Last Returnerer true, hvis det er den sidste gentagelse af løkken. Returnerer false, hvis det ikke er den sidste gentagelse.
Length Returnerer antallet af gentagelser for løkken ߝ, som antallet af elementer i samlingen gentages over.
Rindex Antallet af elementer, der er tilbage i løkken (længde - indeks), hvor 1 er indekset for det sidste element.
rindex0 Antallet af elementer, der er tilbage i løkken (længde - indeks), hvor 0 er indekset for det sidste element.

user

Refererer til den aktuelle portalbruger og giver adgang til alle attributter i den underliggende kontaktpersonpost i Dynamics 365. Hvis ingen bruger er logget på, er denne variabel Liquid-typer.

user er en entities.

{% if user %}

Hello, {{ user.fullname }}!

{% else %}

Hello, anonymous user!

{% endif %}

Attributter

Ud over at have alle attributterne for et entities, har user følgende attributter.

Refererer til portalen websted og giver adgang til alle attributter på Dynamics 365-webstedsposten (adx_website) for portalen.

Bemærk

entities

Kode

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

Resultat

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

website

Gør det muligt at indlæse alle weblinks efter navn eller id.

Hvis weblinksættet findes, returneres et weblinksætobjektet. Hvis et weblinksæt med det angivne navn eller id ikke blev fundet, returneres Liquid-typer.

<!-- 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 %}
Bemærk

entities

Attribut Beskrivelse
Copy HTML-teksten i weblinksættet.
Name Navnet på weblinksættet.
Title Titlen på weblinksættet.
Weblinks Den matrix af weblinkobjekter, der er tilknyttet weblinksættet.
[logisk navn for attribut] Du kan få adgang til en attribut i weblinksættets Dynamics 365-post efter logisk navn, f.eks. {{ weblinkset.createdon }}
Bemærk

entities

Attribut Beskrivelse
Description HTML-beskrivelsen af weblinket.
display_image_only Booleske attributter, der angiver, om weblinket skal vises som et billede uden linktekst.
display_page_child_links Boolesk attribut, der angiver, om weblinket skal vise links til de underordnede sitemap-sider på den linkede side som underordnede hyperlinks.
Image Weblinkets billedobjekt for dette link. Denne attribut er null, hvis der intet billede findes.
is_external Booleske attributter, der angiver, om URL-måladressen på weblinket er til et eksternt websted (i stedet for til en intern portalside).
is_sitemap_ancestor Returnerer true, hvis weblinkets URL-adresse refererer til et overordnet element i den aktuelle webstedsoversigtsnode, og ellers false. Tilføjet 7.0.0008
is_sitemap_current Returnerer true, hvis weblinkets URL-adresse refererer til den aktuelle webstedsoversigtsnode, og ellers false. Tilføjet 7.0.0008
Name Navnet eller titlen på weblinket.
Nofollow Booleske attributter, der angiver, om weblinket skal markeres som rel="nofollow".
open_in_new_window Booleske attributter, der angiver, om weblinket skal åbnes i et ny browservindue/en ny fane, når der klikkes på det.
Tooltip Værktøjstipteksten til weblinket.
url URL-adressen for weblinket,
Weblinks Den matrix af underordnede weblinkobjekter, der er tilknyttet weblinket.
[logisk navn for attribut] Du kan få adgang til en attribut i weblinkets Dynamics 365-post efter logisk navn, f.eks. {{ weblink.createdon }}
alternate_text Alternativ tekst til billedet.
Height Heltal, der indeholder den angivne højde af billedet. Hvis der ikke er angivet en værdi for højde, er denne attribut null.
url URL-adressen til billedet.
Width Heltal, der indeholder den angivne bredde af billedet. Hvis der ikke er angivet en værdi for bredde, er denne attribut null.

Se også

Tilføje dynamisk indhold, og oprette brugerdefinerede skabeloner
Liquid-typer
Liquid-objekter
Liquid-mærker
Liquid-filtre