Käytettävissä olevat Liquid-objektit

Liquid-objektit sisältävät määritteitä, joilla tuotetaan dynaamista sisältöä sivulle. Objektilla page on esimerkiksi määrite nimeltä title , jonka avulla voit tulostaa nykyisen sivun otsikon.

Jos haluat käyttää objektimääritettä nimen mukaan, käytä pistettä (.). Jos haluat hahmontaa objektin määritteen mallissa, rivitä se kohteeseen {{ ja }}.

{{ page.title }}

Objektin määritteitä voidaan käyttää myös merkkijonon nimen ja []-merkkien avulla. Tästä muodosta on hyötyä, jos tarvittu määrite määritetään dynaamisesti tai määritteen nimessä on esimerkiksi merkkejä, välilyöntejä ja erikoismerkkejä, jotka olisivat virheellisiä, kun käytetään pistettä (.) syntaksin sisällä.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Voit käyttää seuraavia objekteja missä tahansa kohdassa mitä tahansa mallia.

ads

Mahdollistaa mainoksen noutamisen ja näyttämisen.

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

Mainossijoittelujen määritteet

Mainossijainnin määritteet

Mainoksen sijoittelu on taulukko-objekti, jolla on samat yleiset määritteet ja seuraavat määritteet:

Mainoksen määritteet

Mainoskuvamääritteet

blogs

Mahdollistaa blogien ja blogikirjoituksten noutamisen ja näyttämisen.

Blogit-objektin avulla voit valita tietyn blogi- tai blogikirjoituksen.

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

blogit-objekti

Blogit-objektin avulla voit käyttää mitä tahansa tiettyä blogia portaalissa tai käyttää kaikkia blogikirjoituksia portaalissa.

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

{% assign blog = blogs["Blog Name"] %}                             

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

blog-objekti

Blogiobjekti toimii yhdessä blogissa, joten voit käyttää kyseisen blogin julkaisuja.

Seuraavassa taulukossa kerrotaan blogiobjektiin liittyvistä eri määritteistä.

blogposts-objekti

Blogimerkintäobjektin avulla voit käyttää blogikirjoituksen objektien kokoelmaa. Voit tilata blogijulkaisut ja tehdä sivutuksen käyttämällä nestemäisiä suodattimia.

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

Muita mahdollisia vaihtoehtoja ovat:

• blogs.posts.all (saat kaikki blogimerkinnät)
• blogs.posts | from\_index: 0 | take: 2

Seuraavassa taulukossa on kuvattu blogijulkaisujen objektiin liittyviä eri määritteitä.

blogpost-objekti

Viittaa yhteen blogikirjoitukseen.

Seuraavassa taulukossa selitetään blogijulkaisuobjektiin liittyviä eri määritteitä.

Yhteisöt

Lataa mikä tahansa Dataverse-taulukko tunnuksen mukaan tämän objektin avulla. Jos taulukko on olemassa, se palauttaa taulukko-objektin. Jos taulukkoa, jolla on annettu tunnus, ei löydy, se palauttaa tyhjäarvon.

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

{% if account %}

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

{% endif %}

{% assign entity_logical_name = 'contact' %}

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

{% if contact %}

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

{% endif %}

Entiteetti

Entiteettiobjekti antaa mahdollisuus käyttää Dataverse -taulukkotietueen määritteitä.

Liitetty taulukkoviittaus

Hakumääritteiden arvot palautetaan liittyvän taulukon viittausobjekteina, joilla on seuraavat määritteet.

Muistio

Muistiinpano on taulukko-objekti, jolla voi käyttää huomautustietueen määritteitä ja suhteita. Taulukko-objektin kaikkien määritteiden lisäksi muistiinpanolla on seuraavat lisämääritteet.

Valintakokonaisuuden arvo

Asetusjoukon tai valintaluettelon määritteiden arvot palautetaan liitetyn taulukon viittausobjekteina, joilla on seuraavat määritteet.

Taulukon oikeudet

