Condividi tramite

Oggetti Liquid disponibili

  • Articolo

Nota

A partire dal 12 ottobre 2022, i portali Power Apps sono denominati Power Pages. Altre informazioni: Microsoft Power Pages è ora generalmente disponibile (blog)
A breve verrà eseguita la migrazione e l'unione della documentazione dei portali Power Apps con la documentazione di Power Pages.

Gli oggetti Liquid contengono gli attributi per emettere il contenuto dinamico alla pagina. Ad esempio, l'oggetto della pagna contiene un attributo denominato title che può essere utilizzato per emettere il titolo della pagina corrente.

Per accedere a un attributo di oggetto per nome, utilizza un punto (.). Per eseguire il rendering di un attributo dell'oggetto in un modello, eseguine il wrapping tra {{ and }}.

Importante

Per evitare potenziali problemi di scripting intersito (XSS), utilizza sempre il filtro di escape per codificare i dati in HTML ogni volta che si utilizzano oggetti Liquid per leggere dati non attendibili forniti dall'utente.

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

I seguenti oggetti possono essere utilizzati ed è possibile accedervi ovunque, in qualsiasi modello.

Oggetto Descrizione
entities Consente di caricare qualsiasi tabella di Power Apps in base all'ID. Altre informazioni: entità
now Un oggetto data/ora che fa riferimento all'ora UTC corrente, quando viene eseguito il rendering del modello.
Nota: questo valore viene memorizzato nella cache dell'app Web del portale e non viene aggiornato ogni volta. Altre informazioni: Filtri data
page Fare riferimento alla pagina di richiesta del portale corrente. 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 Power Apps sottostante. Altre informazioni: pagina
params Un collegamento appropriato per request.params. Altre informazioni: richiesta
request Contiene informazioni sulla richiesta HTTP corrente. Altre informazioni: richiesta
settings Consente di caricare qualsiasi impostazione sito in base al nome. Altre informazioni: impostazioni
sitemap Consenti l'accesso alla mappa del sito del portale. Altre informazioni: mappa del sito
sitemarkers Consente di caricare i marcatori sito per nome. Altre informazioni: marcatori sito
frammenti di codice Consente di caricare tutti i frammenti di codice del contenuto per nome. Altre informazioni: frammenti di codice
utente Fa riferimento all'utente del portale corrente, consentendo l'accesso a tutti gli attributi del record del contatto Power Apps sottostante. Se nessun utente ha eseguito l'accesso, questa variabile sarà null. Altre informazioni: utente
collegamenti Web Consente di caricare il set di collegamenti Web per nome o ID. Altre informazioni: collegamenti Web
sito web Fa riferimento al record del sito Web del portale, consentendo l'accesso a tutti gli attributi del record del sito Web Power Apps (adx_website) per il portale. Altre informazioni: sito Web

annunci

Fornisce la possibilità di accedere ed eseguire il rendering 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

Attributo Descrizione
placements Restituisce l'oggetto adplacements.
[nome o id annuncio] Puoi accedere a qualsiasi annuncio per nome o proprietà ID.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Attributi posizionamenti annunci

Attributo Descrizione
[nome o id posizionamento annuncio] Puoi accedere a qualsiasi posizionamento annuncio per nome o proprietà ID.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Attributi posizionamento annunci

Un posizionamento di annunci è un oggetto tabella con gli stessi attributi generali e gli attributi elencati di seguito.

Attributo Descrizione
Annunci Restituisce la raccolta di oggetti di annunci associati al posizionamento. Tag di iterazione e filtri matrice possono essere utilizzati con questa raccolta.
Nome Restituisce il campo Nome per il posizionamento dell'annuncio.
placement_url L'URL che può essere utilizzato per recuperare il posizionamento dell'annuncio che ha eseguito il rendering completo da un modello.
random_url L'URL che può essere utilizzato per recuperare un annuncio casuale dal posizionamento di cui è stato eseguito il rendering completo da parte di un modello.

Attributi annuncio

Nota

Un annuncio è un oggetto tabella, con tutti gli stessi attributi, oltre a quelli elencati di seguito.

Attributo Descrizione
ad_url L'URL che può essere utilizzato per recuperare l'annuncio che ha eseguito il rendering completo da un modello.
Copia Restituisce il campo Copia per l'annuncio.
image Restituisce l'oggetto di immagine (se esistente) per l'annuncio.
Nome Restituisce il campo Nome per l'annuncio.
open_in_new_window Restituisce true se l'url specificato da redirect_url deve essere aperto in una nuova finestra.
redirect_url L'URL a cui l'utente sarà indirizzato selezionando l'annuncio.

Attributi di immagine annuncio

Attributo Descrizione
alternate_text Restituisce il testo che deve essere visualizzato nell'attributo alt del tag.
height Restituisce l'altezza in pixel per l'immagine
URL Restituisce l'origine dell'URL per l'immagine.
width Restituisce l'ampiezza in pixel per l'immagine

blog

Fornisce la capacità di accedere e di eseguire il rendering dei Blog e dei Post di blog.

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

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

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

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

Attributo Descrizione
posts Restituisce un oggetto blogposts contenente tutti i post del blog nel portale.
[nome o id blog] Puoi accedere a qualsiasi blog per nome o proprietà ID. 
{% assign blog = blogs["Blog Name"] %}                             

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

Oggetto blog

L'oggetto blog consente di utilizzare un singolo blog e accedere ai post per quel blog.

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

Attributo Descrizione
posts Restituisce un oggetto blogposts contenente tutti i post per il blog.
Nome Nome del blog.
title Titolo del blog.
URL URL del blog.

Oggetto blogposts

