Bagikan melalui

Transformasi klaim bilangan bulat

Penting

Berlaku mulai 1 Mei 2025, Azure AD B2C tidak akan lagi tersedia untuk dibeli untuk pelanggan baru. Pelajari lebih lanjut di FAQ kami.

Artikel ini menyediakan contoh untuk menggunakan transformasi klaim bilangan bulat dari skema Identity Experience Framework di Azure Active Directory B2C (Azure AD B2C). Untuk informasi selengkapnya, lihat ClaimsTransformations.

Sesuaikan Nomor

Meningkatkan atau mengurangi klaim numerik dan mengembalikan klaim baru. Lihat demo Langsung dari transformasi klaim ini.

Elemen TransformationClaimType Jenis Data Catatan
Klaim Masukan inputKlaim int (integer) Jenis klaim, yang berisi jumlah yang akan ditingkatkan atau dikurangi. inputClaim Jika nilai klaim null, default 0 digunakan.
Parameter Masukan Pengoperasi benang Nilai yang mungkin: INCREMENT (default), atau DECREMENT.
Klaim Keluaran outputKlaim int (integer) Jenis klaim yang dihasilkan setelah transformasi klaim ini telah dipanggil.

Contoh AdjustNumber

Gunakan transformasi klaim ini untuk meningkatkan atau mengurangi nilai klaim numerik. Transformasi klaim berikut meningkatkan nilai klaim numerik.

<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>
  • Klaim input:
    • masukanKlaim: 1
  • Parameter input:
    • Operator: KENAIKAN
  • Klaim output:
    • outputKlaim: 2

Contoh AdjustNumber dengan nilai null

Jika klaim input null, klaim output akan menjadi satu.

  • Klaim input:
    • inputClaim: NULL
  • Parameter input:
    • Operator: KENAIKAN
  • Klaim output:
    • outputKlaim: 1

Angka Tegaskan

Menentukan apakah klaim numerik lebih besar, lebih kecil, sama, atau tidak sama dengan angka. Lihat demo Langsung dari transformasi klaim ini.

Elemen TransformationClaimType Jenis Data Catatan
Klaim Masukan inputKlaim int (integer) Klaim numerik pertama untuk membandingkan apakah itu lebih besar, lebih kecil, sama, atau tidak sama dengan angka kedua. Nilai null memberikan pengecualian.
Parameter Masukan Bandingkan Dengan Nilai int (integer) Angka kedua untuk membandingkan apakah itu lebih besar, lebih kecil, sama, atau tidak sama dengan angka pertama.
Parameter Masukan Pengoperasi benang Nilai yang mungkin: LessThan, GreaterThan, GreaterThanOrEqual, LessThanOrEqual, Equal, NotEqual.
Parameter Masukan throwError Boolean Menentukan apakah pernyataan ini harus melemparkan kesalahan jika hasil perbandingan adalah true. Nilai yang mungkin: true (default), atau false.
 
Ketika diatur ke true (Mode pernyataan), dan hasil perbandingannya adalah true, pengecualian akan dilemparkan. Ketika diatur ke false (Mode evaluasi), hasilnya adalah jenis klaim boolean baru dengan nilai true, atau false.
Klaim Keluaran outputKlaim Boolean Jika ThrowError diatur ke false, klaim output ini berisi true, atau false sesuai dengan hasil perbandingan.

Mode pernyataan

Ketika throwError parameter input adalah true (default), transformasi klaim AssertNumber selalu dijalankan dari profil teknis validasi yang dipanggil oleh profil teknis yang dinyatakan sendiri.

Metadata profil teknis assertNumberError yang ditegaskan sendiri mengontrol pesan kesalahan yang disajikan profil teknis kepada pengguna. Pesan kesalahan dapat dilokalisasi.

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

Untuk informasi selengkapnya cara memanggil transformasi klaim dalam mode pernyataan, lihat Transformasi klaim AssertStringClaimsAreEqual, AssertBooleanClaimIsEqualToValue, dan AssertDateTimeIsGreaterThan .

Contoh AssertNumber

Contoh berikut menegaskan jumlah upaya lebih dari lima. Transformasi klaim melemparkan kesalahan sesuai dengan hasil perbandingan.

<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>
  • Klaim input:
    • masukanKlaim: 10
  • Parameter input:
    • Operator: GreaterThan
    • BandingkanKenilai: 5
    • throwError: true
  • Hasil: Kesalahan diberikan

Contoh mode evaluasi AssertNumber

Contoh berikut mengevaluasi apakah jumlah upaya lebih dari lima. Klaim output berisi nilai boolean sesuai dengan hasil perbandingan. Transformasi klaim tidak akan melemparkan kesalahan.

<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>
  • Klaim input:
    • masukanKlaim: 10
  • Parameter input:
    • Operator: GreaterThan
    • BandingkanKenilai: 5
    • throwError: false
  • Klaim output:
    • outputClaim: benar

ConvertNumberToStringClaim

Mengonversi jenis data panjang menjadi jenis data string. Lihat demo Langsung dari transformasi klaim ini.

Elemen TransformationClaimType Jenis Data Catatan
Klaim Masukan inputKlaim panjang Jenis klaim untuk dikonversi ke string.
Klaim Keluaran outputKlaim benang Jenis klaim yang dihasilkan setelah transformasi klaim ini telah dipanggil.

Contoh ConvertNumberToStringClaim

Dalam contoh ini, numericUserId klaim dengan jenis nilai panjang dikonversi ke UserId klaim dengan jenis nilai string.

<ClaimsTransformation Id="CreateUserId" TransformationMethod="ConvertNumberToStringClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="UserId" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Klaim input:
    • inputClaim: 12334 (panjang)
  • Klaim output:
    • outputClaim: "12334" (string)

Langkah selanjutnya

  • Last updated on