Utilizzare i moduli

Articolo
03/08/2023

In questo articolo viene descritto come e quando utilizzare moduli in generatore di siti Microsoft Dynamics 365 Commerce.

I moduli sono blocchi predefiniti logici che costituiscono la struttura della pagina e hanno scopi e finalità. Alcuni moduli sono contenitori di alto livello e il loro solo scopo è di contenere e organizzare altri moduli (moduli figlio). Altri moduli, ad esempio un modulo Posizionamento immagine semplice, hanno uno scopo molto specifico. Altri moduli, come il modulo Sequenza, non rientrano in nessuna di queste due categorie.

Per impostazione predefinita, il sito di Dynamics 365 Commerce include una libreria di moduli che consente di ottenere la maggior parte degli scenari di e-Commere di base. Dovrebbe essere possibile poter creare un sito di e-Commerce end-to-end utilizzando questi moduli. Tuttavia, è anche possibile che si intenda personalizzare tali moduli o creare nuovi moduli personalizzati per specifiche esigenze. Se si desidera creare moduli personalizzati, un kit SDK di progettazione di moduli è disponibile per creare una libreria di moduli personalizzati.

Moduli contenitore e slot

Come indicato in precedenza, alcuni moduli sono progettati per contenere moduli figlio. Questi moduli sono noti come contenitori e consentono l'utilizzo di gerarchie di moduli nidificati. I moduli contenitore includono slot. Gli slot sono utilizzati per gestire il layout e lo scopo dei moduli figlio nel contenitore. Un esempio è un modulo contenitore pagina di base (un modulo di livello superiore per qualsiasi pagina) che definisce vari slot importanti:

Uno slot di intestazione
Uno slot di intestazione secondaria
Uno slot principale
Uno slot piè di pagina
Uno slot di piè di pagina secondario

Lo sviluppatore del modulo definisce tali slot e determina quali e quanti moduli figlio possono essere inseriti direttamente all'interno di tale modulo. Ad esempio, lo slot intestazione potrebbe supportare solo un modulo di tipo modulo Intestazione, mentre lo slot corpo potrebbe supportare un numero illimitato di moduli di qualsiasi tipo (tranne altri moduli contenitore pagina).

Negli strumenti di creazione, gli autori di pagine non devono sapere in anticipo quali moduli possono e non possono essere inseriti in ogni slot. Quando gli autori di pagine selezionano uno slot e quindi tentano di selezionare un modulo da aggiungere allo slot, vedono una visualizzazione filtrata dei tipi di modulo supportati per quello slot.

Moduli contenuto

I moduli contenuto contengono contenuto ed elementi multimediali, come testo (ad esempio, titoli, paragrafi e collegamenti) o riferimenti ad asset (ad esempio, immagini, video e PDF). Tipici tipi di moduli di contenuto includono blocchi di contenuto, blocchi di testo e moduli banner promozionali. I moduli di questi tre tipi possono contenere testo o elementi multimediali e non richiedono moduli figlio per rendere qualcosa visibile in una pagina.

La maggior parte delle attività di creazione di pagine e contenuto quotidiane tipiche comporta moduli contenuto, in particolare perché questi moduli definiscono il contenuto effettivo di cui viene eseguito il rendering nei moduli contenitore padre. Molti moduli contenuto sono disponibili e questi moduli sono in genere gli ultimi pezzi che saranno aggiunti alla gerarchia di moduli nidificati di una pagina.

Nella figura seguente viene illustrato come i moduli sono nidificati negli slot di moduli contenitore padre.

Moduli nidificati.

Aggiungere o rimuovere moduli

Nelle procedure riportate di seguito viene descritto come aggiungere e rimuovere moduli.

Aggiungere un modulo

Per aggiungere un modulo a uno slot o contenitore in una pagina, effettuare le seguenti operazioni.

Nel riquadro a sinistra o direttamente nel canvas principale, selezionare un contenitore o uno slot a cui un modulo figlio può essere aggiunto.

Nota

Lo strumento di progettazione di moduli definisce l'elenco dei tipi di modulo che possono essere aggiunti a uno slot di modulo specifico. Gli autori di modelli possono quindi affinare le opzioni per moduli consentite per garantire un'ottimizzazione del motore di ricerca coerente e l'efficacia di creazione per tutte le pagine generate da un modello specifico. Durante l'aggiunta di un modulo a uno slot, la finestra di dialogo Aggiungi modulo viene automaticamente filtrata in modo da visualizzare solo i moduli che sono supportati nel contenitore o nello slot selezionato. L'elenco di moduli consentiti viene determinato dal modello della pagina o dalla definizione del modulo contenitore.
Se si utilizza il riquadro di contorno, selezionare i puntini di sospensione (...) accanto al nome del modulo, quindi selezionare Aggiungi modulo. Se si utilizzano i controlli direttamente nel canvas, selezionare il simbolo più (+) in uno slot vuoto o adiacente al modulo attualmente selezionato, quindi selezionare Aggiungi modulo.

Nota

Se un contenitore o uno slot non supporta nuovi moduli figlio, l'opzione Aggiungi modulo non è disponibile.
Nella finestra di dialogo Aggiungi modulo, selezionare un modulo da aggiungere alla pagina.

