هيكل الوحدة

1C: المؤسسة 8.2 /
للمطورين /
اتفاقيات الاتفاقيات

جدول المحتويات

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

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

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

1.2. أقسام القالب (فارغة للنسخ) للوحدات النمطية الشائعة:

////////////////////////////////////////////////// ////////////////////////////// // // // //////////// ////////////////////////////////////////////////// ////////////// //////////////////////////////////// //////////////////////////////////////////// // // SOFTWARE INTERFACE // ////////////////////////////////////////////////// //////////////////////////// // إجراءات الخدمة ووظائفها

• يحتوي القسم "واجهة البرنامج" على إجراءات ووظائف التصدير المعدة للاستخدام من قبل كائنات التكوين الأخرى أو البرامج الأخرى (على سبيل المثال ، من خلال اتصال خارجي).
• يحتوي قسم "إجراءات المساعدة والوظائف" على الإجراءات والوظائف التي تشكل التنفيذ الداخلي لوحدة نمطية مشتركة. في الحالات التي تكون فيها الوحدة النمطية المشتركة جزءًا من بعضها وظيفي الأنظمة الفرعية التي تحتوي على العديد من كائنات البيانات الأولية ، يمكن أن يحتوي هذا القسم أيضًا على إجراءات ووظائف تصدير الخدمة المخصصة فقط ليتم استدعاؤها من الكائنات الأخرى لهذا النظام الفرعي.
  بالنسبة للوحدات النمطية الشائعة ، يوصى بتقسيم هذا القسم إلى أقسام فرعية وفقًا للسمة الوظيفية. تسبق الأقسام الفرعية تعليق ، يوصى بإصداره بطريقة مماثلة. على سبيل المثال:

////////////////////////////////////////////////// ////////////////////////////// // تحديث قاعدة المعلومات

1.3. قالب لتصميم أقسام لوحدات الكائن ، المديرين ، مجموعات السجلات ، المعالجات ، التقارير ، إلخ:

////////////////////////////////////////////////// ////////////////////////////// // واجهة البرنامج ////////////// // ////////////////////////////////////////////////// ////////////// // معالجات الأحداث //////////////////////////////// //////////////////////////////////////////////// // // إجراءات الخدمة ووظائفها

• يحتوي قسم "واجهة البرنامج" على إجراءات ووظائف التصدير المعدة للاستخدام في وحدات التكوين الأخرى أو البرامج الأخرى (على سبيل المثال ، من خلال اتصال خارجي). ليس من الضروري وضع وظائف وإجراءات التصدير في هذا القسم والمقصودة ليتم استدعاؤها فقط من وحدات الكائن نفسه وأشكاله وأوامره. على سبيل المثال ، الإجراءات الخاصة بتعبئة جزء الجدول من المستند الذي يتم استدعاؤه من معالجة التعبئة في وحدة الكائن ومن نموذج المستند في معالج أمر النموذج ليست واجهة البرنامج الخاصة بوحدة الكائن ، حيث إن تسمى فقط في الوحدة النمطية نفسها ومن أشكال الكائن نفسه. يجب أن توضع في القسم "إجراءات المنفعة ووظائفها."
• يحتوي قسم "معالجات الأحداث" على معالجات الأحداث لوحدة الكائن ( Prizavisi ، PRO ، إلخ.)
• قسم "إجراءات المساعدة والوظائف" له نفس الغرض كما في الوحدات العامة.

1.4. قالب تصميم القسم لوحدات النموذج:

////////////////////////////////////////////////// ////////////////////////////// // HANDLER OF EVENTS OF FORM ///////////// ////////////////////////////////////////////////// /////////////// // المتعاملين في أحداث عناصر شكل النموذج //////////////////////////// ////////////////////////////////////////////////// // // معالجات الفعاليات أشكال الجداول ////////////////////////////////////////// ////////////////////////////////////// // معاونو فرق النموذج /////// ////////////////////////////////////////////////// /////////////////////// // إجراءات ووظائف الخدمة

• يحتوي القسم "معالجات أحداث النموذج" على إجراءات معالج أحداث النموذج: عند إنشاء خادم أو فتح أو ما إلى ذلك.
• يحتوي القسم "معالجات عناصر النموذج" على إجراءات لمعالجة العناصر الموجودة في الجزء الرئيسي من النموذج (كل ما لا يرتبط بالجداول في النموذج).
• في الأقسام "معالجات الأحداث في جدول النموذج <اسم جدول النموذج>" ، توجد إجراءات لمعالجات جدول النموذج وعناصر الجدول. بالنسبة لإجراءات المعالج ، يجب أن يكون لكل جدول قسم خاص به.
• يحتوي قسم "معالجات أوامر النموذج" على إجراءات لمعالجات أمر النموذج (يتم تحديد أسماءها في خاصية إجراء لأوامر النموذج).
• قسم "إجراءات المساعدة والوظائف" له نفس الغرض كما في الوحدات العامة.

راجع أيضًا: قواعد إنشاء وحدات النماذج

2. المتطلبات العامة لأقسام وحدات البرامج.

2.1. رأس الوحدة النمطية هو تعليق في بداية الوحدة النمطية. يوفر عنوان الوحدة النمطية وصفًا موجزًا ​​وشروط التطبيق.
على سبيل المثال:

////////////////////////////////////////////////// //////////////////////////// // // إجراءات العميل ووظائفه للأغراض العامة: // - للعمل مع القوائم في النماذج ؛ // - للعمل مع السجل ؛ // - لمعالجة الإجراءات المستخدم في التقدم تحرير // متعدد الخطوط نص ، على سبيل المثال التعليقات في الوثائق ؛ // - أخرى. // //////////////////////////////////////////////// ////////////////////////////////

بالنسبة لوحدات النماذج ، يوصى بوضع وصف لمعلمات النموذج في الرأس.

2.2. قسم الوصف المتغير . يتم تعيين أسماء المتغيرات وفقا لعامة قواعد اسم المتغير ، واستخدامها هو موضح في المقال. استخدام المتغيرات العالمية في وحدات البرامج .

يجب تزويد جميع متغيرات الوحدة بتعليق كافٍ لفهم الغرض منها. يوصى بوضع التعليق في نفس السطر الذي يتم فيه الإعلان عن المتغير.
على سبيل المثال:

Pem CurrencyAccounting Export؛ // العملة التي يتم فيها الاحتفاظ بالمحاسبة Perem Address يدعم Export؛ // عنوان البريد الإلكتروني حيث يتم إرسال رسائل خطأ

2.3. واجهة البرنامج يتم وضع إجراءات ووظائف التصدير التي تشكل واجهة البرمجة الخاصة بها مباشرة بعد وصف المتغيرات. هذه الإجراءات والوظائف مخصصة للاستخدام من قبل كائنات التكوين الأخرى أو البرامج الأخرى (على سبيل المثال ، من خلال اتصال خارجي) ، وبالتالي يجب أن تكون موجودة في "مكان مرئي" في الوحدة النمطية.

انظر أيضا: وصف الإجراءات والوظائف.

2.4.1 معالجات أحداث النموذج ، الأوامر ، وعناصر النموذج . قبل إجراءات ووظائف الخدمة في وحدة النموذج ، توجد معالجات الأحداث في النموذج ، وكذلك معالجات الأحداث للأوامر وعناصر النموذج.

توصية منهجية (نصيحة مفيدة)

يوصى بوضع معالجات عنصر نموذج واحد معًا حسب ترتيب ما يلي في لوحة خصائص محرر النماذج في مكون .

2.4.2. يجب أن يكون لكل حدث إجراء معالج خاص به. إذا كان يجب تنفيذ نفس الإجراءات عند حدوث الأحداث في عناصر مختلفة من النموذج:

• إنشاء إجراء منفصل (وظيفة) يقوم بتنفيذ الإجراءات اللازمة

• لكل عنصر نموذج ، قم بإنشاء معالج منفصل بالاسم الافتراضي

• استدعاء الإجراء المطلوب (وظيفة) من كل معالج.

على سبيل المثال ، خطأ:

& OnClient الإجراء الخاص بمعلمات اختيار تنفيذ التطبيق (Element) = التوافق الجديد () ؛ خيارات التحديد. لصق ("حسب المؤلف" ، حسب المؤلف) ؛ اختيار الخيارات ، لصق ("التنفيذي" ، التنفيذي) ؛ تعيين قائمة التحديد (قائمة ، خيارات التحديد) ؛ KonetsProtsedury & على إجراء العميل للتأليف بالتغيير (عنصر) إلى التنفيذ بالتغيير (غير محدد) ؛ KonetsProtsedury

صحيح:

& OnClient Procedure to PerformIndicator (Item) SetSelection ()؛ إنهاء الإجراء وفي إجراء العميل حسب مؤلف تغيير (عنصر) تثبيت التحديد () ؛ معلمات اختيار EndScedion وإجراءات OnServer () لتحديد معلمات التحديد = توافق جديد () ؛ خيارات التحديد. لصق ("حسب المؤلف" ، حسب المؤلف) ؛ اختيار الخيارات ، لصق ("التنفيذي" ، التنفيذي) ؛ تعيين قائمة التحديد (قائمة ، خيارات التحديد) ؛ KonetsProtsedury

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

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

توصية منهجية (نصيحة مفيدة)

يوصى بوضع معالجات ، حسب ترتيب ما يلي في وصف اللغة المضمنة.

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

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

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

2.7. يحتوي قسم التهيئة على عبارات تهيئ متغيرات الوحدة أو الكائن (النموذج). على سبيل المثال:

عنوان الدعم = "[email protected]" ؛ // العنوان للاتصال بالدعم الفني Perform Initialization ()؛

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

مواد من القسم: 1C: المؤسسة 8.2 / المطورون / الاتفاقيات عند كتابة التعليمات البرمجية

مواد أخرى حول هذا الموضوع:

وصف الإجراءات والوظائف

ميزات التحجيم للكائن المحدد

نقل التكوينات على النظام الأساسي 1C: Enterprise 8.2 إلى النظام الأساسي 1C: Enterprise 8.3 دون وضع التوافق مع الإصدار 8.2

أسماء الإجراءات والوظائف

باستخدام الوضع المميز

نجد: بنية الوحدة النمطية 1c هي ، إجراءات الخدمة ووظائفها ، الوحدة النمطية ، إجراء استدعاء الوحدة النمطية للمدير 1c 8 2 ، كيفية استدعاء إجراء من وحدة أخرى 1c ، رأس وحدة اللغة الإنجليزية ، 1C من إجراء نموذج استدعاء وحدة المعالجة ، 1c 8 2 استدعاء إجراء من وحدة الإدارة ، 1