Yerelleştirme öğesi

Önemli

1 Mayıs 2025 tarihinden itibaren Azure AD B2C artık yeni müşteriler için satın alınamayacak. SSS bölümünden daha fazla bilgi edinebilirsiniz.

Uyarı

Azure Active Directory B2C'de özel ilkeler öncelikli olarak karmaşık senaryoları ele almak için tasarlanmıştır. Çoğu senaryoda, yerleşik kullanıcı akışlarını kullanmanızı öneririz. Bunu yapmadıysanız, Active Directory B2C'de özel ilkeleri kullanmaya başlama bölümünde özel ilke başlangıç paketi hakkında bilgi edinin.

Localization öğesi, kullanıcı yolculukları için ilkede birden çok yerel ayarı veya dili desteklemenizi sağlar. İlkelerdeki yerelleştirme desteği şunları yapmanızı sağlar:

bir ilkede desteklenen dillerin açık listesini ayarlayın ve varsayılan bir dil seçin.
Dile özgü dizeler ve koleksiyonlar sağlayın.

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

Localization öğesi aşağıdaki öznitelikleri içerir:

Özellik	Gerekli	Açıklama
Etkinleştirildi	Hayı	Olası değerler: `true` veya `false`.

Localization öğesi aşağıdaki XML öğelerini içerir

Öğe	Oluşum	Açıklama
Desteklenen Diller	1:n	Desteklenen dillerin listesi.
Yerelleştirilmiş Kaynaklar	0:n	Yerelleştirilmiş kaynakların listesi.

Desteklenen Diller

SupportedLanguages öğesi aşağıdaki öznitelikleri içerir:

Özellik	Gerekli	Açıklama
Varsayılan Dil	Evet	Yerelleştirilmiş kaynaklar için varsayılan olarak kullanılacak dil.
Birleştirme Davranışı	Hayı	Aynı tanımlayıcıya sahip bir üst ilkede bulunan herhangi bir ClaimType ile birleştirilen değerlerin numaralandırma değerleri. Temel ilkede belirtilen bir talebin üzerine yazdığınızda bu özniteliği kullanın. Olası değerler: `Append`, `Prepend`veya `ReplaceAll`. değeri, `Append` mevcut veri koleksiyonunun üst ilkede belirtilen koleksiyonun sonuna eklenmesi gerektiğini belirtir. değeri, `Prepend` mevcut veri koleksiyonunun üst ilkede belirtilen koleksiyondan önce eklenmesi gerektiğini belirtir. değeri, `ReplaceAll` üst ilkede tanımlanan veri koleksiyonunun yoksayılması gerektiğini belirtir ve bunun yerine geçerli ilkede tanımlanan veriler kullanılır.

Desteklenen Diller

SupportedLanguages öğesi aşağıdaki öğeleri içerir:

Öğe	Oluşum	Açıklama
Desteklenen Dil	1:n	RFC 5646 - Dilleri Tanımlamak için Etiketler başına bir dil etiketine uyan içeriği görüntüler.

Yerelleştirilmiş Kaynaklar

LocalizedResources öğesi aşağıdaki öznitelikleri içerir:

Özellik	Gerekli	Açıklama
Kimlik	Evet	Yerelleştirilmiş kaynakları benzersiz olarak tanımlamak için kullanılan tanımlayıcı.

LocalizedResources öğesi aşağıdaki öğeleri içerir:

Öğe	Oluşum	Açıklama
Yerelleştirilmiş Koleksiyonlar	0:n	Çeşitli kültürlerdeki koleksiyonların tamamını tanımlar. Bir koleksiyon, çeşitli kültürler için farklı sayıda öğeye ve farklı dizeye sahip olabilir. Koleksiyonlara örnek olarak talep türlerinde görünen numaralandırmalar verilebilir. Örneğin, kullanıcıya açılan listede bir ülke/bölge listesi gösterilir.
Yerelleştirilmiş Dizeler	0:n	Çeşitli kültürlerde koleksiyonlarda görünen dizeler dışında tüm dizeleri tanımlar.

Yerelleştirilmiş Koleksiyonlar

LocalizedCollections öğesi aşağıdaki öğeleri içerir:

Öğe	Oluşum	Açıklama
YerelleştirilmişKoleksiyon	1:n	Desteklenen dillerin listesi.

YerelleştirilmişKoleksiyon

LocalizedCollection öğesi aşağıdaki öznitelikleri içerir:

