Tag di modello

I tag di modello controllano l'output di un modello in molti modi e consentono la combinazione di più modelli in una singola uscita.

Fetchxml

Consente all'utente di eseguire query sui dati di Microsoft Dataverse e di eseguire il rendering dei risultati in una pagina.

Nota

Ulteriori informazioni sull'esecuzione di query sui dati tramite fetchxml sono disponibili in Utilizzare FetchXML per eseguire query sui dati.

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

Quando utilizzi fetchxml per eseguire query sui dati, assicurati di non utilizzare tag a chiusura automatica. Ad esempio, invece di <attribute name="title"/>, utilizza <attribute name="title"></attribute> con tag a chiusura esplicita </attribute>.

Attributo dei risultati

L'attributo dei risultati nella variabile fornita (come "resultVariable" nell'esempio precedente) contiene i risultati della query FetchXML e alcuni altri attributi.

• Entità

  Questo attributo contiene il risultato della query fetchxml. Puoi eseguire l'iterazione del risultato e usarlo nel modello Web.

  <table> 
  {% for entityVariable in resultVariable.results.entities %} 
  <tr> 
  <td>Attribut-1: {{ entityVariable.attribute1 }}</td> 
  <td>Attribut-2: {{ entityVariable.attribute2 }}</td> 
  </tr> 
  {% endfor %} 
  </table> 
  

• TableName

  Ottiene il nome logico dell'entità.

• ExtensionData

  Ottiene la struttura che contiene dati aggiuntivi.

• MinActiveRowVersion

  Ottiene il valore della versione della riga attiva più basso.

• MoreRecords

  Determina se sono disponibili più record.

• PagingCookie

  Ottiene le informazioni di paging correnti.

• TotalRecordCount

  Ottiene il numero totale di record nella raccolta.
  ReturnTotalRecordCount era true quando è stata eseguita la query.

• TotalRecordCountLimitExceeded

  Indica se i risultati della query superano il conteggio totale dei record.

Attributo XML

L'attributo XML nella variabile fornita (come "resultVariable" nell'esempio precedente) contiene la query risultante che può essere utilizzata per ottenere dati da Microsoft Dataverse. Questo attributo è utile per scopi di debug quando si intende capire come viene applicata l'autorizzazione tabella in questo tag fetchxml.

Altri elementi e attributi supportati

Il tag Liquid FetchXML supporta gli attributi e gli elementi figlio seguenti.

Elemento/elemento figlio	Attributi	Elemento figlio
fetch	mapping versione conteggio pagina paging-cookie utc-offset aggregate distinct min-active-row-version output-format returntotalrecordcount no-lock	ordine entità
ordine	attributo alias decrescente
entità	nome all-attributes no-attrs Attributo	ordine filtro link-entity
filtro	tipo hint isquickfindfields	condizione filtro
link-entity	nome da a alias link-type visible intersecazione all-attributes no-attrs Attributo	ordine filtro link-entity
condizione	colonna entityname attributo operatore aggregazione alias uiname uitype uihidden Valore	Valore

includi

Include il contenuto di un modello in un altro, per nome. Nei portali Power Pages, l'origine di quest'altro modello sarà in genere un modello Web. Questo operatore consente di riutilizzare i frammenti di un modello comune in più aree.

Quando un modello è incluso in un altro, il modello incluso potrà accedere a tutte le variabili definite nel modello padre.

{% include 'My Template' %}

È inoltre possibile passare qualsiasi numero di parametri denominati al tag di inclusione. Questi parametri vengono definiti come variabili nel modello incluso.

{% include 'My Template' a:x, b:y %}

block

Utilizzato insieme a extends fornisce l'ereditarietà del modello. Vedi extends per l'utilizzo.

extends

Utilizzato con il tag block, fornisce l'ereditarietà del modello. Questo operatore consente a più modelli di utilizzare un layout condiviso, sostituendo aree specifiche del layout padre.

Nei portali Power Pages, il nome del modello padre fornito al tag farà in genere riferimento al nome di un modello Web.

Quando viene utilizzato extends, deve essere il primo contenuto nel modello e può essere solo seguito da uno o più tag block.

Se un blocco definito nel modello padre non è sovrascritto, verrà eseguito il rendering dei relativi contenuti nel modello padre (se esistenti).

commento

Consente di lasciare un codice non letto in un modello Liquid. Non verrà eseguito il rendering del contenuto nel blocco e il codice Liquid in esso non verrà eseguito.

Codice

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Output

Hello. My name is Charles.

raw

Questa funzionalità consente di visualizzare il codice Liquid in una pagina senza analizzarlo o eseguirlo.

Output

Hello, {{ user.fullname }}. My name is Charles.

sostituzione

Quando abiliti la memorizzazione nella cache di intestazioni e piè di pagina e desideri evitare la memorizzazione nella cache di determinati output di sezione, puoi utilizzare questo tag. Questo tag fornisce il blocco di contenuto nell'intestazione o nel piè di pagina in cui l'output del blocco di contenuto spostato non viene memorizzato nella cache. Questo operatore è utile negli scenari in cui l'utente utilizza un oggetto che può essere frequentemente aggiornato, come richiesta, pagina, lingua e data. Ad esempio, fai riferimento agli scenari di aggiornamento del codice sorgente del modello Web di intestazione e piè di pagina quando la cache di intestazione e piè di pagina è abilitata.

Suggerimento

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.

codecomponent

Vedi Informazioni sul tag di entità Dataverse per componenti di codice, Usare il tag modello Liquid per componenti di codice.

Vedi anche

Tag del flusso di controllo
Tag di iterazione
Tag di variabile
Tag Liquid Dataverse
Usare il tag modello Liquid per componenti di codice