6. Studio وأدوات التأليف

السابق: نواة React · التالي: نمذجة البيانات

Studio تطبيق مبني فوق النواة

يظهر Studio داخل تطبيق DEVELOPMENT. بعض صفحاته قوائم ونماذج عامة تصف جداول metadata، وبعضها مكونات React متخصصة. وهذا يجعله أفضل مثال على الوصف الذاتي للنظام: النواة تعرض أدوات تعدل تعريفات ستقرأها النواة لاحقًا.

لكن Studio ليس مترجم تطبيق كاملًا، ولا يملك زرًا واحدًا ينشئ التطبيق وينشر كل أجزائه. هو مجموعة أدوات، ولكل أداة عقد حفظ ودورة حياة.

الأنواع الثلاثة للأدوات

في FREEPDB1/AOS_DEV بتاريخ 2026-09-14 احتوت مجموعة قائمة Studio على 27 مدخل شاشة: 16 مدخلًا ظاهرًا و11 مدخلًا غير ظاهر يُفتح كثير منها من مركز أو إجراء. هذه لقطة كتالوج للبيئة المذكورة وليست جردًا لكل شاشة داخل تطبيق DEVELOPMENT. الجرد المثبت.

1. المحررات العامة

تستخدم LIST وFORM وCHILD_LIST لقراءة سجل metadata وكتابته:

التطبيقات.
الكيانات والحقول.
المجالات وقيمها.
عقود البيانات.
الشاشات ومناطقها وحقولها.
الإجراءات ومنفذاتها ومواضعها.
القوائم.
سير العمل وحالاته وانتقالاته.
تدفقات المستندات.
أذونات الحقول.
تجاوزات واجهة المستأجر وتفضيلات المستخدم.
مجموعات التغييرات.

عند الحفظ تمر الكتابة عبر مسار metadata عام، وتفتح أو تغلق changeset بحسب العملية. لا يعني ذلك وجود مرحلة نشر منفصلة لهذا السجل.

2. مراكز التأليف المركبة

تجمع سجلًا رئيسيًا وأبناءه في مساحة واحدة:

مركز التطبيق.
مركز الكيان.
مركز الشاشة.
مركز الإجراء.
مركز سير العمل.

المركز واجهة تنظيم، وليس معاملة موحدة. حفظ حقل، ثم علاقة، ثم موضع شاشة قد ينتج عمليات وchangesets مستقلة حتى لو ظهرت في صفحة واحدة.

3. أدوات متخصصة

لها سير لا يستطيع النموذج العام تقديمه:

معالج الكيان.
مصمم الشاشة.
مصمم دورة الحياة.
مصمم تدفق المستند.
Copilot.
Explain Access.

الخريطة المثبتة لأدوات Studio تميز ما ظهر في قائمة AOS_DEV عن المكونات الموجودة في المصدر فقط.

Studio ليس كل تطبيق DEVELOPMENT

أدوات Studio تؤلف تطبيقًا: التطبيقات والكيانات والشاشات والعقود والإجراءات والقوائم وسير العمل وتدفقات المستندات والتخصيصات ومجموعات التغييرات، ومعها Copilot وExplain Access.

أما مجموعات Tenants وAudit وAutomation وSecurity Administration، وشاشتا «المسند إليّ» و«بانتظار موافقتي»، والعملات وأسعار الصرف، فهي أسطح إدارة منصة أو تشغيل أو أعمال موضوعة أيضًا داخل DEVELOPMENT. وجودها في التطبيق نفسه لا يجعلها أدوات تأليف Studio. حافظ على هذا الفصل عند وصف صلاحيات الفريق أو توسيع القائمة. الحكم F-05.

ماذا يعني «حفظ»؟

ليست للكلمة دلالة واحدة:

الأداة	معنى الحفظ
نموذج metadata عام	كتابة سجل وإغلاق changeset للعملية
مركز مركب	حفظ الجزء الذي عُدل، لا المركز كله
مصمم الشاشة	عدة طلبات، وقد تكون لكل واحدة changeset
مصمم دورة الحياة	عدة كتابات مترابطة مع Undo يعكس المعرفات
معالج الكيان	stage للمسودة، ثم preview، ثم publish
مصمم تدفق المستند	إنشاء تجميعة في changeset واحدة
Copilot	اقتراح أولًا، ثم تطبيق مجموعة عمليات محدودة

إذا فشلت الإيماءة بعد بعض الطلبات، فقد تكون أجزاء سابقة قد حفظت. زر Undo قد يعكس changesets بترتيب عكسي، لكنه لا يحولها بأثر رجعي إلى معاملة Oracle واحدة. معاني الحفظ والمعاينة والنشر.

معالج الكيان

هو أكثر مسار توليد اكتمالًا في Studio.

المدخلات

هوية الكيان وMODULE_CODE.
PK_STRATEGY وتعريف المفتاح.
TENANT_SCOPE_MODE وTENANT_COLUMN_NAME.
الحقول الفيزيائية بأسماء أعمدتها وأنواعها وقيودها، مع الحقول المخصصة أو المحسوبة عند الحاجة.
بعض إعدادات السطح.

الدورة

عرض نص الرسم

stateDiagram-v2
    [*] --> Draft
    Draft --> Staged: حفظ المسودة
    Staged --> Previewed: معاينة الخطة وDDL
    Previewed --> Published: نشر
    Staged --> Discarded: إسقاط
    Previewed --> Discarded: إسقاط

المسودة ليست نسخة تشغيل مستقلة يستطيع مستخدم الأعمال قراءتها ككيان حي. والمعاينة لا تنفذ DDL. والنشر قد يغير المخطط وينشئ تعريفات السطح.

