Comparteix a través de

Transformaciones de notificaciones StringCollection

  • Article

En este artículo se proporcionan ejemplos para usar las transformaciones de notificaciones de la colección de cadenas del esquema de Identity Experience Framework en Azure Active Directory B2C (Azure AD B2C). Para más información, consulte Transformaciones de notificaciones.

AddItemToStringCollection

Agrega una notificación de cadena a una nueva notificación stringCollection de valores únicos. Consulte la demo en vivo de esta transformación de notificaciones.

Elemento TransformationClaimType Tipo de datos Notas
InputClaim Elemento string Elemento ClaimType que se agregará a la notificación de salida.
InputClaim collection stringCollection El colección de cadena que se agregará a la notificación de salida. Si la colección contiene elementos, la transformación de notificaciones copia los elementos y agrega el elemento al final de la notificación de la colección de salida.
OutputClaim collection stringCollection Valor ClaimType que se genera después de que se haya invocado a esta transformación de notificaciones, con el valor especificado en la notificación de entrada.

Use esta transformación de notificaciones para agregar una cadena a una clase stringCollection nueva o existente. Se usa normalmente en un perfil técnico AAD-UserWriteUsingAlternativeSecurityId. Antes de crear una nueva cuenta de redes sociales, la transformación de notificaciones CreateOtherMailsFromEmail lee el ClaimType y agrega el valor al ClaimType otherMails.

Ejemplo de AddItemToStringCollection

La siguiente transformación de notificaciones agrega el ClaimType email al ClaimType otherMails.

<ClaimsTransformation Id="CreateOtherMailsFromEmail" TransformationMethod="AddItemToStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="item" />
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>
  • Notificaciones de entrada:
    • collection: ["someone@outlook.com"]
    • item: "admin@contoso.com"
  • Notificaciones de salida:
    • collection: ["someone@outlook.com", "admin@contoso.com"]

AddParameterToStringCollection

Agrega un parámetro de cadena a una nueva notificación stringCollection de valores únicos. Consulte la demo en vivo de esta transformación de notificaciones.

Elemento TransformationClaimType Tipo de datos Notas
InputClaim collection stringCollection El colección de cadena que se agregará a la notificación de salida. Si la colección contiene elementos, la transformación de notificaciones copia los elementos y agrega el elemento al final de la notificación de la colección de salida.
InputParameter Elemento string El valor que se agregará a la notificación de salida.
OutputClaim collection stringCollection El valor ClaimType que se genera después de que se haya invocado esta transformación de notificaciones, con el valor especificado en el parámetro de entrada.

Ejemplo de AddParameterToStringCollection

En el ejemplo siguiente se agrega una dirección de correo electrónico constante (admin@contoso.com) a la notificación otherMails.

<ClaimsTransformation Id="SetCompanyEmail" TransformationMethod="AddParameterToStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="item" DataType="string" Value="admin@contoso.com" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>
  • Notificaciones de entrada:
    • collection: ["someone@outlook.com"]
  • Parámetros de entrada
    • item: "admin@contoso.com"
  • Notificaciones de salida:
    • collection: ["someone@outlook.com", "admin@contoso.com"]

GetSingleItemFromStringCollection

Obtiene el primer elemento de la colección de la cadena proporcionada. Consulte la demo en vivo de esta transformación de notificaciones.

Elemento TransformationClaimType Tipo de datos Notas
InputClaim collection stringCollection ClaimTypes que usa la transformación de notificaciones para obtener el elemento.
OutputClaim extractedItem string Elementos ClaimTypes que se producen después de que se invoque este elemento ClaimsTransformation. El primer elemento de la colección.

Ejemplo de GetSingleItemFromStringCollection

En el ejemplo siguiente se lee la notificación otherMails y se devuelve el primer elemento de la notificación de correo electrónico.

<ClaimsTransformation Id="CreateEmailFromOtherMails" TransformationMethod="GetSingleItemFromStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="extractedItem" />
  </OutputClaims>
</ClaimsTransformation>
  • Notificaciones de entrada:
    • collection: ["someone@outlook.com", "someone@contoso.com"]
  • Notificaciones de salida:
    • extractedItem: "someone@outlook.com"

StringCollectionContains

Comprueba si un tipo de notificación StringCollection contiene un elemento. Consulte la demo en vivo de esta transformación de notificaciones.

Elemento TransformationClaimType Tipo de datos Notas
InputClaim inputClaim stringCollection La notificación que se va a buscar.
InputParameter item string Valor que se va a buscar.
InputParameter ignoreCase string Especifica si la comparación distingue entre mayúsculas y minúsculas en las cadenas que se están comparando.
OutputClaim outputClaim boolean El valor ClaimType que se genera después de que se haya invocado esta ClaimsTransformation. Indicador booleano si la colección contiene una cadena de este tipo.

Ejemplo de StringCollectionContains

En el siguiente ejemplo se comprueba si el tipo de notificación stringCollection roles contiene el valor admin.

<ClaimsTransformation Id="IsAdmin" TransformationMethod="StringCollectionContains">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="roles" TransformationClaimType="inputClaim"/>
  </InputClaims>
  <InputParameters>
    <InputParameter  Id="item" DataType="string" Value="Admin"/>
    <InputParameter  Id="ignoreCase" DataType="string" Value="true"/>
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="isAdmin" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>
  • Notificaciones de entrada:
    • inputClaim: ["reader", "author", "admin"]
  • Parámetros de entrada:
    • item: "Admin"
    • ignoreCase: "true"
  • Notificaciones de salida:
    • outputClaim: "true"

StringCollectionContainsClaim

Comprueba si un tipo de notificación StringCollection contiene un valor de notificación. Consulte la demo en vivo de esta transformación de notificaciones.

Elemento TransformationClaimType Tipo de datos Notas
InputClaim collection stringCollection La notificación que se va a buscar.
InputClaim item string Tipo de notificación que contiene el valor que se va a buscar.
InputParameter ignoreCase string Especifica si la comparación distingue entre mayúsculas y minúsculas en las cadenas que se están comparando.
OutputClaim outputClaim boolean El valor ClaimType que se genera después de que se haya invocado esta ClaimsTransformation. Indicador booleano si la colección contiene una cadena de este tipo.

Ejemplo de StringCollectionContainsClaim

En el siguiente ejemplo se comprueba si el tipo de notificación del elemento stringCollection roles contiene el valor del tipo de notificación role.

<ClaimsTransformation Id="HasRequiredRole" TransformationMethod="StringCollectionContainsClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="roles" TransformationClaimType="collection" />
    <InputClaim ClaimTypeReferenceId="role" TransformationClaimType="item" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="ignoreCase" DataType="string" Value="true" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="hasAccess" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Notificaciones de entrada:
    • collection: ["reader", "author", "admin"]
    • item: "Admin"
  • Parámetros de entrada:
    • ignoreCase: "true"
  • Notificaciones de salida:
    • outputClaim: "true"

Pasos siguientes