Element Lokalizace

  • Článek

Poznámka

V Azure Active Directory B2C jsou vlastní zásady navržené primárně tak, aby řešily složité scénáře. Ve většině scénářů doporučujeme používat předdefinované toky uživatelů. Pokud jste to neudělali, přečtěte si informace o úvodním balíčku vlastních zásad v tématu Začínáme s vlastními zásadami v Active Directory B2C.

Element Localization umožňuje podporu více národních prostředí nebo jazyků v zásadách pro cesty uživatele. Podpora lokalizace v zásadách umožňuje:

  • Nastavte explicitní seznam podporovaných jazyků v zásadách a vyberte výchozí jazyk.
  • Zadejte řetězce a kolekce specifické pro konkrétní jazyk.
<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">
  ...

Element Localization obsahuje následující atributy:

Atribut Povinné Description
Povoleno No Možné hodnoty: true nebo false.

Element Localization obsahuje následující elementy XML.

Prvek Výskyty Description
Podporované jazyky 1:n Seznam podporovaných jazyků
LocalizedResources 0:n Seznam lokalizovaných prostředků

Podporované jazyky

Element SupportedLanguages obsahuje následující atributy:

Atribut Povinné Popis
DefaultLanguage Yes Jazyk, který se použije jako výchozí pro lokalizované prostředky.
MergeBehavior No Výčtové hodnoty hodnot, které jsou sloučeny společně s libovolným ClaimType přítomným v nadřazené zásadě se stejným identifikátorem. Tento atribut použijte při přepsání deklarace identity zadané v základních zásadách. Možné hodnoty: Append, Prependnebo ReplaceAll. Hodnota Append určuje, že kolekce přítomných dat by měla být připojena na konec kolekce určené v nadřazené zásadě. Hodnota Prepend určuje, že kolekce přítomných dat by měla být přidána před kolekci zadanou v nadřazené zásadě. Hodnota ReplaceAll určuje, že by se měla ignorovat kolekce dat definovaná v nadřazené zásadě, místo toho se používají data definovaná v aktuálních zásadách.

Podporované jazyky

Element SupportedLanguages obsahuje následující prvky:

Prvek Výskyty Description
Podporovaný jazyk 1:n Zobrazí obsah, který odpovídá značce jazyka podle DOKUMENTU RFC 5646 – Značky pro identifikaci jazyků.

LocalizedResources

Element LocalizedResources obsahuje následující atributy:

Atribut Povinné Popis
Id Yes Identifikátor, který se používá k jednoznačné identifikaci lokalizovaných prostředků.

Element LocalizedResources obsahuje následující prvky:

Prvek Výskyty Description
LocalizedCollections 0:n Definuje celé kolekce v různých jazykových verzích. Kolekce může mít různý počet položek a různé řetězce pro různé jazykové verze. Mezi příklady kolekcí patří výčty, které se zobrazují v typech deklarací identity. Například seznam zemí/oblastí se uživateli zobrazí v rozevíracím seznamu.
Lokalizované řetězce 0:n Definuje všechny řetězce s výjimkou těch, které se zobrazují v kolekcích, v různých jazykových verzích.

LocalizedCollections

Element LocalizedCollections obsahuje následující prvky:

Prvek Výskyty Description
LocalizedCollection 1:n Seznam podporovaných jazyků

LocalizedCollection

Element LocalizedCollection obsahuje následující atributy:

Atribut Povinné Popis
Typ elementu Yes Odkazuje na element ClaimType nebo prvek uživatelského rozhraní v souboru zásad.
Id elementu Yes Řetězec, který obsahuje odkaz na typ deklarace identity již definovaný v části ClaimsSchema, která se používá, pokud ElementType je nastavena na ClaimType.
Cílová kolekce Yes Cílová kolekce.

Element LocalizedCollection obsahuje následující prvky:

Prvek Výskyty Description
Položka 0:n Definuje dostupnou možnost, kterou uživatel může vybrat pro deklaraci identity v uživatelském rozhraní, například hodnotu v rozevíracím seznamu.

Element Item obsahuje následující atributy:

Atribut Povinné Popis
Text Yes Uživatelsky přívětivý zobrazovaný řetězec, který by se měl uživateli zobrazit v uživatelském rozhraní pro tuto možnost.
Hodnota Yes Hodnota deklarace identity řetězce přidružená k výběru této možnosti.
SelectByDefault No Určuje, jestli má být tato možnost ve výchozím nastavení v uživatelském rozhraní vybraná. Možné hodnoty: Pravda nebo Nepravda.

Následující příklad ukazuje použití LocalizedCollections element. Obsahuje dva prvky LocalizedCollection , jeden pro angličtinu a druhý pro španělštinu. Obě sady nastaví kolekci Omezení deklarace se Gender seznamem položek pro angličtinu a španělštinu. Další ukázky najdete v živé ukázce výčtu omezení deklarací identity.

<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>

Lokalizované řetězce

Element LocalizedStrings obsahuje následující prvky:

Prvek Výskyty Description
Lokalizovaný řetězec 1:n Lokalizovaný řetězec.

Element LocalizedString obsahuje následující atributy:

Atribut Povinné Popis
Typ elementu Yes Možné hodnoty: ClaimsProvider, ClaimType, ErrorMessage, GetLocalizedStringsTransformationClaimType, FormatLocalizedStringTransformationClaimType, Predicate, PredicateValidation nebo UxElement.
Id elementu Yes Pokud elementType je nastavena na ClaimType, Predicatenebo PredicateValidation, obsahuje tento element odkaz na typ deklarace identity již definovaný v části ClaimsSchema.
StringId Yes Pokud ElementType je nastaven na ClaimType, tento prvek obsahuje odkaz na atribut typu deklarace identity. Možné hodnoty: DisplayName, AdminHelpTextnebo PatternHelpText. Hodnota se DisplayName používá k nastavení zobrazovaný název deklarace identity. Hodnota AdminHelpText slouží k nastavení textového názvu nápovědy uživatele deklarace identity. Hodnota se PatternHelpText používá k nastavení textu nápovědy ke vzoru deklarace identity. Pokud ElementType je nastaven na UxElement, tento prvek obsahuje odkaz na atribut prvku uživatelského rozhraní. Pokud elementType je nastaven na ErrorMessage, tento prvek určuje identifikátor chybové zprávy. Úplný seznam identifikátorů najdete v UxElement tématu ID lokalizačních řetězců.

Typ elementu

ElementType odkazuje na typ deklarace identity, transformaci deklarace identity nebo prvek uživatelského rozhraní v zásadách, které se mají lokalizovat.

Element pro lokalizaci Typ elementu Id elementu StringId
Název zprostředkovatele identity ClaimsProvider ID elementu ClaimsExchange
Atributy typu deklarace identity ClaimType Název typu deklarace identity Atribut deklarace identity, která se má lokalizovat. Možné hodnoty: AdminHelpText, DisplayName, PatternHelpTexta UserHelpText.
Chybová zpráva ErrorMessage ID chybové zprávy
Zkopíruje lokalizované řetězce do deklarací identity. GetLocalizedStringsTra nsformationClaimType Název výstupní deklarace identity
Predikát uživatelské zprávy Predicate Název predikátu Atribut predikátu, který se má lokalizovat. Možné hodnoty: HelpText.
Predikát zprávy uživatele skupiny PredicateValidation ID elementu PredikateValidation. ID elementu PredicateGroup. Skupina predikátu musí být podřízená elementu ověření predikátu, jak je definováno v ElementId.
Prvky uživatelského rozhraní UxElement ID elementu uživatelského rozhraní, který se má lokalizovat.
Ovládací prvek zobrazení DisplayControl ID ovládacího prvku zobrazení. ID elementu uživatelského rozhraní, který se má lokalizovat.

Příklady

ClaimsProvider

Hodnota ClaimsProvider slouží k lokalizaci zobrazovaného názvu zprostředkovatele deklarací identity.

<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>

Následující příklad ukazuje, jak lokalizovat zobrazovaný název zprostředkovatelů deklarací identity.

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

Typ deklarace identity

Hodnota ClaimType se používá k lokalizaci jednoho z atributů deklarací identity.

<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>

Následující příklad ukazuje, jak lokalizovat DisplayName, UserHelpText a PatternHelpText atributy typu deklarace e-mailu.

<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

Hodnota ErrorMessage se používá k lokalizaci jedné ze systémových chybových zpráv.

<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>

Následující příklad ukazuje, jak lokalizovat chybovou zprávu UserMessageIfClaimsPrincipalAlreadyExists.

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

FormatLocalizedStringTransformationClaimType

Hodnota FormatLocalizedStringTransformationClaimType slouží k formátování deklarací identity do lokalizovaného řetězce. Další informace najdete v tématu Transformace deklarací identity FormatLocalizedString.

<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>

Následující příklad ukazuje, jak lokalizovat formát řetězce FormatLocalizedStringTransformationClaimType transformace deklarací identity.

<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

Hodnota GetLocalizedStringsTransformationClaimType se používá ke kopírování lokalizovaných řetězců do deklarací identity. Další informace najdete v tématu Transformace deklarací identity GetLocalizedStringsTransformation.

<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>

Následující příklad ukazuje, jak lokalizovat výstupní deklarace identity GetLocalizedStringsTransformation transformace deklarací identity.

<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átu

Hodnota predikátu slouží k lokalizaci jedné z chybových zpráv predikátu .

<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>

Následující příklad ukazuje, jak lokalizovat text nápovědy predikáty.

<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átValidace

Hodnota PredikateValidation se používá k lokalizaci jedné z chybových zpráv skupiny PredikateValidation .

<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>

Následující příklad ukazuje, jak lokalizovat text nápovědy skupiny pro ověření predikátu.

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

UxElement

Hodnota UxElement slouží k lokalizaci jednoho z prvků uživatelského rozhraní. Následující příklad ukazuje, jak lokalizovat tlačítka pokračovat a zrušit.

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

Ovládací prvek DisplayControl

Hodnota DisplayControl slouží k lokalizaci jednoho z prvků uživatelského rozhraní ovládací prvek zobrazení . Pokud je povoleno, má ovládací prvek zobrazení lokalizovanéStrings přednost před některými identifikátory UxElement StringID, jako jsou ver_but_send, ver_but_edit, ver_but_resend a ver_but_verify. Následující příklad ukazuje, jak lokalizovat tlačítka odeslat a ověřit.

<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>

V oddílu Metadata samostatného technického profilu musí odkazovaná definice ContentDefinition mít identifikátor DataUri nastavený na rozložení stránky verze 2.1.0 nebo vyšší. Příklad:

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

Další kroky

Příklady lokalizace najdete v následujících článcích: