Modelli Power Pages

Completato

Sebbene le pagine Web rappresentino il contenuto accessibile agli utenti del sito Web, i modelli di pagina aiutano a garantire la coerenza a livello di aspetto in tutto il sito Web. I modelli definiscono anche il modo in cui il contenuto dinamico basato sui dati di Microsoft Dataverse viene distribuito agli utenti e il modo in cui gli utenti possono interagire con le pagine del sito Web.

Quando viene creata una nuova pagina Web nello studio di progettazione di Power Pages o nell'app Gestione del portale, scegliere un modello di pagina nell'elenco dei modelli esistenti. In ogni modello Power Pages sono disponibili diversi modelli di pagina.

Due tipi di modello controllano il modo in cui il modello determina gli elementi da visualizzare:

  • Riscrivi: usa la colonna Riscrivi URL per eseguire il rendering di un modello ASP.NET fisso.

  • Modello Web: usa la colonna Modello Web per eseguire il rendering di un modello Web specifico.

Riscrivi

Il tipo di modello Riscrivi fa riferimento al percorso fisico della pagina .aspx che viene eseguita nell'app Web Power Pages e che elabora la richiesta. Power Pages è ospitato e non fornisce accesso diretto all'app, al codice o alle risorse. Non è possibile creare nuovi modelli Riscrivi né modificare il comportamento dei modelli esistenti.

I modelli Riscrivi sono utili per l'elaborazione di contenuti specializzati, ad esempio forum, blog e idee. Sono disponibili diversi modelli di pagina Riscrivi speciali, quali Accesso negato, Errore e Profilo. Non è consigliabile rimuovere o sostituire questi modelli.

Modelli Web

Per creare modelli di pagina personalizzati è possibile usare il tipo Modello Web, che è un modello di layout. Ad esempio, se un modello Web include HTML statico, l'elemento HTML viene visualizzato così com'è nell'output della pagina che usa tale modello. Il vero vantaggio dei modelli Web è dato dalla capacità di contenere codice Liquid, che aggiunge funzionalità di elaborazione al contenuto statico, incluso l'accesso ai dati di Dataverse.

I modelli Web sono flessibili, è possibile eseguirne il rendering in maniera autonoma oppure includerli in un altro modello. I modelli Web supportano l'ereditarietà, ovvero un modello si basa su un altro modello e ne estende le funzionalità. Inoltre, possono essere usati per eseguire il rendering di un frammento autonomo di codice HTML, ad esempio il percorso di navigazione di una pagina o l'intera pagina personalizzata oppure è possibile creare intestazioni e piè di pagina personalizzati per il sito Web Power Pages.

Poiché il modello Web definisce il contenuto distribuito al client, un consulente funzionale spesso si rivolge a un responsabile della progettazione o a uno sviluppatore per aggiungere CSS o JavaScript per estendere un modello Web e aggiungere funzionalità lato client alla pagina generata.

Screenshot del modello in fase di modifica nell'app Gestione del portale.

Colonne del modello Web

Un modello Web è una tabella semplice che contiene le seguenti colonne:

  • Nome: quando un modello è incluso in altri contenuti o esteso da altri modelli, viene indicato con questo nome.

  • Origine: il contenuto di origine del modello. Può essere un testo statico, un frammento HTML o un layout creato con Liquid.

  • Tipo MIME: definisce il tipo MIME che il server invia al client quando viene eseguito il rendering del modello. Se non si specifica un valore, si presume che sia text/html, che è un tipo standard per le pagine HTML. È possibile creare un modello Web con rendering di contenuti specializzati. Ad esempio, è possibile creare un modello Web che restituisce alcuni dati in formato JSON. In questo caso, il tipo MIME è impostato su application/json. Le persone non userebbero una pagina basata su questo modello Web in un browser. Esso verrà invece chiamato da codice JavaScript, che definisce in modo efficace un'origine dati per la soluzione.

Intestazioni e piè di pagina del sito Web

I modelli Web consentono inoltre di sostituire l'intestazione e il piè di pagina globali usati da un sito Web Power Pages. A tale scopo, impostare la colonna Modello di intestazione o Modello piè di pagina del sito web sul modello Web prescelto. Se si sostituisce Modello di intestazione, il modello selezionato provvederà a eseguire il rendering della navigazione principale, dei collegamenti di accesso/disconnessione, dell'interfaccia di ricerca e così via, per gli elementi dell'interfaccia del sito normalmente gestiti dal modello di intestazione predefinito.

Suggerimento

Se non si specifica alcun modello di intestazione o piè di pagina nella riga del sito Web, viene eseguito il rendering del contenuto predefinito. Per rimuovere l'intestazione o il piè di pagina, specificare un modello vuoto.