Honosítási elem

Cikk
01/11/2024

Megjegyzés

Az Azure Active Directory B2C-ben az egyéni szabályzatok elsősorban összetett forgatókönyvek kezelésére szolgálnak. A legtöbb esetben javasoljuk, hogy beépített felhasználói folyamatokat használjon. Ha még nem tette meg, tekintse meg az egyéni szabályzatok kezdőcsomagját az Egyéni szabályzatok használatának első lépései az Active Directory B2C-ben című témakörben.

A Honosítás elem lehetővé teszi, hogy a házirendben több területi beállítást vagy nyelvet is támogatjon a felhasználói folyamatokhoz. A szabályzatok honosítási támogatása lehetővé teszi a következőket:

Állítsa be a támogatott nyelvek explicit listáját egy szabályzatban, és válasszon egy alapértelmezett nyelvet.
Adjon meg nyelvspecifikus sztringeket és gyűjteményeket.

<Localization Enabled="true">
  <SupportedLanguages DefaultLanguage="en" MergeBehavior="ReplaceAll">
    <SupportedLanguage>en</SupportedLanguage>
    <SupportedLanguage>es</SupportedLanguage>
  </SupportedLanguages>
  <LocalizedResources Id="api.localaccountsignup.en">
  <LocalizedResources Id="api.localaccountsignup.es">
  ...

A Honosítás elem a következő attribútumokat tartalmazza:

Attribútum	Kötelező	Description
Engedélyezve	No	Lehetséges értékek: `true` vagy `false`.

A Honosítás elem a következő XML-elemeket tartalmazza

Elem	Események	Description
Támogatottlanguages	1:n	Támogatott nyelvek listája.
LocalizedResources	0:n	Honosított erőforrások listája.

Támogatottlanguages

A SupportedLanguages elem a következő attribútumokat tartalmazza:

Attribútum	Kötelező	Leírás
DefaultLanguage	Yes	A honosított erőforrások alapértelmezett nyelve.
MergeBehavior	No	Olyan értékek enumerálási értékei, amelyek egyesítve vannak a szülőszabályzatban található Bármely Jogcímtípussal, ugyanazzal az azonosítóval. Ezt az attribútumot akkor használja, ha felülír egy alapszabályzatban megadott jogcímet. Lehetséges értékek: `Append`, `Prepend`vagy `ReplaceAll`. Az `Append` érték azt határozza meg, hogy a jelen lévő adatgyűjtést hozzá kell fűzni a szülőszabályzatban megadott gyűjtemény végéhez. Az `Prepend` érték azt határozza meg, hogy a jelen lévő adatgyűjtést a szülőszabályzatban megadott gyűjtemény előtt kell hozzáadni. Az `ReplaceAll` érték azt határozza meg, hogy a szülőszabályzatban definiált adatok gyűjtését figyelmen kívül kell hagyni az aktuális szabályzatban definiált adatok helyett.

Támogatottlanguages

A SupportedLanguages elem a következő elemeket tartalmazza:

Elem	Események	Description
Támogatottnyelv	1:n	Az RFC 5646 – A nyelvek azonosítására szolgáló címkék szerint egy nyelvi címkének megfelelő tartalmat jelenít meg.

LocalizedResources

A LocalizedResources elem a következő attribútumokat tartalmazza:

Attribútum	Kötelező	Leírás
Id	Yes	A honosított erőforrások egyedi azonosítására szolgáló azonosító.

A LocalizedResources elem a következő elemeket tartalmazza:

Elem	Események	Description
LocalizedCollections	0:n	A különböző kultúrák teljes gyűjteményeit definiálja. A gyűjtemények különböző számú elemet és különböző sztringeket tartalmazhatnak különböző kultúrákhoz. A gyűjtemények közé tartoznak például a jogcímtípusokban megjelenő enumerációk. Például egy ország-/régiólista jelenik meg a felhasználó számára egy legördülő listában.
LocalizedStrings	0:n	Meghatározza az összes sztringet, kivéve azokat a sztringeket, amelyek gyűjteményekben, különböző kultúrákban jelennek meg.

