Localization 要素

Localization 要素を使用すると、ユーザー体験のポリシーで複数のロケールまたは言語をサポートできます。 ポリシーでのローカリゼーション のサポートにより、次のことができます。

• ポリシーでサポートされている言語の明示的な一覧を設定し、既定の言語を選択します。
• 言語固有の文字列とコレクションを指定します。

<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 要素には、次の属性が含まれています。

Localization 要素には、次の XML 要素が含まれています

サポートされている言語

SupportedLanguages 要素には、次の属性が含まれています。

サポートされている言語

SupportedLanguages 要素には、次の要素が含まれています。

ローカライズされたリソース

LocalizedResources 要素には、次の属性が含まれています。

LocalizedResources 要素には、次の要素が含まれています。

ローカライズされたコレクション

LocalizedCollections 要素には、次の要素が含まれています。

ローカライズされたコレクション

LocalizedCollection 要素には、次の属性が含まれています。

LocalizedCollection 要素には、次の要素が含まれています。

Item 要素には、次の属性が含まれています。

LocalizedCollections 要素の使用例を次に示します。 これには、2 つの LocalizedCollection 要素が含まれています。1 つは英語用、もう 1 つはスペイン語用です。 両方とも、要求の Gender コレクションに、英語とスペイン語の項目の一覧を設定します。 その他のサンプルについては、要求の制限リストに関するライブ デモをご覧ください。

<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 要素には、次の要素が含まれています。

LocalizedString 要素には、次の属性が含まれています。

要素タイプ

ローカライズするポリシー内の要求の種類、要求変換、またはユーザー インターフェイス要素への ElementType 参照。

例示

クレーム プロバイダー

ClaimsProvider 値は、クレーム プロバイダーの表示名の 1 つをローカライズするために使用されます。

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

次の例は、要求プロバイダーの表示名をローカライズする方法を示しています。

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

クレームタイプ

ClaimType 値は、要求属性の 1 つをローカライズするために使用されます。

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

次の例は、電子メール要求の種類の DisplayName、UserHelpText、および PatternHelpText 属性をローカライズする方法を示しています。

<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 値は、システム エラー メッセージの 1 つをローカライズするために使用されます。

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

次の例は、UserMessageIfClaimsPrincipalAlreadyExists エラー メッセージをローカライズする方法を示しています。

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

FormatLocalizedStringTransformationClaimType (英語)

FormatLocalizedStringTransformationClaimType 値は、要求をローカライズされた文字列に書式設定するために使用されます。 詳細については、「FormatLocalizedString 要求変換」を参照してください。

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

次の例は、FormatLocalizedStringTransformationClaimType 要求変換の文字列形式をローカライズする方法を示しています。

<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 値は、ローカライズされた文字列をクレームにコピーするために使用されます。 詳細については、「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>

次の例は、GetLocalizedStringsTransformation 要求変換の出力要求をローカライズする方法を示しています。

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

述語

述語の値は、 述語 エラー メッセージの 1 つをローカライズするために使用されます。

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

次の例は、述語のヘルプ テキストをローカライズする方法を示しています。

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

述語検証

PredicateValidation 値は、 PredicateValidation グループのエラー メッセージの 1 つをローカライズするために使用されます。

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

次の例は、述語検証グループのヘルプ テキストをローカライズする方法を示しています。

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

UxElement (ユークスエレメント)

UxElement 値は、ユーザー インターフェイス要素の 1 つをローカライズするために使用されます。 次の例は、[続行] ボタンと [キャンセル] ボタンをローカライズする方法を示しています。

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

ディスプレイコントロール

DisplayControl 値は、 表示コントロール のユーザー インターフェイス要素の 1 つをローカライズするために使用されます。 有効にすると、表示コントロールの localizedStrings が、ver_but_send、ver_but_edit、ver_but_resend、ver_but_verifyなどの一部の UxElement StringID よりも優先されます。 次の例は、送信ボタンと確認ボタンをローカライズする方法を示しています。

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

セルフアサート技術プロファイルのメタデータ セクションでは、参照先の ContentDefinition で DataUri を ページ レイアウト バージョン 2.1.0 以降に設定する必要があります。 例えば次が挙げられます。

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

次のステップ

ローカライズの例については、次の記事を参照してください。

• Azure Active Directory B2C でのカスタム ポリシーを使用した言語のカスタマイズ
• Azure Active Directory B2C でのユーザー フローを使用した言語のカスタマイズ