Condividi tramite

Elemento di localizzazione

Importante

A partire dal 1° maggio 2025, Azure AD B2C non sarà più disponibile per l'acquisto per i nuovi clienti. Altre informazioni sono disponibili nelle domande frequenti.

Annotazioni

In Azure Active Directory B2C i criteri personalizzati sono stati progettati principalmente per far fronte a scenari complessi. Per la maggior parte degli scenari, è consigliabile usare i flussi utente predefiniti. In caso contrario, vedere Introduzione ai criteri personalizzati in Active Directory B2C.

L'elemento Localizzazione consente di supportare più impostazioni locali o lingue nei criteri per i percorsi utente. Il supporto per la localizzazione nei criteri consente di:

  • Configurare l'elenco esplicito delle lingue supportate in un criterio e selezionare una lingua predefinita.
  • Specificare stringhe e raccolte specifiche del linguaggio.
<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">
  ...

L'elemento Localization contiene gli attributi seguenti:

Attributo Obbligatorio Descrizione
Attivato NO I valori possibili sono: true o false.

L'elemento Localization contiene gli elementi XML seguenti

Elemento Occorrenze Descrizione
Lingue supportate 1:n Elenco delle lingue supportate.
Risorse localizzate 0:n Elenco di risorse localizzate.

Lingue supportate

L'elemento SupportedLanguages contiene gli attributi seguenti:

Attributo Obbligatorio Descrizione
LinguaPredefinita Sì Lingua da usare come impostazione predefinita per le risorse localizzate.
MergeBehavior NO Valori di enumerazione di valori uniti a qualsiasi ClaimType presente in un criterio padre con lo stesso identificatore. Usare questo attributo quando si sovrascrive un'attestazione specificata nei criteri di base. I valori possibili sono: Append, Prepend o ReplaceAll. Il Append valore specifica che la raccolta di dati presenti deve essere aggiunta alla fine della raccolta specificata nei criteri padre. Il Prepend valore specifica che la raccolta di dati presenti deve essere aggiunta prima della raccolta specificata nei criteri padre. Il ReplaceAll valore specifica che la raccolta di dati definiti nei criteri padre deve essere ignorata, usando invece i dati definiti nei criteri correnti.

Lingue supportate

L'elemento SupportedLanguages contiene gli elementi seguenti:

Elemento Occorrenze Descrizione
Lingua supportata 1:n Visualizza il contenuto conforme a un tag di lingua per RFC 5646 - Tag per l'identificazione dei linguaggi.

Risorse localizzate

L'elemento LocalizedResources contiene gli attributi seguenti:

Attributo Obbligatorio Descrizione
id Sì Identificatore utilizzato per identificare in modo univoco le risorse localizzate.

L'elemento LocalizedResources contiene gli elementi seguenti:

Elemento Occorrenze Descrizione
Collezioni localizzate 0:n Definisce intere raccolte in diverse impostazioni cultura. Una raccolta può avere un numero diverso di elementi e stringhe diverse per diverse impostazioni cultura. Esempi di raccolte includono le enumerazioni visualizzate nei tipi di attestazione. Ad esempio, un elenco paese/area geografica viene visualizzato all'utente in un elenco a discesa.
LocalizedStrings 0:n Definisce tutte le stringhe, ad eccezione delle stringhe visualizzate nelle raccolte, in diverse impostazioni cultura.

Collezioni localizzate

L'elemento LocalizedCollections contiene gli elementi seguenti:

Elemento Occorrenze Descrizione
Collezione localizzata 1:n Elenco delle lingue supportate.

Collezione localizzata

L'elemento LocalizedCollection contiene gli attributi seguenti:

Attributo Obbligatorio Descrizione
Tipo di elemento Sì Fa riferimento a un elemento ClaimType o a un elemento dell'interfaccia utente nel file dei criteri.
ElementId Sì Stringa che contiene un riferimento a un tipo di attestazione già definito nella sezione ClaimsSchema utilizzata se ElementType è impostato su claimType.
Collezione Target Sì Raccolta di destinazione.

L'elemento LocalizedCollection contiene gli elementi seguenti:

Elemento Occorrenze Descrizione
Elemento 0:n Definisce un'opzione disponibile per l'utente da selezionare per un'attestazione nell'interfaccia utente, ad esempio un valore in un elenco a discesa.

L'elemento Item contiene gli attributi seguenti:

Attributo Obbligatorio Descrizione
Testo Sì Stringa di visualizzazione intuitiva che deve essere visualizzata all'utente nell'interfaccia utente per questa opzione.
Valore Sì Valore dell'attestazione stringa associato alla selezione di questa opzione.
SelezionarePerImpostazione predefinita NO Indica se questa opzione deve essere selezionata o meno per impostazione predefinita nell'interfaccia utente. I valori possibili sono: True o False.

Nell'esempio seguente viene illustrato l'utilizzo dell'elemento LocalizedCollections . Contiene due elementi LocalizedCollection , uno per l'inglese e l'altro per lo spagnolo. Entrambi impostano la raccolta Restriction dell'attestazioneGender con un elenco di elementi per l'inglese e lo spagnolo. Per altri esempi, vedere la demo live relativa all'enumerazione delle restrizioni attestazioni.

<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

L'elemento LocalizedStrings contiene gli elementi seguenti:

Elemento Occorrenze Descrizione
LocalizedString 1:n Stringa localizzata.

L'elemento LocalizedString contiene gli attributi seguenti:

Attributo Obbligatorio Descrizione
Tipo di elemento Sì Valori possibili: ClaimsProvider, ClaimType, ErrorMessage, GetLocalizedStringsTransformationClaimType, FormatLocalizedStringTransformationClaimType, Predicate, PredicateValidation o UxElement.
ElementId Sì Se ElementType è impostato su ClaimType, Predicateo PredicateValidation, questo elemento contiene un riferimento a un tipo di attestazione già definito nella sezione ClaimsSchema.
Stringa Id Sì Se ElementType è impostato su ClaimType, questo elemento contiene un riferimento a un attributo di un tipo di attestazione. I valori possibili sono: DisplayName, AdminHelpText o PatternHelpText. Il DisplayName valore viene usato per impostare il nome visualizzato dell'attestazione. Il AdminHelpText valore viene usato per impostare il nome di testo della Guida dell'utente dell'attestazione. Il PatternHelpText valore viene usato per impostare il testo della Guida del criterio di attestazione. Se ElementType è impostato su UxElement, questo elemento contiene un riferimento a un attributo di un elemento dell'interfaccia utente. Se ElementType è impostato su ErrorMessage, questo elemento specifica l'identificatore di un messaggio di errore. Per un elenco completo degli identificatori, vedere ID stringa di UxElement localizzazione.

Tipo di elemento

Riferimento ElementType a un tipo di attestazione, a una trasformazione di attestazione o a un elemento dell'interfaccia utente nei criteri da localizzare.

Elemento da localizzare Tipo di elemento ElementId Stringa Id
Nome provider di identità ClaimsProvider ID dell'elemento ClaimsExchange
Attributi del tipo di attestazione ClaimType Nome del tipo di attestazione Attributo dell'attestazione da localizzare. Valori possibili: AdminHelpText, DisplayNamePatternHelpText, e UserHelpText.
Messaggio di errore ErrorMessage ID del messaggio di errore
Copia le stringhe localizzate in attestazioni GetLocalizedStringsTransformationClaimType Nome dell'attestazione di output
Messaggio utente predicato Predicate Nome del predicato Attributo del predicato da localizzare. Valori possibili: HelpText.
Messaggio utente del gruppo di predicati PredicateValidation ID dell'elemento PredicateValidation. ID dell'elemento PredicateGroup. Il gruppo di predicati deve essere un elemento figlio dell'elemento di convalida del predicato come definito in ElementId.
Elementi dell'interfaccia utente UxElement ID dell'elemento dell'interfaccia utente da localizzare.
Visualizza controllo DisplayControl ID del controllo di visualizzazione. ID dell'elemento dell'interfaccia utente da localizzare.

Esempi

Fornitore di attestazioni

Il valore ClaimsProvider viene usato per localizzare uno dei provider di attestazioni nome visualizzato.

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

Nell'esempio seguente viene illustrato come localizzare il nome visualizzato dei provider di attestazioni.

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

Tipo di richiesta

Il valore ClaimType viene usato per localizzare uno degli attributi dell'attestazione.

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

Nell'esempio seguente viene illustrato come localizzare gli attributi DisplayName, UserHelpText e PatternHelpText del tipo di attestazione di posta elettronica.

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

messaggio di errore

Il valore ErrorMessage viene usato per localizzare uno dei messaggi di errore di sistema.

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

Nell'esempio seguente viene illustrato come localizzare il messaggio di errore UserMessageIfClaimsPrincipalAlreadyExists.

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

FormatLocalizedStringTransformationClaimType

Il valore FormatLocalizedStringTransformationClaimType viene usato per formattare le attestazioni in una stringa localizzata. Per altre informazioni, vedere Trasformazione delle attestazioni 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>

Nell'esempio seguente viene illustrato come localizzare il formato stringa della trasformazione delle attestazioni 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

Il valore GetLocalizedStringsTransformationClaimType viene usato per copiare stringhe localizzate in attestazioni. Per altre informazioni, vedere Trasformazione delle attestazioni 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>

Nell'esempio seguente viene illustrato come localizzare le attestazioni di output della trasformazione delle attestazioni 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>

Predicato

Il valore predicato viene usato per localizzare uno dei messaggi di errore predicato .

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

Nell'esempio seguente viene illustrato come localizzare il testo della Guida dei predicati.

<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

Il valore PredicateValidation viene usato per localizzare uno dei messaggi di errore del gruppo PredicateValidation .

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

Nell'esempio seguente viene illustrato come localizzare un testo della Guida del gruppo di convalida del predicato.

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

Elemento Ux

Il valore UxElement viene usato per localizzare uno degli elementi dell'interfaccia utente. Nell'esempio seguente viene illustrato come localizzare i pulsanti continua e annulla.

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

Controllo schermo

Il valore DisplayControl viene utilizzato per localizzare uno degli elementi dell'interfaccia utente Di controllo di visualizzazione . Se abilitata, il controllo display localizedStrings ha la precedenza su alcuni UxElement StringIDs come ver_but_send, ver_but_edit, ver_but_resend e ver_but_verify. Nell'esempio seguente viene illustrato come localizzare i pulsanti di invio e verifica.

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

Nella sezione Metadati di un profilo tecnico autocertivo, contentDefinition a cui si fa riferimento deve impostare DataUri sul layout di pagina versione 2.1.0 o successiva. Per esempio:

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

Passaggi successivi

Per esempi di localizzazione, vedere gli articoli seguenti: