Oggetti Liquid disponibili
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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<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:
{{ 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
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.
Attributi
Nota
| 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
| 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
| 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
| 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
| 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:
{{ 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
| 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
| 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
| 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 %}
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 %}
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).