Delen via

Lokalisatie-element

Belangrijk

Vanaf 1 mei 2025 is Azure AD B2C niet meer beschikbaar voor nieuwe klanten. Meer informatie vindt u in onze veelgestelde vragen.

Opmerking

In Azure Active Directory B2C is aangepast beleid voornamelijk bedoeld om met complexe scenario's om te gaan. Voor de meeste scenario's wordt aangeraden ingebouwde gebruikersstromen te gebruiken. Als u dit nog niet hebt gedaan, vindt u meer informatie over aangepast beleid in het starterspakket in Aan de slag met aangepaste beleidsregels in Active Directory B2C.

Met het element Lokalisatie kunt u meerdere landinstellingen of talen in het beleid voor de gebruikersbelevingen ondersteunen. Met de lokalisatieondersteuning in beleidsregels kunt u het volgende doen:

  • Stel de expliciete lijst met ondersteunde talen in een beleid in en kies een standaardtaal.
  • Taalspecifieke tekenreeksen en verzamelingen opgeven.
<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">
  ...

Het element Lokalisatie bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Ingeschakeld Nee. Mogelijke waarden: true of false.

Het element Lokalisatie bevat de volgende XML-elementen

Onderdeel Instanties Beschrijving
Ondersteunde talen 1:n Lijst met ondersteunde talen.
Gelokaliseerde bronnen 0:n Lijst met gelokaliseerde resources.

Ondersteunde talen

Het element SupportedLanguages bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Standaardtaal Ja De taal die moet worden gebruikt als de standaardtaal voor gelokaliseerde resources.
Gedrag samenvoegen Nee. Een opsommingswaarden van waarden die worden samengevoegd met elk ClaimType dat aanwezig is in een bovenliggend beleid met dezelfde id. Gebruik dit kenmerk wanneer u een claim overschrijft die is opgegeven in het basisbeleid. Mogelijke waarden: Append, Prependof ReplaceAll. De Append waarde geeft aan dat de verzameling van aanwezige gegevens moet worden toegevoegd aan het einde van de verzameling die is opgegeven in het bovenliggende beleid. De Prepend waarde geeft aan dat de verzameling van aanwezige gegevens moet worden toegevoegd voordat de verzameling die is opgegeven in het bovenliggende beleid. De ReplaceAll waarde geeft aan dat de verzameling gegevens die in het bovenliggende beleid zijn gedefinieerd, moet worden genegeerd, met behulp van de gegevens die zijn gedefinieerd in het huidige beleid.

Ondersteunde talen

Het element SupportedLanguages bevat de volgende elementen:

Onderdeel Instanties Beschrijving
Ondersteunde taal 1:n Geeft inhoud weer die voldoet aan een taaltag per RFC 5646 - Tags voor het identificeren van talen.

Gelokaliseerde bronnen

Het element LocalizedResources bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Identiteitsbewijs Ja Een id die wordt gebruikt om gelokaliseerde resources uniek te identificeren.

Het element LocalizedResources bevat de volgende elementen:

Onderdeel Instanties Beschrijving
Gelokaliseerde collecties 0:n Definieert volledige verzamelingen in verschillende culturen. Een verzameling kan een verschillend aantal items en verschillende tekenreeksen voor verschillende culturen hebben. Voorbeelden van verzamelingen zijn de opsommingen die worden weergegeven in claimtypen. Een lijst met landen/regio's wordt bijvoorbeeld weergegeven aan de gebruiker in een vervolgkeuzelijst.
Gelokaliseerde tekenreeksen 0:n Definieert alle tekenreeksen, behalve de tekenreeksen die in verzamelingen worden weergegeven, in verschillende culturen.

Gelokaliseerde collecties

Het element LocalizedCollections bevat de volgende elementen:

Onderdeel Instanties Beschrijving
Gelokaliseerde collectie 1:n Lijst met ondersteunde talen.

Gelokaliseerde collectie

