إنشاء قوالب مصدر البيانات وإدارتها

نظرة عامة

صفحة Data Source Templates هي المحور المركزي لإدارة جميع القوالب في بيئة Validatar الخاصة بك. من هنا يمكنك إنشاء قوالب جديدة من الصفر، واستيراد قوالب من ملفات أو من Validatar Marketplace، وتصدير قوالب لمشاركتها مع بيئات أخرى، وإدارة دورة حياة القوالب الحالية.

انتقل إلى Settings > Data Source Templates للوصول إلى قائمة القوالب.

قائمة القوالب

تعرض قائمة القوالب جميع القوالب في بيئتك مع معلومات أساسية بلمحة سريعة:

من القائمة يمكنك:

• New — إنشاء قالب فارغ
• Open — تعديل قالب موجود
• Activate / Deactivate — تبديل ما إذا كان القالب متاحًا للاستخدام
• Export — تنزيل قالب كملف XML
• Import — تحميل قالب من ملف XML

إنشاء قالب جديد

انقر على New لفتح محرر القالب مع علامة تبويب General فارغة. تصبح علامات التبويب الأخرى (Data Types، Defaults، Metadata Ingestion، Profiling، Macros) متاحة بعد حفظ الإعداد الأولي.

حقول علامة تبويب General

فئات الاتصال (Connection Categories)

تحدد فئة الاتصال السلوك الأساسي للقالب — لا سيما كيفية عمل استيعاب البيانات الوصفية والتنميط:

فواصل المعرّفات (Identifier Delimiters)

تُخبر الفواصل Validatar كيفية وضع علامات اقتباس على أسماء الكائنات (المخططات، الجداول، الأعمدة) عند بناء استعلامات SQL لهذه المنصة. من المهم ضبطها بشكل صحيح — الفواصل غير الصحيحة تسبب أخطاء صياغة في سكربتات الاستيعاب، واستعلامات التنميط، وتنفيذ الاختبارات.

تصدير القوالب

يحزم التصدير (Export) قالبًا وجميع مكوناته (أنواع البيانات، سكربتات الاستيعاب، تعريفات التنميط، الـ macros، المعاملات) في ملف XML واحد. هذا مفيد في:

• مشاركة القوالب بين بيئات Validatar (مثل التطوير → الإنتاج)
• أخذ نسخة احتياطية من قالب يعمل قبل إجراء تغييرات جوهرية عليه
• النشر في Validatar Marketplace

للتصدير، اختر قالبًا في القائمة وانقر على Export. اختر ما تريد تضمينه في التصدير واحفظ الملف.

استيراد القوالب

يقوم الاستيراد (Import) بتحميل قالب من ملف XML. يمكن أن يكون هذا قالبًا صدّرته من بيئة أخرى أو قالبًا تم تنزيله من Validatar Marketplace.

للاستيراد:

1. 1انقر على Import في صفحة قائمة القوالب
2. 2اختر ملف XML
3. 3راجع معاينة الاستيراد — تُظهر ما سيتم إنشاؤه أو تحديثه
4. 4أكّد الاستيراد

إذا كان هناك قالب موجود بالفعل بنفس الاسم، يعرض مربع حوار الاستيراد التعارضات ويتيح لك تحديد كيفية التعامل معها (استبدال، إعادة تسمية، أو تخطي).

الاستيراد من Marketplace

يوفّر Validatar Marketplace قوالب جاهزة للمنصات الشائعة. للعثور على قالب في Marketplace واستيراده:

1. 1قم بزيارة Validatar Marketplace (يمكن الوصول إليه من داخل التطبيق أو من موقع Validatar)
2. 2تصفح أو ابحث عن القوالب حسب اسم المنصة
3. 3قم بتنزيل ملف XML الخاص بالقالب
4. 4استخدم وظيفة Import في صفحة Data Source Templates لتحميله

تأتي قوالب Marketplace مُهيَّأة مسبقًا بسكربتات استيعاب، وتخطيطات أنواع بيانات، وتعريفات تنميط، وmacros محسّنة للمنصة المستهدفة. بعد الاستيراد، راجع الإعداد واضبط أي إعدادات تناسب بيئتك الخاصة (مثل فلاتر المخططات، الـ macros المخصصة).

إدارة دورة حياة القالب

التفعيل والتعطيل

تعطيل قالب (Deactivating) يخفيه من واجهة إعداد الاتصال — لن يتمكن المستخدمون من اختياره عند إعداد اتصالات جديدة. الاتصالات الحالية التي تستخدم القالب بالفعل تستمر في العمل بشكل طبيعي.

هذا مفيد عند تطوير قالب جديد وليس جاهزًا بعد لاستخدام الآخرين له، أو عند التخلص التدريجي من قالب لصالح إصدار أحدث.

العلاقة بين القوالب وأنواع الاتصال

العلاقة بين القوالب وأنواع الاتصال هي علاقة متعددة إلى متعددة (many-to-many):

• يمكن لقالب واحد أن يخدم عدة أنواع اتصال (مثل قالب ODBC عام قد يعمل مع عدة أنواع اتصال)
• يمكن لنوع اتصال واحد أن يحتوي على عدة قوالب متاحة (مثل نوع اتصال Snowflake قد يحتوي على قوالب لإعدادات Snowflake مختلفة)

عندما يكون "Restrict Engines" مفعّلًا على نوع اتصال، تظهر فقط القوالب المرتبطة صراحةً بذلك النوع في القائمة المنسدلة أثناء إعداد الاتصال. وعند تعطيله، تتوفر جميع القوالب النشطة ضمن نفس فئة الاتصال.

أفضل الممارسات

• إصدار قوالبك (Version) — استخدم حقل الإصدار لتتبع التغييرات بمرور الوقت. يساعد ذلك في استكشاف الأخطاء وإصلاحها وعند إبلاغ فريقك بالتغييرات
• الاختبار قبل التفعيل — أنشئ القالب، واضبط جميع علامات التبويب، واختبره مع مصدر بيانات واحد قبل تفعيله للاستخدام العام
• التصدير قبل التعديل — قم دائمًا بتصدير نسخة احتياطية من قالب يعمل قبل إجراء تغييرات جوهرية على سكربتات الاستيعاب، أو التنميط، أو الـ macros
• استخدام تسمية متسقة — اعتمد اصطلاح تسمية يوضح المنصة والإصدار والغرض من كل قالب (مثل "Snowflake - Data Vault 2.0"، "PostgreSQL 15 - Standard")

كيف يندرج هذا ضمن الصورة الأكبر

إنشاء قالب هو الخطوة الأولى لتمكين Validatar من العمل مع منصة بيانات جديدة. بمجرد وجود القالب، يمكنك إنشاء اتصالات تستخدمه، وبناء مصادر بيانات على تلك الاتصالات، واستيعاب البيانات الوصفية، وتشغيل التنميط، وتوليد الاختبارات — كل ذلك باستخدام الإعداد الذي يوفّره القالب.

تتناول المقالات التالية في هذا القسم كل علامة تبويب في محرر القالب بالتفصيل: Data Types، Default Parameters and Execution Scripts، Metadata Ingestion، Profiling، وMacros.

للحصول على رؤية شاملة لكيفية قيادة القوالب لدورة حياة مصدر البيانات بالكامل، راجع Data Source Templates: The Complete Picture.