Definición de transformaciones de notificaciones de número de teléfono en Azure AD B2C

Importante

A partir del 1 de mayo de 2025, Azure AD B2C ya no estará disponible para la compra por parte de nuevos clientes. Obtenga más información en nuestras preguntas más frecuentes.

En este artículo se proporcionan referencias y ejemplos para usar las transformaciones de notificaciones de número de teléfono en la directiva personalizada de Azure Active Directory B2C (Azure AD B2C). Para obtener más información sobre las transformaciones de notificaciones en general, vea ClaimsTransformations.

Nota:

Esta característica está en versión preliminar pública.

ConvertPhoneNumberClaimToString

Convierte un phoneNumber tipo de datos en un string tipo de datos. Consulte la demo en vivo de esta transformación de notificaciones.

Elemento	TransformationClaimType	Tipo de datos	Notas
InputClaim	número de teléfono	número de teléfono	Notificación que se va a convertir en una cadena.
OutputClaim (Reclamo de salida)	phoneNumberString	cuerda / cadena	Notificación que se genera después de que se haya invocado esta transformación de notificaciones.

Ejemplo de ConvertPhoneNumberClaimToString

En este ejemplo, la notificación cellPhoneNumber con un tipo de valor de phoneNumber se convierte en una notificación cellPhone con un tipo de valor de string.

<ClaimsTransformation Id="PhoneNumberToString" TransformationMethod="ConvertPhoneNumberClaimToString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="cellPhoneNumber" TransformationClaimType="phoneNumber" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="cellPhone" TransformationClaimType="phoneNumberString" />
  </OutputClaims>
</ClaimsTransformation>

Notificaciones de entrada:
- phoneNumber: +11234567890 (phoneNumber)
Notificaciones de salida:
- phoneNumberString: +11234567890 (cadena)

ConvertStringToPhoneNumberClaim

Valida el formato de un número de teléfono. Si es válido, cámbielo a un formato estándar usado por Azure AD B2C. Si el número de teléfono proporcionado no tiene un formato válido, se devuelve un mensaje de error. Consulte la demo en vivo de esta transformación de notificaciones.

Elemento	TransformationClaimType	Tipo de datos	Notas
InputClaim	phoneNumberString	cuerda / cadena	Notificación de cadena para el número de teléfono. El número de teléfono debe estar en formato internacional, completo con un código de país o región "+" inicial. Si se proporciona la notificación `country` de entrada, el número de teléfono está en formato local (sin el código de país o región).
InputClaim	país	cuerda / cadena	[Opcional] La notificación de cadena para el código de país o región del número de teléfono en ISO3166 formato (el código de país o región ISO-3166 de dos letras).
OutputClaim (Reclamo de salida)	outputClaim	número de teléfono	Resultado de esta transformación de notificaciones.

La transformación de notificaciones ConvertStringToPhoneNumberClaim siempre se ejecuta desde un perfil técnico de validación al que llama un perfil técnico autoafirmado o un control de visualización. Los metadatos del perfil técnico autoafirmado UserMessageIfClaimsTransformationInvalidPhoneNumber controlan el mensaje de error que se presenta al usuario.

Diagrama de la ruta de acceso de ejecución del mensaje de error

Ejemplo de ConvertStringToPhoneNumberClaim

En el ejemplo siguiente se comprueba que la notificación phoneString es realmente un número de teléfono válido y, a continuación, devuelve el número de teléfono en el formato estándar de Azure AD B2C. De lo contrario, se produce un mensaje de error.

<ClaimsTransformation Id="ConvertStringToPhoneNumber" TransformationMethod="ConvertStringToPhoneNumberClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="phoneString" TransformationClaimType="phoneNumberString" />
    <InputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="country" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

Notificaciones de entrada:
- phoneNumberString: 033 456-7890
- país: DK
Notificaciones de salida:
- outputClaim: +450334567890

Ejemplo de convertStringToPhoneNumberClaim sin notificación de código de país

Consulte la demostración en vivo de este modo de transformación de notificaciones.

Notificaciones de entrada:
- phoneNumberString: +1 (123) 456-7890
Notificaciones de salida:
- outputClaim: +11234567890

Llamada a la transformación de notificaciones ConvertStringToPhoneNumberClaim

El perfil técnico autoafirmado que llama al perfil técnico de validación que contiene esta transformación de notificaciones puede definir el mensaje de error.

