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.

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.

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

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.

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.

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.

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

Vedi Usare il tag modello Liquid per componenti di codice.

Vedi anche

• Tag del flusso di controllo
• Tag di iterazione
• Tag di variabile
• Tag di modello