الناتج

بحسب هذه المدخلات، ينتج تخزينًا وعرضًا وعقدًا وشاشتي قائمة ونموذج وقائمة وموارد وإجراءات عامة. ترتبط الأسطح المولدة بصلاحية STUDIO_ADMIN. أما منحة الخطة فلا يصدرها المولد؛ تأتي من بذرة أو مسار تهيئة يستدعي GRANT_SURFACE_TO_PLAN. كذلك لا يصدر PKG_DDL عمود COMPANY_ID، مع أن Architecture Reference §7.3 يوجبه لجداول الأعمال ما لم يوجد ADR صحيح؛ يحتاج المطور إلى ترحيل يدوي أو قرار صالح إلى أن يصلح المولد. لا ينتج المعالج كل منطق التطبيق. الحكم F-04b وF-23.

مصمم الشاشة

يتعامل المصمم مع شبكة مكونات:

رأس الشاشة.
المناطق.
الحقول ومواضعها.
العناصر.
الإجراءات ومواضعها.
الفرز والعلاقات.
أوضاع العرض أو إضافات متخصصة.

يحمل التعريف الحالي، ويبني مسودة واجهة، ثم يرسل عمليات الحفظ. المعاينة تستطيع تركيب التعريف داخل المصمم، لكنها لا تعيد بالضرورة مسار الدخول الطبيعي والاستحقاقات والقائمة نفسها.

عند إضافة منطقة أبناء، لا يكفي اختيار CHILD_LIST؛ يجب ربط المنطقة بعلاقة، وأن يكون للكيان الابن شاشة أو إجراء مناسب. وعند إضافة action، يحتاج تعريفًا وموردًا ومعالجًا قبل أن يصبح زرًا عاملًا. تأليف الشاشة.

مصمم دورة الحياة

يؤلف:

تعريف workflow وربطه بالكيان وحقل الحالة.
الحالات وأعلام الأولية والنهائية والقفل.
الانتقالات واتجاهاتها.
التحقق والتأثير ومتطلبات التعليق أو الشخص الثاني.
الترتيب والتسميات.

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

مصمم تدفق المستند

يصف إنشاء سجل هدف من سجل مصدر:

كيان المصدر والهدف.
خرائط حقول الرأس.
علاقة وخريطة أسطر عند وجودها.
شروط الكمية أو الاستهلاك.
action يشغل التدفق.
موضع action والواصف والموارد والصلاحيات.

على خلاف مصمم الشاشة، ينشئ backend هذه التجميعة في changeset واحدة في المسار المتتبع. التنفيذ اللاحق يستخدم PKG_WORKFLOW لإنشاء الهدف ونسخ القيم وتسجيل الرابط. تدفقات المستند.

Copilot

Copilot يقترح عمليات على قائمة محددة من جداول metadata. يفصل بين:

إنشاء الاقتراح.
مراجعة المطور.
تطبيق حتى الحد المدعوم في changeset.

لا يكتب محرك React أو حزمة PL/SQL من اقتراح metadata. ولا ينبغي قبول الاقتراح لأنه صالح JSON فقط؛ يجب أن تكون الرموز والعلاقات والمنفذات موجودة. حدوده.

Explain Access

هذه أداة قراءة وتشخيص. تأخذ موردًا وسياقًا وتشرح بعض قرارات الإتاحة. فائدتها في رؤية المنح والحكم، لكنها لا تعدل الصلاحيات ولا تختبر كل حارس صف أو كل مسار API. استعملها نقطة تفسير ثم طابقها مع الطلب الفعلي.

changeset

الـchangeset وحدة لتجميع تغييرات metadata وتدقيقها والتراجع عنها. يحمل حالة ونوعًا وفاعلًا وعناصر وصورًا سابقة في المسارات المدعومة.

لا تخلطه مع:

معاملة قاعدة البيانات.
commit في Git.
إصدار تطبيق.
مسودة كيان.
migration مخطط.

قد تحتوي إيماءة UI عدة changesets، وقد يحتوي changeset عمليات متعددة. وتصدير changeset موجود، لكن هذا ليس تصدير تطبيق كامل. دورة التغيير.

التراجع

يعيد التراجع صورًا سابقة لسجلات مدعومة. لا يستطيع بالضرورة:

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

لذلك صمم التراجع لكل أثر، ولا تفترض أن وجود زر Undo يحل كل نتيجة.

ما لا تملكه أدوات Studio المثبتة حاليًا

لم تجد الجولة 14 في قائمة Development المثبتة محررًا مخصصًا لـ:

تعريف التقارير.
قوالب الطباعة.
الترجمات.

توجد محركات وجداول ومسارات لهذه العائلات في المصدر، وقد يسمح الكاتب العام ببعض جداولها، لكن هذا لا يثبت وجود تجربة تأليف مخصصة مكتملة.

كما يعرض مصمم الشاشة النوع DETAIL دون محرك مسجل له. هذا فرق بين خيار واجهة وقدرة تشغيل.

كيف تستخدم Studio بوعي؟

قبل الحفظ:

حدد السجلات التي ستتغير.
اعرف هل العملية طلب واحد أم عدة طلبات.
حدد هل توجد مرحلة publish أم يصبح السجل فعالًا فور الحفظ.
افحص المنفذ الذي سيقرأ التعريف.
افحص المورد والاستحقاق والصلاحية.
افهم أثر الفشل الجزئي وUndo.
اختبر النتيجة عبر المسار الطبيعي، لا المعاينة وحدها.