Freigeben über

Ganzzahlige Anspruchstransformationen

Von Bedeutung

Ab dem 1. Mai 2025 steht Azure AD B2C nicht mehr für neue Kunden zur Verfügung. Weitere Informationen finden Sie in unseren HÄUFIG gestellten Fragen.

Dieser Artikel enthält Beispiele für die Verwendung der ganzzahligen Anspruchstransformationen des Identity Experience Framework-Schemas in Azure Active Directory B2C (Azure AD B2C). Weitere Informationen finden Sie unter ClaimsTransformations.

Anpassen Anzahl

Erhöht oder verkleinert einen numerischen Anspruch und gibt einen neuen Anspruch zurück. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Element TransformationClaimType Datentyp Hinweise
Eingabe-Behauptung inputClaim INT Der Anspruchstyp, der die Zahl enthält, die erhöht oder verkleinert werden soll. Wenn der inputClaim Anspruchswert null ist, wird der Standardwert 0 verwendet.
Eingabeparameter Bediener Schnur Mögliche Werte: INCREMENT (Standard) oder DECREMENT.
OutputClaim (Ausgabeanspruch) outputClaim (Ausschreibung) INT Dies ist der Anspruchstyp, der erstellt wird, nachdem diese Anspruchstransformation aufgerufen wurde.

Beispiel für "AdjustNumber"

Verwenden Sie diese Anspruchstransformation, um einen numerischen Anspruchswert zu erhöhen oder zu verkleinern. Die folgende Anspruchstransformation erhöht einen numerischen Anspruchswert.

<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>
  • Eingabeansprüche:
    • inputAnspruch: 1
  • Eingabeparameter:
    • Operator: INCREMENT
  • Ausgabeansprüche:
    • outputAnspruch: 2

Beispiel für "AdjustNumber" mit NULL-Wert

Wenn der Eingabeanspruch NULL ist, ist der Ausgabeanspruch eins.

  • Eingabeansprüche:
    • inputAnspruch: NULL
  • Eingabeparameter:
    • Operator: INCREMENT
  • Ausgabeansprüche:
    • outputAnspruch: 1

AssertNumber (Bestätigen)

Bestimmt, ob ein numerischer Anspruch größer, kleiner, gleich oder nicht gleich einer Zahl ist. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Element TransformationClaimType Datentyp Hinweise
Eingabe-Behauptung inputClaim INT Der erste numerische Anspruch, der vergleicht, ob es größer, kleiner, gleich oder nicht gleich der zweiten Zahl ist. Ein Null-Wert löst eine Ausnahme aus.
Eingabeparameter CompareToValue INT Die zweite Zahl, die verglichen werden soll, ob sie größer, kleiner, gleich oder nicht gleich der ersten Zahl ist.
Eingabeparameter Bediener Schnur Mögliche Werte: LessThan, GreaterThan, GreaterThanOrEqual, LessThanOrEqual, Equal, NotEqual.
Eingabeparameter throwFehler Boolescher Wert Gibt an, ob diese Assertion einen Fehler auslösen soll, wenn das Vergleichsergebnis lautet true. Mögliche Werte: true (Standard) oder false.
 
Bei Festlegung auf true (Assertionsmodus) und das Vergleichsergebnis wird trueeine Ausnahme ausgelöst. Bei Festlegung auf false (Auswertungsmodus) ist das Ergebnis ein neuer boolescher Anspruchstyp mit einem Wert von true, oder false.
OutputClaim (Ausgabeanspruch) outputClaim (Ausschreibung) Boolescher Wert Wenn ThrowError dieser Ausgabeanspruch auf false festgelegt ist, enthält trueoder false entspricht dem Vergleichsergebnis.

Assertionsmodus

Wenn throwError der Eingabeparameter (Standard) lautet true , wird die AssertionNumber-Anspruchstransformation immer aus einem technischen Überprüfungsprofil ausgeführt, das von einem selbst bestätigten technischen Profil aufgerufen wird.

Die self-asserted technical profile metadata controls the error message that the technical profile presents to the user. Die Fehlermeldungen können lokalisiert werden.

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

Weitere Informationen zum Aufrufen der Forderungstransformation in einem Assertionsmodus finden Sie unter AssertStringClaimsAreEqual, AssertBooleanClaimIsEqualToValue und AssertDateTimeIsGreaterThan-Anspruchstransformationen .

Beispiel für AssertNumber

Im folgenden Beispiel wird bestätigt, dass die Anzahl der Versuche über fünf liegt. Die Anspruchstransformation löst einen Fehler gemäß dem Vergleichsergebnis aus.

<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>
  • Eingabeansprüche:
    • inputAnspruch: 10
  • Eingabeparameter:
    • Operator: GreaterThan
    • VergleichzuWert: 5
    • throwError: true
  • Ergebnis: Fehler wird ausgelöst.

Beispiel für den AssertNumber-Auswertungsmodus

Im folgenden Beispiel wird ausgewertet, ob die Anzahl der Versuche über fünf liegt. Der Ausgabeanspruch enthält einen booleschen Wert gemäß dem Vergleichsergebnis. Die Anspruchstransformation löst keinen Fehler aus.

<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>
  • Eingabeansprüche:
    • inputAnspruch: 10
  • Eingabeparameter:
    • Operator: GreaterThan
    • VergleichzuWert: 5
    • throwError: falsch
  • Ausgabeansprüche:
    • outputAnspruch: wahr

ConvertNumberToStringClaim

Konvertiert einen langen Datentyp in einen Zeichenfolgendatentyp. Sehen Sie sich die Livedemo dieser Anspruchstransformation an.

Element TransformationClaimType Datentyp Hinweise
Eingabe-Behauptung inputClaim lang Der Anspruchstyp, der in eine Zeichenfolge konvertiert werden soll.
OutputClaim (Ausgabeanspruch) outputClaim (Ausschreibung) Schnur Dies ist der Anspruchstyp, der erstellt wird, nachdem diese Anspruchstransformation aufgerufen wurde.

Beispiel für ConvertNumberToStringClaim

In diesem Beispiel wird der numericUserId Anspruch mit einem Werttyp von long in einen UserId Anspruch mit einem Werttyp der Zeichenfolge konvertiert.

<ClaimsTransformation Id="CreateUserId" TransformationMethod="ConvertNumberToStringClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="UserId" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Eingabeansprüche:
    • inputClaim: 12334 (lang)
  • Ausgabeansprüche:
    • outputClaim: "12334" (Zeichenfolge)

Nächste Schritte

  • Last updated on