البيان

البيان هو ملف XML تقرأه Metadata API لمعرفة المكوّنات التي يجب أن تلمسها عملية ما. يسرد package.xml ما يجب استرجاعه أو نشره؛ ويسرد destructiveChangesPre.xml وdestructiveChangesPost.xml ما يجب إزالته، قبل بقية عملية النشر أو بعدها. أي شيء غير مذكور في البيان يبقى دون تغيير، لذا فإن الإدخال المفقود هو فجوة صامتة وليس خطأً. تتطلب أدوات تنسيق البيانات الوصفية، مثل Ant Migration Tool الأقدم واستدعاءات Metadata API الخام، بيانًا لكل عملية؛ بينما يمكن لأدوات تنسيق المصدر المبنية حول sfdx-project.json استنتاج ما يجب استرجاعه أو نشره من بنية المجلدات بدلًا من ذلك، رغم أنه لا يزال يُولَّد بيان في الخلفية لاستدعاء API الفعلي. صيانة بيان يدويًا لكل إصدار هي مصدر شائع للمكوّنات المفقودة مع توسّع فريق ما إلى ما بعد بيئتين أو ثلاث. راجع دليل إدارة البيانات الوصفية الخاص بنا لمعرفة كيف تتخطى الفرق عادةً البيانات اليدوية.