Honosítási elem

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:

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

Támogatottlanguages

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

Támogatottlanguages

A SupportedLanguages elem a következő elemeket tartalmazza:

LocalizedResources

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

A LocalizedResources elem a következő elemeket tartalmazza:

LocalizedCollections

A LocalizedCollections elem a következő elemeket tartalmazza:

LocalizedCollection

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

A LocalizedCollection elem a következő elemeket tartalmazza:

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

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:

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

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.

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="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 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:

• Nyelvi testreszabás egyéni szabályzattal az Azure Active Directory B2C-ben
• Nyelvi testreszabás felhasználói folyamatokkal az Azure Active Directory B2C-ben