Tag di entità Dataverse

  • Articolo

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.

I tag dell'entità Microsoft Dataverse sono utilizzati per caricare e visualizzare i dati Dataverse, o utilizzare altri servizi del framework dei portali Power Apps. Questi tag sono estensioni specifiche di Dataversedel linguaggio Liquid.

grafico

Aggiunge un grafico 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 grafico Power Apps a una pagina Web, vedi Aggiungere un grafico a una pagina Web in un portale.

{% 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 ottenerlo 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 o dashboard Power BIa una pagina Web nel portale, vedi Aggiungere un report o dashboard Power BI a una pagina Web nel portale.

Nota

Affinché il tag funzioni, devi abilitare l'integrazione Power BI dall'interfaccia di amministrazione del portale Power Apps. 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

  • ADD: consente di condividere i report Power BI protetti o i dashboard per gli utenti autenticati di Power BI Azure Active Directory.

  • 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 Azure Active Directory. Per informazioni sulla configurazione del servizio Power BI Embedded, vedi Abilitare il servizio Power BI Embedded servizio.

Mentre aggiungi il report o il dashboard Power BI sicuro, verifica che sia condiviso con i servizi Azure Active Directory o Power BI Embedded dei portali.

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 sarà:

{% 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 come esposto di seguito:

{% 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 portale 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 portale. 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 dei portali Power Apps 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. Il 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 di cui eseguire il 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 questa tag verrà 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 eseguirà il rendering. Il tag eseguirà 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 verrà 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 che sarà 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 verrà eseguito il rendering del contenuto nel blocco.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Per impostazione predefinita, all'oggetto entitylist verrà 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. id deve essere una stringa che può essere analizzata come GUID.

{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

In generale, le stringhe GUID letterali non verranno utilizzate. Verrà invece specificato id utilizzando 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 verrà caricato per ID. In caso contrario, verrà 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 Power Apps per selezionare le etichette localizzate dell'elenco da caricare. Se non viene fornito language_code, verrà utilizzata la lingua predefinita della connessione Power Apps dell'applicazione del portale.

{% entitylist name:"My List", language_code:1033 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

entityview

Carica una visualizzazione Power Apps 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 sarà disponibile nel blocco di tag.

Se la visualizzazione viene caricata correttamente, viene eseguito il rendering del contenuto nel blocco. Se l'elenco non viene rilevato, non verrà 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 verrà 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, erediterà 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, caricherà 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 o id o logical_name con nome per selezionare la visualizzazione Power Apps da caricare. Se non viene specificato nulla e il tag entityview è annidato nel tag entitylist, verrà 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 letterali non verranno utilizzate. Verrà invece specificato id utilizzando 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à Power Apps 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 Power Apps 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, verrà 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, verrà 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, verrà utilizzata la dimensione della pagina elenco. Se non in un blocco di entitylist, verrà 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, verrà 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 filtreranno 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 Power Apps per selezionare le etichette localizzate di visualizzazione dell'entità (etichette di intestazione di colonna e altro.) da caricare. Se non viene fornito language_code, verrà utilizzata la lingua predefinita della connessione Power Apps dell'applicazione del portale.

Se entityview è utilizzato in un blocco entitylist, entityview erediterà 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 portale. Puoi accedere ai risultati corrispondenti utilizzando searchindex che sarà 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 verrà 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

Una query aggiuntiva 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à Power Apps a cui saranno limitati i risultati corrispondenti, come la stringa delimitata da virgole. Se non specificate, verranno 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, verrà 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, verrà utilizzata una dimensione predefinita di 10.

{% searchindex query: request.params.query, page_size: 20 %}

...

{% endsearchindex %}

entityform

Esegue il rendering completo dei moduli di base configurati con Power Apps per 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 configurato con Power Apps 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.

Importante

  • Questa è una funzionalità di anteprima.
  • Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso iniziale e fornire dei commenti.

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.

Vedi anche

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

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).