L'oggetto blogposts consente di accedere a una raccolta di oggetti del post di blog. Puoi ordinare i post di blog e per eseguire la paginazione oltre ad utilizzare i filtri Liquid:

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

Altre opzioni possibili:

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

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

Attributo Descrizione
Tutte Restituisce tutti gli oggetti blogposts nella raccolta.

Oggetto blogpost

Fa riferimento a un singolo post di blog.

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

Attributo Descrizione
URL. URL del post.
contenuto Restituisce il campo Contenuto per il post.
autore Restituisce gli autori del post (che è semplicemente un oggetto tabella contatto).
titolo Titolo del post.
comment_count Restituisce il valore intero del contenuto di quanti commenti ci sono per un post specificato.
publish_date La data in cui il post è stato pubblicato.

Entità

Attenzione

Per evitare potenziali problemi di scripting intersito (XSS), utilizza sempre il filtro escape per codificare in HTML i dati delle stringhe ogni volta che utilizzi l'oggetto Liquid entities per leggere i dati forniti dall'utente che non possono essere considerati attendibili.

Nota

Alcune delle convenzioni di denominazione di Dataverse sono cambiate, ad esempio le entità Dataverse sono ora chiamate tabelle. Le modifiche al nome non si applicano agli oggetti Liquid. L'oggetto entità Liquid continuerà a essere indicato come entità.

Consente di caricare qualsiasi tabella di Power Apps in base all'ID. Se la tabella esiste, verrà restituito un oggetto tabella. Se non viene trovata una tabella con un ID specificato, verrà restituito 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 %}

Entity

Un oggetto entità fornisce l'accesso agli attributi di un record di tabella Power Apps.

Attributo Descrizione
ID ID GUID della tabella, come stringa. Ad esempio, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Nome logico Power Apps della tabella.
Note Carica eventuali note (annotation) associate alla tabella, ordinate da quella meno recente alla più recente (createdon). Le note vengono restituite come oggetti nota.
autorizzazioni Risultati dell'asserzione Autorizzazione tabella dei carichi per la tabella. I risultati vengono restituiti come oggetto di autorizzazione.
URL Restituisce il percorso URL del sistema di gestione dei contenuti dei portali di Power Apps per la tabella. Se la tabella non ha un URL valido nel sito Web corrente, restituisce null. In genere, questo restituirà solo un valore per alcuni tipi di tabella che sono stati integrati nel portale CMS a meno che non abbia personalizzato il provider dell'URL nell'applicazione.
[nome relazione o attributo] Puoi accedere a qualsiasi attributo della tabella Power Apps per nome logico. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
I valori della maggior parte degli attributi di tabella sono mappati direttamente ai tipi Liquid: due campi Opzione sono mappati a valori booleani, i campi di testo alle stringhe, i campi numerici/di valuta ai numeri, i campi di data/ora agli oggetti data. Ma, alcuni tipi di attributo vengono restituiti come oggetti:
  • I campi di ricerca (riferimento alla tabella associata) vengono restituiti come oggetti di riferimento della tabella associati.
  • I campi Set di opzioni/Picklist vengono restituiti come oggetti di valore del set di opzioni.
  • Puoi inoltre caricare tutte le entità correlate per nome dello schema di relazione.
    • {{ page.adx_webpage_entitylist.adx_name }}Nel caso in cui una relazione sia riflessiva (ad esempio autoreferenziale), verrà visualizzato un oggetto di relazione riflessiva. (In caso contrario, il risultato desiderato sarà ambiguo).{{ page.adx_webpage_webpage.referencing.adx_name }}
    Nota: il caricamento di un numero elevato di entità correlate, o l'accesso a un numero elevato di relazioni in un unico modello, può avere un effetto negativo sulle prestazioni del rendering del modello. Evitare di caricare le entità correlate per ogni elemento in una matrice, in un ciclo. Laddove possibile, utilizzare i tag di tabella di Common Data Service di Dataverse per caricare le raccolte di entità.

Riferimento tabella associata

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

Attributo Descrizione
ID ID GUID della tabella a cui si fa riferimento, come stringa.
Ad esempio, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Nome logico Power Apps della tabella a cui si fa riferimento.
Nome Attributo del nome primario della tabella di riferimento.

Nota

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.

Attributo Descrizione
documentbody Carica l'attributo documentbody del record annotation di nota, come stringa con codifica Base64. Dal momento che il contenuto di questo attributo può essere ampio, non viene caricato con il resto degli attributi nota, ma solo su richiesta.
Nota: l'utilizzo dell'attributo documentbody può avere un effetto negativo sulle prestazioni per il rendering del modello e deve essere eseguito con attenzione.
Utilizza invece l'attributo url per includere un collegamento nell'allegato della nota, se possibile.
URL Restituisce il percorso dell'URL per il gestore dell'allegato di annotazione del portale incorporato. Se l'utente dispone di autorizzazione e la nota ha un file allegato, una richiesta a questo URL scaricherà l'allegato file di nota.

Nota

Filtri aggiuntivi

Valore di Option Set

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

Attributo Descrizione
Etichetta L'etichetta localizzata del valore dell'attributo di tipo set di opzioni/picklist. Ad esempio, Attivo
Valore Valore intero del valore dell'attributo di tipo set di opzioni/picklist. Ad esempio, 0

Autorizzazioni tabella

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