LocalizedCollections

A LocalizedCollections elem a következő elemeket tartalmazza:

Elem	Események	Description
LocalizedCollection	1:n	Támogatott nyelvek listája.

LocalizedCollection

A LocalizedCollection elem a következő attribútumokat tartalmazza:

Attribútum	Kötelező	Leírás
Elemtípus	Yes	A házirendfájlban egy ClaimType elemre vagy felhasználói felületi elemre hivatkozik.
Elemazonosító	Yes	Olyan sztring, amely a ClaimsSchema szakaszban már definiált jogcímtípusra mutató hivatkozást tartalmaz, amelyet akkor használunk, ha az ElementType jogcímtípusra van állítva.
TargetCollection	Yes	A célgyűjtemény.

A LocalizedCollection elem a következő elemeket tartalmazza:

Elem	Események	Description
Elem	0:n	Meghatároz egy elérhető lehetőséget a felhasználó számára, hogy a felhasználói felületen válasszon egy jogcímet, például egy legördülő menüben szereplő értéket.

Az Elem elem a következő attribútumokat tartalmazza:

Attribútum	Kötelező	Leírás
Szöveg	Yes	A felhasználó számára megjelenítendő felhasználóbarát megjelenítési sztring a felhasználói felületen ehhez a beállításhoz.
Érték	Yes	A beállítás kiválasztásához társított sztring jogcímértéke.
SelectByDefault	No	Azt jelzi, hogy ezt a beállítást alapértelmezés szerint ki kell-e választani a felhasználói felületen. Lehetséges értékek: Igaz vagy Hamis.

Az alábbi példa a LocalizedCollections elem használatát mutatja be. Két LocalizedCollection elemet tartalmaz, az egyik az angol, a másik a spanyol. Mindkettő a jogcímGender Korlátozás gyűjteményét állítja be az angol és spanyol elemek listájával. További mintákért tekintse meg a Jogcímkorlátozások számbavétele élő bemutatót.

<LocalizedResources Id="api.selfasserted.en">
  <LocalizedCollections>
    <LocalizedCollection ElementType="ClaimType" ElementId="Gender" TargetCollection="Restriction">
      <Item Text="Female" Value="F" />
      <Item Text="Male" Value="M" />
    </LocalizedCollection>
  </LocalizedCollections>
</LocalizedResources>

<LocalizedResources Id="api.selfasserted.es">
 <LocalizedCollections>
   <LocalizedCollection ElementType="ClaimType" ElementId="Gender" TargetCollection="Restriction">
      <Item Text="Femenino" Value="F" />
      <Item Text="Masculino" Value="M" />
    </LocalizedCollection>
  </LocalizedCollections>
</LocalizedResources>

LocalizedStrings

A LocalizedStrings elem a következő elemeket tartalmazza:

Elem	Események	Description
LocalizedString	1:n	Honosított sztring.

A LocalizedString elem a következő attribútumokat tartalmazza:

Attribútum	Kötelező	Leírás
Elemtípus	Yes	Lehetséges értékek: ClaimsProvider, ClaimType, ErrorMessage, GetLocalizedStringsTransformationClaimType, FormatLocalizedStringTransformationClaimType, Predicate, PredicateValidation vagy UxElement.
Elemazonosító	Yes	Ha az ElementType értéke `ClaimType`, `Predicate`vagy `PredicateValidation`, akkor ez az elem egy, a ClaimsSchema szakaszban már definiált jogcímtípusra mutató hivatkozást tartalmaz.
Sztringazonosító	Yes	Ha az Elemtípus értékre `ClaimType`van állítva, akkor ez az elem egy jogcímtípus attribútumára mutató hivatkozást tartalmaz. Lehetséges értékek: `DisplayName`, `AdminHelpText`vagy `PatternHelpText`. Az `DisplayName` érték a jogcím megjelenítendő nevének beállítására szolgál. Az `AdminHelpText` érték a jogcímfelhasználó súgószöveg-nevének beállítására szolgál. Az `PatternHelpText` érték a jogcímminta súgószövegének beállítására szolgál. Ha az ElementType értékre `UxElement`van állítva, akkor ez az elem egy felhasználói felületi elem attribútumára mutató hivatkozást tartalmaz. Ha az ElementType értékre `ErrorMessage`van állítva, ez az elem egy hibaüzenet azonosítóját adja meg. Az azonosítók teljes listáját lásd`UxElement`: Honosítási sztringazonosítók.