Het element LocalizedCollection bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
ElementType Ja Verwijst naar een ClaimType-element of een element van de gebruikersinterface in het beleidsbestand.
ElementId Ja Een tekenreeks die een verwijzing bevat naar een claimtype dat al is gedefinieerd in de sectie ClaimsSchema die wordt gebruikt als ElementType is ingesteld op een ClaimType.
Doel-collectie Ja De doelverzameling.

Het element LocalizedCollection bevat de volgende elementen:

Onderdeel Instanties Beschrijving
Onderdeel 0:n Hiermee definieert u een beschikbare optie die de gebruiker kan selecteren voor een claim in de gebruikersinterface, zoals een waarde in een vervolgkeuzelijst.

Het element Item bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
Tekst Ja De gebruiksvriendelijke weergavetekenreeks die moet worden weergegeven aan de gebruiker in de gebruikersinterface voor deze optie.
Waarde Ja De waarde van de tekenreeksclaim die is gekoppeld aan het selecteren van deze optie.
SelectByDefault Nee. Hiermee wordt aangegeven of deze optie standaard moet worden geselecteerd in de gebruikersinterface. Mogelijke waarden: Waar of Onwaar.

In het volgende voorbeeld ziet u het gebruik van het element LocalizedCollections . Het bevat twee LocalizedCollection-elementen , één voor Engels en een voor Spaans. Beide stellen de beperkingsverzameling van de claim Gender in met een lijst met items voor Engels en Spaans. Bekijk de livedemo voor claimbeperkingen voor meer voorbeelden.

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

Gelokaliseerde tekenreeksen

Het element LocalizedStrings bevat de volgende elementen:

Onderdeel Instanties Beschrijving
Gelokaliseerde tekenreeks 1:n Een gelokaliseerde tekenreeks.

Het element LocalizedString bevat de volgende kenmerken:

Eigenschap Verplicht Beschrijving
ElementType Ja Mogelijke waarden: ClaimsProvider, ClaimType, ErrorMessage, GetLocalizedStringsTransformationClaimType, FormatLocalizedStringTransformationClaimType, Predicate, PredicateValidation of UxElement.
ElementId Ja Als ElementType is ingesteld op ClaimType, Predicateof , bevat PredicateValidationdit element een verwijzing naar een claimtype dat al is gedefinieerd in de sectie ClaimsSchema.
StringId Ja Als ElementType is ingesteld op ClaimType, bevat dit element een verwijzing naar een kenmerk van een claimtype. Mogelijke waarden: DisplayName, AdminHelpTextof PatternHelpText. De DisplayName waarde wordt gebruikt om de weergavenaam van de claim in te stellen. De AdminHelpText waarde wordt gebruikt om de Help-tekstnaam van de claimgebruiker in te stellen. De PatternHelpText waarde wordt gebruikt om de helptekst van het claimpatroon in te stellen. Als ElementType is ingesteld op UxElement, bevat dit element een verwijzing naar een kenmerk van een element van de gebruikersinterface. Als ElementType is ingesteld op ErrorMessage, geeft dit element de id van een foutbericht op. Zie Lokalisatietekenreeks-id's voor een volledige lijst met id's UxElement .

ElementType

De ElementType-verwijzing naar een claimtype, een claimtransformatie of een element van de gebruikersinterface in het beleid dat moet worden gelokaliseerd.