Özellik	Gerekli	Açıklama
Öğe Türü	Evet	İlke dosyasındaki bir ClaimType öğesine veya kullanıcı arabirimi öğesine başvurur.
Öğe Kimliği	Evet	ElementType bir ClaimType olarak ayarlandıysa kullanılan ClaimsSchema bölümünde zaten tanımlanmış bir talep türüne başvuru içeren dize.
Hedef Koleksiyonu	Evet	Hedef koleksiyon.

LocalizedCollection öğesi aşağıdaki öğeleri içerir:

Öğe	Oluşum	Açıklama
Ürün	0:n	Kullanıcının kullanıcı arabirimindeki bir talep için seçmesi için açılan menüdeki bir değer gibi kullanılabilir bir seçenek tanımlar.

Item öğesi aşağıdaki öznitelikleri içerir:

Özellik	Gerekli	Açıklama
Metin	Evet	Bu seçenek için kullanıcı arabiriminde kullanıcıya gösterilmesi gereken kullanıcı dostu görüntü dizesi.
Değer	Evet	Bu seçeneğin seçilmesiyle ilişkili dize talep değeri.
SelectByDefault	Hayı	Bu seçeneğin kullanıcı arabiriminde varsayılan olarak belirlenip belirlenmeyeceğini gösterir. Olası değerler: True veya False.

Aşağıdaki örnekte LocalizedCollections öğesinin kullanımı gösterilmektedir. Biri İngilizce, diğeri İspanyolca için iki LocalizedCollection öğesi içerir. Her ikisi de talebin Gender koleksiyonunu İngilizce ve İspanyolca için bir öğe listesiyle ayarlar. Daha fazla örnek için Talep kısıtlama numaralandırması canlı tanıtımına göz atın.

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

Yerelleştirilmiş Dizeler

LocalizedStrings öğesi aşağıdaki öğeleri içerir:

Öğe	Oluşum	Açıklama
LocalizedString	1:n	Yerelleştirilmiş bir dize.

LocalizedString öğesi aşağıdaki öznitelikleri içerir:

Özellik	Gerekli	Açıklama
Öğe Türü	Evet	Olası değerler: ClaimsProvider, ClaimType, ErrorMessage, GetLocalizedStringsTransformationClaimType, FormatLocalizedStringTransformationClaimType, Predicate, PredicateValidation veya UxElement.
Öğe Kimliği	Evet	ElementType , `ClaimType`veya `Predicate`olarak ayarlandıysa`PredicateValidation`, bu öğe ClaimsSchema bölümünde önceden tanımlanmış bir talep türüne başvuru içerir.
Dize Kimliği	Evet	ElementType olarak ayarlanırsa`ClaimType`, bu öğe bir talep türü özniteliğine başvuru içerir. Olası değerler: `DisplayName`, `AdminHelpText`veya `PatternHelpText`. Değer `DisplayName` , talep görünen adını ayarlamak için kullanılır. `AdminHelpText` değer, talep kullanıcısının yardım metin adını ayarlamak için kullanılır. Değer `PatternHelpText` , talep deseni yardım metnini ayarlamak için kullanılır. ElementType olarak ayarlanırsa`UxElement`, bu öğe bir kullanıcı arabirimi öğesinin özniteliğine başvuru içerir. ElementType olarak ayarlanırsa`ErrorMessage`, bu öğe bir hata iletisinin tanımlayıcısını belirtir. Tanımlayıcıların tam listesi için bkz. `UxElement`.

Öğe Türü

ElementType, yerelleştirilecek ilkedeki bir talep türüne, talep dönüştürmesine veya kullanıcı arabirimi öğesine başvurur.

Yerelleştirecek öğe	Öğe Türü	Öğe Kimliği	Dize Kimliği
Kimlik sağlayıcısı adı	`ClaimsProvider`		ClaimsExchange öğesinin kimliği
Talep türü öznitelikleri	`ClaimType`	Talep türünün adı	Yerelleştirilecek talebin özniteliği. Olası değerler: `AdminHelpText`, `DisplayName`, `PatternHelpText`ve `UserHelpText`.
Hata mesajı	`ErrorMessage`		Hata iletisinin kimliği
Yerelleştirilmiş dizeleri taleplere kopyalar	`GetLocalizedStringsTransformationClaimType`		Çıkış talebi adı
Kullanıcı iletisini koşullandır	`Predicate`	Koşulun adı	Yerelleştirilecek koşulun özniteliği. Olası değerler: `HelpText`.
Koşul grubu kullanıcı iletisi	`PredicateValidation`	PredicateValidation öğesinin kimliği.	PredicateGroup öğesinin kimliği. Koşul grubu, ElementId içinde tanımlandığı gibi koşul doğrulama öğesinin alt öğesi olmalıdır.
Kullanıcı arabirimi öğeleri	`UxElement`		Yerelleştirilecek kullanıcı arabirimi öğesinin kimliği.
Denetim Görüntüle	`DisplayControl`	Görüntü denetiminin kimliği.	Yerelleştirilecek kullanıcı arabirimi öğesinin kimliği.

