Lokalizációs elem

Fontos

2025. május 1-jére az Azure AD B2C már nem lesz elérhető az új ügyfelek számára. További információ a GYIK-ben.

Megjegyzés:

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

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

  • Állítsa be a szabályzatban támogatott nyelvek explicit listáját, és válasszon ki egy alapértelmezett nyelvet.
  • Nyelvspecifikus sztringek és gyűjtemények biztosítása.
<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 Honization elem a következő attribútumokat tartalmazza:

Jellemző Kötelező Leírás
Bekapcsolva Nem Lehetséges értékek: true vagy false.

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

Elem Események Leírás
Támogatott nyelvek 1:n A támogatott nyelvek listája.
LocalizedResources 0:n Honosított erőforrások listája.

Támogatott nyelvek

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

Jellemző Kötelező Leírás
Alapértelmezett nyelv Igen A honosított erőforrások alapértelmezettjeként használandó nyelv.
MergeBehavior Nem Olyan értékek enumerálási értékei, amelyek egyesítve vannak az azonos azonosítóval rendelkező szülő-szabályzatban található bármely ClaimType ClaimType-val. Ezt az attribútumot akkor használja, ha felülírja az alapházirendben megadott jogcímet. Lehetséges értékek: Append, Prependvagy ReplaceAll. Az Append érték azt adja meg, hogy a jelenlévő adatok gyűjteményét hozzá kell fűzni a szülőszabályzatban megadott gyűjtemény végéhez. Az Prepend érték azt adja meg, hogy a jelen lévő adatok gyűjteményét a szülőszabályzatban megadott gyűjtemény előtt kell hozzáadni. Az ReplaceAll érték azt adja meg, hogy a szülő szabályzatban meghatározott adatgyűjtést figyelmen kívül kell hagyni, és helyette az aktuális szabályzatban meghatározott adatokat kell használni.

Támogatott nyelvek

A SupportedLanguages elem a következő elemeket tartalmazza:

Elem Események Leírás
Támogatott nyelv 1:n Olyan tartalmat jelenít meg, amely megfelel az RFC 5646 – Címkék a nyelvek azonosításához című dokumentum szerint.

LocalizedResources

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

Jellemző Kötelező Leírás
Azonosító Igen 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 Leírás
Lokalizált gyűjtemények 0:n Teljes gyűjteményeket határoz meg különböző kultúrákban. Egy gyűjtemény különböző számú elemet és különböző sztringeket tartalmazhat a különböző kultúrákhoz. A gyűjtemények közé tartoznak például a jogcímtípusokban megjelenő felsorolások. Például egy ország/régió lista jelenik meg a felhasználó számára egy legördülő listában.
HonizedStrings 0:n Meghatározza az összes karakterláncot, kivéve azokat a karakterláncokat, amelyek a gyűjteményekben jelennek meg a különböző kultúrákban.

Lokalizált gyűjtemények

A LocalizedCollections elem a következő elemeket tartalmazza:

Elem Események Leírás
LocalizedCollection 1:n A támogatott nyelvek listája.

LocalizedCollection

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

Jellemző Kötelező Leírás
Elemtípus Igen A házirendfájl egy ClaimType elemére vagy felhasználói felületi elemére hivatkozik.
Elemazonosító Igen Olyan sztring, amely a ClaimsSchema szakaszban már definiált jogcímtípusra mutató hivatkozást tartalmaz, amely akkor használatos, ha az ElementType ClaimType értékre van állítva.
TargetCollection Igen A célgyűjtemény.

A LocalizedCollection elem a következő elemeket tartalmazza:

Elem Események Leírás
Termék 0:n Meghatározza a felhasználó számára elérhető beállítást, amelyet a felhasználói felületen kiválaszthat egy jogcímhez, például egy legördülő menü értékét.

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

Jellemző Kötelező Leírás
Szöveg Igen A felhasználóbarát megjelenítési karakterlánc, amelyet a felhasználó számára meg kell jeleníteni a felhasználói felületen ehhez a beállításhoz.
Érték Igen A beállítás kiválasztásához társított sztringjogcím értéke.
SelectByDefault Nem Azt jelzi, hogy ezt a beállítást alapértelmezés szerint ki kell-e jelölni a felhasználói felületen. Lehetséges értékek: Igaz vagy Hamis.