Element om te lokaliseren ElementType ElementId StringId
Id-providernaam ClaimsProvider De id van het element ClaimsExchange
Kenmerken van claimtype ClaimType Naam van het claimtype Het kenmerk van de claim die moet worden gelokaliseerd. Mogelijke waarden: AdminHelpText, DisplayName, , PatternHelpTexten UserHelpText.
Foutmelding ErrorMessage De id van het foutbericht
Gelokaliseerde tekenreeksen naar claims kopiëren GetLocalizedStringsTransformationClaimType De naam van de uitvoerclaim
Predicaat gebruikersbericht Predicate De naam van het predicaat Het kenmerk van het predicaat dat moet worden gelokaliseerd. Mogelijke waarden: HelpText.
Predicaat groepsgebruikersbericht PredicateValidation De id van het predicaatvalidatie-element. De id van het element PredicateGroup. De predicaatgroep moet een onderliggend element van het predicaatvalidatieelement zijn, zoals gedefinieerd in de ElementId.
Gebruikersinterface-elementen UxElement De id van het element van de gebruikersinterface dat moet worden gelokaliseerd.
Besturingselement weergeven DisplayControl De id van het weergavebeheer. De id van het element van de gebruikersinterface dat moet worden gelokaliseerd.

Voorbeelden

Aanbieder van vorderingen

De claimproviderwaarde wordt gebruikt om een van de weergavenaam van claimproviders te lokaliseren.

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

In het volgende voorbeeld ziet u hoe u de weergavenaam van claimproviders kunt lokaliseren.

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

Claamtype

De waarde ClaimType wordt gebruikt om een van de claimkenmerken te lokaliseren.

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

In het volgende voorbeeld ziet u hoe u de kenmerken DisplayName, UserHelpText en PatternHelpText van het type e-mailclaim kunt lokaliseren.

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

Foutmelding

De ErrorMessage-waarde wordt gebruikt om een van de systeemfoutberichten te lokaliseren.

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

In het volgende voorbeeld ziet u hoe u het foutbericht UserMessageIfClaimsPrincipalAlreadyExists kunt lokaliseren.

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

FormatLocalizedStringTransformationClaimType

De waarde FormatLocalizedStringTransformationClaimType wordt gebruikt om claims op te maken in een gelokaliseerde tekenreeks. Zie FormatLocalizedString-claimtransformatie voor meer informatie

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

In het volgende voorbeeld ziet u hoe u de tekenreeksindeling van de claimtransformationClaimType FormatLocalizedStringTransformationClaimType kunt lokaliseren.

<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

De waarde GetLocalizedStringsTransformationClaimType wordt gebruikt om gelokaliseerde tekenreeksen naar claims te kopiëren. Zie GetLocalizedStringsTransformation-claimtransformation-transformatie voor meer informatie

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

In het volgende voorbeeld ziet u hoe u uitvoerclaims van de transformatie getLocalizedStringsTransformation-claims kunt lokaliseren.

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

Predicaat

De predicaatwaarde wordt gebruikt om een van de predicaatfoutberichten te lokaliseren .

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

In het volgende voorbeeld ziet u hoe u help-tekst kunt lokaliseren voor predicaten.

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

PredicaatValidatie

De predicateValidation-waarde wordt gebruikt om een van de foutberichten van de predicateValidation-groep te lokaliseren.

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

In het volgende voorbeeld ziet u hoe u helptekst van een predicaatvalidatiegroep kunt lokaliseren.

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

UxElement

De UxElement-waarde wordt gebruikt om een van de elementen van de gebruikersinterface te lokaliseren. In het volgende voorbeeld ziet u hoe u de knoppen doorgaan en annuleren kunt lokaliseren.

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

DisplayControl

De waarde DisplayControl wordt gebruikt om een van de elementen van de gebruikersinterface van Het besturingselement weer te geven. Wanneer dit is ingeschakeld, heeft het display-besturingselement localizedStrings voorrang op een aantal UxElement StringID's, zoals ver_but_send, ver_but_edit, ver_but_resend en ver_but_verify. In het volgende voorbeeld ziet u hoe u de knoppen voor verzenden en verifiëren kunt lokaliseren.

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

In de sectie Metagegevens van een zelf-asserted technisch profiel moet voor de inhoudsdefinition waarnaar wordt verwezen DataUri zijn ingesteld op pagina-indeling versie 2.1.0 of hoger. Voorbeeld:

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

Volgende stappen

Zie de volgende artikelen voor lokalisatievoorbeelden:

  • Last updated on