Raccogliere attributi utente personalizzati durante l'iscrizione

Si applica a: Tenant esterni della forza lavoro (altre informazioni)

Suggerimento

Questo articolo si applica ai flussi utente nei tenant esterni. Per informazioni sui tenant della forza lavoro, vedere Definire attributi personalizzati per i flussi utente.

Se l'app richiede più informazioni rispetto agli attributi utente predefiniti, è possibile aggiungere attributi personalizzati. Questi attributi vengono indicati come attributi utente personalizzati.

Per definire un attributo utente personalizzato, creare prima l'attributo a livello di tenant in modo che possa essere usato in qualsiasi flusso utente nel tenant. Assegnare quindi l'attributo al flusso utente di iscrizione e configurare la modalità di visualizzazione nella pagina di iscrizione.

Altre informazioni sugli attributi utente personalizzati sono disponibili nell'articolo Attributi del profilo utente.

Creare attributi utente personalizzati

1. Accedi all'Interfaccia di amministrazione di Microsoft Entra.

2. Se si ha accesso a più tenant, usare l'icona Impostazioni nel menu in alto per passare al tenant esterno dal menu Directory e sottoscrizioni.

3. Passare a Identity>External Identity Identities>Overview (Panoramica delle identità esterne).

4. Selezionare Attributi utente personalizzati. L'elenco contiene tutti gli attributi utente disponibili nel tenant, inclusi gli attributi utente personalizzati creati. La colonna Tipo attributo indica se un attributo è predefinito o personalizzato.

5. Selezionare Aggiungi. Nel riquadro Aggiungi un attributo immettere un nome per l'attributo personalizzato, ad esempio "Condizioni per l'utilizzo".

6. In Tipo di dati scegliere String, Boolean o Int a seconda del tipo di dati e del controllo di input utente che si desidera creare. Gli attributi stringa hanno un valore di tipo di input utente predefinito textBox, ma è possibile modificarlo in un passaggio successivo, ad esempio se si vogliono configurare pulsanti di opzione o caselle di controllo a selezione multipla.

7. (Facoltativo) In Descrizione immettere una descrizione dell'attributo personalizzato per l'uso interno. Questa descrizione non è visibile all'utente.

   

8. Seleziona Crea. L'attributo personalizzato è ora disponibile nell'elenco degli attributi utente e può essere aggiunto ai flussi utente.

Includere l'attributo utente personalizzato in un flusso di iscrizione

Seguire questa procedura per aggiungere attributi utente personalizzati a un flusso utente già creato. Se è necessario creare un nuovo flusso utente, vedere Creare un flusso utente di iscrizione e accesso per i clienti.

1. Accedi all'Interfaccia di amministrazione di Microsoft Entra.

2. Se si ha accesso a più tenant, usare l'icona Impostazioni nel menu in alto per passare al tenant esterno dal menu Directory e sottoscrizioni.

3. Passare a Identità>esterne Flussi> utente.

4. Selezionare il flusso utente dall'elenco.

5. Selezionare Attributi utente. L'elenco include tutti gli attributi utente personalizzati definiti come descritto nella sezione precedente. Ad esempio, il nuovo attributo Condizioni per l'utilizzo viene ora visualizzato nell'elenco. Scegliere tutti gli attributi da raccogliere dall'utente durante l'iscrizione.

   

6. Seleziona Salva.

Configurare i tipi di input utente e il layout di pagina

Nella pagina Layout di pagina è possibile indicare quali attributi sono necessari e disporre l'ordine di visualizzazione. È anche possibile modificare le etichette degli attributi, creare pulsanti di opzione o caselle di controllo e aggiungere collegamenti ipertestuali a altri contenuti, ad esempio le condizioni per l'utilizzo o un'informativa sulla privacy.

1. Accedi all'Interfaccia di amministrazione di Microsoft Entra.

2. Passare a Identità>esterne Flussi> utente.

3. Nell'elenco selezionare il flusso utente.

4. In Personalizza, selezionare Layout di pagina. Vengono visualizzati gli attributi scelti per la raccolta.

5. Modificare l'etichetta per qualsiasi attributo selezionando il valore nella colonna Etichetta e modificando il testo.