Attributo Descrizione
can_append Restituisce true se l'utente corrente dispone dell'autorizzazione di aggiungere record alle relazioni di questo record. In caso contrario, restituisce false.
can_append_to Restituisce true se l'utente corrente dispone dell'autorizzazione di aggiungere record a una relazione di un'altra tabella. In caso contrario, restituisce false.
can_create Restituisce true se l'utente corrente dispone dell'autorizzazione per creare nuovi record di questo tipo di tabella. In caso contrario, restituisce false.
can_delete Restituisce true se l'utente corrente dispone dell'autorizzazione per eliminare questo record. In caso contrario, restituisce false.
can_read Restituisce true se l'utente corrente dispone dell'autorizzazione per leggere questo record. In caso contrario, restituisce false.
can_write Restituisce true se l'utente corrente dispone dell'autorizzazione per aggiornare questo record. In caso contrario, restituisce false.
rules_exist Restituisce true se i risultati di autorizzazione rappresentati da questo oggetto sono il risultato di regole di autorizzazione definite in modo esplicito. Restituisce false se sono i risultati predefiniti in assenza di autorizzazioni definite in modo esplicito.

Relazione riflessiva

I tentativi di caricare le relazioni riflessive (autoreferenziali) nelle entità vengono restituiti come oggetti con gli attributi seguenti.

Attributo Descrizione
is_reflexive Restituisce true. Può essere utilizzato per eseguire il test se un oggetto restituito da una relazione è un oggetto di relazione riflessiva.
referenced Restituisce una matrice delle entità di riferimento per una relazione specificata.
referencing Restituisce una tabella di riferimento per la relazione specificata. Restituisce null se non esiste alcuna tabella di riferimento. Se la relazione è molti-a-molti (N:N), restituisce una matrice di entità di riferimento.

entitylist

L'oggetto entitylist viene utilizzato nei tag di tabella di Power Apps Dataverse. Fornisce accesso a tutti gli attributi di un determinato elenco.

Nota

Rendering dell'elenco associato alla pagina corrente

Attributi

Nota

entities

Attributo Descrizione
create_enabled Restituisce true se la creazione di nuovi record è configurata per l'elenco. In caso contrario, restituisce false.
create_url Restituisce il percorso URL configurato per un link/pulsante di creazione per l'elenco.
detail_enabled Restituisce true se una visualizzazione dettagliata per record singoli è configurata per l'elenco. In caso contrario, restituisce false.
detail_id_parameter Restituisce il nome del parametro di stringa della query da utilizzare per l'ID del record quando si costruisce un URL di visualizzazione dettagli del record. Vedi Filtri URL per dettagli sull'utilizzo dei filtri Liquid per costruire URL. Ad esempio, ID
detail_label Restituisce l'etichetta localizzata configurata per i collegamenti di visualizzazione in dettaglio o i pulsanti per l'elenco.
detail_url Restituisce il percorso dell'URL configurato per i collegamenti di visualizzazione in dettaglio o i pulsanti per l'elenco.
empty_list_text Restituisce il testo localizzato da visualizzare quando la visualizzazione dell'elenco non restituisce alcun risultato.
enable_entity_permissions Restituisce true se il filtro Autorizzazione tabella è abilitato per questo elenco di entità. In caso contrario, restituisce false.
entity_logical_name Restituisce il nome logico della tabella Power Apps per i record da visualizzare tramite questo elenco di entità. Esempio: contact
filter_account_attribute_name Restituisce il nome logico dell'attributo per la ricerca di account che verrà utilizzato per filtrare i record dei risultati per mezzo dell'account padre dell'utente del portale corrente. Ad esempio: accountid
filter_apply_label Restituisce l'etichetta localizzata configurata da utilizzare per il collegamento/pulsante che applica un filtro di attributo avanzato ai risultati dell'elenco.
filter_definition Restituisce la definizione del filtro attributo JSON per l'elenco. Vedi Filtri elenco per i dettagli su come utilizzare il filtro Liquid metafilters per elaborare questa definizione.
filter_enabled Restituisce true se il filtro Attributo avanzato è abilitato per l'elenco. In caso contrario, restituisce false.
filter_portal_user_attribute_name Restituisce il nome logico dell'attributo per la ricerca di contact che verrà utilizzato per filtrare i record dei risultati per mezzo del contatto utente del portale. Esempio: contactid
filter_website_attribute_name Restituisce il nome logico dell'attributo per la ricerca di adx_website che verrà utilizzato per filtrare i record dei risultati per mezzo del sito Web del portale corrente. Ad esempio, adx_websiteid
language_code Restituisce il codice della lingua di tipo Integer di Power Apps che verrà utilizzato per selezionare tutte le etichette localizzate per questo elenco.
page_size Restituisce la dimensione della pagina dei risultati configurata per l'elenco.
primary_key_name Restituisce il nome logico dell'attributo della chiave principale per i record da visualizzare tramite questo elenco.
search_enabled Restituisce true se la ricerca è abilitata per questo elenco. In caso contrario, restituisce false.
search_placeholder Restituisce il testo localizzato configurato per il segnaposto del campo di ricerca dell'elenco.
search_tooltip Restituisce il testo localizzato configurato per il suggerimento di ricerca dell'elenco.
visualizzazioni Restituisce le visualizzazioni disponibili per l'elenco, come oggetti di visualizzazione elenco.
[nome logico attributo] Puoi accedere a qualsiasi attributo del record Power Apps (adx_entitylist) dell'elenco per nome logico, nello stesso modo di un oggetto tabella . Ad esempio, {{ entitylist.adx_name }}

Attributi visualizzazione elenco

