Oggetti Liquid disponibili

Gli oggetti Liquid contengono gli attributi per emettere il contenuto dinamico alla pagina. Ad esempio, l'oggetto page ha un attributo denominato title che è possibile usare per restituire il titolo della pagina corrente.

Per accedere a un attributo dell'oggetto in base al nome, usare un punto (.). Per eseguire il rendering dell'attributo di un oggetto in un modello, eseguirne il wrapping in {{ e }}.

{{ page.title }}

È inoltre possibile accedere agli attributi di un oggetto utilizzando un nome stringa e []. Questo formato è utile nei casi in cui l'attributo richiesto è determinato dinamicamente o il nome dell'attributo contiene caratteri, spazi, caratteri speciali e così via che non sarebbero validi in caso di utilizzo di un punto (.) all'interno della sintassi.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

È possibile usare e accedere agli oggetti seguenti ovunque, in qualsiasi modello.

Annunci

Consente il recupero e la visualizzazione di un annuncio.

L'oggetto ads consente di selezionare uno specifico annuncio o posizionamento dell'annuncio:

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

Attributi annunci

Attributi posizionamenti annunci

Attributi di posizionamento degli annunci

Un posizionamento di annunci è un oggetto tabella con gli stessi attributi generali e i seguenti attributi:

Attributi annuncio

Attributi dell'immagine degli annunci

blog

Abilita il recupero e la visualizzazione di blog e blog.

L'oggetto blogs consente di selezionare un blog o un post di blog specifico.

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

oggetto blogs

L'oggetto blogs consente di accedere a qualsiasi blog specifico nel portale o di accedere a tutti i post di blog nel portale.

Nella tabella seguente vengono illustrati gli attributi associati all'oggetto blogs.

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

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

Oggetto blog

L'oggetto blog funziona con un singolo blog, in modo da poter accedere ai post per tale blog.

Nella tabella seguente vengono illustrati vari attributi associati all'oggetto blog.

Oggetto blogposts

L'oggetto blogposts consente di accedere a una raccolta di oggetti di post di blog. È possibile ordinare i post di blog e ottenere la paginazione usando filtri liquidi.

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

Altre opzioni possibili includono:

• blogs.posts.all (per ottenere tutti i post di blog)
• blogs.posts | from\_index: 0 | take: 2

Nella tabella seguente vengono illustrati i vari attributi associati all'oggetto blogposts.

Oggetto blogpost

Fa riferimento a un singolo post di blog.

Nella tabella seguente vengono illustrati i vari attributi associati all'oggetto blogpost.

entities

Utilizzare questo oggetto per caricare qualsiasi tabella Dataverse in base all'ID. Se la tabella esiste, restituisce un oggetto tabella. Se non viene trovata una tabella con l'ID specificato, restituisce Null.

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

Entità

Un oggetto entità fornisce l'accesso agli attributi di un record di tabelle Dataverse.

Riferimento tabella associata

I valori dell'attributo di ricerca vengono restituiti come oggetti di riferimento della tabella associata, con gli attributi seguenti.

Annotazioni

Una nota è un oggetto tabella che consente l'accesso agli attributi e alle relazioni di un record annotation. Oltre a tutti gli attributi di un oggetto tabella, una nota dispone di uno dei seguenti attributi aggiuntivi.

Valore di Set di opzioni

I valori dell'attributo di tipo set di opzioni/Picklist vengono restituiti come oggetti di riferimento della tabella associata, con gli attributi seguenti.

Autorizzazioni della tabella

L'oggetto Autorizzazioni tabella consente l'accesso ai risultati di asserzione di autorizzazione aggregati per una tabella.

Relazione riflessiva

Tenta di caricare relazioni riflessive (ovvero auto-referenziale) sulle entità restituite come oggetti con gli attributi seguenti.

entitylist

Utilizzare l'oggetto entitylist all'interno dei tag della tabella Dataverse per accedere a tutti gli attributi di un determinato elenco.

Attributi

Attributi visualizzazione elenco

Attributi delle colonne della visualizzazione elenco

entityview

Usare l'oggetto entityview all'interno del tag entityview. Fornisce l'accesso ai metadati per la vista, oltre a visualizzare i record dei risultati.

Attributi

events

Consente il recupero e la visualizzazione di un annuncio. L'oggetto events consente di selezionare un evento specifico o tutti gli eventi.

oggetto events

