مسرد Salesforce DevOps

Metadata API

واجهة برمجة تطبيقات Salesforce لاسترجاع ونشر تكوين المؤسسة، وهي الأساس الذي تُبنى عليه تقريبًا كل أداة DevOps.

التعريف

Metadata API هي واجهة برمجة تطبيقات Salesforce القائمة على SOAP لاسترجاع ونشر وإنشاء وحذف التكوين (البيانات الوصفية) الذي يحدد مؤسسة ما، أشياء مثل الكائنات المخصصة والحقول والتدفقات وفئات Apex والتخطيطات، على عكس السجلات (البيانات) التي تحملها تلك الكائنات. إنها الأساس الذي تُبنى عليه تقريبًا كل أداة Salesforce DevOps: تستدعي Salesforce CLI وchange sets وأدوات النشر من جهات خارجية جميعها في النهاية عمليات Metadata API لنقل التكوين بين المؤسسات.

يمكن التحقق من صحة عمليات النشر عبر Metadata API (وضع التحقق فقط) قبل تشغيلها فعليًا، وتدعم التغييرات التدميرية عبر بيان مخصص يبقى منفصلًا عما يُنشر. وبما أنها مدفوعة ببيان XML، تتطلب عمليات النشر ملف package.xml دقيقًا يسرد كل نوع مكوّن واسمه المُدرج.

يُعد البيان السيئ أو غير المكتمل أحد أكثر أسباب فشل عمليات نشر Salesforce شيوعًا، لأن أي شيء متروك خارج القائمة يُتخطى ببساطة بدلًا من الإشارة إليه. يغطي دليل Salesforce DevOps الخاص بنا كيفية اندماج عمليات نشر Metadata API في خط أنابيب نشر كامل.

من واقع الاستخدام

إزاي بيشتغل في Serpent

يستخدم Serpent استدعاءات Metadata API القياسية لكل عملية نشر، دون أي أثر مثبَّت في مؤسستك، ويبني بيان الحزمة تلقائيًا من المكوّنات التي لمستها المهمة فعليًا، بحيث لا يوجد ملف package.xml يُصان يدويًا للحفاظ على تزامنه. تقرأ ميزات مقارنة المؤسسات والمزامنة حالة البيانات الوصفية عبر المؤسسات المسودة والإنتاج للإشارة إلى الانحراف قبل تشغيل عملية النشر، ما يلتقط التعارضات التي لن تحذرك منها Metadata API وحدها. راجع إدارة المؤسسات في Serpent لمعرفة كيف تعمل مقارنة البيانات الوصفية عبر بيئاتك.

إعدادات تكامل Git في Serpent
أسئلة شائعة

Metadata API، تمت الإجابة

ما الفرق بين Metadata API وواجهة برمجة التطبيقات القياسية لـ Salesforce؟
تقرأ وتكتب واجهة REST أو SOAP القياسية السجلات، أي البيانات داخل كائناتك. أما Metadata API فتقرأ وتكتب التكوين الذي يحدد تلك الكائنات، مثل الحقول والتدفقات وفئات Apex.
هل يمكنني التحقق من صحة عملية نشر عبر Metadata API دون نشرها فعليًا؟
نعم، تُجري عمليات النشر في وضع التحقق فقط نفس عمليات التحقق، بما في ذلك اختبارات Apex، دون تنفيذ أي تغييرات في المؤسسة الهدف. إنها الطريقة القياسية لاكتشاف الإخفاقات قبل عملية نشر حقيقية.
لماذا نجحت عملية نشر Metadata API الخاصة بي لكنها استبعدت مكوّنًا؟
غالبًا ما يكون السبب ملف package.xml غير مكتمل. تلمس Metadata API فقط ما هو مُدرج في البيان، لذا يُتخطى المكوّن غير المُدرج بصمت بدلًا من الإشارة إليه كخطأ.

ابدأ مجانًا. بلا بطاقة ائتمان، بلا تثبيت، بلا التزام.

الإعداد في أقل من 15 دقيقة. لا حاجة لتوظيف DevOps.

هل تريد معرفة كيف يمكنكم الشحن أسرع قبل البدء؟ لنتحدث

بدون التزام.