Attributo Descrizione
colonne Restituisce le colonne della visualizzazione come oggetti di colonna di visualizzazione elenco.
entity_logical_name Restituisce il nome logico della tabella Power Apps per i record inclusi nella visualizzazione. Esempio: contact
ID Restituisci l'ID GUID della visualizzazione.
language_code Restituisce il codice della lingua di tipo Integer di Power Apps che verrà utilizzato per selezionare tutte le etichette localizzate (intestazioni di colonna, e così via) per la visualizzazione.
Nome Restituisce il nome visualizzato Power Apps della visualizzazione.
primary_key_logical_name Restituisce il nome logico della chiave primaria della tabella Power Apps per i record inclusi nella visualizzazione. Esempio: contactid
sort_expression Restituisce l'espressione di ordinamento predefinito per la visualizzazione. Ad esempio, name ASC, createdon DESC

Attributi colonna di visualizzazione elenco

Attributo Descrizione
attribute_type Restituisce il nome del tipo attributo Power Apps per la colonna, come una stringa. Ad esempio Lookup, Picklist, String, Boolean, DateTime
logical_name Restituisce il nome logico dell'attributo Power Apps per la colonna. Ad esempio, createdon
Nome Restituisce il nome visualizzato Power Apps localizzato per la colonna. Ad esempio, Data di creazione
sort_ascending Restituisce una stringa di espressione di ordinamento per ordinare la colonna in ordine ascendente. Ad esempio, createdon ASC
sort_descending Restituisce una stringa di espressione di ordinamento per ordinare la colonna in ordine discendente. Ad esempio, createdon DESC
sort_disabled Restituisce true se l'ordinamento è disattivato per la colonna. In caso contrario, restituisce false.
sort_enabled Restituisce true se l'ordinamento è attivato per la colonna. In caso contrario, restituisce false.
width Restituisce l'ampiezza configurata per la colonna, in pixel.

entityview

L'oggetto entityview è utilizzato nel tag entityview e consente l'accesso ai metadati per la visualizzazione, oltre ai record dei risultati di visualizzazione.

Attributi

Attributo Descrizione
colonne Restituisce le colonne nella visualizzazione, come oggetti di colonna di visualizzazione di tabella.
entity_permission_denied Restituisce true se l'accesso ai risultati di visualizzazione è stato negato a causa di autorizzazioni di tabella insufficienti per l'utente corrente. Restituisce false se è stato concesso l'accesso in lettura ai risultati di visualizzazione.
entity_logical_name Il nome logico della tabella Power Apps dei record del risultato di visualizzazione. Esempio: contact
first_page Il numero della prima pagina dei risultati di visualizzazione. Questo sarà 1 a meno che non ci siano risultati restituiti, nel qual caso sarà null.
ID ID della GUID della visualizzazione Power Apps che definisce entityview.
language_code Il codice della lingua di tipo Integer di Power Apps può essere utilizzato per caricare le etichette per la visualizzazione corrente.
last_page Il numero dell'ultima pagina dei risultati di visualizzazione. Se non vengono restituiti risultati, sarà null.
nome Nome della visualizzazione Power Apps che definisce entityview. Esempio: Active Contacts.
next_page Il numero della pagina successiva dei risultati di visualizzazione. Se non è disponibile alcun pagina di risultati successiva, sarà null.
Pagina Il numero della pagina corrente dei risultati di visualizzazione.
pages Restituisce una matrice dei numeri di pagina che contengono tutte le pagine dei risultati per la visualizzazione corrente.
page_size Il numero di risultati restituiti per pagina per la visualizzazione corrente.
previous_page Il numero della pagina successiva dei risultati di visualizzazione. Se non è disponibile alcun pagina di risultati precedente, sarà null.
primary_key_logical_name Nome logico Power Apps dell'attributo della chiave primaria della tabella di risultato per questa visualizzazione. Esempio: contactid.
record La pagina corrente dei record del risultato per la visualizzazione, in qualità di oggetti tabella.
sort_expression L'espressione di ordinamento predefinita per la visualizzazione. Ad esempio nameASC, createdon DESC.
total_pages Il numero totale delle pagine di risultato per la visualizzazione.
total_records Il numero totale di risultati per la visualizzazione (in tutte le pagine).

eventi

Fornisce la possibilità di accedere ed eseguire il rendering degli eventi. L'oggetto events consente di selezionare un evento specifico o tutti gli eventi.

Oggetto events

L'oggetto events consente di accedere a un evento specifico nel portale, o di accedere a tutti gli eventi nel portale (indipendentemente dall'evento).

L'oggetto events dispone dei seguenti attributi:

Attributo Descrizione
occurences Restituisce un oggetto eventoccurancessobject contenente tutte le ricorrenze evento nel portale
[nome o id evento] Puoi accedere a qualsiasi evento per nome o proprietà ID.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Oggetto event

L'oggetto event consente di utilizzare un singolo evento, permettendo di accedere alle pianificazione e alle ricorrenze per tale evento.

L'oggetto event dispone dei seguenti attributi:

Attributo Descrizione
occorrenze Restituisce un oggetto eventoccurrencesobject contenente tutte le ricorrenze per l'evento.
nome Nome dell'evento.
URL L'URL dell'evento.

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

nota che

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

è inoltre possibile.

Gli attributi seguenti sono associati all'oggetto eventoccurrences

Attributo Descrizione
Tutte Restituisce tutti gli oggetti eventoccurance nella raccolta.

Oggetto eventoccurence

Rappresenta una singola ricorrenza evento. Gli attributi associati sono indicati di seguito:

Attributo Descrizione
URL URL della ricorrenza.
is_all_day_event Si tratta di un evento la cui durata corrisponde a una giornata intera?
start_time Ora di inizio per l'evento.
end_time Ora di fine per l'evento.

forloop

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

Nota

forloop può essere utilizzato solo in un tag 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

