Egész jogcímátalakítások
Ez a cikk példákat tartalmaz az Identity Experience Framework séma egész számú jogcímátalakításának használatára az Azure Active Directory B2C-ben (Azure AD B2C). További információt a ClaimsTransformations (Jogcímátalakítások) című témakörben talál.
AdjustNumber
Növeli vagy csökkenti a numerikus jogcímeket, é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 a növelni vagy csökkenteni kívánt számot tartalmazza. Ha a inputClaim jogcím értéke null, a rendszer a 0 alapértelmezett értékét használja. |
InputParameter | Operátor | sztring | 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 a AdjustNumberre
Ezzel a jogcímátalakítással növelheti vagy csökkentheti a numerikus jogcímértékeket. Az alábbi jogcímátalakítás növeli a numerikus jogcím értékét.
<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 Igazító számra null értékkel
Ha a bemeneti jogcím null értékű, 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ő-e 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 jogcím, amely összehasonlítja, hogy nagyobb, kisebb, egyenlő vagy nem egyenlő-e, mint a második szám. A null érték kivételt jelez. |
InputParameter | CompareToValue | int | A második szám, amely összehasonlítja, hogy nagyobb, kisebb, egyenlő vagy nem egyenlő-e, mint az első szám. |
InputParameter | Operátor | sztring | Lehetséges értékek: LessThan , GreaterThan , GreaterThanOrEqual , LessThanOrEqual , Equal , . NotEqual |
InputParameter | throwError | boolean | Meghatározza, hogy a helyesség hibát jelez-e, ha az összehasonlítás eredménye .true Lehetséges értékek: true (alapértelmezett) vagy false . Ha a (Helyességi mód) értékre true van állítva, és az összehasonlítás eredménye , true a rendszer kivételt ad. Ha a (Kiértékelési mód) értékre false van állítva, az eredmény egy új logikai jogcímtípus, amelynek értéke true , vagy false . |
OutputClaim | outputClaim | boolean | Ha ThrowError a értékre false van állítva, akkor ez a kimeneti jogcím tartalmazza true a értéket, vagy false az összehasonlítási eredménynek megfelelően. |
Helyességi mód
Ha throwError
a true
bemeneti paraméter (alapértelmezett), az AssertNumber jogcímek átalakítása mindig egy önaláírt műszaki profil által meghívott érvényesítési műszaki profilból történik.
Az AssertNumberError önérvényesített műszaki profil metaadatai vezérli azt a hibaüzenetet, amelyet a műszaki profil a felhasználónak jelenít meg. 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>
A jogcímátalakítások helyességi módban való meghívásáról további információt az AssertStringClaimsAreEqual, a AssertBooleanClaimIsEqualToValue és az AssertDateTimeIsGreaterThan jogcímátalakítások című témakörben talál.
Példa AssertNumberre
Az alábbi példa azt állítja, hogy a kísérletek száma meghaladja az ötöt. A jogcímek átalakítása hibát jelez az összehasonlítás eredményének 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
- CompareToValue: 5
- throwError: true
- Eredmény: Hiba történt
Példa Az AssertNumber kiértékelési módjára
Az alábbi példa kiértékeli, hogy a kísérletek száma meghaladja-e az ötöt. A kimeneti jogcím az összehasonlítási eredménynek megfelelően logikai értéket tartalmaz. A jogcímek átalakítása nem okoz 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
- CompareToValue: 5
- throwError: false
- Kimeneti jogcímek:
- outputClaim: true
ConvertNumberToStringClaim
Hosszú adattípust sztring adattípussá alakít át. Tekintse meg a jogcímátalakítás élő bemutatóját .
Elem | TransformationClaimType | Adattípus | Jegyzetek |
---|---|---|---|
InputClaim | inputClaim | hosszú | A sztringgé konvertálandó jogcímtípus. |
OutputClaim | outputClaim | sztring | A jogcímátalakítás meghívása után létrehozott jogcímtípus. |
Példa a ConvertNumberToStringClaim függvényre
Ebben a példában a numericUserId
hosszú értéktípusú jogcímet a rendszer érték típusú sztringgel UserId
rendelkező jogcímké alakítja.
<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" (sztring)
Következő lépések
- További jogcímátalakítási minták keresése a Azure AD B2C-közösség GitHub-adattárában