Element lokalizace

Důležité

Od 1. května 2025 už nebude Azure AD B2C k dispozici k nákupu pro nové zákazníky. Další informace najdete v našich nejčastějších dotazech.

Poznámka:

V Azure Active Directory B2C jsou vlastní zásady navržené především pro řešení složitých scénářů. Ve většině scénářů doporučujeme používat integrované 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 ve službě Active Directory B2C.

Element Lokalizace umožňuje podporovat 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 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 Lokalizace obsahuje následující atributy:

Vlastnost	Povinné	Popis
Povoleno	Ne	Možné hodnoty: `true` nebo `false`.

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

prvek	Výskyty	Popis
Podporované jazyky	1:n	Seznam podporovaných jazyků
Lokalizované zdroje	0:n	Seznam lokalizovaných prostředků

Podporované jazyky

Element SupportedLanguages obsahuje následující atributy:

Vlastnost	Povinné	Popis
Výchozí jazyk	Ano	Jazyk, který se má použít jako výchozí pro lokalizované prostředky.
Chování při slučování	Ne	Hodnoty výčtu hodnot, které jsou sloučeny spolu s libovolným typem ClaimType, které jsou přítomné 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í zásadě. Možné hodnoty: `Append`, `Prepend`nebo `ReplaceAll`. Hodnota `Append` určuje, že kolekce dat, která jsou k dispozici, by měla být připojena ke konci kolekce určené v nadřazené zásadě. Hodnota `Prepend` určuje, že kolekce dat, která jsou k dispozici, by se měla přidat před kolekci určenou v nadřazené zásadě. Hodnota `ReplaceAll` určuje, že se má ignorovat shromažďování dat definovaných v nadřazené zásadě, a to pomocí dat definovaných v aktuální zásadě.

Podporované jazyky

Element SupportedLanguages obsahuje následující prvky:

prvek	Výskyty	Popis
PodporovanýJazyk	1:n	Zobrazí obsah, který odpovídá značce jazyka podle dokumentu RFC 5646 – značky pro identifikaci jazyků.

Lokalizované zdroje

Element LocalizedResources obsahuje následující atributy:

Vlastnost	Povinné	Popis
identifikační číslo	Ano	Identifikátor, který slouží k jednoznačné identifikaci lokalizovaných prostředků.

Element LocalizedResources obsahuje následující prvky:

prvek	Výskyty	Popis
Lokalizované kolekce	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í nebo oblastí se uživateli zobrazí v rozevíracím seznamu.
Lokalizované řetězce	0:n	Definuje všechny řetězce s výjimkou řetězců, které se zobrazují v kolekcích, v různých jazykových verzích.

Lokalizované kolekce

Element LocalizedCollections obsahuje následující prvky:

prvek	Výskyty	Popis
Lokalizovaná kolekce	1:n	Seznam podporovaných jazyků

Lokalizovaná kolekce

Element LocalizedCollection obsahuje následující atributy:

Vlastnost	Povinné	Popis
Typ prvku	Ano	Odkazuje na element ClaimType nebo element uživatelského rozhraní v souboru zásad.
Identifikátor prvku	Ano	Řetězec obsahující odkaz na typ deklarace identity, který je již definován v oddílu ClaimsSchema, který se používá, pokud je ElementType nastaven na ClaimType .
Cílová kolekce	Ano	Cílová kolekce.

Element LocalizedCollection obsahuje následující prvky:

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

Element Item obsahuje následující atributy:

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

Následující příklad ukazuje použití LocalizedCollections elementu. Obsahuje dva prvky LocalizedCollection , jeden pro angličtinu a druhý pro španělštinu. Obě nastaví kolekci omezení deklarace identity Gender se seznamem položek pro angličtinu a španělštinu. Další ukázky najdete v živé ukázce 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	Popis
LocalizedString	1:n	Lokalizovaný řetězec.

Element LocalizedString obsahuje následující atributy:

