Delen via

Transformaties van gehele claims

Belangrijk

Vanaf 1 mei 2025 is Azure AD B2C niet meer beschikbaar voor nieuwe klanten. Meer informatie vindt u in onze veelgestelde vragen.

Dit artikel bevat voorbeelden voor het gebruik van de transformaties van gehele claims van het Identity Experience Framework-schema in Azure Active Directory B2C (Azure AD B2C). Zie ClaimsTransformations voor meer informatie.

Nummer aanpassen

Hiermee verhoogt of verlaagt u een numerieke claim en retourneert u een nieuwe claim. Bekijk de livedemo van deze claimtransformatie.

Onderdeel TransformatieClaimType Gegevenssoort Opmerkingen
Invoer claimen invoerClaim int (integer) Het claimtype, dat het aantal bevat dat moet worden verhoogd of verlaagd. Als de inputClaim claimwaarde null is, wordt de standaardwaarde van 0 gebruikt.
Invoerparameter Operateur touw Mogelijke waarden: INCREMENT (standaard) of DECREMENT.
Uitvoer claimen outputClaim int (integer) Het claimtype dat wordt geproduceerd nadat deze claimtransformatie is aangeroepen.

Voorbeeld van AdjustNumber

Gebruik deze claimtransformatie om een numerieke claimwaarde te verhogen of te verlagen. Met de volgende claimtransformatie wordt een numerieke claimwaarde verhoogd.

<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>
  • Invoerclaims:
    • invoerBewering: 1
  • Invoerparameters:
    • Operator: INCREMENT
  • Uitvoerclaims:
    • outputClaim: 2

Voorbeeld van AdjustNumber met null-waarde

Als de invoerclaim null is, is de uitvoerclaim er een.

  • Invoerclaims:
    • inputClaim: NULL
  • Invoerparameters:
    • Operator: INCREMENT
  • Uitvoerclaims:
    • outputClaim: 1

AssertNumber

Bepaalt of een numerieke claim groter, kleiner, gelijk of niet gelijk is aan een getal. Bekijk de livedemo van deze claimtransformatie.

Onderdeel TransformatieClaimType Gegevenssoort Opmerkingen
Invoer claimen invoerClaim int (integer) De eerste numerieke claim om te vergelijken of deze groter, kleiner, gelijk of niet gelijk is aan het tweede getal. Een null waarde genereert een uitzondering.
Invoerparameter CompareToValue int (integer) Het tweede getal om te vergelijken of het groter, kleiner, gelijk of niet gelijk is aan het eerste getal.
Invoerparameter Operateur touw Mogelijke waarden: LessThan, GreaterThan, GreaterThanOrEqual, LessThanOrEqual, Equal, NotEqual.
Invoerparameter gooien Fout booleaan Hiermee geeft u op of deze bewering een fout moet veroorzaken als het vergelijkingsresultaat is true. Mogelijke waarden: true (standaard) of false.
 
Wanneer deze is ingesteld op true (assertiemodus) en het vergelijkingsresultaat is true, wordt er een uitzondering gegenereerd. Als dit is ingesteld op false (evaluatiemodus), is het resultaat een nieuw booleaanse claimtype met een waarde van true, of false.
Uitvoer claimen outputClaim booleaan Als ThrowError dit is ingesteld falseop, bevat truedeze uitvoerclaim , of false volgens het vergelijkingsresultaat.

Assertiemodus

Wanneer throwError de invoerparameter (standaard) is true , wordt de claimtransformatie AssertNumber altijd uitgevoerd vanuit een validatie technisch profiel dat wordt aangeroepen door een zelf-asserted technisch profiel.

De zelfbeweerte metagegevens van het technische profiel AssertNumberError beheren het foutbericht dat het technische profiel aan de gebruiker presenteert. De foutberichten kunnen worden gelokaliseerd.

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

Zie AssertStringClaimsAreEqual, AssertBooleanClaimIsEqual en AssertDateTimeIsGreaterThan-claimtransformaties voor meer informatie over het aanroepen van de claimtransformatie in een assertiemodus.

Voorbeeld van AssertNumber

In het volgende voorbeeld wordt het aantal pogingen meer dan vijf keer weergegeven. De claimtransformatie genereert een fout volgens het vergelijkingsresultaat.

<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>
  • Invoerclaims:
    • inputClaim: 10
  • Invoerparameters:
    • Operator: GreaterThan
    • Vergelijkingswaarde: 5
    • throwError: waar
  • Resultaat: fout gegenereerd

Voorbeeld van de evaluatiemodus AssertNumber

In het volgende voorbeeld wordt geëvalueerd of het aantal pogingen meer dan vijf is. De uitvoerclaim bevat een Booleaanse waarde volgens het vergelijkingsresultaat. De claimtransformatie genereert geen fout.

<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>
  • Invoerclaims:
    • inputClaim: 10
  • Invoerparameters:
    • Operator: GreaterThan
    • Vergelijkingswaarde: 5
    • throwError: onwaar
  • Uitvoerclaims:
    • outputClaim: waar

ConvertNumberToStringClaim

Converteert een lang gegevenstype naar een tekenreeksgegevenstype. Bekijk de livedemo van deze claimtransformatie.

Onderdeel TransformatieClaimType Gegevenssoort Opmerkingen
Invoer claimen invoerClaim lang Het claimtype dat moet worden geconverteerd naar een tekenreeks.
Uitvoer claimen outputClaim touw Het claimtype dat wordt geproduceerd nadat deze claimtransformatie is aangeroepen.

Voorbeeld van ConvertNumberToStringClaim

In dit voorbeeld wordt de numericUserId claim met een waardetype long geconverteerd naar een UserId claim met een waardetype tekenreeks.

<ClaimsTransformation Id="CreateUserId" TransformationMethod="ConvertNumberToStringClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="UserId" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Invoerclaims:
    • inputClaim: 12334 (lang)
  • Uitvoerclaims:
    • outputClaim: "12334" (tekenreeks)

Volgende stappen

  • Last updated on