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 sopra) 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 sopra) 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. In 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 verranno quindi 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.

In 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

Consente l'output del codice Liquid in una pagina senza doverlo analizzare ed eseguire.

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