Örnekler

Talep Sağlayıcısı

ClaimsProvider değeri, talep sağlayıcılarından birinin görünen adını yerelleştirmek için kullanılır.

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

Aşağıdaki örnekte talep sağlayıcılarının görünen adını yerelleştirme gösterilmektedir.

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

Talep Türü

ClaimType değeri, talep özniteliklerinden birini yerelleştirmek için kullanılır.

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

Aşağıdaki örnekte, e-posta talep türünün DisplayName, UserHelpText ve PatternHelpText özniteliklerinin yerelleştirilmesi gösterilmektedir.

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

Hata Mesajı

ErrorMessage değeri, sistem hata iletilerinden birini yerelleştirmek için kullanılır.

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

Aşağıdaki örnekte UserMessageIfClaimsPrincipalAlreadyExists hata iletisinin nasıl yerelleştirilmemiş olduğu gösterilmektedir.

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

FormatLocalizedStringTransformationClaimType

FormatLocalizedStringTransformationClaimType değeri, talepleri yerelleştirilmiş bir dizede biçimlendirmek için kullanılır. Daha fazla bilgi için bkz . FormatLocalizedString talep dönüştürme

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

Aşağıdaki örnekte FormatLocalizedStringTransformationClaimType talep dönüştürmesinin dize biçiminin nasıl yerelleştirildiği gösterilmektedir.

<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

GetLocalizedStringsTransformationClaimType değeri, yerelleştirilmiş dizeleri taleplere kopyalamak için kullanılır. Daha fazla bilgi için bkz . GetLocalizedStringsTransformation talepleri dönüştürme

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

Aşağıdaki örnekte GetLocalizedStringsTransformation talep dönüştürmesinin çıkış taleplerinin nasıl yerelleştirildiği gösterilmektedir.

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

Yüklem

Koşul değeri Koşul hata iletilerinden birini yerelleştirmek için kullanılır.

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

Aşağıdaki örnekte, koşul yardım metninin yerelleştirilmesi gösterilmektedir.

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

Koşul Doğrulaması

PredicateValidation değeri, PredicateValidation grubu hata iletilerinden birini yerelleştirmek için kullanılır.

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

Aşağıdaki örnekte, bir koşul doğrulama grubu yardım metninin nasıl yerelleştirilmemiş olduğu gösterilmektedir.

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

Kullanıcı Öğesi

UxElement değeri, kullanıcı arabirimi öğelerinden birini yerelleştirmek için kullanılır. Aşağıdaki örnekte, devam ve iptal düğmelerinin nasıl yerelleştirilip iptal edileceği gösterilmektedir.

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

Ekran Kontrolü

DisplayControl değeri, Görüntüleme Denetimi kullanıcı arabirimi öğelerinden birini yerelleştirmek için kullanılır. Etkinleştirildiğinde, görüntüleme denetimi localizedStrings, ver_but_send, ver_but_edit, ver_but_resendve ver_but_verify gibi bazı UxElement StringID'lerinden önceliklidir. Aşağıdaki örnekte gönderme ve doğrulama düğmelerinin nasıl yerelleştirilip doğrulanması gösterilmektedir.

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

Kendi kendine onaylanan bir teknik profilin Meta Veriler bölümünde, başvuruda bulunan ContentDefinition'ın DataUri'nin sayfa düzeni sürüm 2.1.0 veya üzeri olarak ayarlanması gerekir. Örneğin:

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

Sonraki Adımlar

Yerelleştirme örnekleri için aşağıdaki makalelere bakın:

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-06-23

Aracılığıyla paylaş

Yerelleştirme öğesi

Desteklenen Diller

Desteklenen Diller

Yerelleştirilmiş Kaynaklar

Yerelleştirilmiş Koleksiyonlar

YerelleştirilmişKoleksiyon

Yerelleştirilmiş Dizeler

Öğe Türü

Örnekler

Talep Sağlayıcısı

Talep Türü

Hata Mesajı

FormatLocalizedStringTransformationClaimType

GetLocalizedStringsTransformationClaimType

Yüklem

Koşul Doğrulaması

Kullanıcı Öğesi

Ekran Kontrolü

Sonraki Adımlar

Geri Bildirim

Ek kaynaklar