Delen via

Claimtransformaties voor gehele getallen

  • Artikel

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

AdjustNumber

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

Element TransformationClaimType Gegevenstype Notities
InputClaim inputClaim int Het claimtype, dat het aantal bevat dat moet worden verhoogd of verlaagd. Als de inputClaim claimwaarde null is, wordt de standaardwaarde 0 gebruikt.
InputParameter Operator tekenreeks Mogelijke waarden: INCREMENT (standaard) of DECREMENT.
OutputClaim outputClaim int 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. De volgende claimtransformatie verhoogt een numerieke claimwaarde.

<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>
  • De invoerclaims:
    • inputClaim: 1
  • De invoerparameters:
    • Operator: INCREMENT
  • De uitvoerclaims:
    • outputClaim: 2

Voorbeeld van AdjustNumber met null-waarde

Als de invoerclaim null is, is de uitvoerclaim er één.

  • De invoerclaims:
    • inputClaim: NULL
  • De invoerparameters:
    • Operator: INCREMENT
  • De uitvoerclaims:
    • outputClaim: 1

AssertNumber

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

Element TransformationClaimType Gegevenstype Notities
InputClaim inputClaim int 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.
InputParameter CompareToValue int Het tweede getal om te vergelijken of het groter, kleiner, gelijk of niet gelijk is aan het eerste getal.
InputParameter Operator tekenreeks Mogelijke waarden: LessThan, GreaterThan, GreaterThanOrEqual, LessThanOrEqual, Equal, . NotEqual
InputParameter throwError booleaans Hiermee geeft u op of deze assertie een fout moet genereren als het vergelijkingsresultaat is true. Mogelijke waarden: true (standaard) of false.
 
Wanneer deze optie 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 de waarde true, of false.
OutputClaim outputClaim booleaans Als ThrowError is ingesteld op false, bevat truedeze uitvoerclaim , of false volgens het vergelijkingsresultaat.

Assertiemodus

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

De zelf-gecontroleerde metagegevens van het technische profiel AssertNumberError bepalen het foutbericht dat het technische profiel aan de gebruiker weergeeft. 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 Claimtransformaties AssertStringClaimsAreEqual, AssertBooleanClaimIsEqual en AssertDateTimeIsGreaterThan voor meer informatie over het aanroepen van de claimtransformatie in een assertiemodus.

Voorbeeld van AssertNumber

In het volgende voorbeeld wordt bevestigd dat het aantal pogingen meer dan vijf is. De claimtransformatie genereert een fout op basis van 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>
  • De invoerclaims:
    • inputClaim: 10
  • De invoerparameters:
    • Operator: GreaterThan
    • CompareToValue: 5
    • throwError: true
  • 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 op basis van 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>
  • De invoerclaims:
    • inputClaim: 10
  • De invoerparameters:
    • Operator: GreaterThan
    • CompareToValue: 5
    • throwError: false
  • Uitvoerclaims:
    • outputClaim: true

ConvertNumberToStringClaim

Converteert een lang gegevenstype naar een tekenreeksgegevenstype. Bekijk de Livedemo van de claimtransformatie.

Element TransformationClaimType Gegevenstype Notities
InputClaim inputClaim long Het claimtype dat moet worden geconverteerd naar een tekenreeks.
OutputClaim outputClaim tekenreeks Het claimtype dat wordt geproduceerd nadat deze claimtransformatie is aangeroepen.

Voorbeeld van ConvertNumberToStringClaim

In dit voorbeeld wordt de numericUserId claim met het 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>
  • De invoerclaims:
    • inputClaim: 12334 (lang)
  • De uitvoerclaims:
    • outputClaim: "12334" (tekenreeks)

Volgende stappen