Vlastnost	Povinné	Popis
Typ prvku	Ano	Možné hodnoty: ClaimsProvider, ClaimType, ErrorMessage, GetLocalizedStringsTransformationClaimType, FormatLocalizedStringTransformationClaimType, Predicate , PredicateValidation nebo UxElement.
Identifikátor prvku	Ano	Pokud ElementType je nastavena na `ClaimType`, `Predicate`nebo `PredicateValidation`, tento element obsahuje odkaz na typ deklarace identity již definován v Části ClaimsSchema.
Identifikátor řetězce	Ano	Pokud elementType je nastaven na `ClaimType`, tento element obsahuje odkaz na atribut typu deklarace identity. Možné hodnoty: `DisplayName`, `AdminHelpText`nebo `PatternHelpText`. Hodnota `DisplayName` se používá k nastavení zobrazovaného názvu deklarace identity. Hodnota `AdminHelpText` se používá k nastavení textového názvu nápovědy uživatele deklarace identity. Hodnota `PatternHelpText` se používá k nastavení textu nápovědy pro vzor deklarací identity. Pokud ElementType je nastaven na `UxElement`, tento element obsahuje odkaz na atribut prvku uživatelského rozhraní. Pokud je elementType nastaven na `ErrorMessage`, tento prvek určuje identifikátor chybové zprávy. Úplný seznam identifikátorů najdete v identifikátorech lokalizačních`UxElement` řetězců.

Typ prvku

ElementType odkaz na typ deklarace identity, transformaci deklarací identity nebo prvek uživatelského rozhraní v zásadách, které mají být lokalizovány.

Element k lokalizaci	Typ prvku	Identifikátor prvku	Identifikátor řetězce
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`, `PatternHelpText`a `UserHelpText`.
Zpráva o chybě	`ErrorMessage`		ID chybové zprávy
Zkopíruje lokalizované řetězce do deklarací identity.	`GetLocalizedStringsTransformationClaimType`		Název výstupní deklarace identity
Predikát zprávy uživatele	`Predicate`	Název predikátu	Atribut predikátu, který má být lokalizován. Možné hodnoty: `HelpText`.
Predikát zprávy uživatele skupiny	`PredicateValidation`	ID predikateValidation elementu.	ID elementu PredicateGroup. Predikátová skupina musí být podřízeným ověřovacím elementem predikátu, jak je definováno v ElementId.
Prvky uživatelského rozhraní	`UxElement`		ID prvku uživatelského rozhraní, který se má lokalizovat.
Ovládací prvek zobrazení	`DisplayControl`	ID ovládacího prvku zobrazení.	ID prvku uživatelského rozhraní, který se má lokalizovat.

Příklady

Deklarace identity Provider

Hodnota ClaimsProvider slouží k lokalizaci jednoho z zobrazovaných názvů zprostředkovatelů deklarací.

<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 nároku

Hodnota ClaimType se používá k lokalizaci jednoho z atributů deklarace 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 identity 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>

Chybová zpráva

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 UserMessageIfClaimsPrincipalAlreadyExists chybová zpráva.

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

FormatLocalizedStringTransformationClaimType

Hodnota FormatLocalizedStringTransformationClaimType se používá k formátování deklarací do lokalizovaného řetězce. Další informace naleznete v tématu FormátLocalizedString transformace deklarací identity

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

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

<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

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

<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 deklarace 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át

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 predikáty nápovědy.

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

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 ověřování predikátu.

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

UxElement

Hodnota UxElement se používá k lokalizaci jednoho z prvků uživatelského rozhraní. Následující příklad ukazuje, jak lokalizovat tlačítka pro pokračování a zrušení.

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

DisplayControl

Hodnota DisplayControl slouží k lokalizaci jednoho z prvků uživatelského rozhraní ovládací prvek zobrazení . Pokud je tato možnost povolená, má ovládací prvek zobrazení 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 části Metadata technického profilu s vlastním kontrolním výrazem musí odkazovaný ContentDefinition mít identifikátor DataUri nastavený na rozložení stránky verze 2.1.0 nebo vyšší. Napří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:

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-06-23

Sdílet prostřednictvím

Element lokalizace

Podporované jazyky

Podporované jazyky

Lokalizované zdroje

Lokalizované kolekce

Lokalizovaná kolekce

Lokalizované řetězce

Typ prvku

Příklady

Deklarace identity Provider

Typ nároku

Chybová zpráva

FormatLocalizedStringTransformationClaimType

GetLocalizedStringsTransformationClaimType

Predikát

PredikátValidation

UxElement

DisplayControl

Další kroky

Váš názor

Další materiály