Usare l'oggetto events per accedere a un evento specifico nel portale o per accedere a tutti gli eventi nel portale.

L'oggetto events ha gli attributi seguenti:

oggetto di evento

Utilizzare l'oggetto event per lavorare con un singolo evento. È possibile accedere alle pianificazioni e alle occorrenze per l'evento.

L'oggetto event ha gli attributi seguenti:

Oggetto eventoccurences

L'oggetto eventoccurrences consente di accedere a una raccolta di oggetti di ricorrenze evento. Puoi ordinare le ricorrenze evento e specificare un intervallo di date per le ricorrenze da recuperare, nonché ottenere l'impaginazione e utilizzare i filtri Liquid:

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

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

Gli attributi seguenti sono associati all'oggetto eventoccurrences

Oggetto eventoccurence

Rappresenta una singola ricorrenza evento. Gli attributi associati sono i seguenti:

forloop

Contiene le proprietà utili in un blocco del ciclo per.

Codice

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Output

This is the first child page!

This is child page number 2.

This is child page number 3.

Attributi

forum

Abilita il recupero e la visualizzazione di forum e thread del forum. La possibilità di utilizzare il linguaggio Liquid per eseguire il rendering dei dati del forum si estende ai post, ma per creare un nuovo post o un nuovo thread, è necessario utilizzare un modello di pagina di moduli multistep ASP.NET con funzionalità integrate (come i Modelli di Pagina predefiniti per Thread di Forum e Post di Forum).

L'oggetto dei forum consente di selezionare un forum o i thread del forum:

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

oggetto forum

L'oggetto dei forum consente di accedere a un forum specifico nel portale, o di accedere a tutti i thread del forum nel portale (indipendentemente dal forum).

L'oggetto forum consente di lavorare con un singolo forum, in modo da poter accedere ai thread per tale forum.

L'oggetto forumthreads consente di accedere a una raccolta di oggetti forumthread. È possibile ordinare i thread del forum e ottenere l'impaginazione usando filtri Liquid.

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

Un singolo thread del forum

L'oggetto forumposts consente di accedere a una raccolta di oggetti forumpost.

Attributi

Oggetto forum

Attributi

Oggetto forumthreads

Attributi

Oggetto forumthread

Attributi

Oggetto forumposts

Attributi

Un singolo post del forum

Attributi

conoscenza

Consente l'accesso agli elementi knowledgearticle di Dataverse e ai record delle tabelle delle categorie per eseguire il rendering di articoli e categorie in un portale.

Attributi

oggetto articoli

L'oggetto articoli consente di accedere a una raccolta di oggetti articolo. Puoi ordinare gli articoli e ottenere l'impaginazione anche utilizzando i filtri Liquid.

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

Attributi

Filtri

I filtri seguenti possono accettare parametri facoltativi per le dimensioni e la lingua della pagina. Il primo parametro è il numero o i record da recuperare. La dimensione predefinita della pagina 5. Il secondo parametro è il codice di una lingua per recuperare gli articoli per la lingua specifica. I filtri possono essere combinati con altri filtri Liquid.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}

Oggetto Categories

L'oggetto categories consente di accedere a una raccolta di oggetti category. Puoi ordinare gli oggetti categories ed eseguire la paginazione anche utilizzando i filtri Liquid.

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

Attributi

Filtri

I filtri seguenti possono accettare un parametro facoltativo per le dimensioni della pagina. La dimensione predefinita della pagina 5. I filtri possono essere combinati con altri filtri Liquid.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

oggetto article

L'oggetto article consente di utilizzare un singolo elemento knowledgearticle per visualizzare dettagli dell'articolo nel portale.

Attributi

L'articolo è un oggetto entità, con tutti gli stessi attributi oltre a quelli elencati di seguito:

oggetto category

L'oggetto category consente di utilizzare una singola categoria per visualizzarne i dettagli nel portale.

Attributi

la categoria è un oggetto entità, con tutti gli stessi attributi oltre a quelli elencati di seguito:

language

Fornisce il nome della lingua corrente e il codice della lingua se il supporto multilingue è abilitato.

Attributi

Ad esempio, il modello Web Elenco a discesa lingue per impostazione predefinita utilizza questo oggetto Liquid per elencare le lingue disponibili quando sono disponibili più lingue.

log

Gli autori hanno la possibilità di integrare istruzioni di registro nel codice Liquid. Quando il sito Power pages è in esecuzione, i log aggiunti da un autore nel codice Liquid vengono visualizzati nell'estensione dello strumento di sviluppo Power Pages. Questi registri, incorporati dal produttore, vengono visualizzati nell'estensione dello strumento di sviluppo quando l'impostazione diagnostica è abilitata.

La seguente sintassi può essere utilizzata nel codice Liquid per registrare messaggi personalizzati:

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

Attributi del registro

Esempio:

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

pagina

Fa riferimento alla pagina di richiesta del portale corrente. Questo oggetto combina gli attributi di mappa del sito e la richiesta corrente entitità (in genere una pagina Web).

L'oggetto page consente di accedere a elementi come i percorsi per la pagina corrente, il titolo o l'URL della pagina corrente e tutti gli altri attributi o entità correlate del record Dataverse sottostante.

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

Attributi della pagina

polls

Consente il recupero e la visualizzazione di un sondaggio.

L'oggetto polls consente di selezionare uno specifico sondaggio o posizionamento sondaggio:

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

Attributi sondaggio

Attributi posizionamenti sondaggio

Attributi posizionamento sondaggio

Attributi sondaggio

Attributi Opzione sondaggio

Richiesta

Contiene informazioni sulla richiesta HTTP corrente.

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

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

Attributi

searchindex

L'oggetto searchindex è utilizzato nei tag di tabella Dataverse e fornisce l'accesso ai risultati di una query.

{% searchindex query: 'support', page: params.page, page_size: 10 %}

{% if searchindex.results.size > 0 %}

<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>

<ul>

{% for result in searchindex.results %}

<li>

<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>

<p>{{ result.fragment }}</p>

</li>

{% endfor %}

</ul>

{% else %}

<p>Your query returned no results.</p>

{% endif %}

{% endsearchindex %}

Attributi

Risultati indice di ricerca

serverlogic

Durante il rendering del modello Liquid, il serverlogic tag richiama un'operazione di logica del server. Il output parametro del serverlogic tag crea l'oggetto . L'oggetto non è disponibile come oggetto Liquid globale.

Syntax

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

Parameters

L'esempio seguente passa l'input JSON a un'operazione logica del server:

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

Nell'operazione per la logica del server usare Server.Context.Input per leggere l'input:

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

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

Per altre informazioni, vedere Chiamare la logica del server da Liquid.

Attributi

settings

Utilizzare questo oggetto per caricare qualsiasi impostazione del sito in base al nome. Se il portale non riesce a trovare un'impostazione con il nome specificato, restituisce Null.

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

mappa del sito

Utilizzare questo oggetto per accedere alla mappa del sito del portale.

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

Attributi della mappa del sito

Attributi del nodo della mappa del sito

marcatori sito

Consente di caricare il marcatore sito per nome. Se esiste il marcatore sito, verrà restituito un oggetto del marcatore sito. Se non viene trovato un marcatore sito con il nome specificato, verrà restituito null.

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

Attributi del segnaposto

frammenti di codice

Consente di caricare tutti i frammenti di codice per nome. Se non viene trovato un frammento con il nome specificato, verrà restituito null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Contiene le proprietà utili in un blocco del ciclo tag di iterazione.

Attributi

Utente

Fa riferimento all'utente del portale corrente, consentendo l'accesso a tutti gli attributi del record del contatto Dataverse sottostante. Se nessun utente ha eseguito l'accesso, questa variabile è null.

L'utente è un oggetto entità.

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

Attributi

Oltre ad avere tutti gli attributi di un oggetto entità, utente contiene gli attributi seguenti.

collegamenti Web

Consente di caricare qualsiasi collegamento Web per nome o ID.

Se esiste un set di collegamenti Web, verrà restituito un oggetto del set di collegamenti Web. Se non viene trovato un set di collegamenti Web con il nome o l'ID specificato, verrà restituito null.

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

Attributi set di collegamenti Web

Attributi collegamento Web

Attributi immagine collegamenti Web

sito web

Fa riferimento al sito Web del portale, consentendo l'accesso a tutti gli attributi del sito Web Dataverse (adx_website) per il portale.

Codice

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

Output

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

Attributi

La tabella seguente elenca gli attributi per questo tag che possono essere utilizzati in sostituzione dei valori predefiniti per evitare la memorizzazione nella cache.

Vedere anche

Tipi Liquid
Tag Liquid
Filtri Liquidi