Shromažďování atributů uživatele během registrace
Cvičení – shromažďování atributů uživatele během registrace
Atributy uživatele jsou hodnoty shromážděné od uživatele během samoobslužné registrace. V nastavení toku uživatele si můžete vybrat ze sady předdefinovaných atributů uživatelů , které chcete od zákazníků shromažďovat. Můžete také vytvořit vlastní atributy uživatele a přidat je do toku uživatele během registrace. Na registrační stránce uživatel zadá informace a uloží se s jeho profilem ve vašem adresáři. Pro účely webu online potravin použijeme kombinaci předdefinovaných atributů a vlastního atributu označovaného jako speciální dieta.
Poznámka:
Ke konfiguraci atributů uživatele, které se mají shromažďovat během registrace, budete potřebovat alespoň roli adresáře Správce atributů toku externího ID.
Máte zpětnou vazbu? Dejte nám prosím vědět, jak váš projekt testování konceptu probíhá. Rádi se dozvíme váš názor!
Začneme vytvořením speciálního uživatelského atributu diety. Uděláte to tak, že se přihlásíte do Centra pro správu Microsoft Entra a přejdete na přehled externích identit>. Pak vyberte Vlastní atributy uživatele.
Seznam obsahuje všechny atributy uživatele dostupné v tenantovi, včetně všech vlastních atributů uživatele, které byly vytvořeny. Sloupec Typ atributu označuje, zda je atribut předdefinovaný nebo vlastní. Vyberte Přidat a přidejte nový atribut.
V podokně Přidat atribut zadejte název vlastního atributu. Například SpecialDiet. V datovém typu zvolte Řetězec. Do popisu zadejte popis vlastního atributu pro interní použití. Tento popis není pro uživatele viditelný.
Po přidání vlastního atributu uživatele do tenanta pokračujte zahrnutím vlastního atributu uživatele do toku registrace. Přejděte k> tokům identity externích>identit uživatelů. Pak ze seznamu vyberte tok uživatele.
Vyberte Atributy uživatele. Seznam obsahuje všechny vlastní atributy uživatele, které jste definovali podle popisu v předchozí části. Například nový SpecialDiet se teď zobrazí v seznamu. Zvolte všechny atributy, které chcete shromáždit od uživatele během registrace, a vyberte Uložit.
V posledním kroku nakonfigurujete rozložení registrační stránky. V rozloženích stránky můžete určit, které atributy jsou povinné, a uspořádat zobrazené pořadí. Můžete také upravovat popisky atributů, vytvářet přepínače nebo zaškrtávací políčka a provádět další akce. Pro náš web potravin přidáme popisek k atributu SpecialDiet. V části Přizpůsobitvyberte Rozložení stránek. Zobrazí se atributy, které jste zvolili ke shromažďování. Upravte popisek libovolného atributu tak, že vyberete hodnotu ve sloupci Popisek a upravíte text.
Skvělá práce! Do tenanta jste přidali vlastní atribut, přidali jste vlastní atribut do toku uživatele a pak jste do atributu přidali popisek.
1. Vytvoření vlastního atributu
Pokud chcete vytvořit vlastní atribut, spusťte následující požadavek Microsoft Graphu.
POST https://graph.microsoft.com/beta/identity/userFlowAttributes
{
"displayName": "SpecialDiet",
"description": "Customer's special diet",
"dataType": "string"
}
1.1 Zkopírování vlastního atributu
Z odpovědi zkopírujte hodnotu ID vlastního atributu. Například:
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identity/userFlowAttributes/$entity",
"id": "extension_a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1_SpecialDiet",
"displayName": "SpecialDiet",
"description": "Customer's special diet",
"userFlowAttributeType": "custom",
"dataType": "string"
}
2. Přidání atributu do toku uživatele
Pokud chcete do toku uživatele přidat atribut, spusťte níže uvedený požadavek Microsoft Graphu. {user-flow-ID} nahraďte ID toku uživatele. Nahraďte {attribute-ID} id atributu z předchozího kroku.
POST https://graph.microsoft.com/beta/identity/authenticationEventsFlows/{user-flow-ID}/microsoft.graph.externalUsersSelfServiceSignUpEventsFlow/onAttributeCollection/microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp/attributes/$ref
{
"@odata.id":"https://graph.microsoft.com/beta/identity/userFlowAttributes/{attribute-ID}"
}
Příklad
POST https://graph.microsoft.com/beta/identity/authenticationEventsFlows/{user-flow-ID}/microsoft.graph.externalUsersSelfServiceSignUpEventsFlow/onAttributeCollection/microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp/attributes/$ref
{
"@odata.id":"https://graph.microsoft.com/beta/identity/userFlowAttributes/{attribute-ID}"
}
3. (Volitelné) Aktualizace rozložení stránky
Obvykle se atribut zobrazí v dolní části registrační stránky. Rozložení registrační stránky můžete aktualizovat. V rozloženích stránky můžete určit, které atributy jsou povinné, a uspořádat pořadí zobrazení. Můžete také upravovat popisky atributů, vytvářet přepínače nebo zaškrtávací políčka a provádět další akce.
K tomu je potřeba aktualizovat tok uživatele. V textu požadavku zadejte pouze hodnoty vlastností, které by se měly aktualizovat. Existující vlastnosti, které nejsou zahrnuté v textu požadavku, udržují své předchozí hodnoty nebo se přepočítávají na základě změn jiných hodnot vlastností.
Upozorňující
Kolekce vstupů musí obsahovat všechny atributy. Pokud chcete přidat nebo odebrat atributy, nezapomeňte zahrnout všechny ostatní atributy.
{user-flow-ID} nahraďte ID toku uživatele. Nahraďte {attribute-ID} svým ID atributu.
PATCH https://graph.microsoft.com/beta/identity/authenticationEventsFlows/{user-flow-ID}
{
"@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow",
"onAttributeCollection": {
"@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp",
"attributeCollectionPage": {
"customStringsFileId": null,
"views": [
{
"title": null,
"description": null,
"inputs": [
{
"attribute": "email",
"label": "Email Address",
"inputType": "text",
"defaultValue": null,
"hidden": true,
"editable": false,
"writeToDirectory": true,
"required": true,
"validationRegEx": "^[a-zA-Z0-9.!#$%&’'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*$",
"options": []
},
{
"attribute": "displayName",
"label": "Display Name",
"inputType": "text",
"defaultValue": null,
"hidden": false,
"editable": true,
"writeToDirectory": true,
"required": true,
"validationRegEx": "^.*",
"options": []
},
{
"attribute": "country",
"label": "Country/Region",
"inputType": "radioSingleSelect",
"defaultValue": null,
"hidden": false,
"editable": true,
"writeToDirectory": true,
"required": false,
"validationRegEx": "^.*",
"options": [
{
"label": "Australia",
"value": "au"
},
{
"label": "Spain",
"value": "es"
},
{
"label": "United States",
"value": "us"
}
]
},
{
"attribute": "city",
"label": "City",
"inputType": "text",
"defaultValue": null,
"hidden": false,
"editable": true,
"writeToDirectory": true,
"required": true,
"validationRegEx": "^.*",
"options": []
}, {
"attribute": "{attribute-ID}",
"label": "Special diet",
"inputType": "text",
"defaultValue": null,
"hidden": false,
"editable": true,
"writeToDirectory": true,
"required": false,
"validationRegEx": "^.*",
"options": []
}
]
}
]
}
}
}