Az alábbi példa az elem használatát mutatja be LocalizedCollections . Két LocalizedCollection elemet tartalmaz, egyet az angolhoz és egyet a spanyolhoz. Mindkettő beállítja a követelés Gender gyűjteményét 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>

HonizedStrings

A LocalizedStrings elem a következő elemeket tartalmazza:

Elem Események Leírás
LocalizedString 1:n Honosított karakterlánc.

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

Jellemző Kötelező Leírás
Elemtípus Igen Lehetséges értékek: ClaimsProvider, ClaimType, ErrorMessage, GetLocalizedStringsTransformationClaimType, FormatLocalizedStringTransformationClaimType, Predicate, PredicateValidation vagy UxElement.
Elemazonosító Igen Ha az ElementType értéke ClaimType, Predicate, vagy PredicateValidation, ez az elem a ClaimsSchema szakaszban már definiált jogcímtípusra mutató hivatkozást tartalmaz.
StringId Igen Ha az ElementType értéke ClaimType, ez az elem egy jogcímtípus attribútumára mutató hivatkozást tartalmaz. Lehetséges értékek: DisplayName, AdminHelpTextvagy 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ím felhasználójának súgószövegének 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éke UxElement, ez az elem a felhasználói felület egyik elemének attribútumára mutató hivatkozást tartalmaz. Ha az ElementType értéke ErrorMessage, ez az elem adja meg a hibaüzenet azonosítóját. Az azonosítók teljes listáját lásd: UxElement.

Elemtípus

Az ElementType hivatkozás egy jogcímtípusra, jogcím-átalakításra vagy felhasználói felület elemre a honosítani kívánt szabályzatban.

Honosítandó elem Elemtípus Elemazonosító StringId
Identitásszolgáltató neve ClaimsProvider A ClaimsExchange elem azonosítója
Jogcímtípus attribútumai ClaimType A jogcímtípus neve A lokalizálni kívánt jogcím attribútuma. Lehetséges értékek: AdminHelpText, DisplayName, PatternHelpTextés UserHelpText.
Hibaüzenet ErrorMessage A hibaüzenet azonosítója
Honosított sztringeket másol jogcímekbe GetLocalizedStringsTransformationClaimType A kimeneti jogcím neve
Felhasználói üzenet predikálása Predicate Az állítmány neve A lokalizálandó állítmány attribútuma. Lehetséges értékek: HelpText.
Csoportos felhasználói üzenet predikálása PredicateValidation A PredicateValidation elem azonosítója. A PredicateGroup elem azonosítója. A predikátumcsoportnak az ElementId-ben meghatározott predikátumérvényesítési elem gyermekének kell lennie.
A felhasználói felület elemei UxElement A honosítani kívánt felhasználói felület elem azonosítója.
Kijelző vezérlés DisplayControl A kijelzővezérlő azonosítója. A honosítani kívánt felhasználói felület elem azonosítója.

Példák

ClaimsProvider

A ClaimsProvider érték a jogcímszolgáltatók egyik 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>

Hibaüzenet

Az ErrorMessage érték az egyik rendszerhibaüzenet 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 meg 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é formázá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="ResponseMessage_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="ResponseMessage_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 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ímek átalakításának 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>

Állítmány

A Predikátum értéke a Predikátum egyik hibaüzeneté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>

Predikátum érvényesítése

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íthatja meg a 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 meg a folytatás és a mégse 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 Display Control felhasználói felület egyik elemének honosítására szolgál. Ha engedélyezve van, a megjelenítési vezérlő localizedStrings elsőbbséget élvez néhány UxElement StringID-vel szemben, például a 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és és az ellenőrzés 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>

Egy önkiszolgáló technikai profil Metadata szakaszában a hivatkozott ContentDefinitionnek DataUri 2.1.0-s vagy újabb oldalelrendezési verzió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:

  • Last updated on