Suggerimento

Blocco di contenuto è un buon tipo di modulo con cui i principianti possono lavorare.
Selezionare OK per aggiungere il modulo selezionato al contenitore o allo slot selezionato nella pagina.

Rimuovere un modulo

Per rimuovere un modulo da uno slot o un contenitore in una pagina, effettuare le seguenti operazioni.

Nel riquadro a sinistra, selezionare il pulsante con i puntini di sospensione (...) accanto al nome del modulo da rimuovere e quindi selezionare il simbolo del cestino. In alternativa, nel canvas principale è possibile selezionare il simbolo del cestino sulla barra degli strumenti di un modulo selezionato.
Quando viene richiesto di confermare la rimozione del modulo, selezionare OK.

Spostare un modulo in una una posizione

Per spostare un modulo in una nuova posizione all'interno della pagina, utilizzare uno dei seguenti metodi.

Spostare un modulo utilizzando il riquadro struttura

Per spostare un modulo utilizzando il riquadro struttura, attenersi alla seguente procedura.

Selezionare e tenere premuto il modulo che si desidera spostare nel riquadro struttura, quindi trascinare il modulo in una nuova posizione nella struttura. La linea blu nel contorno e nel canvas indica dove è possibile posizionare il modulo.
Rilasciare il modulo per inserirlo nella nuova posizione.

Spostare un modulo direttamente nel canvas

Per spostare un modulo direttamente nel canvas, attenersi alla seguente procedura.

Selezionare il modulo che si desidera spostare nel canvas.
Selezionare un simbolo di freccia rivolta verso l'alto o verso il basso nella barra degli strumenti del modulo, quindi trascinare la freccia in una nuova posizione sulla pagina. La linea blu nel contorno e nel canvas indica dove è possibile posizionare il modulo. Se un modulo non può essere spostato verso l'alto o verso il basso, quel simbolo di freccia verrà disattivato.
Rilasciare il modulo per inserirlo nella nuova posizione.

Per spostare un modulo utilizzando il menu dei puntini di sospensione, attenersi alla seguente procedura.

Selezionare un modulo nella struttura o nel canvas.
Selezionare i puntini di sospensione (...) accanto al nome del modulo nel riquadro struttura o nella barra degli strumenti del modulo nel canvas.
Se il modulo può essere spostato verso l'alto o verso il basso all'interno del contenitore o dello slot, verranno visualizzate le opzioni per Sposta su o Sposta giù. Selezionare l'opzione di spostamento desiderata per spostare il modulo verso l'alto o verso il basso rispetto ai suoi elementi di pari livello.

Configurare moduli

Nelle procedure riportate di seguito viene descritto come configurare moduli contenuto e contenitore.

Configurare un modulo contenuto

Per configurare un modulo contenuto in una pagina, effettuare le seguenti operazioni.

Nella riquadro a sinistra, espandere la struttura e selezionare qualsiasi modulo contenuto (ad esempio Blocco di contenuto). In alternativa, è possibile selezionare il modulo nel canvas principale.
Nel riquadro delle proprietà del modulo sulla destra, immettere le proprietà per tutti i controlli del modulo desiderati.
Selezionare Salva nella barra dei comandi. Ciò aggiornerà anche la canvas di anteprima.

Modificare le proprietà del testo del modulo

Le proprietà del testo del modulo che non sono di sola lettura possono essere modificate direttamente nel canvas.

Per modificare le proprietà del testo del modulo, attenersi alla seguente procedura.

Selezionare il controllo del testo nel canvas, quindi posizionare il cursore nel punto in cui desideri modificare il testo.
Immettere il contenuto del testo.
Selezionare un punto qualsiasi al di fuori del contenuto del testo per continuare a modificare altro contenuto.

Selezione immagine in linea

Le immagini del modulo che non sono di sola lettura possono essere modificate direttamente dal canvas.

Per scegliere una nuova immagine per un modulo di contenuto, effettuare le seguenti operazioni.

Nel canvas, fare doppio clic sull'immagine. Questo farà apparire la finestra di selezione dei file multimediali.
Trovare e selezionare una nuova immagine da utilizzare, quindi selezionare OK. Il rendering della nuova immagine viene ora effettuato nel canvas.

Configurare un modulo contenitore

Per configurare un modulo contenitore in una pagina, effettuare le seguenti operazioni.

Selezionare un modulo contenitore nella pagina (ad esempio un modulo contenitore fluido o Sequenza).
Nel riquadro delle proprietà a destra, espandere i controlli nidificati selezionando le intestazioni e impostare tutti i valori di controllo necessari.
Nel riquadro a sinistra, selezionare il pulsante con i puntini di sospensione accanto al nome del contenitore o di qualsiasi slot nel contenitore e quindi selezionare Aggiungi modulo. Aggiungere quindi i moduli figlio al contenitore selezionato. Per ulteriori informazioni, vedi la sezione Utilizzare i moduli descritta precedentemente in questo articolo.
Se molteplici moduli figlio esistono come elementi di pari livello in un contenitore padre, è possibile modificarne l'ordine di visualizzazione nel contenitore padre. Selezionare il pulsante con i puntini di sospensione per un modulo e quindi utilizzare i tasti freccia GIÙ o SU.