شحن البيانات الأولية مع الحل
الهدف
اجعل السجلات التي يحتاجها الحل — بيانات مرجعية، صفوف تكوين، مجموعة عيّنة — تسافر داخل حزمة الحل، بحيث يترك استيراد الحل في بيئة فارغة البيئةَ جاهزةً للاستخدام لا جاهزةً للتعبئة.
المتطلبات المسبقة
- أنت مسجَّل الدخول بدور صانع (أو مدير المنصة).
- الجدول الذي ينبغي أن تسافر سجلاته مكوِّن من مكوّنات الحل، والسجلات موجودة في البيئة التي تصدّر منها.
الخطوات
- افتح الجدول في الجداول وانتقل إلى علامة التبويب العروض.
- اختر جديد لفتح مصمم العروض.
- أدخل اسم عرض — مثلًا
العتبات التي تُشحن— واسمًا منطقيًا بعد بادئة الناشر، مثلًاapproval_threshold_seed. - اضبط نوع العرض على البيانات الأولية.
واختر في نوع الصفوف ما هي الصفوف:
- إعدادات: صفوف يحتاجها الحل ليعمل، مثل حدود الموافقة. يجلبها كل استيراد، حتى في Production.
- عرض توضيحي: صفوف تعرّف بالحل، مثل عملاء مختلَقين. لا يجلبها الاستيراد إلا حين يُطلب، ولا تذهب أبداً إلى Production.
- اسحب إلى رأس الجدول كل حقل ينبغي أن يسافر. اترك ما يخص هذه البيئة لا السجل — مبلغًا ملتزمًا به، تاريخ آخر تشغيل، عدّادًا.
- أضف مرشِّحًا إذا كان ينبغي أن يسافر بعض السجلات فقط — مثلًا الحالة تساوي نشط. بلا مرشِّح، تسافر كل السجلات.
- اختر حفظ.
- صدِّر الحل من صفحة الحلول. تحمل الحزمة الآن وثيقة بيانات أولية واحدة للجدول، تضم السجلات التي أعادها العرض.
- استورد الحزمة في بيئة أخرى. تأتي صفوف الإعدادات معها. وإن كانت تحمل صفوف عرض توضيحي، يسألك الاستيراد أولاً: ضع علامة على تضمين بيانات العرض التوضيحي لجلبها. عند انتهاء الاستيراد تخبرك رسالة بعدد السجلات التي أُنشئت، وعدد ما حُدِّث، وتسمّي أي سجل تم تخطيه، وتذكر كم صفاً توضيحياً تُرك.
الإعدادات تأتي دائماً؛ ا لعرض التوضيحي حين يُطلب فقط
يحدد خيار نوع الصفوف في عرض البيانات الأولية ما يفعله الاستيراد بالصفوف.
| إعدادات | عرض توضيحي | |
|---|---|---|
| ما هي | ما يحتاجه الحل ليعمل: حدود، مناطق، إعدادات يقرؤها نص برمجي | ما يعرّف بالحل: عملاء مختلَقون، سنة من السجل النموذجي |
| الاستيراد | يجلبها دائماً | لا يجلبها إلا بتحديد تضمين بيانات العرض التوضيحي |
| Production | نعم | أبداً: الخانة معطّلة، والمنصة ترفضها |
لا يصل العرض التوضيحي أبداً إلى Production لأن الصفوف المستوردة هناك تقع بين سجلات عملائك دون ما يميزها، ولا يزيلها إلغاء تثبيت الحل. وتصل الإعدادات دائماً لأن البيئة التي تفتقدها لا تعمل.
اختر إعدادات فقط للصفوف المتطابقة في كل مكان يعمل فيه الحل. الصف الذي تعدّله بيئة لنفسها يُستبدل عند الاستيراد التالي.
ما الذي يحدث خلف الكواليس
عرض البيانات الأولية لا يُعرض على أحد أبدًا: إنه سؤال يطرحه التصدير. يجيب مرشِّحه عن أي السجلات، وتجيب أعمدته عن أي الحقول. الجدول الذي له عدة عروض من هذا النوع يستخدم العرض المعلَّم افتراضيًا، وإلا فالأول بترتيب الاسم المنطقي.
يسافر كل سجل مع معرِّفه، ويقوم الاستيراد بالإدراج أو التحديث بحسب ذلك المعرِّف: السجل الذي لا يملكه الهدف يُنشأ بالمعرِّف نفسه؛ والسجل الذي يملكه بالفعل يُحدَّث في الأعمدة المحزومة فقط ويحتفظ بكل قيمة أخرى. لا يُحذف شيء أبدًا. ولأن المعرِّف واحد في كل بيئة، يمكن لسجل أولي أن يشير إلى سجل أولي آخر — بند ميزانية إلى برنامجه — ويكتب الاستيراد الجداول بالترتيب الصحيح لينجح ذلك. أما البحث الذي يشير إلى صف من الجدول نفسه فيُملأ بعد أن توجد كل الصفوف.
يمر كل سجل عبر مسار كتابة السجلات المعتاد: يُتحقق منه مقابل الجدول، ويُنسب إلى الاستيراد، ويُفحص مقابل عمليات البحث في الهدف، وتعمل عليه خطوات الإضافات المسجَّلة على الجدول — بما فيها خطوة جلبها الحل نفسه.
ما لا يفعله سجل البيانات الأولية هو بدء عملية أعمال. العملية التي تبدأ عند إنشاء سجل تدور حول قيام شخص بإنشائه؛ أما سجل البيانات الأولية فهو صورة الحل للجدول كما تُرك — طلب سبقت الموافقة عليه، وآخر سبق رفضه. لو أُطلقت العملية لكل سجل في الحزمة لبدأ تشغيل لكل سجل، ولأعادت الخطوة الأولى في العملية نفسها كتابة الحالة التي شُحن بها السجل. ويعني ذلك أيضًا أن السجل الذي زُرع بحالة «قيد الانتظار» لا مهمة خلفه: الحزمة تحمل سجلات لا عمليات تشغيل. إن احتاج العرض إلى مهمة حيّة، فأنشئ سجلًا في البيئة المستوردة — ذاك هو الذي يُوجَّه.
السجل الذي يرفضه الهدف — غالبًا بحث يشير إلى سجل لا يملكه الهدف — يُتخطى ويُسمّى، بالجدول والمعرِّف والسبب، بدلًا من إفشال الاستيراد. فالجداول والنماذج والعروض تكون قد وصلت عندئذ، واستيراد يفشل بسبب صف واحد يترك البيئة نصف مستوردة.
بعض الأشياء لا تسافر عمدًا: المالك (المستخدمون لكل مستأجر)، وطوابع الإنشاء والتعديل وإصدار الصف (فهي للهدف)، وأعمدة الملفات والصور (بايتاتها في البيئة المصدر). أما أعمدة الترقيم التلقائي فيولّدها الهدف.
حل المشكلات
- يقول الاستيراد إن سجلًا تم تخطيه. اقرأ السبب — هو الجملة نفسها التي كان النموذج سيعرضها. بحثٌ يشير إلى سجل غير موجود يعني أن الهدف يفتقر إلى صف افترضته الحزمة؛ أضف سجلات ذلك الجدول إلى الحزمة، أو السجل إلى الهدف.
- سجل عدّلته في الهدف تم استبداله. هذا ما تفعله إعادة الاستيراد: الأعمدة المحزومة ملك للحل. أبقِ القيم الخاصة بالبيئة خارج أعمدة عرض البيانات الأولية.
- يرفض التصدير برسالة «يعيد N صفًا». تحمل الحزمة على الأكثر 10,000 صف لكل جدول. ضيّق مرشِّح العرض — البيانات الأولية بيانات مرجعية لا تاريخ — أو حمِّل الصفوف باستيراد CSV بدلًا من ذلك.
- لم يسافر شيء. تحقق من أن نوع العرض هو البيانات الأولية وأنه على جدول يحتويه الحل. وإن كانت صفوفه عرضاً توضيحياً، فتحقق من تحديد تضمين بيانات العرض التوضيحي عند الاستيراد.
- خانة تضمين بيانات العرض التوضيحي رمادية. البيئة بيئة Production، وبيانات العرض التوضيحي لا تُستورد إليها أبداً. أما صفوف الإعدادات فتأتي.
- لم تصل إلى Production صفوف يحتاجها الحل. عرض البيانات الأولية الخاص بها عرض توضيحي. غيّره إلى إعدادات، وصدّر الحل مجدداً، واستورده.
- إلغاء تثبيت الحل ترك الصفوف. صفوف الجدول الذي يملكه الحل تذهب مع الجدول. أما الصفوف التي أضافها إلى جدول يعود لحل آخر فتبقى، لأن الجدول يبقى.