Tag Liquid Dataverse
I tag Liquid di Microsoft Dataverse sono utilizzati per caricare e visualizzare i dati Dataverse o utilizzare altri servizi del framework di Power Pages. Questi tag sono estensioni specifiche di Dataversedel linguaggio Liquid.
chart
Aggiungi un grafico dell'app basata su modello Power Apps a una pagina Web. Il tag del grafico può essere aggiunto nel campo Copia in una pagina Web o nel campo Origine su un modello Web. Per i passaggi per aggiungere un'app basata su modello Power Apps a una pagina Web, vedi Aggiungere un grafico a una pagina Web in Power Pages.
{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}
Parametri
I parametri da fornire con il tag del grafico sono due: ID grafico e viewid.
ID grafico
ID di visualizzazione del grafico. Puoi ottenere l'ID esportando il grafico.
viewid
ID della tabella quando aperto nell'editor di visualizzazione.
powerbi
Aggiunge dashboard e report Power BI nelle pagine. Il tag può essere aggiunto nel campo Copia in una pagina Web o nel campo Origine su un modello Web Per la procedura per aggiungere un report Power BI o un dashboard a una pagina Web in Power Pages, vedi Aggiungere un report Power BI o un dashboard a una pagina Web in Power Pages.
Nota
Affinché il tag funzioni, devi abilitare l'integrazione Power BI dall'hub Power Pages nell'interfaccia di amministrazione del portale Power Platform. Se l'integrazione Power BI non è abilitata, il dashboard o il report non vengono visualizzati.
Parametri
Il tag powerbi accetta i parametri elencati di seguito:
path
Percorso del dashboard o report Power BI. Se il report o dashboard Power BI è sicuro, devi specificare il tipo di autenticazione.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
authentication_type
Tipo di autenticazione obbligatorio per il report o dashboard Power BI. I valori validi per questo parametro sono:
Anonimo: consente di incorporare i report Power BI pubblicati sul Web. Il tipo di autenticazione predefinito è Anonimo. Quando si utilizza il tipo di autenticazione come Anonimo, devi ottenere l'URL del report di Power BI come descritto in: Pubblicare sul Web da Power BI
AAD: consente di condividere i report Power BI protetti o i dashboard per gli utenti autenticati di Power BI Microsoft Entra ID.
powerbiembedded: consente di condividere i report o i dashboard Power BI protetti con utenti esterni che non dispongono della licenza Power BI o della configurazione di autenticazione di Microsoft Entra. Per informazioni sulla configurazione del servizio Power BI Embedded, vedi Abilitare il servizio Power BI Embedded servizio.
Mentre aggiungi il report Power BI o il dashboard sicuro, verifica che sia condiviso con i servizi Microsoft Entra o Power BI Embedded di Power Pages.
Nota
I valori per il parametro authentication_type non fanno distinzione tra maiuscole e minuscole.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Puoi inoltre filtrare il report in base a uno o più valori. La sintassi per filtrare un report è:
URL?filter=Table/Field eq 'value'
Ad esempio, supponiamo che intendi filtrare il report per visualizzare i dati di un contatto denominato Bert Hair. Devi aggiungere l'URL con i seguenti dati:
?filter=Executives/Executive eq 'Bert Hair'
Il codice completo è:
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq 'Bert Hair'" %}
Per ulteriori informazioni su come filtrare un report: Filtrare un report utilizzando parametri stringa di query nell'URL
Nota
Il report anonimo non supporta la funzionalità di filtro.
Puoi anche creare un percorso dinamico utilizzando la variabile Liquid capture :
{% capture pbi_path %}https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq '{{user.id}}'{% endcapture %}
{% powerbi authentication_type:"AAD" path:pbi_path %}
Per ulteriori informazioni sulla variabile Liquid: Tag variabili
tileid
Visualizza il riquadro specificato del dashboard. Devi fornire l'ID del riquadro.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/dashboards/00000000-0000-0000-0000-000000000001" tileid:"00000000-0000-0000-0000-000000000002" %}
ruoli.
Ruoli assegnati al report Power BI. Questo parametro viene eseguito solo quando il parametro authentication_type è impostato su powerbiembedded.
Se hai definito i ruoli in Power BI e li hai assegnati ai report, devi specificare i ruoli appropriati nel tag Liquid powerbi. I ruoli consentono di filtrare i dati da visualizzare in un report. Puoi specificare più ruoli separati da una virgola. Per ulteriori informazioni sulla definizione dei ruoli in Power BI, vedi Protezione a livello di riga (RLS) con Power BI.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:"Region_East,Region_West" %}
Se hai assegnato un ruolo a un report Power BI e non hai specificato il parametro ruoli nel tag Liquid o non hai specificato un ruolo nel parametro, viene visualizzato un errore.
Suggerimento
Se vuoi utilizzare i ruoli Web definiti nel sito come ruoli Power BI, puoi definire una variabile e assegnare ruoli Web ad essa. Puoi quindi utilizzare la variabile definita nel tag Liquid.
Ad esempio, hai definito due ruoli Web come Region_East e Region_West nel sito. Puoi unirli utilizzando il codice: {% assign webroles = user.roles | join: ", " %}
Nel frammento di codice sopra, webroles è una variabile e i ruoli Web Region_West e Region_East saranno archiviati in essa.
Utilizza la variabile webroles come segue nel tag Liquid:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}
editable
Esegue il rendering di uno specifico oggetto CMS del sito Power Pages come modificabile nel portale, per gli utenti con autorizzazione di modifica dei contenuti per l'oggetto. Gli oggetti modificabili includono page, snippets e weblinks.
{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}
{% editable snippets Header type: 'html' %}
<!--
An editable web link set required a specific DOM structure, with
certain classes on the containing element, as demonstrated here.
-->
{% assign primary_nav = weblinks[Primary Navigation] %}
{% if primary_nav %}
<div {% if primary_nav.editable %}class=xrm-entity xrm-editable-adx_weblinkset{% endif %}>
<ul>
<!-- Render weblinks... -->
</ul>
{% editable primary_nav %}
</div>
{% endif %}
Parametri
Il primo parametro fornito è l'oggetto modificabile, ad esempio un set di collegamenti Web, frammenti o la pagina corrente. Il secondo parametro facoltativo è di specificare un nome attributo o una chiave in tale oggetto di cui deve essere eseguito il rendering e che deve essere modificato. Questo valore può essere il nome di un attributo di tabella o un nome di frammento, ad esempio.
Dopo questi parametri iniziali, il tag supporta molti parametri denominati facoltativi.
class
Specifica un valore di attributo class per l'elemento radice di cui viene eseguito il rendering da questo tag.
default
Un valore predefinito sottoposto a rendering nel caso in cui l'elemento modificabile non abbia valore.
escape
Un valore booleano che indica se il valore di cui è stato eseguito il rendering da questo tag viene codificato in formato HTML. Per impostazione predefinita, questo valore è false.
liquid
Un valore booleano che indica se verrà elaborato un codice del modello Liquid trovato nel valore testuale di cui ha eseguito il rendering per mezzo del tag. Per impostazione predefinita questo valore è true.
tag
Il nome dei tag HTML del contenitore di cui questo tag ha eseguito il rendering. Il tag esegue il rendering degli elementi div per impostazione predefinita. Ti consigliamo di scegliere tra div o span come valore per questo parametro.
title
Specifica un'etichetta per questo elemento modificabile nell'interfaccia di modifica del contenuto. Se non viene specificato niente, un'etichetta descrittiva viene generata automaticamente.
type
Un valore stringa che indica il tipo dell'interfaccia di modifica da presentare, per valori di testo modificabili. I valori validi per il parametro sono html or text. L'impostazione predefinita è html.
entitylist
Carica un elenco specificato, per nome o ID. Puoi accedere alle proprietà dell'elenco utilizzando un oggetto entitylist disponibile nel blocco di tag. Per il rendering dei record di risultato effettivo dell'elenco, utilizza il tag entityview nel blocco.
Se l'elenco viene caricato correttamente, viene eseguito il rendering del contenuto nel blocco. Se l'elenco non viene rilevato, non viene eseguito il rendering del contenuto nel blocco.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Per impostazione predefinita, all'oggetto entitylist viene fornito il nome della variabile entitylist. Facoltativamente, è possibile fornire un nome della variabile diversa.
{% entitylist my_list = name:My List %}
Loaded list {{ my_list.adx_name }}.
{% endentitylist %}
Parametri
Fornisci solo uno tra id, nome o chiave per selezionare l'elenco da caricare.
id
Carica un elenco per ID GUID. L'ID deve essere una stringa che di cui può essere eseguito il parsing come GUID.
{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
In generale, le stringhe GUID con valore letterale non vengono utilizzate. Viene invece specificato un id con una proprietà GUID di un'altra variabile.
{% entitylist id:page.adx_entitylist.id %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
nome
Carica un elenco per nome.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
key
Carica un elenco per ID o nome. Se il valore della chiave fornito può essere analizzato come GUID, l'elenco viene caricato per ID. In caso contrario, viene caricato per nome.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
Un codice della lingua di tipo Integer di Dataverse per selezionare le etichette localizzate dell'elenco da caricare. Se non viene fornito language_code, viene utilizzata la lingua predefinita della connessione Dataverse dell'applicazione del sito.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Carica una visualizzazione Dataverse specificata, per nome o ID. Puoi quindi accedere alle proprietà della visualizzazione ߝ dei metadati della colonna, ai record di risultati impaginati e ad altro, utilizzando un oggetto entityview che è disponibile nel blocco di tag.
Se la visualizzazione viene caricata correttamente, viene eseguito il rendering del contenuto nel blocco. Se la visualizzazione non viene rilevata, non viene eseguito il rendering del contenuto nel blocco.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Per impostazione predefinita, all'oggetto entityview viene fornito il nome della variabile entityview. Facoltativamente, è possibile fornire un nome della variabile diversa.
{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ my_view.total_records }} total records.
{% endentityview %}
Se entityview è annidato in un blocco entitylist, eredita le configurazione predefinita (ad esempio dimensione della pagina dei risultati, opzioni filtro e così via) dall'elenco. Se non è specificato alcun parametro id o name in entityview, carica la visualizzazione predefinita dall'entitylist di chiusura.
{% entitylist id:page.adx_entitylist.id %}
{% entityview %}
Loaded default view of the list associated with the current page, with {{ entityview.total_records }} total records.
{% endentityview %}
{% endentitylist %}
Parametri
Immetti sia id o logicalname con nome per selezionare la visualizzazione Dataverse da caricare. Se non viene specificato nulla e il tag entityview è annidato nel tag entitylist, viene caricata la visualizzazione predefinita di entitylist di chiusura.
id
id deve essere una stringa che può essere analizzata come GUID.
{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded entity view {{ entityview.name }}.
{% endentityview %}
In generale, le stringhe GUID con valore letterale non vengono utilizzate. Viene invece specificato un id con una proprietà GUID di un'altra variabile.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
logical_name
Il nome logico dell'entità Dataverse della visualizzazione da caricare. Deve essere utilizzato insieme a name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
nome
Il nome Dataverse della visualizzazione da caricare. Deve essere utilizzato insieme a logical_name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
filter
Specifica se filtrare i risultati di visualizzazione per utente o account. Deve avere un valore di stringa di utente o account.
{% entityview id:request.params.view, filter:'user' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Un caso di utilizzo comune è di impostare questo parametro in base a una richiesta.
{% entityview id:request.params.view, filter:request.params.filter %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
metafilter
Specifica l'espressione del filtro di metadati Elenco con la quale filtrare i risultati di visualizzazione. Questo parametro è valido solo quando entityview è utilizzato insieme a entitylist. Nella maggior parte dei casi questo parametro è impostato su una richiesta.
{% entitylist id:page.adx_entitylist.id %}
{% entityview id:request.params.view, metafilter:request.params.mf %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
{% endentitylist %}
order
Specifica un'espressione di ordinamento per ordinare i risultati della visualizzazione. Un'espressione di ordinamento può contenere uno o più nomi logici dell'attributo di entità, seguiti da una direzione di ordinamento di ASC o DESC.
{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Un caso di utilizzo comune è di impostare questo parametro in base a una richiesta.
{% entityview id:request.params.view, order:request.params.order %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
page
Specifica la pagina dei risultati di visualizzazione da caricare. Se questo parametro non è specificato, viene caricata la prima pagina dei risultati.
Questo parametro deve già essere un valore intero o una stringa che può essere analizzata come valore intero. Se il valore viene fornito per questo parametro, ma è null o non può essere analizzato come numero intero, viene caricata la prima pagina dei risultati.
{% entityview id:request.params.view, page:2 %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Un caso di utilizzo comune è di impostare questo parametro in base a una richiesta.
{% entityview id:request.params.view, page:request.params.page %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
page_size
Specifica il numero di risultati da caricare per la pagina dei risultati corrente. Se non viene specificato alcun valore per questo parametro e entityview viene utilizzato in un blocco entitylist, viene utilizzata la dimensione della pagina elenco. Se non in un blocco di entitylist, viene utilizzato un valore predefinito di 10.
Questo parametro deve già essere un valore intero o una stringa che può essere analizzata come valore intero. Se il valore viene fornito per questo parametro, ma è null o non può essere analizzato come numero intero, viene utilizzata la dimensione della pagina predefinita.
{% entityview id:request.params.view, page_size:20 %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Un caso di utilizzo comune è di impostare questo parametro in base a una richiesta.
{% entityview id:request.params.view, page_size:request.params.pagesize %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
search
Specifica un'espressione di ricerca con cui filtrare i risultati di visualizzazione. Espressioni semplici di ricerca della parola chiave filtrano se gli attributi iniziano o meno con una parola chiave. È inoltre possibile includere i caratteri jolly * nell'espressione.
{% entityview id:request.params.view, search:'John\*' %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
Un caso di utilizzo comune è di impostare questo parametro in base a una richiesta, in modo che il filtro di ricerca possa essere impostato sull'input utente.
{% entityview id:request.params.view, search:request.params.search %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
language_code
Un codice della lingua di tipo Integer di Dataverse per selezionare le etichette localizzate di visualizzazione dell'entità (etichette di intestazione di colonna e altro.) da caricare. Se non viene fornito language_code, viene utilizzata la lingua predefinita della connessione Dataverse dell'applicazione del sito Web.
Se entityview è utilizzato in un blocco entitylist, entityview eredita il relativo codice di configurazione della lingua da entitylist.
{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}
Loaded entity view {{ entityview.name }}.
{% endentitylist %}
searchindex
Esegue una query nell'indice di ricerca del sito Web. Puoi accedere ai risultati corrispondenti utilizzando searchindex che è disponibile nel blocco di tag.
{% 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 %}
<style>
.highlight {background-color: #FFFCAC;}
</style>
Per impostazione predefinita, all'oggetto dell'indice di ricerca viene fornito il nome della variabile searchindex. Facoltativamente, è possibile fornire un nome della variabile diversa.
{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}
{% if liquid_search.results.size > 0 %}
...
{% endif %}
{% endsearchindex %}
Parametri
Il tag searchindex accetta i parametri elencati di seguito.
query
La query utilizzata in base ai risultati. Questo parametro ha lo scopo di accettare la parte specificata dall'utente della query di indice (se esistente).
{% searchindex query: 'support' %}
...
{% endsearchindex %}
Un caso di utilizzo comune è di impostare questo parametro in base a una richiesta.
{% searchindex query: request.params.query %}
...
{% endsearchindex %}
Questo parametro supporta la sintassi del parser di query Lucene.
filter
Un'altra query utilizzata in base ai risultati. Questo parametro ha lo scopo di accettare un filtro specificato dall'utente per i risultati, se necessario.
{% searchindex query: request.params.query, filter: '+statecode:0' %}
...
{% endsearchindex %}
Questo parametro supporta la sintassi del parser di query Lucene.
Nota
La differenza tra filter e query è che mentre entrambi accettano la sintassi del parser di query Lucene, query ha lo scopo di accettare il modo in cui la sintassi ߝ viene analizzata poiché la maggior parte degli utenti finali non sarà consapevole di questa sintassi. Pertanto, nel caso in cui l'analisi della query in base alla sintassi generasse un errore, verrà utilizzata una sequenza di escape per l'intera query e verrà inoltrato come testo della query. filter, invece, sarà rigorosamente analizzato e restituirà un errore in caso di sintassi non valida.
logical_names
I nomi logici dell'entità Dataverse a cui saranno limitati i risultati corrispondenti, come la stringa delimitata da virgole. Se non specificate, vengono restituite tutte le entità corrispondenti.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
page
La pagina dei risultati di ricerca da restituire. Se non specificata, viene restituita la prima pagina (1).
{% searchindex query: request.params.query, page: 2 %}
...
{% endsearchindex %}
Un caso di utilizzo comune è di impostare questo parametro in base a una richiesta.
{% searchindex query: request.params.query, page: request.params.page %}
...
{% endsearchindex %}
page_size
La dimensione della pagina dei risultati da restituire. Se non specificata, viene utilizzata una dimensione predefinita di 10.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entityform
Esegue il rendering completo di un moduloper nome o ID.
Nota
Il tag entityform è disponibile solo per l'utilizzo nel contenuto del rendering in un modello di pagina basato su un modello Web. Il tentativo di utilizzare il tag in un modello di pagina basato sulla riscrittura non eseguirà il rendering di nulla. Puoi eseguire il rendering di un singolo tag entityform o webform per pagina. Non verrà eseguito il rendering del tag entityform o webform dopo il primo.
{% entityform name: 'My Basic Form' %}
Parametri
nome
Il nome del modulo di base che desideri caricare.
{% entityform name:My Basic Form %}
webform
Esegue il rendering completo del modulo con più passaggi per nome o ID. Il tag webform è disponibile solo per l'utilizzo nel contenuto del rendering in un modello di pagina basato su un modello Web. Il tentativo di utilizzare il tag in un modello di pagina basato sulla riscrittura non eseguirà il rendering di nulla. Puoi eseguire il rendering di un singolo tag entityform o webform per pagina. Non verrà eseguito il rendering del tag entityform o webform dopo il primo.
{% webform name: 'My Multistep Form' %}
Parametri
nome
Il nome del modulo con più passaggi che desideri caricare.
{% webform name:My Multistep Form %}
codecomponent
Consente di incorporare componenti di codice utilizzando un tag Liquid. Ad esempio, l'aggiunta di un controllo personalizzato per la visualizzazione della mappa a una pagina Web.
Parametri
nome
ID o nome del componente di codice.
proprietà
I valori delle proprietà che il componente di codice si aspetta devono essere passati come coppia chiave/valore separati da ":" (due punti), dove la chiave è il nome della proprietà e il valore è il valore della stringa JSON.
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
Nota
Le proprietà richieste potrebbero essere diverse a seconda del componente scelto.
Vedi Usare il tag modello Liquid per componenti di codice.