Käytettävissä olevat Liquid-objektit

Liquid-objektit sisältävät määritteitä, joilla tuotetaan dynaamista sisältöä sivulle. Esimerkiksi sivuobjektilla on otsikko-määrite, jonka avulla voidaan tulostaa nykyisen sivun otsikko.

Voit käyttää objektin määritettä nimen perusteella pisteen avulla . Voit hahmontaa objektin määritteen mallissa laittamalla sen ympärille {{- ja }}-merkit.

{{ page.title }}

Objektin määritteitä voidaan käyttää myös merkkijonon nimen ja []-merkkien avulla. Tästä on hyötyä, jos haluamasi määrite määritetään dynaamisesti tai määritteen nimessä on esimerkiksi merkkejä, välilyöntejä ja erikoismerkkejä, jotka olisivat virheellisiä, kun käytät syntaksia.

{{ page["title"] }}

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

{{ object[attribute_name] }}

Seuraavia objekteja voidaan käyttää ja käsitellä missä tahansa ja kaikissa malleissa.

Objekti Kuvaus
kohteet Mahdollistaa minkä tahansa Dynamics 365 -entiteetin lataamisen tunnuksen perusteella. Lisätietoja: entities
nyt Päivämäärä/kellonaika-objekti, joka viittaa nykyiseen UTC-aikaan sinä hetkenä, kun malli on hahmonnetaan.
Huomautus: Tämä arvo tallentuu välimuistiin portaalin verkkosovelluksella, eikä se päivity joka kerta. Lisätietoja: Päivämääräsuodattimet
sivun Viittaa nykyiseen portaalin pyyntösivuun. Sivuobjekti mahdollistaa pääsyn esimerkiksi nykyisen sivun navigointipolkuun tai otsikkoon sekä muihin taustalla olevan Dynamics 365 -tietueen määritteisiin ja liittyviin entiteetteihin. Lisätietoja: page
params Sopiva request.params-lyhenne. Lisätietoja: request
pyyntö Sisältää tietoja nykyisestä HTTP-pyynnöstä. Lisätietoja: request
Asetukset Sallii minkä tahansa sivustoasetuksen lataamisen nimen perusteella. Lisätietoja: settings, Sivuston asetusten määrittäminen portaalille
sivustokartta Antaa oikeudet portaalin sivustokartan tarkasteluun. Lisätietoja: sitemap
Sivustomerkinnät Sallii minkä tahansa sivustomerkinnän lataamisen nimen perusteella. Lisätietoja: sitemarkers
snippets Sallii minkä tahansa sisältökatkelman lataamisen nimen perusteella. Lisätietoja: Sisällön mukauttaminen sisältökatkelmien avulla
käyttäjä Viittaa portaalin nykyiseen käyttäjään ja sallii kaikkien taustalla olevan Dynamics 365:n yhteyshenkilötietueen määritteiden käytön. Jos kirjautunutta käyttäjää ei ole, tämän muuttuja on tyhjä arvo.. Lisätietoja: Liquid types
Verkkolinkit Sallii minkä tahansa verkkolinkin joukon lataamisen nimen tai tunnuksen perusteella. Lisätietoja: weblinks
sivusto Viittaa portaalin sivustotietueeseen ja sallii kaikkien Dynamics 365 -sivuston (adx_website) portaalitietueen määritteiden käytön. Lisätietoja: website

Kaikki Liquid-objektit

ads

blogs

kohteet

entitylist

entityview

events

forloop

forums

tietämys

page

polls

request

searchindex

settings

sitemap

sitemarkers

snippets

tablerowloop

user

weblinks

website

ads

Tarjoaa mahdollisuuden käyttää ja hahmontaa mainoksia.

Ads-objektin avulla voit valita tietyn mainoksen tai mainossijoittelun.

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

Mainosten määritteet

