Partager via

Transformations de revendications entières

Important

À compter du 1er mai 2025, Azure AD B2C ne sera plus disponible pour les nouveaux clients. Pour plus d’informations, consultez notre FAQ.

Cet article fournit des exemples d’utilisation des transformations de revendications entières du schéma Identity Experience Framework dans Azure Active Directory B2C (Azure AD B2C). Pour plus d’informations, consultez ClaimsTransformations.

AjusterNuméro

Augmente ou diminue une revendication numérique et retourne une nouvelle revendication. Découvrez la démonstration en direct de cette transformation de revendication.

Élément TransformationClaimType Type de données Remarques
InputClaim inputClaim Int Type de revendication, qui contient le nombre à augmenter ou à diminuer. Si la inputClaim valeur de revendication est Null, la valeur par défaut 0 est utilisée.
InputParameter Opérateur ficelle Valeurs possibles : INCREMENT (par défaut) ou DECREMENT.
OutputClaim outputClaim Int Type de revendication généré une fois que cette transformation de revendications a été appelée.

Exemple d’AdjustNumber

Utilisez cette transformation de revendication pour augmenter ou diminuer une valeur de revendication numérique. La transformation de revendication suivante augmente une valeur de revendication numérique.

<ClaimsTransformation Id="UpdateSteps" TransformationMethod="AdjustNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="steps" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="INCREMENT" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="steps" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Revendications d’entrée :
    • inputClaim : 1
  • Paramètres d’entrée :
    • Opérateur : INCREMENT
  • Revendications de sortie :
    • outputClaim : 2

Exemple d’AdjustNumber avec une valeur null

Si la revendication d’entrée a la valeur Null, la revendication de sortie en sera une.

  • Revendications d’entrée :
    • inputClaim : NULL
  • Paramètres d’entrée :
    • Opérateur : INCREMENT
  • Revendications de sortie :
    • outputClaim : 1

AssertNumber

Détermine si une revendication numérique est supérieure, inférieure, égale ou non égale à un nombre. Découvrez la démonstration en direct de cette transformation de revendication.

Élément TransformationClaimType Type de données Remarques
InputClaim inputClaim Int Première revendication numérique à comparer si elle est supérieure, inférieure, égale ou non égale au deuxième nombre. Une valeur null lève une exception.
InputParameter CompareToValue Int Deuxième nombre à comparer s’il est supérieur, inférieur, égal ou différent du premier nombre.
InputParameter Opérateur ficelle Valeurs possibles : LessThan, GreaterThan, GreaterThanOrEqual, LessThanOrEqual, Equal, NotEqual.
InputParameter throwError booléen Spécifie si cette assertion doit lever une erreur si le résultat de comparaison est true. Valeurs possibles : true (par défaut) ou false.
 
Lorsque la valeur est définie true sur (mode Assertion) et que le résultat de comparaison est true, une exception est levée. Lorsqu’il est défini false sur (mode Évaluation), le résultat est un nouveau type de revendication booléenne avec une valeur de true, ou false.
OutputClaim outputClaim booléen Si ThrowError elle est définie falsesur , cette revendication de sortie contient trueou false en fonction du résultat de comparaison.

Mode d’assertion

Lorsque throwError le paramètre d’entrée est true (valeur par défaut), la transformation de revendications AssertNumber est toujours exécutée à partir d’un profil technique de validation appelé par un profil technique autodéclaré.

Les métadonnées de profil technique autodéclarées AssertNumberError contrôlent le message d’erreur que le profil technique présente à l’utilisateur. Les messages d’erreur peuvent être localisés.

<TechnicalProfile Id="SelfAsserted-LocalAccountSignin-Email">
  <Metadata>
    <Item Key="AssertNumberError">You've reached the maximum logon attempts</Item>
  </Metadata>
  ...
</TechnicalProfile>

Pour plus d’informations sur l’appel de la transformation de revendications en mode assertion, consultez AssertStringClaimsAreEqual, AssertBooleanClaimIsEqualToValue et AssertDateTimeIsGreaterThan , transformations de revendications.

Exemple de AssertNumber

L’exemple suivant affirme que le nombre de tentatives est supérieur à cinq. La transformation de revendications lève une erreur en fonction du résultat de comparaison.

<ClaimsTransformation Id="isOverLimit" TransformationMethod="AssertNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="attempts" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="GreaterThan" />
    <InputParameter Id="CompareToValue" DataType="int" Value="5" />
    <InputParameter Id="throwError" DataType="boolean" Value="true" />
  </InputParameters>
</ClaimsTransformation>
  • Revendications d’entrée :
    • inputClaim : 10
  • Paramètres d’entrée :
    • Opérateur : GreaterThan
    • CompareToValue : 5
    • throwError : true
  • Résultat : Erreur levée

Exemple de mode d’évaluation AssertNumber

L’exemple suivant évalue si le nombre de tentatives est supérieur à cinq. La revendication de sortie contient une valeur booléenne en fonction du résultat de comparaison. La transformation des revendications ne génère pas d’erreur.

<ClaimsTransformation Id="isOverLimit" TransformationMethod="AssertNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="attempts" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="GreaterThan" />
    <InputParameter Id="CompareToValue" DataType="int" Value="5" />
    <InputParameter Id="throwError" DataType="boolean" Value="false" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="attemptsCountExceeded" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Revendications d’entrée :
    • inputClaim : 10
  • Paramètres d’entrée :
    • Opérateur : GreaterThan
    • CompareToValue : 5
    • throwError : false
  • Revendications de sortie :
    • outputClaim : true

ConvertNumberToStringClaim

Convertit un type de données long en type de données de chaîne. Découvrez la démonstration en direct de cette transformation de revendication.

Élément TransformationClaimType Type de données Remarques
InputClaim inputClaim long Type de revendication à convertir en chaîne.
OutputClaim outputClaim ficelle Type de revendication généré une fois que cette transformation de revendications a été appelée.

Exemple de ConvertNumberToStringClaim

Dans cet exemple, la numericUserId revendication avec un type valeur de long est convertie en UserId revendication avec un type valeur de chaîne.

<ClaimsTransformation Id="CreateUserId" TransformationMethod="ConvertNumberToStringClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="UserId" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Revendications d’entrée :
    • inputClaim : 12334 (long)
  • Revendications de sortie :
    • outputClaim : « 12334 » (chaîne)

Étapes suivantes

  • Last updated on