Attributo Descrizione
primo Restituisce true se è la prima iterazione del ciclo. Restituisce false se non è la prima iterazione.
index La posizione corrente dell'elemento nella raccolta, dove il primo elemento ha una posizione di 1.
index0 La posizione corrente dell'elemento nella raccolta, dove il primo elemento ha una posizione di 0.
Ultima Restituisce true se è l'ultima iterazione del ciclo. Restituisce false se non è l'ultima iterazione.
length Viene restituito il numero di iterazioni per il loop ߝ il numero di elementi nella raccolta ripetuti.
rindex Numero di elementi rimanenti nel ciclo durata (lunghezza - indice) dove 1 è l'indice dell'ultimo elemento.
rindex0 Numero di elementi rimanenti nel ciclo durata (lunghezza - indice) dove 0 è l'indice dell'ultimo elemento.

forums

Offre la possibilità di accedere ed eseguire il rendering dei forum e dei thread di forum. La possibilità di utilizzare Liquid per eseguire il rendering dei dati del forum si estende ai post, ma per creare un nuovo post o thread, devi utilizzare un modello di pagina dei moduli con più passaggi ASP.NET con tale funzionalità integrate (ad esempio i modelli di pagina Thread del forum e Post del forum predefinito).

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 utilizzare un singolo forum e di accedere ai thread per tale forum.

L'oggetto forumthreads consente di accedere a una raccolta di oggetti forumthread. Puoi ordinare i thread di forum e ottenere l'impaginazione anche utilizzando i 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

Attributo Descrizione
threads Restituisce un oggetto forumthreads contenente tutti gli oggetti forumthreads nel portale.
Tutte Restituisce tutti gli oggetti forum nel portale. Nota che website.forums è inoltre un equivalente.
thread_count Restituisce il valore intero del numero di thread presenti nell'intero sito Web.
post_count Restituisce il valore intero del numero di post totali presenti nel portale.
[nome o id forum] Puoi accedere a qualsiasi forum per nome o proprietà ID.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Oggetto forum

Attributi

Nota

entità

Attributo Description
threads Restituisce un oggetto forumthreads contenente tutti i thread forum per il forum.
Nome Nome del forum.
thread_count Restituisce il valore intero del numero di thread presenti nel forum.
post_count Restituisce il valore intero del numero di post totali presenti nell'intero forum.

Oggetto forumthreads

Attributi

Attributo Descrizione
Tutte Restituisce tutti gli oggetti forumthread nella raccolta.

Oggetto forumthread

Attributi

Nota

entities

Attributo Descrizione
posts Restituisce un oggetto forumposts contenente tutti i post del forum per il thread.
author Restituisce l'autore del thread (che è semplicemente un oggetto tabella contatto).
latest_post Restituisce l'ultimo post nel thread.
first_post Restituisce il primo post nel thread.
post_count Restituisce il valore intero del numero di post presenti nel thread.
is_answered Il thread ha risposto oppure no?
is_sticky Il thread è permanente?

Oggetto forumposts

Attributi

Attributo Descrizione
Tutte Restituisce tutti gli oggetti forumthread nella raccolta.

Un singolo post del forum

Attributi

Nota

entities

Attributo Descrizione
author Restituisce l'autore del post (che è semplicemente un oggetto tabella contatto).
content Contenuto del post.
is_answer Questo post è una risposta al thread?

knowledge

Consente l'accesso agli elementi knowledgearticle di Power Apps e ai record della tabella della categoria per eseguire il rendering di articoli e categorie in un portale.

Attributi

Attributo Descrizione
articoli Restituisce un oggetto articoli che contiene oggetti articolo per i record della tabella knowledgearticle disponibili nel portale.
categorie Restituisce un oggetto categorie che contiene oggetti categoria per i record della tabella categoria disponibili nel portale.

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

Attributo Descrizione
popolare Restituisce una raccolta di oggetti articoli contenenti la maggior parte delle visualizzazioni. {% assign popular_articles = knowledge.articles.popular %}
recente Restituisce una raccolta di oggetti articolo contenenti la data modificata più di recente. {% assign recent_articles = knowledge.articles.recent %}
migliori Restituisce una raccolta di oggetti articoli contenenti la valutazione più alta. {% assign top_articles = knowledge.articles.top %}

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 %}
Attributo Descrizione
popolare Restituisce una raccolta di oggetti articoli contenenti la maggior parte delle visualizzazioni. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recente Restituisce una raccolta di oggetti articolo contenenti la data modificata più di recente. {% assign recent_articles = knowledge.articles \| recent: 5 %}
migliori Restituisce una raccolta di oggetti articoli contenenti la valutazione più alta. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

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

