Accesso ai dati di Dataverse
Gli autori di Power Pages possono usare il linguaggio HTML per creare l'output che include contenuto statico. Analogamente, possono usare Liquid quando lavorano con più pagine e contenuto dinamico provenienti da Microsoft Dataverse e quando apportano modifiche da una pagina alla successiva. Gli elementi Liquid fungono da segnaposto e vengono sostituiti dai dati di Dataverse prima che l'output venga inviato al browser.
Power Pages implementa molte estensioni progettate per funzionare con Dataverse. Alcuni oggetti Liquid disponibili e specifici per Dataverse sono descritti nella tabella seguente.
| Oggetto | Descrizione |
|---|---|
page |
Fa riferimento alla pagina di richiesta del sito Web corrente. L'oggetto page fornisce l'accesso a componenti come il percorso di navigazione per la pagina corrente, il titolo o l'URL della pagina corrente, ad esempio {{ page.title }}, ed eventuali altre colonne o tabelle correlate della riga Power Apps sottostante. |
user |
Fa riferimento all'utente del sito Web corrente e consente l'accesso a tutte le colonne della riga del contatto Power Apps sottostante. Se nessun utente ha effettuato l'accesso, la variabile è null. |
website |
Fa riferimento al sito Web e consente l'accesso a tutte le colonne della riga del sito Web Power Apps (adx_website). |
| Tabelle generiche | Un oggetto tabella fornisce l'accesso alle righe e alle colonne in una tabella di Dataverse. Una raccolta di tutte le tabelle è definita entities. Ad esempio, {{ entities.contact[request.params.contactid].firstname }} fa riferimento alla colonna relativa al nome nella riga del contatto identificata dal parametro di richiesta contactid. |
È possibile usare tag specifici per Microsoft Dataverse per caricare e visualizzare i dati di Dataverse oppure per usare altri servizi del framework di Power Pages. Questi tag sono estensioni specifiche di Dataverse per il linguaggio Liquid. La tabella seguente descrive alcuni di questi tag.
| Tag | Descrizione |
|---|---|
chart |
Aggiunge un grafico di Power Apps a una pagina Web. Per informazioni sui passaggi per aggiungere un grafico di Power Apps a una pagina Web, vedere Aggiungere un grafico a una pagina Web nel portale. |
powerbi |
Aggiunge dashboard e report di Microsoft Power BI nelle pagine. Per informazioni sui passaggi per aggiungere un report o un dashboard di Power BI a una pagina Web del sito Web, vedere Aggiungere un report o un dashboard di Power BI a una pagina Web. |
entitylist |
Tag di blocco Liquid che carica un determinato elenco in base a nome o ID. Se l'elenco viene caricato correttamente, viene eseguito il rendering del contenuto del blocco. |
entityview |
Tag di blocco Liquid che carica una determinata vista di Dataverse in base a nome o ID. Se la vista viene caricata correttamente, viene eseguito il rendering del contenuto del blocco. |
fetchxml |
Consente agli utenti di eseguire query sui dati da Dataverse e il rendering dei risultati in una pagina. |
codecomponent |
Consente di incorporare componenti di codice usando un tag Liquid. Per altre informazioni, vedere Tag modello Liquid per componenti di codice. |
L'esempio seguente carica la vista Active Currencies e visualizza tutte le righe restituite. Nello studio di progettazione di Power Pages questo codice produce output a causa dei privilegi impliciti della fase di progettazione dell'autore. Nel sito Web l'utente deve tuttavia disporre di privilegi di lettura sulla tabella della valuta affinché il frammento restituisca i dati.
{% entityview logical_name:'transactioncurrency', name:'Active Currencies' %}
<p>We support {{ entityview.total_records }} currencies.</p>
<ul>
{% for cur in entityview.records -%}
<li>{{ cur.currencyname }}</li>
{% endfor %}
</ul>
{% endentityview %}
L'output avrà un aspetto simile all'esempio seguente:
We support 4 currencies.
- Australian dollar
- Canadian dollar
- Euro
- US dollar
Usando Liquid in Power Pages è possibile:
Aggiungere contenuto dinamico direttamente al contenuto della pagina Web o a un frammento di contenuto.
Archiviare contenuto di origine tramite modelli Web, interamente tramite la configurazione in Power Apps, da usare nel sistema di gestione dei contenuti di Power Pages.
Eseguire il rendering dell'intestazione e della barra di spostamento principale di un sito Web, interamente tramite la configurazione in Power Apps.
Usare componenti di codice in Power Pages creati con Power Apps Component Framework per fornire un'esperienza avanzata agli utenti che lavorano con i dati in moduli, viste e dashboard.
In questi scenari si dispone dell'accesso dinamico alle funzionalità di Power Pages, come le impostazioni del sito, i frammenti di contenuto, gli elenchi, i moduli di base e così via.
Importante
Le istruzioni Liquid vengono elaborate solo come output. Liquid non ha la capacità di estendere il codice lato server relativo alle interazioni utente, ad esempio l'invio di moduli.