Archiviare contenuto di origine tramite modelli Web

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

Un modello Web è una tabella di Power Apps (adx_webtemplate), inclusa nei portali Power Apps e utilizzata per archiviare il contenuto di origine del modello. Un modello Web conterrà in genere Liquid per il rendering di contenuto dinamico ed è la tabella principale utilizzata per integrare i modelli Liquid al resto del sistema dei portali Power Apps.

I modelli Web possono essere inclusi in altro contenuto o combinati con altri modelli utilizzando i tag del modello; questi tag fanno riferimento ai modelli Web tramite l'attributo Nome. I modelli Web possono anche essere utilizzati per creare interi modelli di pagina personalizzati oppure intestazioni e/o piè di pagina personalizzati per il sito Web del portale.

Nota

Puoi anche archiviare il contenuto di origine del modello in Power Pages. Altre informazioni: Cos'è Power Pages?

Attributi del modello Web

Attributo Descrizione
Nome Nome del modello. Utilizzato per fare riferimento a questo modello quando è incluso in un altro contenuto, o esteso da altri modelli.
Origine Contenuto di origine del modello. In Power Apps, per questo campo, viene fornito un editor del codice sorgente con evidenziazione della sintassi e altre funzionalità di modifica del codice.
Tipo MIME Facoltativamente offre un tipo MIME per il contenuto del modello. Se non viene specificato nulla, si presuppone un tipo text/html. Questo valore verrà utilizzato solo nei casi in cui il modello è associato a un modello di pagina e controlla il rendering di tutti i contenuti per tale modello.

Modelli Web come modelli di pagina

I modelli Web possono essere utilizzati insieme a modelli della pagina per creare nuovi modelli per il sistema di gestione dei contenuti dei portali Power Apps. Questo può essere eseguito interamente in Power Apps, senza dover scrivere il codice .NET o ridistribuire l'applicazione del portale.

Per creare un nuovo modello della pagina in base a un modello Web, seleziona un tipo di modello Web quando si crea un nuovo record Modello di pagina. Seleziona quindi un Modello Web.

Nota l'opzione Usa intestazione e piè di pagina sito Web(selezionata per impostazione predefinita). Se questa opzione è selezionata, il modello Web controllerà il rendering del contenuto della pagina tra l'intestazione e il piè di pagina del sito Web globale. Se questa opzione è deselezionata, il modello Web sarà responsabile del rendering dell'intera risposta, nel caso in cui stai eseguendo il rendering di HTML, e quindi dal tipo di documento ai tag <html> radice compreso tutto quello che c'è nel mezzo.

Mentre verrà eseguito il rendering in HTML dei casi di utilizzo più comuni, il rendering dell'intera risposta (deselezionando Usa intestazione e piè di pagina sito Web) offre la possibilità di eseguire il rendering al formato basato su scelto. Qui l'attributo Tipo MIME del modello Web diventa appropriato. Quando viene eseguito il rendering di un modello di pagina che non utilizza l'intestazione e il piè di pagina del sito Web, l'intestazione Content-Type della risposta HTTP verrà impostata sul tipo MIME del modello Web associato (verrà utilizzato testo/html se non viene fornito alcun tipo MIME.), fornendo un'ampia varietà di opzioni per il rendering di contenuto non HTML utilizzando Liquid. Un caso di utilizzo comune sarebbe di eseguire il rendering di un feed RSS impostando un tipo MIME di application/rss+xml.

Modelli Web come intestazioni e piè di pagina del sito Web

I modelli Web possono inoltre essere utilizzati per sostituire le intestazioni e i piè di pagina globali utilizzati da un portale Power Apps. Imposta il campo Modello intestazione o Modello piè di pagina del sito Web sul modello Web scelto. Se viene sostituita l'intestazione del sito Web, il modello selezionato si assume la responsabilità del rendering della navigazione principale, dei collegamenti di accesso e disconnessione, dell'interfaccia di ricerca e così via per gli elementi di interfaccia del sito che in genere sono gestiti dal modello predefinito dell'intestazione.

Modelli Web incorporati

Esiste un insieme di modelli Liquid predefiniti disponibile nei portali Power Apps. Per utilizzarli, devi includerli per nome, usando l'elenco che segue come riferimento.

