Zbieranie niestandardowych atrybutów użytkownika podczas rejestracji

Dotyczy: dzierżawcy siły roboczej dzierżawcy zewnętrzni (dowiedz się więcej)

Napiwek

Niniejszy artykuł dotyczy przepływów użytkowników w dzierżawach zewnętrznych. Aby uzyskać informacje o najemcach siły roboczej, zobacz Definiowanie niestandardowych atrybutów dla przepływów użytkowników.

Jeśli aplikacja wymaga więcej informacji niż podane wbudowane atrybuty użytkownika, możesz dodać własne atrybuty. Nazywamy te atrybuty niestandardowymi atrybutami użytkownika.

Aby zdefiniować atrybut użytkownika niestandardowego, należy najpierw utworzyć atrybut na poziomie dzierżawy, tak aby mógł być używany w dowolnym przepływie użytkownika w tej dzierżawie. Następnie przypiszesz atrybut do przepływu rejestracji użytkownika i skonfigurujesz, jak ma się pojawić na stronie rejestracji.

Dowiedz się więcej o atrybutach użytkownika niestandardowych w artykule Atrybuty profilu użytkownika.

Tworzenie niestandardowych atrybutów użytkownika

1. Zaloguj się do centrum administracyjnego usługi Microsoft Entra.

2. Jeśli masz dostęp do wielu dzierżaw, użyj ikony Ustawienia w górnym menu, aby przełączyć się do swojej zewnętrznej dzierżawy z menu Katalogi i subskrypcje.

3. Przejdź do sekcji Tożsamości>Tożsamości zewnętrzne>Przegląd.

4. Wybierz pozycję Atrybuty niestandardowe użytkownika. Lista zawiera wszystkie atrybuty użytkownika dostępne w dzierżawie, w tym wszystkie niestandardowe atrybuty użytkownika, które zostały utworzone. Kolumna Typ atrybutu wskazuje, czy atrybut jest wbudowany, czy niestandardowy.

5. Wybierz Dodaj. W okienku Dodawanie atrybutu wprowadź nazwę atrybutu niestandardowego (na przykład "Warunki użytkowania").

6. W Typie danych wybierz ciąg znaków, Boolean lub Int w zależności od typu danych i kontroli danych użytkownika, którą chcesz utworzyć. Atrybuty String mają domyślny typ danych wejściowych użytkownika TextBox, ale można go zmienić na późniejszym etapie (na przykład, jeśli chcesz użyć przycisków radiowych lub pól wielokrotnego wyboru).

7. (Opcjonalnie) W polu Opis wprowadź opis atrybutu niestandardowego do użytku wewnętrznego. Ten opis nie jest widoczny dla użytkownika.

   

8. Wybierz pozycję Utwórz. Atrybut niestandardowy jest teraz dostępny na liście atrybutów użytkownika i można go dodać do przepływów użytkowników.

Dołącz niestandardowy atrybut użytkownika do przepływu rejestracji

Wykonaj następujące kroki, aby dodać niestandardowe atrybuty użytkownika do utworzonego przepływu użytkownika. (Jeśli musisz utworzyć nowy przepływ użytkownika, zobacz Utwórz przepływ użytkownika rejestracji i logowania dla klientów).

1. Zaloguj się do centrum administracyjnego usługi Microsoft Entra.

2. Jeśli masz dostęp do wielu dzierżaw, użyj ikony Ustawienia w górnym menu, aby przełączyć się do swojej zewnętrznej dzierżawy z menu Katalogi i subskrypcje.

3. Przejdź do Identity>External Identities>User flows.

4. Wybierz przepływ użytkownika z listy.

5. Wybierz pozycję Atrybuty użytkownika. Lista zawiera wszystkie niestandardowe atrybuty użytkownika zdefiniowane zgodnie z opisem w poprzedniej sekcji. Na przykład nowy atrybut Warunki użytkowania jest teraz wyświetlany na liście. Wybierz wszystkie atrybuty, które chcesz zebrać od użytkownika podczas rejestracji.

   

6. Wybierz pozycję Zapisz.

Konfigurowanie typów danych wejściowych użytkownika i układu strony

Na stronie Układ strony można wskazać, które atrybuty są wymagane i uporządkować kolejność wyświetlania. Możesz również edytować etykiety atrybutów, tworzyć przyciski radiowe lub pola wyboru oraz dodawać hiperlinki do większej zawartości (np. warunki użytkowania lub zasady ochrony prywatności).

1. Zaloguj się do centrum administracyjnego usługi Microsoft Entra.

2. Przejdź do Identity>External Identities>User flows.

3. Z listy wybierz swój cykl użytkowania.

