فئات قاعدة الحقل: قواعد الافتراضيات، والمؤهلات، والقائمة، والإجراء، و الشروط
يمكنك استخدام قواعد الحقل التالية لتغيير سلوك حقل.
<REQUIRED />
هذا الحقل لا يمكن أن يكون فارغ. يمكنك وضع علامة على أي نوع حقل لجعله مطلوباً. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر REQUIRED (مخطط تعريف نوع عنصر عمل).
<READONLY />
هذا الحقل لا يمكن تعديله. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر READONLY (مخطط تعريف لنوع صنف عمل).
<EMPTY />
هذا الحقل تُمسح قيمته عند الإيداع ولا يمكن للمستخدم إدخال أي قيمة. يتم استخدام هذه القاعدة بشكل أساسي أثناء انتقال الحالة لمسح الحقول التي تنطبق على لحالة التي تم الانتقال إليها. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر EMPTY (مخطط تعريف لنوع عنصر العمل).
<FROZEN/>
بمجرد أن يحتوي الحقل على قيمة بعد الإيداع، لن يصبح تعديلها ممكناً. ومع ذلك، يمكن مسح هذا الحقل باستخدام القيد <EMPTY/>. يمكن للمستخدم مسح الحقل يدويًا، و حفظ عنصر العمل ثم القيام بتحديد قيمة مختلفة عند إعادة التحميل. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصرتجميد (مخطط تعريف نوع عنصر العمل).
<CANNOTLOSEVALUE/>
بعد أن يحتوي حقل ما على قيمة، لن يمكن مسحها أو إزالتها. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر CANNOTLOSEVALUE (مخطط تعريف نوع عنصر العمل).
<NOTSAMEAS field="MyCorp.Reviewer" />
هذا الحقل لا يمكن أن يحتوي على نفس القيمة التي يحتوي عليها حقل آخر؛ و هو في هذه الحالة الحقل "MyCorp.Reviewer". يجب أن تكون قيمة الحقل "اسم مرجع" حقل صالح. لمزيد من المعلومات، راجع اصطلاحات التسمية لكائنات متابعة عناصر العمل.
أمثلة على استخدام قاعدة الحقل NOTSAMEAS:
لا يمكن أن يكون هناك حقلين فارغين في نفس الوقت.
لا يمكن ان تتطابق قيمة الحقل "مراجع التعليمات البرمجية" وقيمة الحقل "معين إلى".
استخدم هذه القاعدة على الحقول من نوع "مثل". لا يمكن استخدامها في الحقول من نوع PlainText أو HTML. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر NOTSAMEAS (مخطط تعريف نوع عنصر العمل).
<VALIDUSER group="group" />
هذا الحقل يجب أن يكون مستخدم صالح، وعضو في المجموعة مستخدمي أساس الفريق الصالحين.
تدعم هذه القاعدة سمة المجموعة الاختيارية الخاصة بتحديد وجوب كون المستخدم عضواً بشكل مباشر أو غير مباشر في المجموعة المحددة. افتراضياً، تقوم هذه القاعدة بتمكين كافة المستخدمين الأعضاء في مجموعة مستخدمي أساس الفريق الصالحين. لمزيد من المعلومات، راجع استخدام الرموز المميزة للإشارة للمستخدمين والمجموعات. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر VALIDUSER (مخطط تعريف نوع عنصر العمل).
ملاحظة
إذا كانت القاعدة <REQUIRED/> غير محددة، فإن هذا الحقل سيقبل قيمة فارغة. يستخدم في الحقول من نوع "سلسلة حرفية".
ملاحظة
لا تقوم حقول عناصر العمل بالتمييز بين هويات المستخدمين من نطاقات مختلفة. لذلك، يعامل "Example1\jaepak" و "Example2\jaepak" على أنهما نفس المستخدم عند إدخالها في حقل يستخدم القاعدة < VALIDUSER / >. ومع ذلك، يتم تمييز هويات المستخدمين بواسطة النطاق في مكان آخر في Team Foundation Server.
<ALLOWEXISTINGVALUE/>
يسمح لحقل بالاحتفاظ بقيمة موجودة حتى إذا لم تعد تلك القيمة متاحة. السلوك البديل و الافتراضي هو أن يفرض على المستخدم، في وقت التحرير، التأكد من تطابق أحدث القيم المتاحة لهذا الحقل. هذا العنصر له تأثير تعديل فقط على العناصر في نفس الكتلة. هذا صواب لا يمكن قبول for أو not سمات. لمزيد من المعلومات، راجع عنصر السماح بقيمة موجودة (مخطط تعريف نوع عنصر عمل).
<ALLOWEDVALUES/>
قائمة تعداد للقيم التي يتم تقديمها للمستخدم في صورة قائمة. يجب أن يختار المستخدمين إحدى القيم الموجودة في هذه القائمة. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر ALLOWEDVALUES (مخطط تعريف نوع عنصر العمل).
<SUGGESTEDVALUES/>
قائمة تعداد للقيم التي يتم تقديمها للمستخدم في صورة قائمة. يمكن أن يقوم المستخدمون بتحديد أياً من القيم. يمكن للمستخدمين أيضًا إدخال القيمة الخاصة بهم والتي ليست ضمن الاقتراحات. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر SUGGESTEDVALUES (مخطط تعريف نوع عنصر العمل).
< PROHIBITEDVALUES / >
لا يمكن للمستخدمين حفظ عنصر عمل إذا احتوى الحقل على أي قيم ممنوعة. تستخدم القيم الممنوعة عادةً عندما تصبح قيمة كان مسموح بها مسبقاً غير صالحة من الآن فصاعدا. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر PROHIBITEDVALUES (تعريف مخطط نوع عنصر العمل).
<DEFAULT>
عندما يقوم مستخدم بتحرير عنصر عمل أو يقوم بإنشاء عنصر عمل جديد، يقوم العنصر < DEFAULT > بتعبئة قيمة حقل إذا كان هذا الحقل فارغاً. إذا كان الحقل له قيمة بالفعل، يتم تجاهل القاعدة الافتراضية. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع العنصر الافتراضى (مخطط تعريف نوع عنصر العمل).
ملاحظة
عند تغيير عنصر عمل، فإن قاعدة العنصر هذه تعتبر غير محددة بالنظر إلى اختيار القيمة الحالية أو السابقة من حقل آخر.
<COPY>
عندما يقوم مستخدم بتغيير عنصر عمل أو إنشاء عنصر عمل جديد، يقوم العنصر <COPY> بتعبئة قيمة حقل بغض النظر عن أي قيمة موجودة بالفعل في الحقل. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر COPY (مخطط تعريف نوع عنصر العمل).
ملاحظة
عند تغيير عنصر عمل، فإن قاعدة العنصر هذه تعتبر غير محددة بالنظر إلى اختيار القيمة الحالية أو السابقة من حقل آخر.
<SERVERDEFAULT>
بعكس <DEFAULT> و <COPY>، والتي تقوم بتعبئة القيم في بداية التحرير، فإن قاعدة < SERVERDEFAULT > تقوم بتعبئة القيمة عند إيداع عنصر العمل بقاعدة البيانات. يحدث هذا عند لحظة الحفظ و لا يمكن للمستخدم تجاوز هذه القيمة. تظهر هذه الحقول للقراءة فقط في النموذج. يتم استخدام هذه القاعدة للحقول مثل "آخر تغيير بواسطة" و "آخر تغيير في" لدعم ملحقات التدقيق آمنة. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر SERVERDEFAULT (مخطط تعريف نوع عنصر العمل).
<MATCH pattern="<pattern>"/>
تقوم بفرض مطابقة الأنماط الأساسية للسلاسل الحرفية فقط.. يجب استبدال <pattern> بالنمط المراد مطابقته. القيم الصحيحة هي "A" و "N" و "X". يتم أخذ كافة القيم الأخرى كقيم الحرفية. " "يمثل حرف أبجدي. " ل"يمثل حرف رقمية. " يمثل X"أي حرف أبجدي رقمي. هذا النمط مدعوم فقط للحقول من نوع سلسلة حرفية. يقبل هذا العنصر السمات for و not. لمزيد من المعلومات، راجع عنصر MATCH (مخطط تعريف نوع عنصر العمل).
أمثلة لمطابقة الأنماط
توضح الأمثلة التالية المطابقات الناجحة وغير الناجحة لمجموعة متنوعة من استخدامات الحقل.
رقم الإصدار
النمط: ANN.NN.NN
تحقق من صحة |
R01.03.04 أو V05.08.99 |
فشل في التحقق من صحة |
1.3.4 أو V5.8.99 أو v1.3 |
معرف مرن
النمط: XXX-XXX
تحقق من صحة |
001-abc أو a00-b02 |
فشل في التحقق من صحة |
1-abc أو 001.abc |
الأولوية
النمط: PN
تحقق من صحة |
P1 أو P5 أو P9 |
فشل في التحقق من صحة |
1 أو P10 |
علامات المطابقة غير حساسة لحالة الأحرف، حتى تطابق "PN" كلاً من P1 و p1.
ملاحظة
يمكنك تحديد عدة عناصر < MATCH >. في حال نجاح عنصر واحد على الأقل، فإن الحقل يحتوي على قيمة صالحة.