Määrite Kuvaus
sijoittelut Palauttaa adplacements-objektin.
[mainoksen nimi tai tunnus] Voit käyttää mitä tahansa mainosta sen nimen tai tunnuksen perusteella.
{% assign ad = ads["Ad Name"] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Mainossijoittelujen määritteet

Määrite Kuvaus
[mainossijoittelun nimi tai tunnus] Voit käyttää mitä tahansa adplacement-objektia sen nimen tai tunnuksen perusteella.
{% assign placement = ads.placements["Placement Name or Id"] %}
{% assign placement = ads.placements["2423d713-abb3-44c3-8a7d-c445e16fccad"] %}

Mainossijoittelun määritteet

Ad placement on entiteetin objekti, jolla on kaikki samat määritteet alla olevien määritteiden lisäksi.

Määrite Kuvaus
Mainokset Palauttaa kokoelman sijoitteluun liittyviä mainosobjekteja. Iterointitunnisteita ja matriisin suodattimia voi käyttää tässä kokoelmassa.
Nimi Palauttaa mainossijoittelun nimikentän.
placement_url URL-osoite, jonka avulla mallin täysin hahmontama mainossijoittelu voidaan noutaa.
random_url URL-osoite, jonka avulla mallin täysin hahmontamasta mainossijoittelusta voidaan noutaa satunnainen mainos.

Mainoksen määritteet

Huomautus

Mainos on entiteetin objekti, jolla on kaikki samat määritteet alla olevien määritteiden lisäksi.

Määrite Kuvaus
ad_url URL-osoite, jonka avulla mallin täysin hahmontama mainos voidaan noutaa.
Tekstisisältö Palauttaa mainoksen tekstisisältökentän.
kuva Palauttaa mainoksen kuvaobjektin (jos sellainen on).
Nimi Palauttaa mainoksen nimikentän.
open_in_new_window Palauttaa tosi-arvon, jos URL-osoite, jonka redirect_url määrittää, avataan uudessa ikkunassa.
redirect_url URL-osoite, johon käyttäjä ohjataan, kun tämä valitsee mainoksen.

Mainoskuvan määritteet

Määrite Kuvaus
alternate_text Palauttaa tekstin, joka on tarkoitus näkyä tunnisteen alt-määritteessä.
height Palauttaa kuvan korkeuden kuvapisteinä
URL-osoite Palauttaa kuvan lähteen URL-osoitteen.
width Palauttaa kuvan leveyden kuvapisteinä

blogs

Tarjoaa mahdollisuuden käyttää ja hahmontaa blogeja ja blogikirjoituksia.

Blogs-objektin avulla voit valita tietyn blogin tai tietyt blogikirjoitukset.

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

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

<div class="panel-heading">

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

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

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

<h4>

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

{{ snippet.adx_value }}

</h4>

</div>

<ul class="list-group">

{% for post in posts.all %}

<li class="list-group-item" >

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

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

</a>

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

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

</h4>

<div class="content-metadata">

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

&ndash;

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

&ndash;

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

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

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

blogs-objekti

blogs-objektin avulla voit käyttää mitä tahansa portaalin blogia tai kaikkia portaalin blogikirjoituksia (blogista huolimatta).

Seuraavassa taulukossa kuvataan blogs-objektiin liittyvät määritteet.

Määrite Kuvaus
posts Palauttaa blogposts-objektin, joka sisältää kaikki portaalin blogikirjoitukset.
[blogin nimi tai tunnus] Voit käyttää mitä tahansa blogia sen nimen tai tunnuksen perusteella.
{% assign blog = blogs["Blog Name"] %}                             

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

blog-objekti

Blog-objektin avulla voit käsitellä yhtä blogia ja kyseisen blogin kirjoituksia.

Seuraavassa taulukossa kuvataan blog-objektiin liittyvät määritteet.

Määrite Kuvaus
posts Palauttaa blogposts-objektin, joka sisältää kaikki blogiin kuuluvat kirjoitukset.
Nimi Blogin nimi.
title Blogin otsikko.
URL-osoite Blogin URL-osoite.

blogposts-objekti

blogposts-objektin avulla voit käyttää blogikirjoitusten-objektikokoelmaa. Voit järjestää ja sivuttaa kirjoitukset sekä käyttää Liquid-suodatusta:

{% assign blogposts = blogs.posts | order_by “adx_name”, “desc” | paginate: 0,4 | all %} Huomaa, että blogs.posts.all on mahdollinen myös kaikkien blogimerkintöjen haussa blogs.posts | from_index: 0 | take: 2 on myös mahdollinen

Seuraavassa taulukossa kuvataan blogposts-objektiin liittyvät määritteet.

Määrite Kuvaus
Kaikki Palauttaa kaikki kokoelman blogpost-objektit.

blogpost-objekti

Viittaa yhteen blogikirjoitukseen.

Seuraavassa taulukossa kuvataan blogpost-objektiin liittyvät määritteet.

Määrite Kuvaus
URL-osoite Kirjoituksen URL-osoite.
content Palauttaa kirjoituksen sisältökentän.
content Palauttaa kirjoituksen Sisältö-kentän.
author Palauttaa kirjoituksen tekijän (joka on yksinkertaisesti yhteyshenkilöentiteettiobjekti).
title Kirjoituksen otsikko.
comment_count Palauttaa kokonaislukuna kirjoitukselle annettujen kommenttien määrän.
publish_date Päivämäärä, jolloin kirjoitus on julkaistu.

kohteet

Mahdollistaa minkä tahansa Dynamics 365 -entiteetin lataamisen tunnuksen perusteella. Jos entiteetti on olemassa, entiteetti-objekti palautetaan. Jos tunnusta vastaavaa entiteettiä ei löydy, Liquid-tyypit palautetaan.

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

Entiteetti

Entiteettiobjekti tarjoaa Dynamics 365 -entiteettitietueen määritteet käytettäväksi.

Määrite Kuvaus
Tunniste Entiteetin GUID-tunnus merkkijonona. Esimerkki: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Dynamics 365:n entiteetin looginen nimi.
Muistiinpanot Lataa entiteettiin liitetyt muistiinpanot (huomautus) järjestyksessä vanhimmasta uusimpaan (createdon). Muistiinpanot palautetaan muistiinpano-objekteina.
oikeudet Lataa entiteetin Entiteettioikeus-vahvistuksen tulokset. Tulos palautetaan oikeusobjektina.
URL-osoite Palauttaa entiteetin Dynamics 365 -portaalien sisällönhallintajärjestelmän URL-polun. Jos entiteetillä ei ole kelvollista URL-osoitetta nykyisessä sivustossa, palautusarvo on tyhjäarvo. Yleensä tämä palauttaa vain arvon tietyille entiteettityypeille, jotka on integroitu portaalin CMS:ään , ellet ole mukauttanut sovelluksen URL-osoitteen tarjoajaa.
[määritteen tai suhteen nimi] Voit käyttää mitä tahansa Dynamics 365 -entiteetin määritettä loogisen nimen perusteella. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Useimmat entiteettimääritteiden arvot yhdistetään suoraan Liquid types -objektiin: kahden asetuksen kentät yhdistyvät totuusarvoihin, tekstikentät merkkijonoihin, numeeriset-/valuuttakentät lukuihin, päivä-/aikakentät päivämääräobjekteihin. Jotkin määritetyypit palautetaan kuitenkin objekteina:
  • Hakukentät (entiteettiviittaus) palautetaan entiteetin viittausobjekteina.
  • Asetusjoukko/valintaluettelokentät palautetaan asetusjoukon arvo-objekteina.
  • Voit myös ladata minkä tahansa liittyvän entiteetin suhderakenteen nimen mukaan.
  • {{ page.adx_webpage_entitylist.adx_name }}Siinä tapauksessa, että suhde on refleksiivinen (eli itseensä viittaava), palautetaan refleksiivinen suhdeobjekti. (Muussa tapauksessa tulos olisi epäselvä.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Huomautus: Jos lataat suuren määrän liittyviä entiteettejä tai käytät suurta määrää suhteita yhdessä mallissa, mallin hahmontamisen suorituskyky voi heikentyä. Vältä liittyvien entiteettien lataamista jokaisessa matriisin kohteessa silmukan sisällä. Käytä mieluummin mahdollisuuksien mukaan Dynamics 365 entiteettitunnisteita entiteettijoukkojen lataamiseen.

Entiteettiviittaus

Hakumääritteiden arvot palautetaan entiteetin viittausobjekteina, joilla on seuraavat määritteet.

Määrite Kuvaus
Tunniste Viitatun entiteetin GUID-tunnus merkkijonona.
Esimerkki: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Viitatun entiteetin looginen nimi Dynamics 365:ssä.
Nimi Viitatun entiteetin ensisijainen nimimäärite.

Huomautus

Muistiinpano on entiteettiobjekti, joka tarjoaa pääsyn huomautustietueen määritteisiin ja suhteisiin. Kaikkien entiteettiobjektin määritteiden lisäksi muistiinpanolla on seuraavat lisämääritteet.

Määrite Kuvaus
documentbody Lataa muistiinpanon huomautustietueen documentbody-määritteen -tietueesta Base64-koodattuna merkkijonona. Koska kyseisen määritteen sisältö voi olla suuri, sitä ei ladata samalla kuin muut muistiinpanon määritteet; se on ladattava erikseen.
Huomautus: documentbody-määritteen käytöllä saattaa olla heikentävä vaikutus mallin hahmontamisen suorituskykyyn, ja sitä tulee siis käyttää varoen.
Tarjoa sen sijaan url-määritteen avulla linkki muistiinpanoon, jos mahdollista.
URL-osoite Palauttaa portaalin sisäisen kommenttiliitteen käsittelijän URL-polun. Jos käyttäjällä on oikeudet ja muistiinpanoon on liitetty tiedosto, tähän URL-osoitteeseen lähetetty pyyntö lataa muistiinpanon liitetiedoston.

Asetusjoukon arvo

Asetusjoukon/valintaluettelon määritteiden arvot palautetaan entiteetin viittausobjekteina, joilla on seuraavat määritteet.

Määrite Kuvaus
Selite Asetusjoukon/valintaluettelon määritearvon lokalisoitu otsikko. Esimerkki: Aktiivinen
Arvo Asetusjoukon/valintaluettelon määritearvon kokonaislukuarvo. Esimerkki: 0

Entiteettioikeudet

Entiteettioikeudet-objekti tarjoaa pääsyn koottuihin entiteetin oikeuksien vahvistuksen tuloksiin.

Määrite Kuvaus
can_append Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus lisätä tietueita tämän tietueen suhteisiin. Muussa tapauksessa palauttaa arvon Epätosi.
can_append_to Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus lisätä tietue toisen tietueen suhteeseen. Muussa tapauksessa palauttaa arvon Epätosi.
can_create Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus luoda uusia tämän entiteettityypin tietueita. Muussa tapauksessa palauttaa arvon Epätosi.
can_delete Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus poistaa tietue. Muussa tapauksessa palauttaa arvon Epätosi.
can_read Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus lukea tietue. Muussa tapauksessa palauttaa arvon Epätosi.
can_write Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus päivittää tietue. Muussa tapauksessa palauttaa arvon Epätosi.
rules_exist Palauttaa Tosi-arvon, jos tämän objektin oikeuksien tulokset ovat seurausta erikseen määritetyistä oikeussäännöistä. Palauttaa Epätosi-arvon, jos ne ovat oletusarvoiset tuloksista, eikä oikeuksia ole erikseen määritetty.

Refleksiivinen suhde

Yritykset ladata entiteettien refleksiivisiä (eli itseensä viittaavia) suhteita palautetaan objekteina, joilla on seuraavat ominaisuudet.

Määrite Kuvaus
is_reflexive Palauttaa arvon Tosi. Tämän avulla voi testata, onko suhteen palauttama objektin refleksiivinen suhdeobjekti.
referenced Palauttaa matriisin annetussa suhteessa viitatuista entiteeteistä.
referencing Palauttaa viittaavan entiteetin annetulle suhteelle. Palauttaa tyhjäarvon, jos viittaavaa entiteettiä ei ole. Jos suhde on monta-moneen (N:N), palauttaa matriisin viittaavista entiteeteistä.

entitylist

Entitylist-objektia käytetään Dynamics 365 entiteettitunnisteiden kanssa. Se tarjoaa pääsyn kaikkiin annetun entiteettiluettelon määritteisiin.

Määritteet

Huomautus

entities

Määrite Kuvaus
create_enabled Palauttaa Tosi-arvon, jos uusien tietueiden luominen on määritetty entiteettiluettelossa. Muussa tapauksessa palauttaa arvon Epätosi.
create_url Palauttaa määritetyn URL-polun entiteettiluettelon luontilinkille/-painikkeelle.
detail_enabled Palauttaa Tosi-arvon, entiteettiluettelolle on määritetty yksittäisten tietojen lisätietonäkymä. Muussa tapauksessa palauttaa arvon Epätosi.
detail_id_parameter Palauttaa kyselymerkkijonoparametrin nimen, jota käytetään tietuen tunnuksena tunnuksen lisätietonäkymän URL-osoitetta luotaessa. Katso lisätietoja Liquid-suodattimien käytöstä URL-osoitteiden muodostamisessa kohdasta URL filters. Esimerkki: id
detail_label Palauttaa määritetyn lokalisoidun otsikon entiteettiluettelon lisätietonäkymän linkille tai painikkeille.
detail_url Palauttaa määritetyn URL-polun entiteettiluettelon lisätietonäkymän linkille tai painikkeille.
empty_list_text Palauttaa määritetyn lokalisoitu tekstin, joka näytetään, kun entiteettiluettelon näkymä ei palauta tuloksia.
enable_entity_permissions Palauttaa Tosi-arvon, jos entiteettiluettelon entiteettioikeuksien suodatus on käytössä. Muussa tapauksessa palauttaa arvon Epätosi.
entity_logical_name Palauttaa Dynamics 365 -entiteetin loogisen nimen tietueille, jotka näytetään tässä entiteettiluettelossa. Esimerkiksi contact
filter_account_attribute_name Palauttaa määritteen loogisen nimen asiakashaulle, jota käytetään suodattamaan tulostietueet nykyisen portaalin käyttäjän pääasiakastilin perusteella. Esimerkki: accountid
filter_apply_label Palauttaa määritetyn lokalisoidun otsikon, jota käytetään linkissä tai painikkeessa, joka soveltaa tehokasta määritesuodatusta entiteettiluettelon tuloksiin.
filter_definition Palauttaa JSON-määritteen suodatinmäärityksen entiteettiluettelolle. Katso lisätietoja Liquid-suodattimen metasuodattimien käyttämisestä entiteettiluettelon suodattimissa tämän määrityksen käsittelemisessä.
filter_enabled Palauttaa Tosi-arvon, jos määritteiden edistynyt suodatus on käytössä entiteettiluettelossa. Muussa tapauksessa palauttaa arvon Epätosi.
filter_portal_user_attribute_name Palauttaa määritteen loogisen nimen yhteyshenkilöhaulle, jota käytetään suodattamaan tulostietueet nykyisen portaalin käyttäjän yhteyshenkilön perusteella. Esimerkki: contactid
filter_website_attribute_name Palauttaa määritteen loogisen nimen adx_website-haulle , jota käytetään suodattamaan tulostietueet nykyisen portaalin käyttäjän sivuston perusteella. Esimerkki: adx_websiteid
language_code Palauttaa Dynamics 365:n kokonaislukumuotoisen kielikoodin, jota käytetään valitsemaan entiteettiluettelon kaikki lokalisoidut otsikot.
page_size Palauttaa määritetyn tulossivun koon entiteettiluettelolle.
primary_key_name Palauttaa ensisijaisen avainmääritteen loogisen nimen tietueille, jotka näytetään tässä entiteettiluettelossa.
search_enabled Palauttaa Tosi-arvon, jos entiteettiluettelon hakutoiminto on käytössä. Muussa tapauksessa palauttaa arvon Epätosi.
search_placeholder Palauttaa lokalisoidun tekstin entiteettiluettelon hakukentän paikkamerkille.
search_tooltip Palauttaa lokalisoidun tekstin entiteettiluettelon hakukentän työkaluvihjeelle.
näkymät Palauttaa entiteettiluettelon käytettävissä olevat näkymät entiteettiluettelon näkymäobjekteina.
[määritteen looginen nimi] Voit käyttää mitä tahansa entiteettiluettelon (adx_entitylist) Dynamics 365:n tietueen määritettä loogisen nimen perusteella, samalla tavalla kuin entities-objektin kanssa. Esimerkki: {{ entitylist.adx_name }}

Entiteettiluettelon näkymän määritteet

Määrite Kuvaus
columns Palauttaa näkymän sarakkeet entiteettiluettelon näkymän sarakeobjekteina.
entity_logical_name Palauttaa Dynamics 365 -entiteetin loogisen nimen näkymässä oleville tietueille. Esimerkiksi contact
Tunniste Palauttaa näkymän GUID-tunnuksen.
language_code Palauttaa Dynamics 365:n kokonaislukumuotoisen kielikoodin, jota käytetään valitsemaan kaikki näkymän lokalisoidut otsikot (sarakkeen otsikot jne.).
Nimi Palauttaa näkymän Dynamics 365 -näyttönimen.
primary_key_logical_name Palauttaa Dynamics 365 -entiteetin ensisijaisen avaimen loogisen nimen näkymässä oleville tietueille. Esimerkki: contactid
sort_expression Palauttaa näkymän oletusarvoisen lajittelulausekkeen. Esimerkki:, name ASC, createdon DESC

Entiteettiluettelon näkymän sarakkeen määritteet

Määrite Kuvaus
attribute_type Palauttaa sarakkeen Dynamics 365 -määritteen tyyppinimen merkkijonona. Esimerkki:, Valinta, Valintaluettelo, Merkkijono, Totuusarvo, Päivämäärä ja aika
logical_name Palauttaa sarakkeen Dynamics 365 -määritteen loogisen nimen. Esimerkki: createdon
Nimi Palauttaa sarakkeen lokalisoidun Dynamics 365 -näyttönimen. Esimerkki: Luotu
sort_ascending Palauttaa lajittelulausekkeen merkkijonon, jolla sarake lajitellaan nousevaan järjestykseen. Esimerkki: createdon ASC
sort_descending Palauttaa lajittelulausekkeen merkkijonon, jolla sarake lajitellaan laskevaan järjestykseen. Esimerkki: createdon DESC
sort_disabled Palauttaa Tosi-arvon, jos sarakkeen lajittelu ei ole käytössä. Muussa tapauksessa palauttaa arvon Epätosi.
sort_enabled Palauttaa Tosi-arvon, jos sarakkeen lajittelu on käytössä. Muussa tapauksessa palauttaa arvon Epätosi.
width Palauttaa sarakkeen määritetyn leveyden kuvapisteinä.

entityview

Entityview-objektia käytetään entityview-tunnisteen kanssa ja se tarjoaa pääsyn näkymän metatietoihin sekä tulosarvojen tietueisiin.

Määritteet

Määrite Kuvaus
columns Palauttaa näkymän sarakkeet entitylist-näkymän sarakeobjekteina.
entity_permission_denied Palauttaa Tosi-arvon jos tulosarvojen tarkasteluoikeudet on evätty käyttäjän riittämättömien entiteetin oikeuksien vuoksi. Palauttaa Epätosi-arvon jos tulosarvojen lukuoikeus myönnettiin.
entity_logical_name Tulosarvojen tietueiden Dynamics 365 -entiteetin looginen nimi. Esimerkiksi contact
first_page Tulosarvojen ensimmäisen sivun sivunumero. Tämä on 1, ellei tuloksia ollut, jolloin se on tyhjäarvo.
Tunniste Sen Dynamics 365 -näkymän GUID-tunnus, joka määrittää tämän entityview-tunnisteen.
language_code Dynamics 365:n kokonaislukumuotoinen kielikoodi, jota käytetään nykyisen näkymän lokalisoitujen otsikoiden lataamiseen.
last_page Tulosarvojen viimeisen sivun sivunumero. Jos haku ei tuottanut tuloksia, tämä on tyhjäarvo.
Nimi Dynamics 365:n näkymän nimi, joka määrittää tämän entityview-tunnisteen. Se voi olla esimerkiksi Aktiiviset yhteyshenkilöt.
next_page Tulosarvojen seuraavan sivun sivunumero. Jos tuloksia ei ole seuraavalla sivulla, tämä on tyhjäarvo.
Sivu Tulosarvojen nykyisen sivun sivunumero.
pages Palauttaa matriisin sivunumeroista, joka sisältää kaikki nykyisen näkymän tulosten sivut.
page_size Nykyisen näkymän palautettujen tulosten sivukohtainen määrä.
previous_page Tulosarvojen seuraavan sivun sivunumero. Jos tuloksia ei ole edellisellä sivulla, tämä on tyhjäarvo.
primary_key_logical_name Näkymän kohde-entiteetin ensisijaisen avainmääritteen looginen nimi Dynamics 365:ssä. Esimerkiksi contactid.
Tietueet Näkymän tulostietueiden nykyinen sivu entiteetin objekteina.
sort_expression Näkymän oletusarvoinen lajittelulauseke. Esimerkiksi nameASC, createdon DESC.
total_pages Näkymän tulossivujen kokonaismäärä.
total_records Näkymän tulosten kokonaismäärä (kaikilla sivuilla).

tapahtumat

Tarjoaa mahdollisuuden käyttää ja hahmontaa tapahtumia. Events-objektin avulla voit valita tietyn tapahtuman tai kaikki tapahtumat.

events-objekti

Events-objektin avulla voit käyttää mitä tahansa portaalin tapahtumaa tai kaikkia portaalin tapahtumia (tapahtumasta huolimatta).

Events-objektilla on seuraavat määritteet:

Määrite Kuvaus
occurences Palauttaa eventoccurancessobject-objektin, joka sisältää kaikki tapahtuman esiintymät portaalissa.
[tapahtuman nimi tai tunnus] Voit käyttää mitä tahansa tapahtumaa sen nimen tai tunnuksen perusteella.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

event-objekti

Event-objektin avulla voit käsitellä yhtä tapahtumaa sekä sen aikatauluja ja esiintymiä.

Event-objektilla on seuraavat määritteet:

Määrite Kuvaus
esiintymän jälkeen Palauttaa eventoccurrencesobject-objektin, joka sisältää kaikki tapahtuman esiintymät.
Nimi Tapahtuman nimi.
URL-osoite Tapahtuman URL-osoite.

eventoccurences-objekti

Eventoccurrences-objektin avulla voit käyttää tapahtumaesiintymien objektikokoelmaa. Voit järjestää tapahtuman esiintymät ja määrittää päivämääräalueen, jolta esiintymät noudetaan, sekä saavuttaa sivutuksen Liquid-suodattimien avulla

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

huomaa, että

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

on myös mahdollista.

Seuraavat määritteet liittyvät eventoccurrences-objektiin

Määrite Kuvaus
Kaikki Palauttaa kaikki kokoelman eventoccurance-objektit.

eventoccurence-objekti

Edustaa yhden tapahtuman esiintymää. Liittyvät ominaisuudet ovat seuraavat:

Määrite Kuvaus
URL-osoite Esiintymän URL-osoite.
is_all_day_event Onko kyseessä koko päivän kestävä tapahtuma?
start_time Tapahtuman aloitusaika.
end_time Tapahtuman päättymisaika.

forloop

Sisältää ominaisuudet, jotka ovat hyödyllisiä Iterointitunnisteita-silmukan lohkossa.

Huomautus

forloop-objektia voi käyttää vain Iterointitunnisteita-tunnisteen kanssa.

Koodi

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Tuloste

This is the first child page!

This is child page number 2.

This is child page number 3.

Määritteet

Määrite Kuvaus
Ensimmäinen Palauttaa Tosi-arvon, jos se on silmukan ensimmäinen iteraatio. Palauttaa Epätosi-arvon, jos se ei ole ensimmäinen iteraatio.
index Nykyisen kohteen sijainti kokoelmassa, jossa ensimmäisen kohteen sijainti on 1.
index0 Nykyisen kohteen sijainti kokoelmassa, jossa ensimmäisen kohteen sijainti on 0.
Viimeinen Palauttaa Tosi-arvon, jos se on silmukan viimeinen iteraatio. Palauttaa Epätosi-arvon, jos se ei ole viimeinen iteraatio.
length Palauttaa silmukan iteraatioiden määrän ߝ kokoelman nimikkeiden määrä, joita iteroidaan.
rindex Silmukassa jäljellä olevien kohteiden määrä (length - index), jossa 1 on viimeisen kohteen indeksi.
rindex0 Silmukassa jäljellä olevien kohteiden määrä (length - index), jossa 0 on viimeisen kohteen indeksi.

forums

Tarjoaa mahdollisuuden käyttää ja hahmontaa keskustelupalstoja ja keskustelupalstan kommenttiketjuja. Huomaa, että mahdollisuus käyttää Liquidia keskustelupalstan tietojen hahmontamiseen viesteihin, mutta luodaksesi uuden viestin tai kommenttiketjun, sinun on käytettävä ASP.NET -verkkolomakkeen sivumallia, joka sisältää mainitun toiminnallisuuden (esimerkiksi oletusarvoiset Keskustelupalstan kommenttiketju- ja Keskustelupalstan viestisivu -mallit).

Voit valita keskustelupalstan tai palstan kommenttiketjuja forums-objektin avulla:

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

forums-objektin avulla voit käyttää mitä tahansa portaalin keskustelupalstaa tai kaikkia portaalin palstojen kommenttiketjuja (palstasta huolimatta).

Forum-objektin avulla voit käsitellä yhtä keskustelupalstaa ja kyseisen palstan kommenttiketjuja.

forumthreads-objektin avulla voit käyttää forumthread-objektikokoelmaa. Voit järjestää ja sivuttaa palstan kommenttiketjuja sekä käyttää Liquid-suodatusta.

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

Yksittäinen keskustelupalstan kommenttiketju

forumposts-objektin avulla voit käyttää forumpost-objektikokoelmaa.

Määritteet

Määrite Kuvaus
threads Palauttaa forumthreads-objektin, joka sisältää kaikki portaalin forumthread-objektit.
Kaikki Palauttaa portaalin forum-objektit. Huomaa, että website.forums on myös vastaava.
thread_count Palauttaa koko sivuston kommenttiketjujen määrän kokonaislukuna.
post_count Palauttaa portaalin viestien kokonaismäärän kokonaislukuna.
[keskustelupalstan nimi tai tunnus] Voit käyttää mitä tahansa keskustelupalstaa sen nimen tai tunnuksen perusteella.
`{% assign forum = forums["Forum Name"] %}
{% assign forum = forums["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

forum-objekti

Määritteet

Huomautus

entities

Määrite Kuvaus
threads Palauttaa forumthreads-objektin, joka sisältää kaikki keskustelupalstan kommenttiketjut.
Nimi Keskustelupalstan nimi.
thread_count Palauttaa keskustelupalstan kommenttiketjujen määrän kokonaislukuna.
post_count Palauttaa koko sivuston viestien määrän kokonaislukuna.

forumthreads-objekti

Määritteet

Määrite Kuvaus
Kaikki Palauttaa kaikki kokoelman forumthread-objektit.

forumthread-objekti

Määritteet

Huomautus

entities

Määrite Kuvaus
posts Palauttaa forumposts-objektin, joka sisältää kaikki kommenttiketjun viestit.
author Palauttaa kommenttiketjun tekijän (joka on yksinkertaisesti yhteyshenkilöentiteettiobjekti).
latest_post Palauttaa kommenttiketjun uusimman viestin.
first_post Palauttaa kommenttiketjun ensimmäisen viestin.
post_count Palauttaa kommenttiketjun viestin määrän kokonaislukuna.
is_answered Onko kommenttiketjussa vastaus?
is_sticky Onko kommenttiketju kiinnitetty?

forumposts-objekti

Määritteet

Määrite Kuvaus
Kaikki Palauttaa kaikki kokoelman forumthread-objektit.

Yksittäinen keskustelupalstan viesti

Määritteet

Huomautus

entities

Määrite Kuvaus
author Palauttaa kirjoituksen tekijän (joka on yksinkertaisesti yhteyshenkilöentiteettiobjekti).
content Viestin sisältö.
is_answer Onko viesti kommenttiketjun vastaus?

tietämys

Sen avulla voit käyttää Dynamics 365 knowledgearticle- ja luokan entiteettitietueita artikkeleiden ja luokkien hahmontamiseksi portaalissa.

Määritteet

Määrite Kuvaus
artikkelit Palauttaa articles-objektin, joka sisältää artikkeliobjekteja knowledgearticle-entiteettitietueille, jotka ovat käytettävissä portaalissa.
luokat Palauttaa luokat-objektin, joka sisältää luokkaobjekteja luokka-entiteettitietueille, jotka ovat käytettävissä portaalissa.

articles-objekti

Articles-objektin avulla voit käyttää artikkeliobjektikokoelmaa. Voit järjestää ja sivuttaa artikkeleja myös käyttämällä Liquid-suodatusta.

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

Määritteet

Määrite Kuvaus
suosituimmat Palauttaa artikkelin objektien eniten näkymiä sisältävän kokoelman. {% assign popular_articles = knowledge.articles.popular %}
äskettäiset Palauttaa artikkelin objektien kokoelman, jota on päivitetty kaikkein äskettäin. {% assign recent_articles = knowledge.articles.recent %}
ensimmäiset Palauttaa artikkelin objektien parhaiten arvostellun sisältävän kokoelman. {% assign top_articles = knowledge.articles.top %}

Suodattimet

Seuraavat suodattimet voivat hyväksyä sivun koon ja kielen mukaan valinnaisen parametrin. Ensimmäisenä parametrina on numero tai tietueet, joita haetaan. Sivun oletuskoko on 5. Toinen parametri on kielikoodi, jos haluat hakea artikkeleita tietyllä kielellä. Suodattimia voi yhdistää muiden kanssa muilla Liquid-suodattimilla.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Määrite Kuvaus
suosituimmat Palauttaa artikkelin objektien eniten näkymiä sisältävän kokoelman. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
äskettäiset Palauttaa artikkelin objektien kokoelman, jota on päivitetty kaikkein äskettäin. {% assign recent_articles = knowledge.articles \| recent: 5 %}
ensimmäiset Palauttaa artikkelin objektien parhaiten arvostellun sisältävän kokoelman. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

categories-objekti

Categories-objektin avulla voit käyttää luokka-objektikokoelmaa. Voit järjestää luokkia ja sivuttaa kirjoitukset myös käyttämällä Liquid-suodatusta.

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

Määritteet

Määrite Kuvaus
äskettäiset Palauttaa luokkaobjektien kokoelman, jota on päivitetty kaikkein äskettäin.
top_level Palauttaa luokkaobjektien kokoelman, jolla ei ole ylätason luokkaa.

Suodattimet

Seuraavat suodattimet voivat hyväksyä sivun koon mukaisen valinnaisen parametrin. Sivun oletuskoko on 5. Suodattimia voi yhdistää muiden kanssa muilla Liquid-suodattimilla.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Määrite Kuvaus
äskettäiset Palauttaa luokkaobjektien kokoelman, jota on päivitetty kaikkein äskettäin. Voit tarjota parametrit {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Palauttaa luokkaobjektien kokoelman, jolla ei ole ylätason luokkaa. {% assign root_categories = knowledge.categories \| top_level %}

article Object

Artikkeli-objektin avulla voit käyttää yksittäistä knowledgearticlea näyttämään kyseisen artikkelin tiedot portaalissa.

Määritteet

artikkeli on entiteetti-objekti, jolla on kaikki samat määritteet alla olevien määritteiden lisäksi.

Määrite Kuvaus
article_public_number Artikkelin julkinen numero.
comment_count Kokonaislukuna ilmaistu kirjoitukselle annettujen kommenttien määrä.
content Artikkelin sisältö.
current_user_can_comment Palauttaa totuusarvon, joka ilmaisee, voiko käyttäjä lisätä kommentteja artikkeliin.
is_rating_enabled Palauttaa totuusarvon, joka ilmaisee, onko artikkelin luokitus otettu käyttöön.
keywords Artikkelin avainsanat.
Nimi Artikkelin otsikon vaihtoehtoinen tunnus.
rating Artikkelin desimaaliluokitusarvo.
title Artikkelin otsikko.
view_count Artikkelin katselukertojen määrä kokonaislukuna.

category Object

Luokkaobjektin avulla voit käyttää yksittäistä luokkaa näyttämään tietonsa portaalissa.

Määritteet

luokka on entiteetti-objekti, jolla on kaikki samat määritteet alla olevien määritteiden lisäksi.

Määrite Kuvaus
categorynumber Luokan numero.
Nimi Luokan otsikon vaihtoehtoinen tunnus.
title Luokan otsikko.

sivun

Viittaa nykyiseen portaalin pyyntösivuun. Tässä objektissa yhdistetään sitemap-määritteet ja nykyisen pyynnön entities (yleensä sivusto).

Sivuobjekti mahdollistaa pääsyn esimerkiksi nykyisen sivun navigointipolkuun tai otsikkoon sekä muihin taustalla olevan Dynamics 365 -tietueen määritteisiin ja liittyviin entiteetteihin.

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

Sivun määritteet

Huomautus

entities

Määrite Kuvaus
breadcrumbs Palauttaa sivun navigointipolun sivustokartan solmuobjekteille, alkaen sivustokartan pääsolmusta ja päättyen päätasoon.
children Palauttaa sivun sivustokartan alitason solmuobjektit.
parent Palauttaa sivun sivustokartan ylätason solmuobjektit. Jos sivu on kotisivu, päätaso on tyhjäarvo.
title Sivun otsikko.
URL-osoite Sivun URL-osoite.
[määritteen tai suhteen nimi] Voit käyttää mitä tahansa sivun pohjana olevaa Dynamics 365 -tietuetta loogisen nimen perusteella.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Useimmat entiteettimääritteiden arvot yhdistetään suoraan Liquid types -objektiin: kahden asetuksen kentät yhdistyvät totuusarvoihin, tekstikentät merkkijonoihin, numeeriset-/valuuttakentät lukuihin, päivä-/aikakentät päivämääräobjekteihin. Jotkin määritetyypit palautetaan kuitenkin objekteina:
  • Hakukentät (entiteettiviittaus) palautetaan entities-objekteina.
  • Asetusjoukon/valintaluettelon kentät palautetaan entities-objekteina.
  • Voit myös ladata minkä tahansa liittyvän entiteetin suhderakenteen nimen mukaan.
    {{ page.adx_webpage_entitylist.adx_name }}
    Siinä tapauksessa, että suhde on refleksiivinen (eli itseensä viittaava), palautetaan entities-objekti. (Muussa tapauksessa tulos olisi epäselvä.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Huomautus: Jos lataat suuren määrän liittyviä entiteettejä tai käytät suurta määrää suhteita yhdessä mallissa, mallin hahmontamisen suorituskyky voi heikentyä. Vältä liittyvien entiteettien lataamista jokaisessa matriisin kohteessa silmukan sisällä. Käytä mieluummin mahdollisuuksien mukaan Dynamics 365 entiteettitunnisteita entiteettijoukkojen lataamiseen.

polls

Tarjoaa mahdollisuuden käyttää ja hahmontaa kyselyjä.

polls-objektin avulla voit valita tietyn kyselyn tai kyselysijoittelun:

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

Kyselyiden määritteet

Määrite Kuvaus
placements Palauttaa pollplacements-objektin.
[kyselyn nimi tai tunnus] Voit käyttää mitä tahansa kyselyä sen nimen tai tunnuksen perusteella. {% assign poll = polls["Poll Name"] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Kyselysijoittelujen määritteet

Määrite Kuvaus
[kyselysijoittelun nimi tai tunnus] Voit käyttää mitä tahansa kyselysijoittelua sen nimen tai tunnuksen perusteella.{% assign placement = polls.placements["Placement Name or Id"] %}
{% assign placement = polls.placements["7677c5d4-406e-4b6c-907c-916ac17dba0f"] %}

Kyselysijoittelun määritteet

Huomautus

entities

Määrite Kuvaus
Nimi Palauttaa kyselysijoittelun nimikentän.
placement_url URL-osoite, jonka avulla mallin täysin hahmontama kyselysijoittelu voidaan noutaa.
polls Palauttaa kokoelman sijoitteluun liittyviä kyselyobjekteja. Iterointitunnisteita ja matriisin suodattimia voi käyttää tässä kokoelmassa.
random_url URL-osoite, jonka avulla mallin täysin hahmontamasta kyselysijoittelusta voidaan noutaa satunnainen kysely.
submit_url URL-osoite, johon valmis kysely lähetetään.

Kyselyn määritteet

Huomautus

entities

Määrite Kuvaus
has_user_voted Palauttaa arvon tosi, jos nykyinen käyttäjä (kirjautunut tai anonyymi) on jo antanut äänensä tähän kyselyyn.
Nimi Palauttaa kyselyn nimikentän.
options Palauttaa kokoelman kyselyyn liittyviä poll option -objekteja. Iterointitunnisteita ja entiteettejä voi käyttää tässä kokoelmassa.
poll_url URL-osoite, jonka avulla mallin täysin hahmontama kysely voidaan noutaa.
-kysymys Palauttaa kyselyn Kysymys-kentän.
submit_button_label Palauttaa merkkijonon, jonka avulla voidaan kyselyn Lähetä-painikkeen otsikko voidaan ohittaa.
submit_url URL-osoite, johon valmis kysely lähetetään.
user_selected_option Palauttaa (jo äänestäneen) käyttäjän valitseman polloption-objektin.
votes Palauttaa kyselyyn taulukoitujen äänien määrän.

Kyselyasetuksen määritteet

Huomautus

entities

Määrite Kuvaus
answer Palauttaa kyselyn Vastaus-kentän.
percentage Palauttaa kyselyn äänten prosenttiosuuden vaihtoehdolle kokonaislukuna väliltä 0–100.
votes Palauttaa vaihtoehdolle taulukoitujen äänien määrän.

pyyntö

Sisältää tietoja nykyisestä HTTP-pyynnöstä.

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

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

Huomautus

Voit luoda URL-osoitteet dynaamisesti Liquidin URL-suodattimien avulla.

Määritteet

Määrite Kuvaus
params Nykyisen pyynnön nimettyjen parametrien arvot. params on yhdistelmä URL-osoitteen kyselymerkkijonon parametreja, lomakkeen lähetysparametreja ja evästeitä.
Polku Nykyisen pyynnön URL-osoitteen polku.
/profile/
path_and_query Nykyisen pyynnön URL-osoitteen polku ja kysely.
/profile/?foo=1&bar=something
kysely Nykyisen pyynnön URL-osoitteen kyselyosa.
?foo=1&bar=something
URL-osoite Nykyisen pyynnön täysi URL-osoite.
http://www.example.com/profile/?foo=1&bar=something

searchindex

Searchindex-objektia käytetään Dynamics 365 entiteettitunnisteiden kanssa esittämään kyselyn tulokset.

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

Määritteet

Määrite Kuvaus
approximate_total_hits Palauttaa indeksin kyselyä vastaavien osumien arvioidun määrän. Huomaa, että tämä luku on vain arvio johtuen hakuindeksin toiminnasta suojaavan suodatuksen ja muiden suunnittelunäkökohtien osalta, eikä se välttämättä vastaa täysin tulosten todellista määrää, joka on käyttäjän käytettävissä tietyissä tilanteissa.
Sivu Palauttaa nykyisen kyselyn sivunumeron.
page_size Palauttaa nykyisen kyselyn sivun enimmäiskoon. Huomaa, että jos haluat nykyiseltä sivulta tulosten todellisen määrän (koska tämä voi olla pienempi kuin määritetty sivun enimmäiskoko), käytä results.size-objektia.
Tulokset Palauttaa kyselyn tulossivun hakuindeksin tulosobjekteina.

Hakuindeksin tulokset

Määrite Kuvaus
entiteetti Tuloksen taustalla olevat entities-objektit.
fragment Asiaankuuluva lyhyt teksti tuloksesta, jossa kyselyn ehtoja vastaavat sanat ovat korostettuna <em>-HTML-tunnisteen avulla. Huomaa, että tietyntyyppiset kyselyt eivät tue korostettuja palasia, kuten sumeat- (~) ja yleismerkkikyselyt (*). Tämän ominaisuuden arvo on nolla näissä tapauksissa.
Tunniste Tuloksen pohjalla olevan tietueen Dynamics 365 -entiteetin tunnus merkkijonona. Esimerkki: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Tuloksen pohjalla olevan tietueen Dynamics 365 -entiteetin looginen nimi. Esimerkki: adx_webpage
Numero Tuloksen järjestysnumero sivuilla, alkaen numerosta 1. Esimerkiksi kun sivun koko on 10, ensimmäinen tulos toisella tulossivulla on 11.
score Tuloksen Lucene-arvo liukulukuna. Tulokset palautetaan tämän arvon mukaisesti järjestettynä.
title Tuloksen otsikko.
URL-osoite Tuloksen URL-osoite. Tämä on yleensä — mutta ei välttämättä — absoluuttinen polku nykyiseen sovellukseen täydellisen URL-osoitteen sijasta. Esimerkiksi: /articles/article1/

Asetukset

Mahdollistaa minkä tahansa Sivuston asetusten määrittäminen portaalille -kohdan lataamisen nimen mukaan. Jos nimeä vastaavaa asetusta ei löydy, Liquid types palautetaan.

Huomautus

Asetukset palautetaan Liquid types -objekteina, mutta voit muuntaa ne muiksi tyypeiksi käyttämällä Type filters -objekteja.

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

sivustokartta

Antaa oikeudet portaalin sivustokartan tarkasteluun.

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

Sivustokartan määritteet

Määrite Kuvaus
Nykyinen Palauttaa nykyisen sivun sivustokarttasolmun objektin.
Päätaso Palauttaa sivuston pääsivun sivustokarttasolmun objektin.

Sivustokartan solmun määritteet

Määrite Kuvaus
Navigointipolku Palauttaa solmun navigointipolun sivustokartan solmuobjekteille, alkaen sivustokartan pääsolmusta ja päättyen päätasoon.
Alikohteet Palauttaa solmun sivustokartan alasolmuobjektit.
Kuvaus Solmun kuvaus/yhteenveto. (Tämä kenttä voi sisältää HTML-koodia.)
Entiteetti Palauttaa solmun pohjana olevat entities-objektit. Jos solmulla ei ole pohjana olevaa entiteettiä, tämä arvo on tyhjäarvo.
is_sitemap_ancestor Palautusarvo on Tosi, jos sivustokartan solmu on nykyistä solmua ylemmällä tasolla, muuten palautusarvo on Epätosi.
is_sitemap_current Palautusarvo on Tosi, jos sivustokartan solmu on nykyinen solmu, muuten palautusarvo on Epätosi.
Päätaso Palauttaa solmun sivustokartan ylätason solmuobjektit. Jos solmu on juurisolmu, pääsolmu on tyhjäarvo.
Ammattinimike Solmun otsikko.
URL-osoite Solmun URL-osoite.

Sivustomerkinnät

Mahdollistaa minkä tahansa sivustomerkinnän lataamisen nimen perusteella. Jos sivustomerkintä on olemassa, sitemarker-objekti palautetaan. Jos nimeä vastaavaa sivustomerkintää ei löydy, Liquid types palautetaan.

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

Sivustomerkinnän määritteet

Määrite Kuvaus
URL-osoite Sivustomerkinnän kohteen URL-osoite.
[määritteen looginen nimi] Voit käyttää mitä tahansa sivustomerkinnän kohteena olevaa Dynamics 365 -tietuetta loogisen nimen perusteella. Esimerkki: {{ sitemarker.adx_name }}

snippets

Mahdollistaa minkä tahansa sisältökatkelman lataamisen nimen perusteella. Jos nimeä vastaavaa katkelmaa ei löydy, Null palautetaan.

{{ snippets["Header"] }}

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

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Sisältää ominaisuudet, jotka ovat hyödyllisiä Iterointitunnisteita-silmukan lohkossa.

Huomautus

Tablerowloop-objektia voi käyttää vain Iterointitunnisteita -tunnisteen kanssa.

Määritteet

Määrite Kuvaus
Col Palauttaa nykyisen rivin indeksin aloittaen kohdasta a.
col0 Palauttaa nykyisen rivin indeksin aloittaen kohdasta 0.
col_first Palauttaa Tosi-arvon, jos nykyinen sarake on rivin ensimmäinen sarake, ja Epätosi-arvon, jos se ei ole.
col_last Palauttaa Tosi-arvon, jos nykyinen sarake on rivin viimeinen sarake, ja Epätosi-arvon, jos se ei ole.
Ensimmäinen Palauttaa Tosi-arvon, jos se on silmukan ensimmäinen iteraatio. Palauttaa Epätosi-arvon, jos se ei ole ensimmäinen iteraatio.
Indeksi Nykyisen kohteen sijainti kokoelmassa, jossa ensimmäisen kohteen sijainti on 1.
index0 Nykyisen kohteen sijainti kokoelmassa, jossa ensimmäisen kohteen sijainti on 0.
Viimeinen Palauttaa Tosi-arvon, jos se on silmukan viimeinen iteraatio. Palauttaa Epätosi-arvon, jos se ei ole viimeinen iteraatio.
Pituus Palauttaa silmukan iteraatioiden määrän ߝ kokoelman nimikkeiden määrä, joita iteroidaan.
Rindex Silmukassa jäljellä olevien kohteiden määrä (length - index), jossa 1 on viimeisen kohteen indeksi.
rindex0 Silmukassa jäljellä olevien kohteiden määrä (length - index), jossa 0 on viimeisen kohteen indeksi.

käyttäjä

Viittaa portaalin nykyiseen käyttäjään ja sallii kaikkien taustalla olevan Dynamics 365:n yhteyshenkilötietueen määritteiden käytön. Jos kirjautunutta käyttäjää ei ole, tämä muuttuja on Liquid types

user on entities.

{% if user %}

Hello, {{ user.fullname }}!

{% else %}

Hello, anonymous user!

{% endif %}

Määritteet

Sen lisäksi, että sillä on kaikki entities-objektin määritteet, käyttäjällä on seuraavat määritteet.

Viittaa portaalin website-objektiin ja sallii portaalin kaikkien Dynamics 365:n sivuston (adx_website) määritteiden käytön.

Huomautus

entities

Koodi

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

Tuloste

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

sivusto

Mahdollistaa minkä tahansa weblinks-objektin lataamisen nimen tai tunnuksen perusteella.

Jos verkkolinkkijoukko on olemassa, palautetaan verkkolinkkijoukon objekti. Jos verkkolinkkijoukkoa ei löydy nimen tai tunnuksen perusteella, palautetaan Liquid types.

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

Huomautus

entities

Määrite Kuvaus
Tekstisisältö Verkkolinkkijoukon HTML-kopio.
Nimi Verkkolinkkijoukon nimi.
Ammattinimike Verkkolinkkijoukon otsikko.
Verkkolinkit Verkkolinkkijoukkoon liittyvä verkkolinkkiobjektien matriisi.
[määritteen looginen nimi] Voit käyttää mitä tahansa verkkolinkkijoukon Dynamics 365 -tietuetta loogisen nimen perusteella. Esimerkki: {{ weblinkset.createdon }}

Huomautus

kohteet

Määrite Kuvaus
Kuvaus Verkkolinkin HTML-kuvaus.
display_image_only Totuusarvo, joka ilmaisee, tuleeko verkkolinkki näyttää vain kuvana ilman linkin tekstiä.
display_page_child_links Totuusarvo, joka ilmaisee, näytetäänkö verkkolinkissä linkitetyn sivun sitemap-alisivut alilinkkeinä.
Kuva Linkin verkkolinkin kuvaobjekti. Tämä määrite on tyhjä, jos kuvaa ei ole.
is_external Totuusarvo, joka ilmaisee, onko verkkolinkin kohteen URL-osoite ulkoisessa sivustossa (sisäisen portaalisivun sijaan).
is_sitemap_ancestor Palautusarvo on Tosi, jos verkkolinkin URL-osoite viittaa sivustokartan nykyistä solmua ylemmälle tasolle. Muuten palautusarvo on Epätosi.
is_sitemap_current Palautusarvo on Tosi, jos verkkolinkin URL-osoite viittaa sivustokartan nykyiseen solmuun. Muuten palautusarvo on Epätosi.
Nimi Verkkolinkin nimi/otsikko.
Nofollow Totuusarvo, joka ilmaisee, tulisiko verkkolinkki merkitä näin: rel="nofollow".
open_in_new_window Totuusarvo, joka ilmaisee, avautuuko verkkolinkki uuteen selainikkunaan/-välilehteen valittaessa.
Työkaluvihje Verkkolinkin työkaluvihjeen teksti.
URL-osoite Verkkolinkin URL-osoite.
Verkkolinkit Verkkolinkkijoukkoon liittyvä verkkolinkkien aliobjektien matriisi.
[määritteen looginen nimi] Voit käyttää mitä tahansa verkkolinkin Dynamics 365 -tietuetta loogisen nimen perusteella. Esimerkki: {{ weblink.createdon }}
alternate_text Kuvan vaihtoehtoinen teksti.
Korkeus Kokonaisluku, joka sisältää kuvan korkeuden. Jos korkeusarvoa ei ole annettu, määritteen arvo on nolla.
URL-osoite Kuvan URL-osoite.
Leveys Kokonaisluku, joka sisältää kuvan leveyden. Jos leveysarvoa ei ole annettu, määritteen arvo on nolla.

Katso myös

Dynaamisen sisällön lisääminen ja mukautettujen mallien luominen
Liquid types
Liquid Objects
Liquid-tunnisteet
Liquid-suodattimet