Taulukko-oikeuksien objekti antaa mahdollisuuden käyttää taulukon koottuja oikeuksien vahvistustuloksia.

Refleksiivinen suhde

Yritykset ladata refleksivejä (eli itseensä viittaavia) suhteita entiteetteihin palautuvat objekteina, joilla on seuraavat määritteet.

entiteettiluettelo

Käytä Dataverse-taulukonentitylist tunnisteissa olevaa objektia, kun haluat käyttää kaikkia tietyn luettelon määritteitä.

Määritteet

Luettelonäkymän määritteet

Luettelonäkymän sarakemääritteet

entityview

Käytä entiteettinäkymäobjektia entiteettinäkymätunnisteessa. Se tarjoaa näkymän metatietojen käytön tulostietueiden tarkastelun lisäksi.

Määritteet

tapahtumat

Mahdollistaa tapahtumien noutamisen ja näyttämisen. Events-objektin avulla voit valita tietyn tapahtuman tai kaikki tapahtumat.

events object

Objektin events avulla voit käyttää tiettyä tapahtumaa portaalissa tai kaikkia portaalin tapahtumia.

- events objektilla on seuraavat määritteet:

tapahtumaobjekti

Objektin event avulla voit käsitellä yksittäistä tapahtumaa. Voit käyttää tapahtuman aikatauluja ja esiintymiä.

- event objektilla on seuraavat määritteet:

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

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

Seuraavat määritteet liittyvät eventoccurrences-objektiin

eventoccurence-objekti

Edustaa yhden tapahtuman esiintymää. Seuraavat ovat tähän liittyvät määritteet:

forloop

Sisältää ominaisuuksia, jotka ovat hyödyllisiä for-silmukkalohkossa.

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

Tulos

This is the first child page!

This is child page number 2.

This is child page number 3.

Määritteet

foorumit

Mahdollistaa keskustelupalstojen ja keskustelupalstakirjoitusten noutamisen ja näyttämisen. Mahdollisuus käyttää Liquidia keskustelupalstatietojen hahmontamiseen ulottuu julkaisuihin, mutta luodaksesi uuden viestin tai säikeen, sinun on käytettävä ASP.NET-monivaiheiset lomakkeet Sivumallia, jossa on mainittu toiminto (kuten oletusarvoiset keskusteluketju- ja keskusteluviestisivumallit).

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 object

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

Keskustelupalstaobjektin avulla voit käsitellä yhtä keskustelupalstaa, jotta voit käyttää kyseisen keskustelupalstan säikeitä.

forumthreads-objektin avulla voit käyttää forumthread-objektikokoelmaa. Voit tilata keskustelupalstan säikeet ja sivutuksen käyttämällä Liquid-suodattimia.

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

Yksittäinen keskustelupalstaketju

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

Määritteet

forum-objekti

Määritteet

forumthreads-objekti

Määritteet

forumthread-objekti

Määritteet

forumposts-objekti

Määritteet

Yksittäinen keskustelupalstan viesti

Määritteet

tiedot

Sen avulla voi käyttää Dataverse tietoartikkelin ja luokan taulukkotietueita artikkeleiden ja luokkien hahmontamiseen portaalissa.

Määritteet

artikkelien 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

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

Luokkaobjekti

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

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

artikkelin objekti

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 seuraavien määritteiden lisäksi:

luokkaobjekti

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 seuraavien määritteiden lisäksi:

kieli

Antaa nykyisen kielen nimen ja kielikoodin, jos usean kielen tuki on käytössä.

Määritteet

Esimerkiksi kielipudotusvalikon verkkomalli näyttää käytettävissä olevat kielet oletusarvoisesti tämän Liquid-objektin avulla, kun käytettävissä on useita kieliä.

kirjata

Tekijät voivat lisätä Liquid-koodiinsa lokilausekkeita. Kun Power pages sivustoa suoritetaan, Liquid-koodiin tekijän lisäämät lokit näytetään Power Pages developer tool extension. Nämä tekijän upottamat lokit näytetään kehittäjien työkalujen laajennuksessa, kun diagnostiikka-asetus on käytössä.

