मॉड्यूल संरचना

1 सी: एंटरप्राइज़ 8.2 /
डेवलपर्स के लिए /
कोड कन्वेंशन

सामग्री की तालिका

1.1। प्रोग्राम मॉड्यूल में (सामान्य मॉड्यूल, ऑब्जेक्ट के मॉड्यूल, ऑब्जेक्ट मैनेजर के मॉड्यूल, फॉर्म, कमांड, आदि के मॉड्यूल) सामान्य मामले में निम्नलिखित अनुभाग निम्नलिखित में मौजूद हो सकते हैं। अनुक्रम :

कुछ अनुभाग केवल एक निश्चित प्रकार के मॉड्यूल में मौजूद हो सकते हैं। उदाहरण के लिए, फार्म तत्वों के लिए ईवेंट हैंडलर केवल फॉर्म मॉड्यूल में मौजूद हो सकते हैं, और वैरिएबल डिस्क्रिप्शन सेक्शन और इनिशियलाइज़ेशन सेक्शन को गैर-वैश्विक सामान्य मॉड्यूल, ऑब्जेक्ट मैनेजर मॉड्यूल, रिकॉर्ड सेट, निरंतर मान और सत्र मॉड्यूल में परिभाषित नहीं किया जा सकता है।

मॉड्यूल कोड को अनुभागों में विभाजित करने की आवश्यकता कोड की पठनीयता बढ़ाने और विभिन्न लेखकों के लिए कोड में परिवर्तन की शुरूआत को सरल बनाने के लिए है ( डेवलपर्स द्वारा ) के रूप में सामूहिक विकास में, और विशिष्ट कार्यान्वयन के लिए आवेदन समाधान के शोधन में।

1.2। सामान्य मॉड्यूल के लिए टेम्पलेट (प्रतिलिपि के लिए रिक्त) अनुभाग:

////////////////////////////////////////////////// /////////////////////////////// // // ///////////// ////////////////////////////////////////////////// ////////////////////////////////////////////////////// ////////////////////////////////////////////// // // सॉफ़्टवेयर इंटरफ़ेस // ////////////////////////////////////////////////// //////////////////////////// // सेवा की प्रक्रिया और सुविधाएं

  • अनुभाग "प्रोग्राम इंटरफ़ेस" में अन्य कॉन्फ़िगरेशन ऑब्जेक्ट्स या अन्य प्रोग्राम्स (उदाहरण के लिए, बाहरी कनेक्शन के माध्यम से) के उपयोग के लिए निर्यात प्रक्रियाएं और फ़ंक्शन शामिल हैं।
  • खंड "यूटिलिटी प्रोसीजर एंड फंक्शंस" में एक सामान्य मॉड्यूल के आंतरिक कार्यान्वयन को बनाने वाली प्रक्रियाएं और कार्य शामिल हैं। ऐसे मामलों में जहां आम मॉड्यूल कुछ का हिस्सा है कार्यात्मक सबसिस्टम जिसमें कई मेटाडेटा ऑब्जेक्ट शामिल हैं, इस अनुभाग में सेवा निर्यात प्रक्रियाएं और कार्य भी हो सकते हैं, जिनका उद्देश्य केवल इस सबसिस्टम के अन्य ऑब्जेक्ट्स से बुलाया जाना है।
    बल्क कॉमन मॉड्यूल के लिए, कार्यात्मक विशेषता के अनुसार, इस खंड को उप-वर्गों में विभाजित करने की सिफारिश की जाती है। सदस्यताएँ एक टिप्पणी से पहले होती हैं, जिसे एक समान तरीके से जारी करने की सिफारिश की जाती है। उदाहरण के लिए:

////////////////////////////////////////////////// //////////////////////////////// // सूचना का आधार अद्यतन

1.3। ऑब्जेक्ट मॉड्यूल, प्रबंधक, रिकॉर्ड सेट, उपचार, रिपोर्ट, आदि के लिए अनुभागों के डिजाइन के लिए टेम्प्लेट।

////////////////////////////////////////////////// ////////////////////////////// // सॉफ़्टवेयर इंटरफ़ेस //////////////// // ////////////////////////////////////////////////// ////////////// // प्रचारकों के समर्थक ////////////////////////////////// /////////////////////////////////////////////////// // // सेवा की प्रक्रिया और समारोह

  • अनुभाग "प्रोग्राम इंटरफ़ेस" में अन्य कॉन्फ़िगरेशन मॉड्यूल या अन्य कार्यक्रमों में उपयोग के लिए निर्यात प्रक्रियाएं और फ़ंक्शन शामिल हैं (उदाहरण के लिए, बाहरी कनेक्शन के माध्यम से)। इस खंड के निर्यात कार्यों और प्रक्रियाओं में जगह के लिए आवश्यक नहीं है जो केवल ऑब्जेक्ट के मॉड्यूल, इसके रूपों और आदेशों से पूरी तरह से बुलाया जाना है। उदाहरण के लिए, किसी दस्तावेज़ के तालिका भाग को पॉप्युलेट करने की प्रक्रियाएँ जिन्हें ऑब्जेक्ट मॉड्यूल में भरने की प्रक्रिया से कहा जाता है और प्रपत्र कमांड हैंडलर में दस्तावेज़ फ़ॉर्म से ऑब्जेक्ट मॉड्यूल के प्रोग्राम इंटरफ़ेस नहीं हैं, क्योंकि केवल मॉड्यूल में ही और उसी ऑब्जेक्ट के रूपों से कहा जाता है। उन्हें रखा जाना चाहिए अनुभाग में "उपयोगिता प्रक्रिया और कार्य।"
  • "ईवेंट हैंडलर्स" सेक्शन में ऑब्जेक्ट के मॉड्यूल ( प्रेज़ाविसी , प्रो आदि) के लिए ईवेंट हैंडलर होते हैं।
  • अनुभाग "उपयोगिता प्रक्रिया और कार्य" का सामान्य मॉड्यूल के समान उद्देश्य है।

1.4। प्रपत्र मॉड्यूल के लिए अनुभाग डिजाइन टेम्पलेट:

////////////////////////////////////////////////// ////////////////////////////// // फार्म के पते का हवाला ///////////////// ////////////////////////////////////////////////// /////////////// // फार्म के आकार की घटनाओं के उम्मीदवारों की सूची //////////////////////////////////// ////////////////////////////////////////////////// // // प्राध्यापकों के प्राध्यापक फोर्ब्स टैब ////////////////////////////////////////////// ////////////////////////////////////// / // फ़ोरम /////// के अध्यापकों के समर्थक ////////////////////////////////////////////////// /////////////////////// // सेवा प्रक्रिया और सुविधाएं

  • अनुभाग "फॉर्म ईवेंट हैंडलर" में फॉर्म ईवेंट हैंडलर प्रक्रियाएं शामिल हैं: सर्वर बनाने पर , खोलने आदि।
  • अनुभाग "फॉर्म एलिमेंट हैंडलर" में फॉर्म के मुख्य भाग में स्थित प्रसंस्करण तत्वों के लिए प्रक्रियाएं होती हैं (सब कुछ जो फॉर्म पर तालिकाओं से संबंधित नहीं है)।
  • "फॉर्म टेबल के इवेंट हैंडलर्स <फॉर्म टेबल नेम" के सेक्शन में फॉर्म टेबल और टेबल एलिमेंट्स के हैंडलर्स के लिए प्रक्रियाएं हैं। हैंडलर प्रक्रियाओं के लिए, प्रत्येक तालिका का अपना विभाजन होना चाहिए।
  • अनुभाग "फॉर्म कमांड हैंडलर" में फॉर्म कमांड हैंडलर (जिसके नाम फॉर्म कमांड के एक्शन प्रॉपर्टी में निर्दिष्ट हैं) के लिए प्रक्रियाएं हैं।
  • अनुभाग "उपयोगिता प्रक्रिया और कार्य" का सामान्य मॉड्यूल के समान उद्देश्य है।

इन्हें भी देखें: फॉर्म मॉड्यूल बनाने के नियम

2. सॉफ्टवेयर मॉड्यूल के वर्गों के लिए सामान्य आवश्यकताएं।

2.1। मॉड्यूल हेडर मॉड्यूल की शुरुआत में एक टिप्पणी है। मॉड्यूल हेडिंग एक संक्षिप्त विवरण और आवेदन की स्थिति प्रदान करता है।
उदाहरण के लिए:

////////////////////////////////////////////////// //////////////////////////// // // सामान्य प्रयोजनों के ग्राहक प्रक्रिया और कार्य: // - रूपों में सूचियों के साथ काम करने के लिए; // - लॉग के साथ काम करने के लिए; // - प्रसंस्करण क्रियाओं के लिए उपयोगकर्ता प्रगति में है संपादित करें // मल्टीलाइन टेक्स्ट , उदाहरण के लिए दस्तावेजों में टिप्पणी; // - अन्य। // ////////////////////////////////////////////////// ////////////////////////////////

फॉर्म मॉड्यूल के लिए, हेडर में फॉर्म पैरामीटर के विवरण को रखने की सिफारिश की जाती है।

2.2। चर विवरण अनुभाग । परिवर्तनीय नाम सामान्य के अनुसार दिए गए हैं चर नाम नियम , और उनका उपयोग लेख में वर्णित है। सॉफ्टवेयर मॉड्यूल में वैश्विक चर का उपयोग करना

सभी मॉड्यूल चर को उनके उद्देश्य को समझने के लिए पर्याप्त टिप्पणी के साथ प्रदान किया जाना चाहिए। कमेंट्री को उसी लाइन में रखने की सिफारिश की जाती है, जहां चर घोषित किया जाता है।
उदाहरण:

पेम करेंअकाउंटिंग एक्सपोर्ट; // वह मुद्रा जिसमें लेखांकन को पेरेम एड्रेस रखा जाता है, निर्यात का समर्थन करता है; // ईमेल पता जहां त्रुटि संदेश भेजे जाते हैं

2.3। सॉफ्टवेयर इंटरफ़ेस निर्यात प्रक्रियाएं और फ़ंक्शन जो इसके प्रोग्रामिंग इंटरफ़ेस को बनाते हैं, चर के विवरण के तुरंत बाद रखे जाते हैं। ऐसी प्रक्रियाओं और कार्यों का उपयोग अन्य कॉन्फ़िगरेशन ऑब्जेक्ट्स या अन्य प्रोग्राम (उदाहरण के लिए, बाहरी कनेक्शन के माध्यम से) के लिए किया जाता है, इसलिए उन्हें मॉड्यूल में "दृश्यमान जगह" में स्थित होना चाहिए।

यह भी देखें: प्रक्रियाओं और कार्यों का विवरण

२.४.१ इवेंट हैंडलर, कमांड, और फॉर्म एलिमेंट्स । प्रपत्र मॉड्यूल में सेवा प्रक्रियाओं और कार्यों से पहले, प्रपत्र के इवेंट हैंडलर स्थित होते हैं, साथ ही कमांड और फॉर्म तत्वों के लिए इवेंट हैंडलर भी।

विधि संबंधी सिफारिश (उपयोगी सलाह)

यह अनुशंसा की जाती है कि प्रपत्र संपादक के संपत्ति पैनल में उनके अनुसरण के आदेश का पालन करते हुए एक फार्म तत्व के हैंडलर को एक साथ रखा जाए। विन्यासकर्ता में

2.4.2। प्रत्येक घटना की अपनी हैंडलर प्रक्रिया होनी चाहिए। यदि प्रपत्र के विभिन्न तत्वों में घटनाएँ घटित होने पर एक ही क्रिया की जानी चाहिए:

  • एक अलग प्रक्रिया (फ़ंक्शन) बनाएं जो आवश्यक क्रियाएं करता है

  • प्रत्येक प्रपत्र तत्व के लिए, डिफ़ॉल्ट नाम के साथ एक अलग हैंडलर बनाएं

  • प्रत्येक हैंडलर से आवश्यक प्रक्रिया (फ़ंक्शन) को कॉल करें।

उदाहरण के लिए, गलत:

निष्पादन प्रक्रिया (तत्व) चयन पैरामीटर्स = नई अनुपालन () के लिए & OnClient प्रक्रिया; विकल्प चयन। पेस्ट ("लेखक द्वारा", लेखक द्वारा); विकल्प चयन। पेस्ट ("कार्यकारी", कार्यकारी); सूची चयन (सूची, चयन विकल्प) सेट करें; KonetsProtsedury और बदलने के लिए (तत्व) कार्यकारी द्वारा बदलकर (अपरिभाषित) द्वारा कार्यकारी के लिए ग्राहक प्रक्रिया पर; KonetsProtsedury

सही ढंग से:

कार्य-निष्पादनकर्ता (मद) सेटसेलेक्शन () के लिए ऑनऑलिएंट प्रक्रिया; लेखक की प्रक्रिया से अंतिम प्रक्रिया और ग्राहक प्रक्रिया में (परिवर्तन) चयन () स्थापित करें; EndProcedures & OnServer Procedure SetSelection () चयन पैरामीटर = नया अनुपालन (); विकल्प चयन। पेस्ट ("लेखक द्वारा", लेखक द्वारा); विकल्प चयन। पेस्ट ("कार्यकारी", कार्यकारी); सूची चयन (सूची, चयन विकल्प) सेट करें; KonetsProtsedury