4. W obszarze Dostosuj wybierz pozycję Układy stron. Atrybuty, które wybrałeś do zbierania, pojawiają się.

5. Edytuj etykietę dla dowolnego atrybutu, wybierając wartość w kolumnie Etykieta i modyfikując tekst.

6. Skonfiguruj pola wyboru lub przyciski radiowe:

   • Pole wyboru pojedynczego zaznaczenia: Atrybut typu logicznego jest renderowany jako pole wyboru pojedynczego zaznaczenia na stronie rejestracji. Aby skonfigurować tekst wyświetlany obok pola wyboru, zaznacz i edytuj wartość w kolumnie Etykieta . Użyj języka Markdown, aby dodać hiperlinki. Aby uzyskać szczegółowe informacje, zobacz Konfigurowanie pojedynczego wyboru pola wyboru (CheckboxSingleSelect)
   • Pola wyboru wielokrotnego zaznaczenia: Znajdź atrybut typu danych String, który chcesz skonfigurować, i wybierz wartość w kolumnie Typ danych wejściowych użytkownika, aby otworzyć okienko edytora. Wybierz typ danych wejściowych CheckboxMultiSelect i wprowadź wartości. Aby uzyskać szczegółowe informacje, zobacz Konfiguracja pól wyboru wielokrotnego (CheckboxMultiSelect).
   • Przyciski opcji: Znajdź atrybut typu danych 'String', który chcesz skonfigurować, i wybierz wartość w kolumnie Typ danych wejściowych użytkownika, aby otworzyć okienko edytora. Wybierz typ danych wejściowych użytkownika RadioSingleSelect i wprowadź wartości. Aby uzyskać szczegółowe informacje, zobacz Aby skonfigurować przyciski radiowe (RadioSingleSelect)

7. Zmień kolejność wyświetlania, wybierając atrybut i wybierając opcję Przenieś w górę, Przenieś w dół, Przenieś na początek lub Przenieś na dół.

8. Ustaw atrybut wymagany, zaznaczając pole wyboru w kolumnie Wymagane . Wszystkie atrybuty można oznaczyć jako wymagane. W przypadku pól wyboru wielokrotnego zaznaczenia pole wyboru "Wymagane" oznacza, że użytkownik musi zaznaczyć co najmniej jedno pole wyboru.

9. Po zakończeniu wszystkich zmian wybierz pozycję Zapisz.

Skonfiguruj jednoprzyciskowe pole wyboru (CheckboxSingleSelect)

Atrybut z logicznym typem danych ma typ wejściowy użytkownika jako Pole wyboru SingleSelect. Możesz zmodyfikować tekst wyświetlany obok pola wyboru i dołączyć hiperlinki.

Napiwek

Aby wypróbować tę funkcję, przejdź do demonstracji Woodgrove Groceries i uruchom scenariusz użycia „Dodaj linki do warunków użytkowania i zasad ochrony prywatności”.

Aby skonfigurować pole wyboru z jedną opcją, wykonaj następujące kroki:

1. Na stronie Układy strony znajdź atrybut z typem danych wartość logiczna, który chcesz skonfigurować.

2. Wybierz wartość w kolumnie Etykieta i wprowadź tekst, który chcesz wyświetlić obok pola wyboru. Użyj języka Markdown, aby dodać hiperlinki. Na przykład:

   • Aby skonfigurować etykietę dla atrybutu Warunki użytkowania , możesz wprowadzić:

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

   • Możesz też połączyć warunki użytkowania i zasady ochrony prywatności w jedno wymagane pole wyboru:

     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. Wybierz OK

   

4. Na stronie Układy strony wybierz pozycję Zapisz.

Konfiguracja pól wielokrotnego wyboru (MultiSelect)

Atrybut z typem danych ciąg można skonfigurować jako typ wejściowy użytkownika CheckboxMultiSelect, który jest serią pól wyboru wyświetlanych pod etykietą atrybutu. Użytkownik może zaznaczyć jedno lub więcej pól wyboru. Możesz zdefiniować tekst poszczególnych pól wyboru i dołączyć hiperlinki do innego elementu zawartości. Ustawienie tego atrybutu "Wymagane" oznacza, że użytkownik musi zaznaczyć co najmniej jedno z pól wyboru.

1. Na stronie Układy znajdź atrybut z typem danych 'Ciąg', który chcesz skonfigurować jako serię pól wyboru.

2. Wybierz wartość w kolumnie Etykieta i wprowadź nagłówek, który chcesz wyświetlić powyżej serii pól wyboru, na przykład How did you hear about us?.

3. Wybierz wartość w kolumnie Typ danych wejściowych użytkownika, aby otworzyć okienko edytora.