Attributo Descrizione
recente Restituisce una raccolta di oggetti category contenenti la data modificata più di recente.
top_level Restituisce una raccolta di oggetti category che non dispongono di una categoria padre.

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 %}
Attributo Descrizione
recente Restituisce una raccolta di oggetti category contenenti la data modificata più di recente. Puoi specificare i parametri {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Restituisce una raccolta di oggetti category che non dispongono di una categoria padre. {% assign root_categories = knowledge.categories \| top_level %}

oggetto article

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

Attributi

article è un oggetto entità, con tutti gli stessi attributi oltre a quelli elencati di seguito.

Attributo Descrizione
article_public_number Numero pubblico dell'articolo.
comment_count Valore intero del numero di commenti presenti per un articolo specifico.
content Contenuto dell'articolo.
current_user_can_comment Restituisce un valore booleano che indica se l'utente corrente può aggiungere commenti nell'articolo.
is_rating_enabled Restituisce un valore booleano che indica se è abilitata la classificazione su un articolo.
parole chiave Parole chiave per l'articolo.
nome Alias alternativo per il titolo dell'articolo.
classificazione Valore decimale di classificazione dell'articolo.
title Titolo dell'articolo.
view_count Valore intero che indica il numero di volte in cui l'articolo è stato visualizzato.

oggetto category

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

Attributi

category è un oggetto entità, con tutti gli stessi attributi oltre a quelli elencati di seguito.

Attributo Descrizione
categorynumber Numero della categoria.
nome Alias alternativo per il titolo della categoria.
titolo Titolo della categoria.

language

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

Attributi

Attributo Descrizione
URL L'URL della richiesta corrente preceduto dal codice della lingua corrente.
url_substitution L'URL della richiesta corrente preceduto dal codice della lingua corrente che ignora la cache di output della pagina.
nome Titolo della lingua corrente.
codice Codice della lingua.

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.

pagina

Fare riferimento alla pagina di richiesta del portale corrente. Questo oggetto combina gli attributi di sitemap e la richiesta corrente entities (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 Power Apps 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

Nota

entities

Attributo Descrizione
breadcrumbs Restituisce gli oggetti del nodo della mappa del sito dell'elemento di navigazione per la pagina, a partire dal nodo principale della mappa del sito fino a parent.
children Restituisce gli oggetti del nodo della mappa del sito figli della pagina.
parent Restituisce il nodo della mappa del sito padre della pagina. Se le pagina è la home page, parent sarà null.
title Titolo della pagina.
URL L'URL della pagina.
[nome relazione o attributo] Puoi accedere a qualsiasi attributo del record Power Apps sottostante della pagina per nome logico.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
I valori della maggior parte degli attributi di tabella sono mappati direttamente ai tipi Liquid: due campi Opzione sono mappati a valori booleani, i campi di testo alle stringhe, i campi numerici/di valuta ai numeri, i campi di data/ora agli oggetti data. Ma, alcuni tipi di attributo vengono restituiti come oggetti:
  • I campi di ricerca (riferimento alla tabella associata) vengono restituiti come oggetti di riferimento della tabella associati.
  • I campi Set di opzioni/Picklist vengono restituiti come oggetti di valore del set di opzioni.
    • Puoi inoltre caricare tutte le entità correlate per nome dello schema di relazione.
    {{ page.adx_webpage_entitylist.adx_name }}
    Nel caso in cui una relazione sia riflessiva (autoreferenziale), verrà restituito un oggetto entità. (In caso contrario, il risultato desiderato sarà ambiguo).{{ page.adx_webpage_webpage.referencing.adx_name }}
    Nota: il caricamento di un numero elevato di entità correlate, o l'accesso a un numero elevato di relazioni in un unico modello, può avere un effetto negativo sulle prestazioni del rendering del modello. Evitare di caricare le entità correlate per ogni elemento in una matrice, in un ciclo. Laddove possibile, utilizza i tag di tabella di Power Apps Dataverse per caricare le raccolte di entità.

polls

Fornisce la possibilità di accedere ed eseguire il rendering 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

Attributo Descrizione
placements Restituisce l'oggetto pollplacements.
[nome o id sondaggio] Puoi accedere a qualsiasi sondaggio per nome o proprietà ID. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Attributi posizionamenti sondaggio

Attributo Descrizione
[nome o id posizionamento sondaggio] Puoi accedere a qualsiasi posizionamento sondaggio per nome o proprietà ID.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Attributi posizionamento sondaggio

Nota

entità

Attributo Descrizione
Nome Restituisce il campo Nome per il posizionamento sondaggio.
placement_url L'URL che può essere utilizzato per recuperare il posizionamento sondaggio che ha eseguito il rendering completo da un modello.
polls Restituisce la raccolta di oggetti sondaggio associati al posizionamento. Tag di iterazione e filtri matrice possono essere utilizzati con questa raccolta.
random_url L'URL che può essere utilizzato per recuperare un sondaggio casuale dal posizionamento di cui è stato eseguito il rendering completo da parte di un modello.
submit_url L'URL a cui viene inviato un sondaggio completo.

Attributi sondaggio

Nota

entities

Attributo Descrizione
has_user_voted Restituisce true se l'utente corrente (collegato o anonimo) ha già votato in questo sondaggio.
Nome Restituisce il campo Nome per il sondaggio.
Opzioni Restituisce la raccolta di oggetti polloption associati al sondaggio. Tag di iterazione e entità possono essere utilizzati con questa raccolta.
poll_url L'URL che può essere utilizzato per recuperare il sondaggio che ha eseguito il rendering completo da un modello.
Domanda Restituisce il campo Domanda per il sondaggio.
submit_button_label Restituisce una stringa che può essere utilizzata per sostituire l'etichetta pulsante invia per il sondaggio.
submit_url L'URL a cui viene inviato un sondaggio completo.
user_selected_option Restituisce l'oggetto polloption selezionato dall'utente (se ha già votato).
votes Restituisce il numero di voti tabulati per il sondaggio.

Attributi Opzione sondaggio

Nota

entities

Attributo Descrizione
answer Restituisce il campo Risposta per il sondaggio.
percentage Restituisce la percentuale di voti nel sondaggio per l'opzione come numero decimale tra 0 e 100.
votes Restituisce il numero di voti tabulati per l'opzione.

richiesta

Contiene informazioni sulla richiesta HTTP corrente.

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

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

Nota

  • Puoi creare gli URL in modo dinamico in Liquid utilizzando i filtri URL.
  • L'URL utilizzato in request.url può essere qualsiasi valore richiesto e viene memorizzato nella cache per richieste successive. Per garantire il valore corretto in request.url, prendi in considerazione l'utilizzo di tag di sostituzione, un URL parziale come ~{percorso WebFile } o l'archiviazione dell'URL del portale in Impostazioni del sito.
  • Nella versione dei portali Power Apps 9.3.8.x o versioni successive sarà applicato per impostazione predefinita il filtro Liquid di escape per gli oggetti Liquid user e request. Per disabilitare questa configurazione predefinita e consentire l'uso di questi oggetti Liquid senza il filtro Liquid di escape, vedi le impostazioni del sito per il portale - Site/EnableDefaultHtmlEncoding.

Attributi

Attributo Descrizione
params Valori del parametro denominato per la richiesta corrente. params è una combinazione di parametri di stringa della query dell'URL, parametri del post del modulo e cookie.
Percorso Il percorso dell'URL di richiesta corrente.
/profile/
path_and_query Il percorso e la query dell'URL di richiesta corrente.
/profile/?foo=1&bar=something
query La parte della query dell'URL di richiesta corrente.
?foo=1&bar=something
URL L'URL completo della richiesta corrente.
https://www.example.com/profile/?foo=1&bar=something

searchindex

L'oggetto searchindex è utilizzato nei tag di tabella di Power Apps 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

Attributo Descrizione
approximate_total_hits Restituisce un numero approssimativo di occorrenze totali corrispondenti alla query dell'indice. A causa della modalità di funzionamento dell'indice di ricerca relativamente ai filtri di sicurezza e ad altri fattori di progettazione, questo numero rappresenta solo un'approssimazione e non può corrispondere esattamente al numero totale di risultati disponibili per l'utente corrente in alcune situazioni.
Pagina Viene restituito il numero di pagina della query corrente.
page_size Viene restituita la dimensione massima della pagina della query corrente. Se vuoi che venga restituito il numero effettivo di risultati per la pagina corrente (poiché potrebbe essere meno della dimensione massima della pagina specificata), utilizza results.size.
Risultati Restituisce la pagina dei risultati di query, come oggetti di risultato dell'indice di ricerca.

Risultati indice di ricerca

Attributo Descrizione
entità Entità sottostanti per il risultato.
fragment Un importante frammento di testo breve per il risultato, con i termini che corrispondono alla query specificata evidenziata utilizzando il tag HTML <em>. Alcuni tipi di query non supportano i frammenti evidenziati, ad esempio le query fuzzy (~) e le query dei caratteri jolly (*). Questa proprietà sarà null in tali casi.
ID ID della tabella Power Apps del record sottostante per il risultato, come stringa. Ad esempio, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Nome logico della tabella Power Apps del record sottostante per il risultato. Ad esempio, adx_webpage
Numero Numero del risultato, in tutte le pagine di risultato, a partire da 1. Ad esempio, per il primo risultato della seconda pagina dei risultati, con una dimensione della pagina di 10, questo valore sarà 11.
score Punteggio Lucene del risultato, come valore a virgola mobile. I risultati verranno restituiti ordinati per questo valore.
title Titolo del risultato.
URL URL per il risultato. In genere questo è un percorso assoluto per l'applicazione corrente, piuttosto che un URL completo ߝ ma non necessariamente ߝ. Ad esempio: /articles/article1/

impostazioni

Consente di caricare qualsiasi impostazione sito in base al nome. Se non viene trovata un'impostazione con il nome specificato, verrà restituito null.

Nota

Le impostazioni sono restituite come stringhe, ma puoi utilizzare filtri tipo per convertirle in altri tipi.

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

Nota

Rendering dell'intestazione e della barra di spostamento principale di un sito Web

sitemap

Consenti l'accesso 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

Attributo Descrizione
Corrente Restituisce l'oggetto del nodo della mappa del sito per la pagina corrente.
Radice Restituisce l'oggetto del nodo della mappa del sito per la pagina principale (home) del sito Web.

Attributi del nodo della mappa del sito

Attributo Descrizione
Percorsi Restituisce gli oggetti del nodo della mappa del sito dell'elemento di navigazione per il nodo, a partire dal nodo principale della mappa del sito fino a parent.
Figli Restituisce gli oggetti del nodo della mappa del sito figli del nodo.
Descrizione Il contenuto di descrizione/riepilogo per il nodo. (Questo campo può contenere HTML).
Entità Restituisce le entità sottostanti del nodo. Se il nodo non ha una tabella sottostante, questo valore sarà null.
is_sitemap_ancestor Restituisce true se il nodo della mappa del sito è un predecessore del nodo corrente, in caso contrario false.
is_sitemap_current Restituisce true se il nodo della mappa del sito è il nodo corrente, in caso contrario false.
Padre Restituisce il nodo della mappa del sito padre del nodo. Se il nodo non è principale, parent sarà null.
Posizione Titolo del nodo.
URL URL del nodo.

sitemarkers

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

Nota

Rendering dell'intestazione e della barra di spostamento principale di un sito Web

Attributi del marcatore sito

Attributo Descrizione
URL L'URL di destinazione del marcatore sito.
[nome logico attributo] Puoi accedere a qualsiasi attributo del record Power Apps di destinazione del marcatore sito per nome logico. Ad esempio, {{ sitemarker.adx_name }}

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.

Nota

tablerowloop può essere utilizzato solo in un tag tag di iterazione.

Attributi

Attributo Descrizione
Col Restituisce l'indice della riga corrente, che inizia con 1.
col0 Restituisce l'indice della riga corrente, che inizia con 0.
col_first Restituisce true se la colonna corrente è la prima colonna in una riga, restituisce false se non lo è.
col_last Restituisce true se la colonna corrente è l'ultima colonna in una riga, restituisce false se non lo è.
Prima Restituisce true se è la prima iterazione del ciclo. Restituisce false se non è la prima iterazione.
Indice La posizione corrente dell'elemento nella raccolta, dove il primo elemento ha una posizione di 1.
index0 La posizione corrente dell'elemento nella raccolta, dove il primo elemento ha una posizione di 0.
Ultima Restituisce true se è l'ultima iterazione del ciclo. Restituisce false se non è l'ultima iterazione.
Lunghezza Viene restituito il numero di iterazioni per il loop ߝ il numero di elementi nella raccolta ripetuti.
Rindex Numero di elementi rimanenti nel ciclo durata (lunghezza - indice) dove 1 è l'indice dell'ultimo elemento.
rindex0 Numero di elementi rimanenti nel ciclo durata (lunghezza - indice) dove 0 è l'indice dell'ultimo elemento.

utente

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

utente è un oggetto entità.

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

Nota

Nella versione dei portali Power Apps 9.3.8.x o versioni successive sarà applicato per impostazione predefinita il filtro Liquid di escape per gli oggetti Liquid user e request. Per disabilitare questa configurazione predefinita e consentire l'uso di questi oggetti Liquid senza il filtro Liquid di escape, vedi le impostazioni del sito per il portale - Site/EnableDefaultHtmlEncoding.

Attributi

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

Attributo Descrizione
ruoli Restituisce i ruoli cui appartiene l'utente, ad esempio una matrice.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Nota: puoi inoltre utilizzare il filtro has_role per provare diverse appartenenze di ruolo.
basic_badges_url Restituisce l'URL del servizio per recuperare i distintivi di un utente.
Per eseguire il rendering dei distintivi per un utente, devi includere un tag con gli attributi "data-badge" e "data-uri". Per eseguire il rendering dei distintivi dell'utente corrente:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Per il rendering dei distintivi di un utente tramite l'identificazione (userid variabile):
`<div data-badge data-uri='{{user.basic_badges_url

collegamenti Web

Consente di caricare qualsiasi collegamento Web per nome o ID.

Se esiste un insieme di collegamenti Web, verrà restituito un oggetto dell'insieme 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 %}

Nota

Esecuzione del rendering di un'intestazione del sito Web e della barra di spostamento principale |

Attributi insieme di collegamenti Web

Nota

Un insieme di collegamenti Web è un oggetto entità, con tutti gli stessi attributi, oltre a quelli elencati di seguito.

Attributo Descrizione
Copia Copia HTML dell'insieme di collegamenti Web.
Nome Nome dell'insieme di collegamenti Web.
Posizione Titolo dell'insieme di collegamenti Web.
Weblinks La matrice di oggetti collegamenti Web associati all'insieme di collegamenti Web.
[nome logico attributo] Puoi accedere a qualsiasi attributo del record Power Apps dell'insieme di collegamenti Web per nome logico. Ad esempio, {{ weblinkset.createdon }}

Attributi collegamenti Web

Nota

Un collegamento Web è un oggetto entità, con tutti gli stessi attributi, oltre a quelli elencati di seguito.

Attributo Descrizione
Descrizione Descrizione HTML del collegamento Web.
display_image_only Attributo booleano che indica se il collegamento Web deve essere visualizzato solo come immagine, senza il testo del collegamento.
display_page_child_links Attributo booleano che indica se il collegamento Web deve visualizzare collegamenti alle pagine figlio della mappa del sito della pagina collegata come collegamenti secondari.
Immagine Oggetto dell'immagine di collegamento Web per questo collegamento. Questo attributo sarà null se non è presente nessuna immagine.
is_external Attributo booleano che indica se l'URL di destinazione del collegamento Web è un sito esterno (anziché una pagina del portale interna).
is_sitemap_ancestor Restituisce true se l'URL del collegamento Web fa riferimento a un predecessore del nodo della mappa del sito corrente, in caso contrario false.
is_sitemap_current Restituisce true se l'URL del collegamento Web fa riferimento al nodo della mappa del sito corrente, in caso contrario false.
Nome Nome/titolo del collegamento Web.
Nofollow Attributo booleano che indica se il collegamento Web deve essere contrassegnato come rel=nofollow.
open_in_new_window Attributo boolean che indica se il collegamento Web deve essere aperto in una nuova finestra/scheda browser una volta selezionato.
Descrizione comando Testo di descrizione comando del collegamento Web.
URL URL del collegamento Web.
Weblinks La matrice di oggetti collegamenti Web figlio associati al collegamento Web.
[nome logico attributo] Puoi accedere a qualsiasi attributo del record Power Apps del collegamento Web per nome logico. Ad esempio, {{ weblink.createdon }}

Attributi immagine collegamenti Web

alternate_text Testo alternativo per l'immagine.
Altezza Numero intero che contiene l'altezza specificata dell'immagine. Se non è stato fornito alcun valore di altezza, questo attributo sarà null.
URL URL dell'immagine.
Larghezza Numero intero che contiene l'ampiezza specificata dell'immagine. Se non è stato fornito alcun valore di ampiezza, questo attributo sarà null.

sito web

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

Nota

Il sito Web è un oggetto entità, con tutti gli stessi attributi.

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.

Predefiniti Sostituto (evita la memorizzazione nella cache) Esempio
sign_in_url sign_in_url_substitution Predefinito: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Sostituzione (evita la memorizzazione nella cache): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("substitute-page" in questo esempio sostituisce l'URL memorizzato nella cache predefinito.)
sign_out_url sign_out_url_substitution Predefinito: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Sostituzione (evita la memorizzazione nella cache): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("substitute-page" in questo esempio sostituisce l'URL memorizzato nella cache predefinito.)

Vedi anche

Tipi Liquid
Tag Liquid
Filtri Liquid

Nota

Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)

Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).