Partager via

Transformations de revendications StringCollection

Cet article fournit des exemples d’utilisation des transformations de revendications de collection de chaînes du schéma Identity Experience Framework dans Azure Active Directory B2C (Azure AD B2C). Pour plus d’informations, consultez Transformations de revendications.

AddItemToStringCollection

Ajoute une revendication de chaîne à une nouvelle revendication stringCollection de valeurs uniques. Découvrez la démonstration en direct de cette transformation de revendication.

Élément TransformationClaimType Type de données Remarques
InputClaim élément ficelle ClaimType à ajouter à la revendication de sortie.
InputClaim collection stringCollection Collection de chaînes à ajouter à la revendication de sortie. Si la collection contient des éléments, la transformation de revendications copie les éléments et ajoute l’élément à la fin de la revendication de collection de sortie.
OutputClaim collection stringCollection ClaimType généré après l’appel de cette transformation de revendications, avec la valeur spécifiée dans la revendication d’entrée.

Utilisez cette transformation de revendications pour ajouter une chaîne à un stringCollection nouveau ou existant. Il est couramment utilisé dans un profil technique AAD-UserWriteUsingAlternativeSecurityId . Avant la création d’un nouveau compte social, la transformation de revendications CreateOtherMailsFromEmail lit le ClaimType et ajoute la valeur à l’autre ClaimType.

Exemple d’AddItemToStringCollection

La transformation de revendications suivante ajoute le ClaimType d’e-mail à otherMails ClaimType.

<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>
  • Revendications d’entrée :
    • collection : [""someone@outlook.com]
    • item : « admin@contoso.com »
  • Revendications de sortie :
    • collection : [" »someone@outlook.com, « admin@contoso.com"]

AddParameterToStringCollection

Ajoute un paramètre de chaîne à une nouvelle revendication stringCollection de valeurs uniques. Découvrez la démonstration en direct de cette transformation de revendication.

Élément TransformationClaimType Type de données Remarques
InputClaim collection stringCollection Collection de chaînes à ajouter à la revendication de sortie. Si la collection contient des éléments, la transformation de revendications copie les éléments et ajoute l’élément à la fin de la revendication de collection de sortie.
InputParameter élément ficelle Valeur à ajouter à la revendication de sortie.
OutputClaim collection stringCollection ClaimType généré après l’appel de cette transformation de revendications, avec la valeur spécifiée dans le paramètre d’entrée.

Exemple de AddParameterToStringCollection

L’exemple suivant ajoute une adresse e-mail constante (admin@contoso.com) à la revendication 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>
  • Revendications d’entrée :
    • collection : [""someone@outlook.com]
  • Paramètres d’entrée
    • item : « admin@contoso.com »
  • Revendications de sortie :
    • collection : [" »someone@outlook.com, « admin@contoso.com"]

GetSingleItemFromStringCollection

Obtient le premier élément de la collection de chaînes fournie. Découvrez la démonstration en direct de cette transformation de revendication.

Élément TransformationClaimType Type de données Remarques
InputClaim collection stringCollection ClaimTypes utilisés par la transformation de revendications pour obtenir l’élément.
OutputClaim extractedItem ficelle ClaimsTypes générés après l’appel de claimsTransformation. Premier élément de la collection.

Exemple de GetSingleItemFromStringCollection

L’exemple suivant lit la revendication otherMails et retourne le premier élément dans la revendication e-mail .

<ClaimsTransformation Id="CreateEmailFromOtherMails" TransformationMethod="GetSingleItemFromStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="extractedItem" />
  </OutputClaims>
</ClaimsTransformation>
  • Revendications d’entrée :
    • collection : [" »someone@outlook.com, « someone@contoso.com"]
  • Revendications de sortie :
    • extractedItem : « someone@outlook.com »

StringCollectionContains

Vérifie si un type de revendication StringCollection contient un élément. Découvrez la démonstration en direct de cette transformation de revendication.

Élément TransformationClaimType Type de données Remarques
InputClaim inputClaim stringCollection Revendication à rechercher.
InputParameter élément ficelle Valeur à rechercher.
InputParameter ignoreCase ficelle Spécifie si cette comparaison doit ignorer la casse des chaînes comparées.
OutputClaim outputClaim booléen ClaimType généré après l’appel de claimsTransformation. Indicateur booléen si la collection contient une telle chaîne

Exemple de StringCollectionContains

L’exemple suivant vérifie si le roles type de revendication stringCollection contient la valeur de l’administrateur.

<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>
  • Revendications d’entrée :
    • inputClaim : ["reader », « author », « admin"]
  • Paramètres d’entrée :
    • élément : « Admin »
    • ignoreCase : « true »
  • Revendications de sortie :
    • outputClaim : « true »

StringCollectionContainsClaim

Vérifie si un type de revendication StringCollection contient une valeur de revendication. Découvrez la démonstration en direct de cette transformation de revendication.

Élément TransformationClaimType Type de données Remarques
InputClaim collection stringCollection Revendication à rechercher.
InputClaim élément ficelle Type de revendication qui contient la valeur à rechercher.
InputParameter ignoreCase ficelle Spécifie si cette comparaison doit ignorer la casse des chaînes comparées.
OutputClaim outputClaim booléen ClaimType généré après l’appel de claimsTransformation. Indicateur booléen si la collection contient une telle chaîne

Exemple de StringCollectionContainsClaim

L’exemple suivant vérifie si le roles type de revendication stringCollection contient la valeur du role type de revendication.

<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>
  • Revendications d’entrée :
    • collection : ["reader », « author », « admin"]
    • élément : « Admin »
  • Paramètres d’entrée :
    • ignoreCase : « true »
  • Revendications de sortie :
    • outputClaim : « true »

Étapes suivantes

  • Last updated on