Impostare pagine personalizzate per l'accesso degli utenti

Note

Il Gruppo di Interesse Retail di Dynamics 365 Business Central è passato da Yammer a Viva Engage. Se non si ha accesso alla nuova community viva engage, compilare questo modulo (https://aka.ms/JoinD365commerceVivaEngageCommunity) per essere aggiunto e rimanere impegnati nelle discussioni più recenti.

In questo articolo viene descritto come creare pagine personalizzate in Microsoft Dynamics 365 Business Central che consentono di gestire accessi personalizzati per gli utenti di tenant business-to-consumer (B2C) di Microsoft Entra.

Per usare pagine personalizzate create in Dynamics 365 Business Central per gestire i flussi di accesso utente, configurare i criteri di Microsoft Entra a cui fa riferimento l'ambiente Commerce. È possibile configurare i criteri "Iscrizione e accesso", "Modifica del profilo" e "Reimpostazione password" di Microsoft Entra B2C utilizzando l'applicazione Microsoft Entra B2C. È quindi possibile fare riferimento ai nomi del tenant e dei criteri di Microsoft Entra B2C durante il processo di provisioning per l'ambiente Commerce utilizzando Microsoft Dynamics Lifecycle Services (LCS).

Compilare le pagine commerciali personalizzate usando i moduli di accesso, iscrizione, modifica del profilo dell'account, reimpostazione della password o moduli di Microsoft Entra generici. Fai riferimento agli URL di pagina pubblicati per queste pagine personalizzate nelle configurazioni dei criteri di Microsoft Entra B2C nel portale di Azure.

Usare la libreria di moduli per Commerce versione 10.0.15 o successiva con i flussi utente B2C consigliati. È anche possibile usare le pagine dei criteri utente predefinite offerte da Microsoft Entra ID B2C. Queste pagine consentono di aggiungere un'immagine di sfondo, modificare il logo e i colori di sfondo, il tutto relativo al brand aziendale. Sebbene più limitate in capacità di progettazione, le pagine dei criteri utente predefiniti forniscono la funzionalità dei criteri Microsoft Entra B2C senza creare e configurare pagine personalizzate dedicate.

Impostare criteri B2C

Dopo aver configurato il tenant Microsoft Entra B2C e associarlo all'ambiente commerciale, passare alla pagina Microsoft Entra B2C nel portale di Azure. Nel menu, in Criteri, selezionare Flussi utente (criteri).

Screenshot di comando Flussi utente (criteri) nel menu.

È ora possibile configurare i flussi di autenticazione utente "Iscrizione e accesso", "Modifica del profilo" e "Reimpostazione password".

Configurare i criteri di iscrizione e accesso

Per configurare il criterio "Iscrizione e accesso", seguire questa procedura:

  1. Seleziona Nuovo flusso utente, seleziona Iscrizione e accesso, seleziona la scheda Consigliato e quindi seleziona Crea.

  2. Immettere un nome per il criterio (ad esempio B2C_1_SignInSignUp).

  3. Nella sezione Provider di identità, selezionare i provider di identità da utilizzare per il criterio. Selezionare almeno Iscrizione tramite posta elettronica.

  4. Nella colonna Raccogli l'attributo, selezionare le caselle di controllo per Indirizzo di posta elettronica, Nome e Cognome.

  5. Nella colonna Restituisci l'attestazione, selezionare le caselle di controllo Indirizzi di posta elettronica, Nome, Provider di identità, Cognome e ID oggetto utente.

    Screenshot degli attributi e delle dichiarazioni selezionati.

  6. Fare clic su OK per creare i criteri.

  7. Fare doppio sul nome del nuovo criterio, quindi, nel pannello di navigazione, selezionare Proprietà.

  8. Impostare l'opzione Abilita JavaScript con imposizione del layout di pagina (anteprima) su Attivo.

    Screenshot della pagina delle proprietà per il nuovo criterio.

Note

L'ambiente Commerce fa riferimento completamente al nome del criterio e include il prefisso B2C_1_ nel riferimento. Non è possibile rinominare i criteri dopo averli creati. Se si sostituisce un criterio esistente per l'ambiente di Commerce, è possibile eliminare il criterio originale e creare un nuovo criterio che ha lo stesso nome. In alternativa, se l'ambiente è già stato predisposto, è possibile inviare il nuovo nome della policy tramite una richiesta di servizio.

Ritorna a questa politica per completare la configurazione dopo aver creato le pagine personalizzate. Per il momento, chiudere il criterio per tornare alla pagina Flussi utente (criteri) nel portale di Azure.

Configurare i criteri di modifica del profilo

Per configurare il criterio di modifica del profilo, seguire questa procedura:

  1. Seleziona Nuovo flusso utente, seleziona Modifica profilo, seleziona la scheda Consigliato e quindi seleziona Crea.
  2. Immettere un nome per il criterio (ad esempio B2C_1_EditProfile).
  3. Nella sezione Provider di identità, selezionare i provider di identità da utilizzare per il criterio. Seleziona almeno Accesso all'account locale.
  4. Nella colonna Raccogli l'attributo, seleziona le caselle di controllo per Nome specificato e Cognome.
  5. Nella colonna Restituisci l'attestazione, selezionare le caselle di controllo Indirizzi di posta elettronica, Nome, Provider di identità, Cognome e ID oggetto utente.
  6. Fare clic su OK per creare i criteri.
  7. Fare doppio sul nome del nuovo criterio, quindi, nel pannello di navigazione, selezionare Proprietà.
  8. Impostare l'opzione Abilita JavaScript con imposizione del layout di pagina (anteprima) su Attivo.

Ritorna a questa politica per completare la configurazione dopo aver creato le pagine personalizzate. Per il momento, chiudere il criterio per tornare alla pagina Flussi utente (criteri) nel portale di Azure.

Configurare i criteri di reimpostazione della password

Per configurare il criterio di reimpostazione della password, seguire questa procedura:

  1. Selezionare Nuovo flusso utente, selezionare l'opzione Reimpostazione password , scegliere la scheda Consigliata e selezionare Crea.
  2. Immettere un nome per il criterio (ad esempio B2C_1_ForgetPassword).
  3. Nella sezione Provider di identità, selezionare Reimposta password utilizzando l'indirizzo di posta elettronica.
  4. Nella colonna Restituisci l'attestazione, selezionare le caselle di controllo Indirizzi di posta elettronica, Nome, Cognome e ID oggetto utente.
  5. Fare clic su OK per creare i criteri.
  6. Fare doppio sul nome del nuovo criterio, quindi, nel pannello di navigazione, selezionare Proprietà.
  7. Impostare l'opzione Abilita JavaScript con imposizione del layout di pagina (anteprima) su Attivo.

Ritorna a questa politica per completare la configurazione dopo aver creato le pagine personalizzate. Per il momento, chiudere il criterio per tornare alla pagina Flussi utente (criteri) nel portale di Azure.

Creare pagine personalizzate

Commerce include moduli Microsoft Entra dedicati per creare pagine personalizzate per i criteri utente di Microsoft Entra B2C. È possibile creare pagine specificamente per il layout di ogni pagina dei criteri utente usando i moduli principali di Microsoft Entra B2C descritti in dettaglio nella sezione seguente. In alternativa, è possibile usare il modulo Microsoft Entra Generic per tutti i layout di pagina e i criteri in Microsoft Entra ID B2C (anche per le opzioni di layout di pagina all'interno dei criteri non elencati nella sezione seguente).

  • I moduli di Microsoft Entra specifici per la pagina si legano agli elementi di input dei dati resi da Microsoft Entra ID B2C. Questi moduli ti danno un maggiore controllo sul posizionamento degli elementi nelle tue pagine. Tuttavia, potrebbe essere necessario creare più pagine ed estensioni del modulo per tenere conto delle variazioni oltre le impostazioni predefinite descritte nella sezione seguente.
  • Il modulo Microsoft Entra Generic crea l'elemento "div" per Microsoft Entra B2C per eseguire il rendering di tutti gli elementi nel layout della pagina dei criteri utente. Questo approccio offre maggiore flessibilità per le funzioni B2C della pagina, ma si ha meno controllo del posizionamento e dello stile (anche se CSS può essere usato per corrispondere all'aspetto del sito).

È possibile creare una singola pagina usando il modulo Microsoft Entra Generic e usarlo per tutte le pagine dei criteri utente. In alternativa, è possibile creare pagine specifiche usando i singoli moduli di Microsoft Entra per l'accesso, l'iscrizione, la modifica del profilo, la reimpostazione della password e la verifica della reimpostazione della password. È anche possibile usare una combinazione di entrambi gli approcci, usando le pagine specifiche di Microsoft Entra per i layout di pagina indicati nella sezione seguente e la pagina generica del modulo Microsoft Entra per i layout di pagina rimanenti all'interno di queste o altre pagine dei criteri utente.

Per altre informazioni sui moduli di Microsoft Entra forniti con la libreria dei moduli, vedere Pagine e moduli di gestione delle identità.

Per compilare le pagine personalizzate con moduli di identità specifici per gestire gli accessi utente, seguire questa procedura:

  1. In Creazione di siti Web di Commerce, accedere al sito.
  2. Crea i seguenti cinque modelli e pagine (se non sono già presenti nel tuo sito):
    • Un modello Accesso e la pagina che utilizza il modulo Accesso.
    • Un modello Iscrizione e la pagina che utilizza il modulo Iscrizione.
    • Un modello Reimpostazione password e una pagina che utilizza modulo Reimpostazione password.
    • Un modello Verifica reimpostazione password e una pagina che utilizza il modulo Verifica reimpostazione password.
    • Un modello Modifica profilo e la pagina che utilizza il modulo Modifica profilo account.

Quando si creano le pagine, attenersi alle seguenti indicazioni:

  • Per ciascuna pagina o modulo, utilizzare il layout e lo stile più appropriati per i requisiti aziendali.
  • Pubblicare tutte le pagine e gli URL che devono essere utilizzati nella configurazione di Microsoft Entra B2C.
  • Dopo la pubblicazione di pagine e URL raccogliere gli URL che devono essere utilizzati per le configurazioni dei criteri di Microsoft Entra B2C. Quando viene utilizzato, ad ogni URL viene aggiunto un suffisso ?preloadscripts=true.

Importante

Microsoft Entra B2C serve le pagine direttamente dal dominio del tenant di Microsoft Entra B2C. Non riutilizzare intestazioni e piè di pagina universali che hanno collegamenti relativi. Poiché queste pagine sono ospitate nel dominio Microsoft Entra B2C, usare solo gli URL assoluti per tutti i collegamenti. Creare un'intestazione e un piè di pagina specifici con URL assoluti per le pagine personalizzate relative a Microsoft Entra. Rimuovere tutti i moduli specifici di Commerce che richiedono la connessione a Retail Server. Ad esempio, i preferiti, la barra di ricerca, il collegamento di accesso e i moduli carrello non devono essere inclusi in nessuna pagina usata nei flussi utente di Microsoft Entra B2C.

Configurare criteri di Microsoft Entra B2C con informazioni sulle pagine personalizzate

Nel portale di Azure tornare alla pagina Microsoft Entra B2C. Nel menu, in Criteri, selezionare Flussi utente (criteri).

Aggiornare i criteri di iscrizione e accesso con informazioni sulla pagina personalizzate

Per aggiornare il criterio "Iscrizione e accesso" con informazioni sulla pagina personalizzate, seguire questa procedura:

  1. Nel criterio Iscrizione e accesso configurato in precedenza, nel pannello di navigazione, selezionare Layout di pagina.
  2. Selezionare il layout Pagina unificata per l'iscrizione o l'accesso.
  3. Impostare l'opzione Usa contenuto di pagina personalizzato su Sì.
  4. Nel campo URI della pagina personalizzata, immettere l'URL di accesso completo. Includere il suffisso ?preloadscripts=true. Ad esempio, immettere www.<my domain>.com/sign-in?preloadscripts=true.
  5. Nel campo Versione layout pagina selezionare la versione 2.1.7 (richiede la libreria dei moduli per Commerce versione 10.0.15 o successiva).
  6. Seleziona Salva.
  7. Selezionare il layout Pagina di iscrizione dell'account locale.
  8. Impostare l'opzione Usa contenuto di pagina personalizzato su Sì.
  9. Nel campo URI della pagina personalizzata, immettere l'URL di iscrizione completo. Includere il suffisso ?preloadscripts=true. Ad esempio, immettere www.<my domain>.com/sign-up?preloadscripts=true.
  10. Nel campo Versione layout pagina selezionare la versione 2.1.7 (richiede la libreria dei moduli per Commerce versione 10.0.15 o successiva).
  11. Nella sezione Attributi utente, effettuare le operazioni seguenti:
    1. Per gli attributi Nome e Cognome seleziona No nel campo Richiede la verifica.
    2. Per l'attributo Indirizzo di posta elettronica lasciare selezionato il valore predefinito Sì nella colonna Richiede verifica . Questa opzione garantisce che gli utenti che si registrano con un determinato indirizzo e-mail verifichino di essere proprietari dell'indirizzo e-mail.
    3. Per gli attributi Indirizzo di posta elettronica, Nome e Cognome, selezionare No nella colonna Facoltativo.
  12. Seleziona Salva.

Aggiornare i criteri di modifica del profilo con informazioni sulla pagina personalizzate

Per aggiornare i criteri di modifica del profilo con informazioni sulla pagina personalizzate, seguire questa procedura:

  1. Nel criterio Modifica profilo configurato in precedenza, nel pannello di navigazione, selezionare Layout di pagina.
  2. Selezionare il layout Pagina di modifica del profilo. Potrebbe essere necessario scorrere verso il basso oltre altre opzioni di layout, a seconda dello schermo.
  3. Impostare l'opzione Usa contenuto di pagina personalizzato su Sì.
  4. Nel campo URI della pagina personalizzata, immettere l'URL di modifica profilo completo. Includere il suffisso ?preloadscripts=true. Ad esempio, immettere www.<my domain>.com/profile-edit?preloadscripts=true.
  5. Per Versione layout di pagina selezionare la versione 2.1.7. Questa versione richiede la libreria di moduli per Commerce versione 10.0.15 o successiva.
  6. Nella sezione Attributi utente, effettuare le operazioni seguenti:
    1. Per gli attributi Nome e Cognome, selezionare No nella colonna Facoltativo.
    2. Per gli attributi Nome e Cognome seleziona No nella colonna Richiede la verifica.
  7. Seleziona Salva.

Aggiornare i criteri di reimpostazione della password con informazioni sulla pagina personalizzate

Per aggiornare i criteri di reimpostazione della password con informazioni personalizzate sulla pagina, seguire questa procedura:

  1. Nel criterio Reimposta password configurato in precedenza, nel pannello di navigazione, selezionare Layout di pagina.
  2. Seleziona il layout Pagina password dimenticata.
  3. Impostare l'opzione Usa contenuto di pagina personalizzato su Sì.
  4. Nel campo URI della pagina personalizzata, immettere l'URL di verifica della reimpostazione della password completo. Includere il suffisso ?preloadscripts=true. Ad esempio, immettere www.<my domain>.com/password-reset-verification?preloadscripts=true.
  5. Nel campo Versione layout pagina selezionare la versione 2.1.7. Questa versione richiede la libreria di moduli per Commerce versione 10.0.15 o successiva.
  6. Seleziona Salva.
  7. Seleziona il layout Pagina modifica password.
  8. Impostare l'opzione Usa contenuto di pagina personalizzato su Sì.
  9. Nel campo URI della pagina personalizzata, immettere l'URL di reimpostazione della password completo. Includere il suffisso ?preloadscripts=true. Ad esempio, immettere www.<my domain>.com/password-reset?preloadscripts=true.
  10. Nel campo Versione layout pagina selezionare la versione 2.1.7. Questa versione richiede la libreria di moduli per Commerce versione 10.0.15 o successiva.
  11. Seleziona Salva.

Personalizzazione stringhe di testo predefinite per etichette e descrizioni

Nella libreria dei moduli i moduli di accesso includono stringhe di testo predefinite per le etichette e le descrizioni. È possibile personalizzare queste stringhe nel riquadro delle proprietà del modulo su cui si sta lavorando. Per modificare altre stringhe nella pagina, ad esempio il testo del collegamento Password dimenticata? o il testo crea una chiamata all'account all'azione, è necessario usare Commerce Software Development Kit (SDK) e aggiornare i valori nel global.json file per il modulo di accesso.

Ad esempio, il testo predefinito per il collegamento per la password dimenticata è Password dimenticata?. Lo screenshot seguente mostra questo testo predefinito nella pagina di accesso.

Screenshot del testo predefinito per il collegamento per la password dimenticata nella pagina di accesso.

Tuttavia, nel global.json file per il modulo di accesso della libreria dei moduli è possibile modificare il testo in Password dimenticata? come illustrato nella figura seguente:

Screenshot del testo del collegamento aggiornato nel file global.json del modulo Accesso.

Dopo aver aggiornato il global.json file e pubblicato le modifiche, il nuovo testo del collegamento viene visualizzato nel modulo di accesso sia in Commerce che nella pagina di accesso live.

Altre risorse

  • Last updated on