مشاركة عبر

تحويلات مطالبات العدد الصحيح

  • مقالة

توفر هذه المقالة أمثلة لاستخدام سلسلة تحويلات مطالبات العدد الصحيح لمخطط إطار عمل تجربة الهوية في خدمات مجال Active Directory B2C (Azure AD B2C). لمزيد من المعلومات، راجع «تحويلات المطالبات».

ضبط الرقم

زيادة مطالبة رقمية أو إنقاصها وإرجاع مطالبة جديدة. تحقق من العرض التوضيحي المباشر لتحول هذه المطالبات.

العنصر نوع مطالبة التحول نوع البيانات ملاحظات
InputClaim مطالبة الإدخال int نوع المطالبة، التي تحتوي على الرقم الذي يجب زيادته أو تقليله. إذا كانت inputClaim قيمة المطالبة خالية، يتم استخدام الافتراضي 0.
معلمة الإدخال عامل تشغيل سلسلة القيم المحتملة: INCREMENT(افتراضي)، أو DECREMENT.
مطالبة الإخراج مطالبة الإخراج int تم إبطال نوع المطالبة التي يتم إصدارها بعد تحويل المطالبات هذا.

مثال على AdjustNumber

استخدِم تحويل المطالبة هذا لزيادة قيمة مطالبة رقمية أو إنقاصها. يزيد تحويل المطالبة التالي قيمة المطالبة الرقمية.

<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>
  • مُطالبات الإدخال:
    • مطالبة الإدخال: 1
  • مَعلمات الإدخال:
    • عامل التشغيل: الزيادة
  • مطالبات الإخراج:
    • مطالبة الإخراج: 2

مثال على AdjustNumber مع قيمة فارغة

إذا كانت مطالبة الإدخال خالية، فإن مطالبة الناتج ستكون مطالبة واحدة.

  • مُطالبات الإدخال:
    • مطالبة الإخراج: خال
  • مَعلمات الإدخال:
    • عامل التشغيل: الزيادة
  • مطالبات الإخراج:
    • مطالبة الإخراج: 1

تأكيد الرقم

تحديد ما إذا كانت المطالبة الرقمية أكبر أو أقل أو متساوية أم غير مساوية لرقم. تحقق من العرض التوضيحي المباشر لتحول هذه المطالبات.

العنصر نوع مطالبة التحول نوع البيانات ملاحظات
InputClaim مطالبة الإدخال int المطالبة الرقمية الأولى للمقارنة ما إذا كان أكبر أو أقل أو يساوي أو لا يساوي الرقم الثاني. تطرح القيمة الخالية استثناء.
معلمة الإدخال المقارنة إلى القيمة int المطالبة الرقمية الأولى للمقارنة ما إذا كان أكبر أو أقل أو يساوي أو لا يساوي الرقم الأول.
معلمة الإدخال عامل تشغيل سلسلة القيم الممكنة: LessThan، GreaterThan، GreaterThanOrEqual، LessThanOrEqual، Equal، NotEqual.
معلمة الإدخال throwError منطقي يحدد ما إذا كان هذا التأكيد يجب أن يطرح خطأ إذا كانت نتيجة المقارنة true. القيم المحتملة: true (افتراضي) أو false.
 
عند التعيين إلى true (وضع التأكيد) وتكون نتيجة المقارنة true، سيتم طرح استثناء. عند التعيين إلى false (وضع التقييم)، تكون النتيجة نوع مطالبة منطقية جديدة بقيمة true، أو false.
مطالبة الإخراج outputClaim منطقي إذا ThrowError تم التعيين إلى false، تحتوي مطالبة الإخراج هذه على true، أو false وفقًا لنتيجة المقارنة.

وَضع التأكيد

عندما throwError تكون معلمة الإدخال true (افتراضية)، يتم تنفيذ تحويل مطالبات تأكيد الرقم بشكل دائم من ملف تعريف فني للتحقق من الصحة يسمى بملف تعريف فني مؤكد ذاتيًا.

تتحكم بيانات التعريف الفنية للملف الشخصي المؤكدة ذاتيًا خطأ تأكيد الرقمفي رسالة الخطأ التي يقدمها ملف التعريف الفني إلى المستخدم. يمكن توطين رسائل الخطأ.

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

لمزيد من المعلومات حول كيفية طلب تحويل المطالبات في وضع التأكيد، راجع تحويل مطالبات «تأكيد في أن تكون المطالبات في السلسلة متساوية»و«تأكيد في أن تكون المطالبات المنطقية مساوية للقيمةو «تأكيد أن التاريخ والوقت أكبر من».

مثال على AssertNumber

يؤكّد المثال التالي أن عدد المحاولات يتجاوز خمس محاولات. يؤدي تحويل المطالبات إلى ظهور خطأ وفقاً لنتيجة المقارنة.

<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>
  • مُطالبات الإدخال:
    • مطالبة الإدخال: 10
  • مَعلمات الإدخال:
    • Operator: GreaterThan
    • المقارنة بالقيمة: 5
    • throwError: true
  • النتيجة: تم طرح الخطأ

مثال وضع التقييم AssertNumber

يقيّم المثال التالي ما إذا كان عدد المحاولات أكثر من خمس محاولات. تحتوي مطالبة الإخراج على قيمة منطقية وفقًا لنتيجة المقارنة. تحويل المطالبات لن يطرح خطأ.

<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>
  • مُطالبات الإدخال:
    • مطالبة الإدخال: 10
  • مَعلمات الإدخال:
    • Operator: GreaterThan
    • المقارنة بالقيمة: 5
    • طرح الخطأ: خطأ
  • مطالبات الإخراج:
    • مطالبة الإخراج: صحيح

ConvertNumberToStringClaim

تحويل نوع بيانات طولية إلى نوع بيانات سلسلة. تحقق من العرض التوضيحي المباشر لتحول هذه المطالبات.

العنصر نوع مطالبة التحول نوع البيانات ملاحظات
InputClaim مطالبة الإدخال طويلة نوع المطالبة للتحويل إلى السلسلة.
مطالبة الإخراج outputClaim سلسلة وقد تم استدعاء نوع المطالبة الذي يتم إنتاجه بعد تحويل المطالبات هذا.

مثال على ConvertNumberToStringClaim

في هذا المثال، numericUserId تُحوّل المطالبة ذات نوع قيمة طويلة إلى UserId مطالبة ذات نوع قيمة سلسلة.

<ClaimsTransformation Id="CreateUserId" TransformationMethod="ConvertNumberToStringClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="UserId" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • مُطالبات الإدخال:
    • inputClaim: 12334 (long)
  • مطالبات الإخراج:
    • outputClaim: "12334" (string)

الخطوات التالية

  • يمكنك العثور على المزيد من أمثلة تحويل المطالبات في مستودع GitHub لمجتمع متاجرة عمل-مستهلك في Microsoft Azure Active Directory