Nome Descrizione Codice
Annuncio Questo modello esegue il rendering di un annuncio in base al nome o casualmente di un annuncio da un posizionamento. {% include 'ad' ad_name:'Name' %}{% include 'ad' ad_placement_name:'Placement Name' %}
Blog Questo modello esegue il rendering di post di blog recenti in un gruppo elenco. {% include 'blogs' %}
Percorsi Questo modello esegue il rendering di collegamenti di pagine predecessore alla Home page dalla pagina corrente. {% include 'breadcrumbs' %}
Gruppo elenco collegamenti figlio Questo modello esegue il rendering di collegamenti a pagine figlio della pagina corrente in un gruppo elenco. {% include 'child_link_list_group' %}{% include 'child_link_list_group' title_only:true %}{% include 'child_link_list_group' image_width:'64px', image_height:'64px' %}
Eventi: futuri Questo modello esegue il rendering dei collegamenti agli eventi che si verificano tra ora e 60 giorni a partire da ora. {% include 'events_upcoming' %}{% include 'events_upcoming' number_of_days_in_advance:60 %}
Forum Questo modello esegue il rendering di un elenco di forum del sito Web con il rispettivo numero di thread e post. {% include 'forums' %}
Layout a 1 colonna Questo modello esegue il rendering di un layout a colonna singola contenente percorsi, il titolo di pagina e il contenuto della pagina. {% extends 'layout_1_column' %}{% block main %}... {% endblock %}
Layout a 2 colonne (colonna sinistra larga) Questo modello esegue il rendering di un layout a due colonne. La colonna sinistra è più ampia della destra. Contiene i percorsi, il titolo della pagina nella parte superiore della pagina e il contenuto della pagina si trova nella colonna sinistra. {% extends 'layout_2_column_wide_left' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %}
Layout a 2 colonne (colonna destra larga) Questo modello esegue il rendering di un layout a due colonne. La colonna destra è più ampia della sinistra. Contiene i percorsi, il titolo della pagina nella parte superiore della pagina e il contenuto della pagina si trova nella colonna destra. {% extends 'layout_2_column_wide_right' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %}
Layout a 3 colonne (colonna intermedia larga) Questo modello esegue il rendering di un layout a tre colonne. La colonna centrale è più ampia della sinistra e della destra. Il layout contiene percorsi, e il titolo della pagina nella parte superiore della pagina e il contenuto della pagina si trova nella colonna centrale. {% extends 'layout_3_column_wide_middle' %}{% block left_aside %}...{% endblock %}{% block main %}...{% endblock %}{% block right_aside %}...{% endblock %}
Copia pagina Questo modello esegue il rendering del codice HTML del contenuto della pagina modificabile con supporto per Liquid incorporato {% include 'page_copy' %}
Intestazione pagina Questo modello esegue il rendering del titolo di pagina. {% include 'page_header' %}
Sondaggio Questo modello esegue il rendering di un sondaggio in base al nome o casualmente di un sondaggio da un posizionamento. {% include 'poll' poll_name:'Name' %}{% include 'poll' poll_placement_name:'Placement Name' %}
Cerca Questo modello esegue il rendering di un modulo di ricerca di base con un pulsante di ricerca e un singolo input di testo. {% include 'search' %}
Spostamento laterale Questo modello esegue il rendering di uno spostamento in stile visualizzazione ad albero verticale. Contiene collegamenti a pagine predecessore fino al primo livello (o offset profondità specificato), collegamenti a pagine di pari livello della pagina corrente e collegamenti a elementi figlio della pagina corrente. {% include 'side_navigation' %}{% include 'side_navigation' depth_offset:1 %}
Frammento di codice Questo modello esegue il rendering di un frammento di contenuto HTML modificabile in base al nome. {% include 'snippet' snippet_name:'Name' %}
Spostamento superiore Questo modello esegue il rendering di una barra di spostamento modificabile con menu a discesa per il set di collegamenti Web della navigazione principale. {% include 'top_navigation' %}
Gruppo elenco collegamenti Web Questo modello esegue il rendering di gruppo elenco di collegamenti per un set di collegamenti Web. {% include 'weblink_list_group' weblink_set_name:'Name' %}

Vedi anche

Informazioni sugli operatori Liquid
Tipi Liquid
Condizionale
Oggetti Liquid
Tag Liquid
Filtri Liquid

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