Egész jogcímek átalakítása

Fontos

2025. május 1-jére az Azure AD B2C már nem lesz elérhető az új ügyfelek számára. További információ a GYIK-ben.

Ez a cikk példákat mutat be az Identity Experience Framework séma egész szám jogcím-átalakításainak használatára a Azure Active Directory B2C (Azure AD B2C). További információ: ClaimsTransformations.

AdjustNumber

Növeli vagy csökkenti a numerikus jogcímet, és új jogcímet ad vissza. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem TransformationClaimType Adattípus Jegyzetek
InputClaim inputClaim Int A jogcím típusa, amely tartalmazza a növelni vagy csökkenteni kívánt számot. Ha a jogcím értéke inputClaim null, a rendszer az alapértelmezett 0 értéket használja.
BemenetiParaméter Operátor szál/zsinór Lehetséges értékek: INCREMENT (alapértelmezett) vagy DECREMENT.
OutputClaim outputClaim Int A jogcímátalakítás meghívása után létrehozott jogcímtípus.

Példa az AdjustNumber-re

Ezzel a jogcímátalakítással növelheti vagy csökkentheti a numerikus jogcím értékét. Az alábbi jogcím-átalakítás növeli a numerikus jogcímértéket.

<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>
  • Bemeneti jogcímek:
    • inputClaim: 1
  • Bemeneti paraméterek:
    • Operátor: NÖVEKMÉNY
  • Kimeneti jogcímek:
    • outputClaim: 2

Példa az AdjustNumber null értékkel rendelkező értékére

Ha a bemeneti jogcím null, a kimeneti jogcím egy lesz.

  • Bemeneti jogcímek:
    • inputClaim: NULL
  • Bemeneti paraméterek:
    • Operátor: NÖVEKMÉNY
  • Kimeneti jogcímek:
    • outputClaim: 1

AssertNumber

Meghatározza, hogy egy numerikus jogcím nagyobb, kisebb, egyenlő vagy nem egyenlő egy számmal. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem TransformationClaimType Adattípus Jegyzetek
InputClaim inputClaim Int Az első numerikus állítás annak összehasonlítására, hogy nagyobb, kisebb, egyenlő vagy nem egyenlő-e a második számmal. A null érték kivételt eredményez.
BemenetiParaméter Összehasonlítás az értékhez Int A második szám annak összehasonlítására, hogy nagyobb, kisebb, egyenlő vagy nem egyenlő-e az első számmal.
BemenetiParaméter Operátor szál/zsinór Lehetséges értékek: LessThan, GreaterThan, GreaterThanOrEqual, LessThanOrEqual, Equal, NotEqual.
BemenetiParaméter throwError Boolean Megadja, hogy ez a helyességi feltétel hibát jelezzen-e, ha az összehasonlítás eredménye true. Lehetséges értékek: true (alapértelmezett) vagy false.
 
Ha a (Helyességi feltétel mód) értékre true van állítva, és az összehasonlítás eredménye , truekivételt ad vissza. Ha (Kiértékelési mód) értékre false van állítva, az eredmény egy új logikai jogcímtípus lesz, amelynek értéke true, vagy false.
OutputClaim outputClaim Boolean Ha ThrowError a következőre van állítva, ez a kimeneti jogcím tartalmazza a következőtfalsetrue, vagy false az összehasonlítási eredmény szerint.

Helyességi feltétel mód

Ha throwError a bemeneti paraméter (truealapértelmezett), az AssertNumber jogcím-átalakítás mindig egy önkiszolgáló technikai profil által meghívott érvényesítési technikai profilból lesz végrehajtva.

Az AssertNumberError önkiszolgáló technikai profil metaadatai azt a hibaüzenetet vezérlik, amelyet a technikai profil jelenít meg a felhasználónak. A hibaüzenetek honosíthatók.

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

További információ a jogcím-átalakítás helyességi feltétel szerinti módban való hívásáról: AssertStringClaimsAreEqual,AssertBooleanClaimIsEqualToValue és AssertDateTimeIsGreaterThan jogcím-átalakítások.

Példa az AssertNumber-re

Az alábbi példa azt állítja, hogy a kísérletek száma meghaladja az ötöt. A jogcím-átalakítás hibát jelez az összehasonlítási eredménynek megfelelően.

<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>
  • Bemeneti jogcímek:
    • inputClaim: 10
  • Bemeneti paraméterek:
    • Operátor: GreaterThan
    • Összehasonlítás értékkel: 5
    • throwError: igaz
  • Eredmény: Hiba történt

Példa az AssertNumber kiértékelési módra

Az alábbi példa azt mutatja be, hogy a kísérletek száma meghaladja-e az ötöt. A kimeneti jogcím az összehasonlítási eredménynek megfelelő logikai értéket tartalmaz. A jogcímek átalakítása nem jelez hibát.

<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>
  • Bemeneti jogcímek:
    • inputClaim: 10
  • Bemeneti paraméterek:
    • Operátor: GreaterThan
    • Összehasonlítás értékkel: 5
    • throwError: hamis
  • Kimeneti jogcímek:
    • outputClaim: igaz

ConvertNumberToStringClaim

Hosszú adattípust sztringadattípussá alakít. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem TransformationClaimType Adattípus Jegyzetek
InputClaim inputClaim hosszú A sztringgé konvertálni kívánt jogcímtípus.
OutputClaim outputClaim szál/zsinór A jogcímátalakítás meghívása után létrehozott jogcímtípus.

Példa a ConvertNumberToStringClaim

Ebben a példában a numericUserId long értéktípusú jogcímet sztring értéktípusúvá alakítja UserId a rendszer.

<ClaimsTransformation Id="CreateUserId" TransformationMethod="ConvertNumberToStringClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="UserId" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Bemeneti jogcímek:
    • inputClaim: 12334 (hosszú)
  • Kimeneti jogcímek:
    • outputClaim: "12334" (karakterlánc)

Következő lépések

  • Last updated on