<TechnicalProfile Id="SelfAsserted-LocalAccountSignUp-Phone">
  <Metadata>
    <Item Key="UserMessageIfClaimsTransformationInvalidPhoneNumber">Custom error message if the phone number is not valid.</Item>
  </Metadata>
  ...
</TechnicalProfile>

GetNationalNumberAndCountryCodeFromPhoneNumberString

Extrae el código de país o región y el número nacional de la notificación de entrada y, opcionalmente, produce una excepción si el número de teléfono proporcionado no es válido. Consulte la demo en vivo de esta transformación de notificaciones.

Elemento	TransformationClaimType	Tipo de datos	Notas
InputClaim	número de teléfono	cuerda / cadena	Notificación de cadena del número de teléfono. El número de teléfono debe estar en formato internacional, completo con un código de país o región "+" inicial.
InputParameter	throwExceptionOnFailure	booleano	[Opcional] Parámetro que indica si se produce una excepción cuando el número de teléfono no es válido. El valor predeterminado es Falso.
InputParameter	countryCodeType	cuerda / cadena	[Opcional] Parámetro que indica el tipo de código de país o región en la notificación de salida. Los valores disponibles son CallingCode (el código de llamada internacional para un país o región, por ejemplo +1) o ISO3166 (el código de país o región ISO-3166 de dos letras).
OutputClaim (Reclamo de salida)	nationalNumber	cuerda / cadena	Notificación de cadena para el número nacional del número de teléfono.
OutputClaim (Reclamo de salida)	countryCode	cuerda / cadena	Notificación de cadena para el código de país o región del número de teléfono.

Si la transformación de notificaciones GetNationalNumberAndCountryCodeFromPhoneNumberString se ejecuta desde un perfil técnico de validación al que llama un perfil técnico autoafirmado o una acción de control de visualización, los metadatos del perfil técnico autoafirmado UserMessageIfPhoneNumberParseFailure controlan el mensaje de error que se presenta al usuario.

Diagrama de la ruta de acceso de ejecución del mensaje de error

Puede usar esta transformación de notificaciones para dividir un número de teléfono completo en el código de país o región y el número nacional. Si el número de teléfono proporcionado no es válido, puede elegir iniciar un mensaje de error.

Ejemplo de GetNationalNumberAndCountryCodeFromPhoneNumberString

En el ejemplo siguiente se intenta dividir el número de teléfono en el número nacional y el código de país o región. Si el número de teléfono es válido, el número de teléfono se reemplazará por el número nacional. Si el número de teléfono no es válido, no se producirá una excepción y el número de teléfono seguirá teniendo su valor original.

<ClaimsTransformation Id="GetNationalNumberAndCountryCodeFromPhoneNumberString" TransformationMethod="GetNationalNumberAndCountryCodeFromPhoneNumberString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="phoneNumber" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="throwExceptionOnFailure" DataType="boolean" Value="false" />
    <InputParameter Id="countryCodeType" DataType="string" Value="ISO3166" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="nationalNumber" TransformationClaimType="nationalNumber" />
    <OutputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="countryCode" />
  </OutputClaims>
</ClaimsTransformation>

Notificaciones de entrada:
- teléfono: +49 (123) 456-7890
Parámetros de entrada:
- throwExceptionOnFailure: false
- countryCodeType: ISO3166
Notificaciones de salida:
- nacionalNúmero: 1234567890
- countryCódigo: DE

Ejemplo de GetNationalNumberAndCountryCodeFromPhoneNumberString con el parámetro CallingCode

En el ejemplo siguiente se intenta dividir el número de teléfono en el número nacional y el código de llamada de país.

<ClaimsTransformation Id="GetNationalNumberAndCountryCodeFromPhoneNumberString" TransformationMethod="GetNationalNumberAndCountryCodeFromPhoneNumberString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="phoneNumber" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="throwExceptionOnFailure" DataType="boolean" Value="false" />
    <InputParameter Id="countryCodeType" DataType="string" Value="CallingCode" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="nationalNumber" TransformationClaimType="nationalNumber" />
    <OutputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="countryCode" />
  </OutputClaims>
</ClaimsTransformation>

Notificaciones de entrada:
- teléfono: +49 (123) 456-7890
Parámetros de entrada
- throwExceptionOnFailure: false
- countryCodeType: CallingCode
Notificaciones de salida:
- nacionalNúmero: 1234567890
- countryCódigo: +49

Llamar a la transformación de notificaciones GetNationalNumberAndCountryCodeFromPhoneNumberString