Elemtípus

Az ElementType hivatkozás egy jogcímtípusra, egy jogcímátalakításra vagy a honosítandó szabályzat felhasználói felületi elemére.

Honosítandó elem	Elemtípus	Elemazonosító	Sztringazonosító
Identitásszolgáltató neve	`ClaimsProvider`		A ClaimsExchange elem azonosítója
Jogcímtípus-attribútumok	`ClaimType`	A jogcímtípus neve	A honosítandó jogcím attribútuma. Lehetséges értékek: `AdminHelpText`, `DisplayName`, `PatternHelpText`és `UserHelpText`.
Hibaüzenet	`ErrorMessage`		A hibaüzenet azonosítója
Honosított sztringek másolása jogcímekbe	`GetLocalizedStringsTra nsformationClaimType`		A kimeneti jogcím neve
Felhasználói üzenet predikátumba való beszűkítése	`Predicate`	A predikátum neve	A honosítandó predikátum attribútuma. Lehetséges értékek: `HelpText`.
Csoport elődikátumának felhasználói üzenete	`PredicateValidation`	A PredicateValidation elem azonosítója.	A PredicateGroup elem azonosítója. A predikátumcsoportnak az Elemazonosítóban meghatározott predikátum-érvényesítési elem gyermekének kell lennie.
Felhasználó felület elemei	`UxElement`		A honosítandó felhasználói felületi elem azonosítója.
Vezérlő megjelenítése	`DisplayControl`	A megjelenítési vezérlő azonosítója.	A honosítandó felhasználói felületi elem azonosítója.

Példák

ClaimsProvider

A ClaimsProvider érték az egyik jogcímszolgáltató megjelenítendő nevének honosítására szolgál.

<OrchestrationStep Order="2" Type="ClaimsExchange">
  ...
  <ClaimsExchanges>
    <ClaimsExchange Id="FacebookExchange" TechnicalProfileReferenceId="Facebook-OAUTH" />
    <ClaimsExchange Id="GoogleExchange" TechnicalProfileReferenceId="Google-OAUTH" />
    <ClaimsExchange Id="LinkedInExchange" TechnicalProfileReferenceId="LinkedIn-OAUTH" />
  </ClaimsExchanges>
</OrchestrationStep>

Az alábbi példa bemutatja, hogyan honosíthatja a jogcímszolgáltatók megjelenítendő nevét.

<LocalizedString ElementType="ClaimsProvider" StringId="FacebookExchange">Facebook</LocalizedString>
<LocalizedString ElementType="ClaimsProvider" StringId="GoogleExchange">Google</LocalizedString>
<LocalizedString ElementType="ClaimsProvider" StringId="LinkedInExchange">LinkedIn</LocalizedString>

Jogcímtípus

A ClaimType érték az egyik jogcímattribútum honosítására szolgál.

<ClaimType Id="email">
  <DisplayName>Email Address</DisplayName>
  <DataType>string</DataType>
  <UserHelpText>Email address that can be used to contact you.</UserHelpText>
  <UserInputType>TextBox</UserInputType>
</ClaimType>

Az alábbi példa bemutatja, hogyan honosíthatja az e-mail jogcímtípus DisplayName, UserHelpText és PatternHelpText attribútumait.

<LocalizedString ElementType="ClaimType" ElementId="email" StringId="DisplayName">Email</LocalizedString>
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="UserHelpText">Please enter your email</LocalizedString>
<LocalizedString ElementType="ClaimType" ElementId="email" StringId="PatternHelpText">Please enter a valid email address</LocalizedString>

ErrorMessage

Az ErrorMessage érték a rendszer egyik hibaüzenetének honosítására szolgál.

<TechnicalProfile Id="AAD-UserWriteUsingAlternativeSecurityId">
  <Metadata>
    <Item Key="RaiseErrorIfClaimsPrincipalAlreadyExists">true</Item>
    <Item Key="UserMessageIfClaimsPrincipalAlreadyExists">You are already registered, please press the back button and sign in instead.</Item>
  </Metadata>
  ...
</TechnicalProfile>

Az alábbi példa bemutatja, hogyan honosíthatja a UserMessageIfClaimsPrincipalAlreadyExists hibaüzenetet.

<LocalizedString ElementType="ErrorMessage" StringId="UserMessageIfClaimsPrincipalAlreadyExists">The account you are trying to create already exists, please sign-in.</LocalizedString>

FormatLocalizedStringTransformationClaimType

A FormatLocalizedStringTransformationClaimType érték a jogcímek honosított sztringgé alakítására szolgál. További információ: FormatLocalizedString jogcímek átalakítása

<ClaimsTransformation Id="SetResponseMessageForEmailAlreadyExists" TransformationMethod="FormatLocalizedString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="stringFormatId" DataType="string" Value="ResponseMessge_EmailExists" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="responseMsg" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

Az alábbi példa bemutatja, hogyan honosíthatja a FormatLocalizedStringTransformationClaimType jogcímátalakítás sztringformátumát.

<LocalizedString ElementType="FormatLocalizedStringTransformationClaimType" StringId="ResponseMessge_EmailExists">The email '{0}' is already an account in this organization. Click Next to sign in with that account.</LocalizedString>

GetLocalizedStringsTransformationClaimType

A GetLocalizedStringsTransformationClaimType érték a honosított sztringek jogcímekbe való másolására szolgál. További információ: GetLocalizedStringsTransformation jogcímek átalakítása

<ClaimsTransformation Id="GetLocalizedStringsForEmail" TransformationMethod="GetLocalizedStringsTransformation">
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="subject" TransformationClaimType="email_subject" />
    <OutputClaim ClaimTypeReferenceId="message" TransformationClaimType="email_message" />
    <OutputClaim ClaimTypeReferenceId="codeIntro" TransformationClaimType="email_code" />
    <OutputClaim ClaimTypeReferenceId="signature" TransformationClaimType="email_signature" />
   </OutputClaims>
</ClaimsTransformation>

Az alábbi példa bemutatja, hogyan honosíthatja a GetLocalizedStringsTransformation jogcímátalakítás kimeneti jogcímeit.

<LocalizedString ElementType="GetLocalizedStringsTransformationClaimType" StringId="email_subject">Contoso account email verification code</LocalizedString>
<LocalizedString ElementType="GetLocalizedStringsTransformationClaimType" StringId="email_message">Thanks for verifying your account!</LocalizedString>
<LocalizedString ElementType="GetLocalizedStringsTransformationClaimType" StringId="email_code">Your code is</LocalizedString>
<LocalizedString ElementType="GetLocalizedStringsTransformationClaimType" StringId="email_signature">Sincerely</LocalizedString>

Predikátum

A Predikátum érték a Predikátum hibaüzenetek egyikének honosítására szolgál.

<Predicates>
  <Predicate Id="LengthRange" Method="IsLengthRange"  HelpText="The password must be between 6 and 64 characters.">
    <Parameters>
      <Parameter Id="Minimum">6</Parameter>
      <Parameter Id="Maximum">64</Parameter>
    </Parameters>
  </Predicate>
  <Predicate Id="Lowercase" Method="IncludesCharacters" HelpText="a lowercase letter">
    <Parameters>
      <Parameter Id="CharacterSet">a-z</Parameter>
    </Parameters>
  </Predicate>
  <Predicate Id="Uppercase" Method="IncludesCharacters" HelpText="an uppercase letter">
    <Parameters>
      <Parameter Id="CharacterSet">A-Z</Parameter>
    </Parameters>
  </Predicate>