6. Configurare caselle di controllo o pulsanti di opzione:

   • Casella di controllo a selezione singola: viene eseguito il rendering di un tipo di attributo booleano come casella di controllo a selezione singola nella pagina di iscrizione. Per configurare il testo visualizzato accanto alla casella di controllo, selezionare e modificare il valore nella colonna Etichetta . Usare la lingua markdown per aggiungere collegamenti ipertestuali. Per informazioni dettagliate, vedere Per configurare una casella di controllo a selezione singola (CheckboxSingleSelect)
   • Caselle di controllo a selezione multipla: trovare l'attributo Tipo di dati Stringa da configurare e selezionare il valore nella colonna Tipo di input utente per aprire il riquadro dell'editor. Scegliere la casella di controlloMultiSelezionare il tipo di input dell'utente e immettere i valori. Per informazioni dettagliate, vedere Per configurare le caselle di controllo a selezione multipla (CheckboxMultiSelect).For details, see To configure multiselect checkboxes (CheckboxMultiSelect).
   • Pulsanti di opzione: trovare l'attributo Tipo di dati Stringa da configurare e selezionare il valore nella colonna Tipo di input utente per aprire il riquadro dell'editor. Scegliere RadioSingleSelezionare il tipo di input dell'utente e immettere i valori. Per informazioni dettagliate, vedere Per configurare i pulsanti di opzione (RadioSingleSelect)

7. Modificare l'ordine di visualizzazione selezionando un attributo e scegliendo Sposta su, Sposta verso il basso, Sposta in alto, Sposta in alto o Sposta in basso.

8. Impostare un attributo obbligatorio selezionando la casella di controllo nella colonna Obbligatorio . Tutti gli attributi possono essere contrassegnati come obbligatori. Per le caselle di controllo a selezione multipla, "Obbligatorio" significa che l'utente deve selezionare almeno una casella di controllo.

9. Al termine di tutte le modifiche, selezionare Salva.

Configurare una casella di controllo a selezione singola (casella di controlloSingleSelezionare)

Un attributo con un tipo di dati booleano ha un tipo di input utente CheckboxSingleSelect. È possibile modificare il testo visualizzato accanto alla casella di controllo e includere collegamenti ipertestuali.

Suggerimento

Per provare questa funzionalità, passare alla demo di Woodgrove Groceries e avviare il caso d'uso "Aggiungi collegamenti alle condizioni per l'utilizzo e le informative sulla privacy".

Per configurare una casella di controllo a selezione singola, seguire questa procedura:

1. Nella pagina Layout di pagina trovare l'attributo con il tipo di dati Boolean che si vuole configurare.

