أمر الإيداع
يقوم بتحويل التغييرات المعلقة في مساحة العمل الحالية الي التحكم بالإصدار Team Foundation الملقم.
الأذونات المطلوبة.
لاستخدام أمر checkin يجب أن تعين مجموعة الأذونات السحب لـسماح. لاستخدام الخيار /author يجب أن يكون التدقيق في تغييرات مجموعة أذونات المستخدم مظبوطة علي السماح. لمزيد من المعلومات، راجع أذونات خادم أساس الفريق.
tf checkin [/author:author name] [/comment:("comment"|@comment file)]
[/noprompt] [/notes:(“Note Name”=”note text”|@notefile)]
[/override:reasonfile|@reason] [/recursive] [/saved] [/validate]
[itemspec]
المعلمات
الوسيطة |
الوصف |
---|---|
authorname |
القيمة الموفرة بواسطة المستخدم للخيار /author . |
comment |
تعليق موفر بواسطة المستخدم حول الاختيار. |
@comment file |
مسار ملف قام المستخدم بتوفيره بواسطة قرص يحتوي على التعليق من أجل الاختيار . |
NoteFieldName=NoteFieldValue |
يقوم بتعيين قيمة حقل اختيار الملاحظة . يمكنك توفير تعبيرات متعددة من نوع "field=value" مفصولة بفصلة منقوطة . |
Notefile |
مسار ملف قام المستخدم بتوفيره بواسطة قرص يحتوي على أسماء حقول ملحوظة الاختيار والقيم في التنسيق "حقل = قيمة" قرميدة من الملحوظات المفصولة بفصلة منقوطة يمكن ان تمتد عبر عدة خطوط على سبيل المثال: حقل1=القيمة1; الحقل2 = قيمة الذي يمتد خطوط، متعددة |
Reasonfile |
وصف قام المستخدم بتوفيره عن سبب تجاهل سياسة الاختيار. إذا تم تحديد سبب , إعلام النهج يتجاوز ويتم إرسال هذا الشرح للمسؤولين Team Foundation عن طريق البريد الإلكتروني. |
itemspec |
تحديد ملف أو مجلد إلى فحص-في. لمزيد من المعلومات حول كيفية Team Foundationيوزع مواصفات ملف إلى تحديد عناصر التي كانت ضمن نطاقه، راجع خيارات سطر الأوامر. |
الخيار |
الوصف |
---|---|
/author |
يعرّف كاتب التغييرات المعلقة الموصوفة او المطبقة حتى يمكن لمستخدم واحد اختيار التغييرات بالنيابة عن مستخدم آخر. تتطلب إذن CheckinOther. |
/comment |
يقوم بربط تعليق بمجموعة التغيرات . |
/noprompt |
يمنع أي مطالبات إدخال منك. |
/notes |
يوفر واحد أو أكثر من إيداع الملاحظات لإقرانها بمجموعة التغيرات . |
/override |
يتيح لك تجاوز فشل إيداع نهج. هناك حاجة لهذا الخيار فقط عندما يكون هناك نهج إيداع وتريد الإيداع على أية حال. |
/recursive |
يتحقق من كافة العناصر في مجلد العمل المحدد أو الضمني و المجلدات الفرعية. |
/saved |
عند فشل إيداع أو إلغاؤه بواسطة المستخدم أو عند تغيير المستخدم التغييرات, التغييرات المحددة و التعليق ،و عناصر العمل و ملحوظات الاختيار و نهج الاختيار تقوم بتجاوز المنطق إذا وجدت اي منهم مخزن على الكمبيوتر. عند combفيed بواسطة /noprompt، /savedخيار تدقيق في التغييرات مع التعليق، أو ما شابه التي تم حفظها، أي. |
/validate |
الخيار /validate يتيح لك اختبار الإيداع دون القيام به. فعلياً /validateالخيارات يؤدي إيداع إلى تقييم نهج الإيداع التحقق من إيداع الملاحظات وابحث عن التعارضات دون تدقيق بوصة فعلياً يجب حل أية مشاكل، مثل وجود تعارضات، والتي تعرف بهذا خيار من قبل فحص في العنصر. |
ملاحظات
يتكون A المعلقة التغيير من ملف أو إضافة مجلد الحذف، إعادة تسمية أو تحرير, التفرع أو إلغاء حذف أو نوع الملف. يمكن تطبيق بعض التغييرات مثل تحرير و إعادة التسمية, في نفس الوقت علي عنصر واحد. أ معلّقة تغيير هو الذي لم يتم إرسالها للإيداع. لمزيد من المعلومات حول وقائمة كاملة من التغييرات في Team Foundation، راجع المعلقة التغييرات المعلقة.
ينشئ الأمر checkin مجموعة تغيير في الملقم التحكم بالإصدار Team Foundation من مجموعة التغييرات المعلقة المعرفة بشكل حيوي،و عناصر العمل و التعليقات المعرفة من قبل المستخدم و تعريف النظام ويوفر التغييرات للمستخدمين الأخرىين. يمكن للمستخدمين الآخرين استخدام الأمر get لاسترداد التغييرات. الأوامرhistory و changeset تظهر المعلومات الخاصة بالتغييرات التي تم إرسالها.
ملاحظة
لأنه يمكنك إيداع التغييرات المعلقة من سطر الأوامر , فمن الممكن أن قائمة السياق Source Control Explorer لا تكون مزامنة دوماً لحالة التغييرات المعلقة.
للحصول على مزيد من المعلومات حول كيفية العثور على أداة سطر الأوامر TF، راجع TF أداة سطر أوامر.
عملية القيد
عملية الاختيار يتم تنفيذها تلقائيا ، مما يعني أن العملية إما تنجح بشكل كامل أو تفشل بشكل كامل. إذا كان لا يمكن إرسال أي حرف من التغييرات في قائمة التغييرات المعلقة الي الملقم التحكم بالإصدار Team Foundation ، لا يتم تسليم أحد التغييرات كما لا يتم إنشاء changeset. على سبيل المثال، إذا فقدت الاتصال بالشبكة في منتصف العملية, تفشل العملية باكملها.
الخطوة الأولى في عملية الاختيار هي تقييم التغييرات المعلقة للتوافق مع نُهج الاختيار . يمكنك تجاوز فشل النهج عند سطر الأوامر باستخدام الخيار" /override . يجب توفير سبب لماذا تتجاوز نهج الفشل . يستمر هذا السبب في الملقم التحكم بالإصدار Team Foundation ويصبح سمة في مجموعة التغيرات. الخيار /override بشكل أساسي مخصص للاستخدام في البرامج النصية. لمزيد من المعلومات، راجع كيفية: تجاوز نهج "تدقيق.
إذا كانت هناك نسخة من عنصر في قائمة التغييرات المعلقة يختلف عن أحدث نسخة للملقم التحكم بالإصدار Team Foundation Team Foundation يطالبك اولا بحل التعارضات بين الإصدار الخاص بك و أحدث إصدار للملقم التحكم بالإصدار Team Foundation . على سبيل المثال، إذا قمت باختبار الإصدار 4 stellar.cs و أحدث إصدار للملقم التحكم بالإصدار Team Foundationو هو الآن الإصدار 6 فستتم مطالبتك بحل التعارضات. ما لم يتم تحديد الخيار **/noprompt ** ، يظهر مربع حوار حل للمساعدة في التحقق من حل الاختلافات الخاصة بالإصدار. بعد حل الاختلافات و اعادة اختبار التعليمات البرمجية يمكنك محاولة إيداع التغييرات مرة أخرى.
أمثلة
يعرض المثال التالي مربع الحوار الخاص بالإيداع الذي يحتوي على تغييرات معلقة محددة سابقًا لعملية ايداع كبيرة الحجم لكافة التغييرات في مساحة العمل في c:\projects. إذا قمت بالنقر فوق إيداع ، يتم إرسال كل عنصر بشكل فردي إلى مجموعة التغيرات في الملقم التحكم بالإصدار Team Foundation و تقييمها للتأكد من أن إصدار الملقم التحكم بالإصدار Team Foundation لم يتم تغييره لأن العنصر تم اختباره . إذا تمت عملية الايداع بنجاح Team Foundation ينشئ changeset ويعرض رقمه للمراجعة لاحقا.
c:\projects>tf checkin
يقوم المثال التالي بإرسال كافة التغييرات المعلقة في مساحة العمل الحالية إلى الملقم التحكم بالإصدار Team Foundation مع التعليق المحدد لإنشاء changeset جديدة.
c:\projects>tf checkin /comment:"Re-implemented Pi calculator" /noprompt
يقوم المثال التالي بإرسال التغييرات المعلقة الي 314. cs ويترك كافة المراجعات الأخرى في مساحة العمل الحالية باسم معلقة.
c:\projects>tf checkin 314.cs /noprompt
راجع أيضًا:
المهام
الإرشادات التفصيلية: تخصيص نُهج التدقيق في وملاحظات
كيفية: إيداع التغييرات المعلقة
المرجع
بناء جملة سطر الأوامر (التحكم بالإصدار)