4. W oknie edytora, w obszarze Typ danych wejściowych, wybierz Wielokrotny wybór pola wyboru.

5. Dla każdego pola wyboru, które chcesz dodać, zacznij od nowego wiersza i wprowadź następujące informacje:

   • W obszarze Tekst wprowadź tekst, który chcesz wyświetlić obok pola wyboru. Użyj języka Markdown, aby dodać hiperlinki.

   • W obszarze Wartości wprowadź wartość, która ma zostać zapisana w obiekcie użytkownika i zwrócona jako oświadczenie, jeśli użytkownik zaznaczy pole wyboru.

6. Wybierz OK

   

7. Na stronie Układy strony wybierz pozycję Zapisz.

Konfigurowanie przycisków radiowych (RadioSingleSelect)

Atrybut z typem danych string można skonfigurować jako typ wejściowy użytkownika RadioSingleSelect, który jest serią przycisków radiowych wyświetlanych pod etykietą atrybutu. Użytkownik może wybrać tylko jeden przycisk radiowy. Możesz zdefiniować tekst dla poszczególnych przycisków radiowych i dołączyć hiperlinki do innego elementu zawartości.

1. Na stronie Układy Stron znajdź atrybut z typem Ciąg, który chcesz skonfigurować jako przycisk radiowy lub serię przycisków radiowych.

2. Wybierz wartość w kolumnie Etykieta i wprowadź nagłówek, który chcesz wyświetlić powyżej serii przycisków radiowych, na przykład Sweatshirt size.

3. Wybierz wartość w kolumnie Typ danych wejściowych użytkownika, aby otworzyć okienko edytora.

4. W okienku edytora w obszarze Typ danych wejściowych użytkownika wybierz pozycję RadioSingleSelect.

5. Dla każdego przycisku radiowego, który chcesz dodać, zacznij od nowego wiersza i wprowadź następujące informacje:

   • W obszarze Tekst wprowadź tekst, który chcesz wyświetlić obok przycisku radiowego. Użyj języka Markdown, aby dodać hiperlinki.

   • W obszarze Wartości wprowadź wartość, która ma zostać zapisana w obiekcie użytkownika i zwrócona jako oświadczenie, jeśli użytkownik wybierze przycisk radiowy.

6. Wybierz OK

   

7. Na stronie Układy strony wybierz pozycję Zapisz.

Znajdowanie identyfikatora aplikacji dla aplikacji rozszerzeń

Niestandardowe atrybuty użytkownika są przechowywane w aplikacji o nazwie b2c-extensions-app. Gdy użytkownik wprowadzi wartość atrybutu niestandardowego podczas rejestracji, jest ona dodawana do obiektu użytkownika i może być wywoływana za pośrednictwem interfejsu API Microsoft Graph zgodnie z konwencją nazewnictwa extension_{appId-without-hyphens}_{custom-attribute-name}, gdzie:

• {appId-without-hyphens} to identyfikator klienta w wersji pozbawionej dla aplikacji b2c-extensions-app.
• {custom-attribute-name} to nazwa przypisana do atrybutu niestandardowego.

Wykonaj następujące kroki, aby znaleźć identyfikator aplikacji dla aplikacji rozszerzeń:

1. Zaloguj się do centrum administracyjnego usługi Microsoft Entra.
2. Przejdź do sekcji Tożsamość>>
3. Wybierz aplikację b2c-extensions-app. Nie modyfikuj. Używany przez usługę AADB2C do przechowywania danych użytkownika.
4. Na stronie Przegląd użyj wartości identyfikatora aplikacji (klienta), na przykład: 12345678-abcd-1234-1234-ab123456789, ale usuń myślniki.

Jeśli na przykład utworzysz atrybut niestandardowy o nazwie loyaltyNumber, użyj go jako extension_12345678abcd12341234ab123456789_loyaltyNumber

Dodaj niestandardowe atrybuty użytkownika do tokenu identyfikatora

Gdy użytkownicy loguje się do aplikacji, aplikacja otrzymuje token identyfikatora, który zawiera szczegóły użytkownika. Te dane są nazywane roszczeniami tokenów. W razie potrzeby możesz dołączyć niestandardowy atrybut użytkownika, który będzie dostępny jako roszczenie w tokenie identyfikacyjnym zwróconym do twojej aplikacji. Aby to zrobić, wykonaj kroki opisane w artykule Dodawanie atrybutów do tokenu identyfikatora, który został zwrócony do aplikacji.

Następne kroki

Dodaj atrybuty do zwróconego do aplikacji tokenu identyfikatora.

Utwórz proces rejestracji i logowania dla klientów.