Seuraavaa syntaksia voidaan käyttää Liwuid-koodissa mukautettujen sanomien kirjaamiseen:

{% log message:'Custom message' level:'Warning' %}

Lokimääritteet

Esimerkki:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

sivu

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

äänestykset

Mahdollistaa kyselyn noutamisen ja näyttämisen.

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

Kyselysijoittelujen määritteet

Kyselysijoittelun määritteet

Kyselyn määritteet

Kyselyasetuksen määritteet

pyyntö

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

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

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

Määritteet

hakuhakemisto

Searchindex-objektia käytetään Dataverse-taulukkotunnisteissa ja antaa mahdollisuuden käyttää kyselyn tuloksia.

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

Hakuindeksin tulokset

palvelinlogiikka

Liquid-mallin hahmonnuksen serverlogic aikana tunniste käynnistää palvelinlogiikkatoiminnon. - output tunnisteen serverlogic parametri luo -objektin. Objekti ei ole käytettävissä yleisenä Liquid-objektina.

Syntaksi

{% serverlogic name: 'server-logic-name', operation: 'operation-name', input: inputData, output: result %}

Parametrit

Seuraava esimerkki välittää JSON-syötteen palvelinlogiikkatoimintoon:

{% assign inputData = '{"category":"active","maximumResults":5}' %}

{% serverlogic name: 'customer-summary', operation: 'getSummary', input: inputData, output: result %}

{% if result.success %}
  <p>{{ result.data.message | escape }}</p>
{% else %}
  <p>The customer summary couldn't be retrieved.</p>
{% endif %}

Lue syöte palvelinlogiikkatoiminnolla Server.Context.Input :

function getSummary() {
    var input = JSON.parse(Server.Context.Input || "{}");

    return JSON.stringify({
        message: "Summary retrieved",
        category: input.category,
        maximumResults: input.maximumResults
    });
}

Lisätietoja on kohdassa Kutsu palvelimen logiikka Liquid-kohdasta.

Määritteet

asetukset

Lataa mikä tahansa sivuston asetus nimen mukaan tämän objektin avulla. Jos portaali ei löydä asetusta, jolla on etunimi, se palauttaa tyhjäarvon.

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

Tämän objektin avulla voit käyttää portaalin sivustokarttaa.

<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

Sivustokartan solmumääritteet

Sivustomerkinnät

Mahdollistaa minkä tahansa sivustomerkinnän lataamisen nimen perusteella. Jos sivustomerkintä on olemassa, sitemarker-objekti palautetaan. Jos nimeä vastaavaa sivustomerkintää ei löydy, tyhjäarvo 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 %}

Sitemarker-määritteet

koodinpätkät

Mahdollistaa minkä tahansa sisältökatkelman lataamisen nimen perusteella. Jos nimeä vastaavaa koodikatkelmaa ei löydy, tyhjäarvo 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.

Määritteet

Käyttäjä

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

Käyttäjä on entiteetti-objekti.

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

Määritteet

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

Verkkolinkit

Mahdollistaa minkä tahansa verkkolinkin lataamisen nimen tai tunnuksen perusteella.

Jos verkkolinkkijoukko on olemassa, palautetaan verkkolinkkijoukon objekti. Jos verkkolinkkijoukkoa ei löydy nimen tai tunnuksen perusteella, palautetaan tyhjäarvo.

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

Verkkolinkkijoukkojen määritteet

Verkkolinkin määritteet

Verkkolinkin kuvien määritteet

sivusto

Viittaa portaalin sivustoon ja sallii portaalin kaikkien Dataverse-sivuston (adx_website) määritteiden käytön.

Koodi

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

Tulos

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

Määritteet

Seuraavassa taulukossa on esitetty tämän tunnisteen määritteet, joita voidaan käyttää korvaamaan oletusarvot välimuistin välttämiseksi.

Katso myös

Liquid-tyypit
Liquid-tunnisteet
Liquid-suodattimet