यह आवश्यकता इस तथ्य के कारण है कि इवेंट हैंडलर प्रक्रियाओं का तर्क मॉड्यूल कोड में उपयोग के लिए नहीं है, लेकिन प्लेटफ़ॉर्म द्वारा सीधे कहा जाता है। इन दोनों परिदृश्यों को एक प्रक्रिया में मिलाना अनावश्यक रूप से इसके तर्क को जटिल बनाता है और इसकी मजबूती को कम करता है (एक परिकल्पित कॉल परिदृश्य के बजाय - मंच से एक घटना पर - प्रक्रिया कोड को कोड से अन्य प्रत्यक्ष कॉल पर भरोसा करना होगा)।

2.5। ऑब्जेक्ट मॉड्यूल और ऑब्जेक्ट मैनेजर के लिए ईवेंट हैंडलर को निर्यात के बाद रखा जाता है, लेकिन उपयोगिता प्रक्रियाओं और मॉड्यूल कार्यों से पहले।

विधि संबंधी सिफारिश (उपयोगी सलाह)

हैंडलर लगाने की सिफारिश की जाती है, एम्बेडेड भाषा के विवरण में उनके पालन के आदेश का पालन करना।

2.6। उपयोगिता प्रक्रियाएं और मॉड्यूल फ़ंक्शन जो इवेंट हैंडलर नहीं हैं, लेकिन एक मॉड्यूल के आंतरिक कार्यान्वयन का गठन करते हैं, इवेंट हैंडलर के बगल में मॉड्यूल में रखा जाता है।

ऐसे मामलों में जहां एक सामान्य मॉड्यूल एक कार्यात्मक सबसिस्टम का हिस्सा होता है, जिसमें कई मेटाडेटा ऑब्जेक्ट शामिल होते हैं, इस खंड में सेवा निर्यात प्रक्रियाएं भी हो सकती हैं और इस उद्देश्य को केवल इस सबसिस्टम की अन्य वस्तुओं से बुलाया जा सकता है।

प्रकृति या कार्य के तर्क द्वारा एक-दूसरे से संबंधित प्रक्रियाओं और कार्यों को एक साथ रखने की सिफारिश की जाती है। यह स्पष्ट रूप से मॉड्यूल की प्रक्रियाओं और कार्यों को सर्वर, क्लाइंट और संदर्भ के बिना कार्य करने के लिए अनुशंसित नहीं है, क्योंकि ऐसे "तकनीकी" ऑर्डर मॉड्यूल तर्क की समझ को जटिल करते हैं, इसके कार्यान्वयन के विवरण के लिए डेवलपर का ध्यान आकर्षित करते हैं।

2.7। इनिशियलाइज़ेशन सेक्शन में ऐसे स्टेटमेंट होते हैं जो मॉड्यूल या ऑब्जेक्ट (फॉर्म) के वैरिएबल को इनिशियलाइज़ करते हैं। उदाहरण के लिए:

समर्थन पता = "[email protected]"; // तकनीकी सहायता से संपर्क करने के लिए पता प्रदर्शन प्रारंभ ();

विषय पर अन्य सामग्री:
अद्यतन डेटाबेस घटना संचालकों सॉफ्टवेयर इंटरफ़ेस संचालकों प्रक्रियाओं टेम्पलेट हैडर प्रक्रिया का अंत कार्यों इंटरफ़ेस विवरण क्लिपबोर्ड नकल करना अनुभाग विनिमय आकार एक वस्तु तत्व को विन्यस्त विन्यास दस्तावेज़

अनुभाग से सामग्री: 1C: एंटरप्राइज़ 8.2 / डेवलपर्स / कोड लिखते समय सहमति / सहमति

विषय पर अन्य सामग्री:

प्रक्रियाओं और कार्यों का विवरण

चयनित वस्तु के लिए स्केलिंग की विशेषताएं

1C पर कॉन्फ़िगरेशन का स्थानांतरण: एंटरप्राइज़ 8.2 प्लेटफ़ॉर्म 1C: एंटरप्राइज़ 8.3 प्लेटफ़ॉर्म संस्करण 8.2 के साथ संगतता मोड के बिना

प्रक्रियाओं और कार्यों के नाम

विशेषाधिकार प्राप्त मोड का उपयोग करना


हम पाते हैं: मॉड्यूल 1 सी की संरचना , सेवा प्रक्रियाओं और कार्यों , मॉड्यूल, प्रबंधक मॉड्यूल कॉल प्रक्रिया 1c 8 2 है, किसी अन्य मॉड्यूल 1c से प्रक्रिया को कैसे कॉल करें, अंग्रेजी मॉड्यूल हेडर, प्रसंस्करण फॉर्म कॉल मॉड्यूल प्रक्रिया से 1c, प्रबंधक मॉड्यूल से 1c 8 2 कॉल प्रक्रिया।


1 सी: एंटरप्राइज़ 8