2. Selezionare il valore nella colonna Etichetta e immettere il testo che si desidera visualizzare accanto alla casella di controllo. Usare la lingua markdown per aggiungere collegamenti ipertestuali. Ad esempio:

   • Per configurare l'etichetta per un attributo Condizioni per l'utilizzo , è possibile immettere:

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use).

   • In alternativa, è possibile combinare le condizioni per l'utilizzo e l'informativa sulla privacy in un'unica casella di controllo obbligatoria:

     I have read and agree to the [terms of use](https://woodgrove.com/terms-of-use) and the [privacy policy](https://woodgrove.com/privacy).

3. Selezionare OK.

   

4. Nella pagina Layout di pagina selezionare Salva.

Configurare caselle di controllo a selezione multipla (CheckboxMultiSelect)

Un attributo con un tipo di dati String può essere configurato come tipo di input utente CheckboxMultiSelect, ovvero una serie di una o più caselle di controllo visualizzate sotto l'etichetta dell'attributo. L'utente può selezionare una o più caselle di controllo. È possibile definire il testo per le singole caselle di controllo e includere collegamenti ipertestuali ad altri contenuti. L'impostazione di questo attributo "Obbligatorio" indica che l'utente deve selezionare almeno una delle caselle di controllo.

1. Nella pagina Layout di pagina trovare l'attributo con tipo di dati String che si vuole configurare come una serie di caselle di controllo.

2. Selezionare il valore nella colonna Etichetta e immettere l'intestazione da visualizzare sopra la serie di caselle di controllo, ad esempio How did you hear about us?.

3. Selezionare il valore nella colonna Tipo di input utente per aprire il riquadro dell'editor.

4. Nel riquadro dell'editor, in Tipo di input utente, selezionare CheckboxMultiSelect.

5. Per ogni casella di controllo da aggiungere, iniziare in una nuova riga e immettere le informazioni seguenti:

   • In Testo immettere il testo che si desidera visualizzare accanto alla casella di controllo. Usare la lingua markdown per aggiungere collegamenti ipertestuali.

   • In Valori immettere un valore da scrivere nell'oggetto utente e restituito come attestazione se l'utente seleziona la casella di controllo.

6. Selezionare OK.

   

7. Nella pagina Layout di pagina selezionare Salva.

Configurare i pulsanti di opzione (OpzioneSingleSelect)

Un attributo con un tipo di dati String può essere configurato come tipo di input utente RadioSingleSelect, ovvero una serie di pulsanti di opzione visualizzati sotto l'etichetta dell'attributo. L'utente può selezionare un solo pulsante di opzione. È possibile definire il testo per singoli pulsanti di opzione e includere collegamenti ipertestuali ad altri contenuti.

1. Nella pagina Layout di pagina trovare l'attributo con tipo di dati String che si vuole configurare come pulsante di opzione o serie di pulsanti di opzione.

2. Selezionare il valore nella colonna Etichetta e immettere l'intestazione da visualizzare sopra la serie di pulsanti di opzione, ad esempio Sweatshirt size.

3. Selezionare il valore nella colonna Tipo di input utente per aprire il riquadro dell'editor.

4. Nel riquadro dell'editor, in Tipo di input utente selezionare RadioSingleSelect.

5. Per ogni pulsante di opzione da aggiungere, iniziare in una nuova riga e immettere le informazioni seguenti:

   • In Testo immettere il testo che si desidera visualizzare accanto al pulsante di opzione. Usare la lingua markdown per aggiungere collegamenti ipertestuali.

   • In Valori immettere un valore da scrivere nell'oggetto utente e restituito come attestazione se l'utente seleziona il pulsante di opzione.

6. Selezionare OK.

   

7. Nella pagina Layout di pagina selezionare Salva.

Trovare l'ID applicazione per l'app delle estensioni

Gli attributi utente personalizzati vengono archiviati in un'app denominata b2c-extensions-app. Dopo che un utente immette un valore per l'attributo personalizzato durante l'iscrizione, viene aggiunto all'oggetto utente e può essere chiamato tramite l'API Microsoft Graph usando la convenzione extension_{appId-without-hyphens}_{custom-attribute-name} di denominazione in cui:

• {appId-without-hyphens}è la versione rimossa dell'ID client per b2c-extensions-app.
• {custom-attribute-name} è il nome assegnato all'attributo personalizzato.

Usare questi passaggi per trovare l'ID applicazione per l'app delle estensioni:

1. Accedi all'Interfaccia di amministrazione di Microsoft Entra.
2. Passare a Identity> Registrazioni app> Tutte le applicazioni.
3. Selezionare l'applicazione b2c-extensions-app. Non modificare. Usato da AADB2C per l'archiviazione dei dati utente.
4. Nella pagina Panoramica usare il valore ID applicazione (client), ad esempio , 12345678-abcd-1234-1234-ab123456789ma rimuovere i trattini.

Ad esempio, se si crea un attributo personalizzato denominato loyaltyNumber, farvi riferimento come extension_12345678abcd12341234ab123456789_loyaltyNumber

Aggiungere attributi utente personalizzati al token ID

Quando gli utenti accedono all'app, l'app riceve un token ID, che include i dettagli dell'utente. Questi dettagli sono denominati attestazioni token. Se necessario, puoi includere un attributo utente personalizzato da rendere disponibile come attestazione nel token ID restituito all'app. A tale scopo, seguire la procedura descritta nell'articolo Aggiungere attributi al token ID restituito all'applicazione .

Passaggi successivi

Aggiungere attributi al token ID restituito all'applicazione.

Creare un flusso utente di iscrizione e accesso per i clienti.