</Predicates>

Az alábbi példa bemutatja, hogyan honosíthatja a predikátumok súgószövegét.

<LocalizedString ElementType="Predicate" ElementId="LengthRange" StringId="HelpText">The password must be between 6 and 64 characters.</LocalizedString>
<LocalizedString ElementType="Predicate" ElementId="Lowercase" StringId="HelpText">a lowercase letter</LocalizedString>
<LocalizedString ElementType="Predicate" ElementId="Uppercase" StringId="HelpText">an uppercase letter</LocalizedString>

PredikateValidation

A PredicateValidation érték a PredicateValidation csoport egyik hibaüzenetének honosítására szolgál.

<PredicateValidations>
  <PredicateValidation Id="CustomPassword">
    <PredicateGroups>
      <PredicateGroup Id="LengthGroup">
        <PredicateReferences MatchAtLeast="1">
          <PredicateReference Id="LengthRange" />
        </PredicateReferences>
      </PredicateGroup>
      <PredicateGroup Id="CharacterClasses">
        <UserHelpText>The password must have at least 3 of the following:</UserHelpText>
        <PredicateReferences MatchAtLeast="3">
          <PredicateReference Id="Lowercase" />
          <PredicateReference Id="Uppercase" />
          <PredicateReference Id="Number" />
          <PredicateReference Id="Symbol" />
        </PredicateReferences>
      </PredicateGroup>
    </PredicateGroups>
  </PredicateValidation>
</PredicateValidations>

Az alábbi példa bemutatja, hogyan honosíthat egy predikátumérvényesítési csoport súgószövegét.

<LocalizedString ElementType="PredicateValidation" ElementId="CustomPassword" StringId="CharacterClasses">The password must have at least 3 of the following:</LocalizedString>

UxElement

Az UxElement érték a felhasználói felület egyik elemének honosítására szolgál. Az alábbi példa bemutatja, hogyan honosíthatja a folytatás és a megszakítás gombot.

<LocalizedString ElementType="UxElement" StringId="button_continue">Create new account</LocalizedString>
<LocalizedString ElementType="UxElement" StringId="button_cancel">Cancel</LocalizedString>

DisplayControl

A DisplayControl érték a megjelenítési vezérlő felhasználói felületének egyik elemének honosítására szolgál. Ha engedélyezve van, a localizedStrings megjelenítési vezérlő elsőbbséget élvez egyes UxElement stringID-kkel szemben, például ver_but_send, ver_but_edit, ver_but_resend és ver_but_verify. Az alábbi példa bemutatja, hogyan honosíthatja a küldési és ellenőrzési gombokat.

<LocalizedString ElementType="DisplayControl" ElementId="emailVerificationControl" StringId="but_send_code">Send verification code</LocalizedString>
<LocalizedString ElementType="DisplayControl" ElementId="emailVerificationControl" StringId="but_verify_code">Verify code</LocalizedString>

Az önkiszolgáló technikai profil Metaadatok szakaszában a hivatkozott ContentDefinition elemnek a DataUri-t a lapelrendezés 2.1.0-s vagy újabb verziójára kell állítania. Például:

<ContentDefinition Id="api.selfasserted">
  <DataUri>urn:com:microsoft:aad:b2c:elements:selfasserted:2.1.0</DataUri>
  ...

Következő lépések

A honosítási példákért tekintse meg az alábbi cikkeket:

Megosztás a következőn keresztül:

Honosítási elem

Támogatottlanguages

Támogatottlanguages

LocalizedResources

LocalizedCollections

LocalizedCollection

LocalizedStrings

Elemtípus

Példák

ClaimsProvider

Jogcímtípus

ErrorMessage

FormatLocalizedStringTransformationClaimType

GetLocalizedStringsTransformationClaimType

Predikátum

PredikateValidation

UxElement

DisplayControl

Következő lépések

Visszajelzés

További források