Модуль құрылымы
1С: Кәсіпорын 8.2 /
Әзірлеушілерге арналған /
Кодекс конвенциялары
Мазмұны
1.1. Бағдарламалық модульде (жалпы модульдер, объектілер модульдері, объектілерді басқарушы модульдер, формалар модулдері, командалар және т.б.) жалпы жағдайда келесі бөлімдер келуі мүмкін: реттіліктер :
Кейбір бөлімдер белгілі бір модульдерде ғана болуы мүмкін. Мысалы, форма элементтеріне арналған оқиғалар өңдеушілері тек пішін модулдерінде бола алады, ал өзгермелі сипаттама бөлімі мен инициализация бөлімі ғаламдық емес жалпы модульдерде, объектілерді басқару модулдерінде, жазбалар жиынтығында, тұрақты мәндер мен сессия модулінде анықталмайды.
Модуль кодын бөлімдерге бөлу талабы кодтың оқылуын арттыруға және әр түрлі авторлардың кодқа өзгерістер енгізуді жеңілдетуге арналған ( әзірлеушілер ) ұжымдық дамуда және нақты іске асыру үшін қолданбалы шешімдерді нақтылауда.
1.2. Жалпы модульдерге арналған шаблондар (көшіруге арналған бос):
//////////////////////////////////////////////////// ////////////////////////////// // // /////////////// //////////////////////////////////////////////////// ////////////// ////////////////////////////////////// ////////////////////////////////////////////// // SOFTWARE INTERFACE // //////////////////////////////////////////////////// ////////////////////////////// // ҚЫЗМЕТ ТӘРТІБІ ЖӘНЕ ФУНКЦИЯЛАР
- «Бағдарламалық интерфейс» бөлімі басқа конфигурация объектілері немесе басқа бағдарламалар (мысалы, сыртқы байланыс арқылы) пайдалануға арналған экспорттық процедуралар мен функцияларды қамтиды.
- «Пайдалы процедуралар мен функциялар» бөлімінде жалпы модульдің ішкі орындалуын құрайтын процедуралар мен функциялар бар. Жалпы модуль кейбір бөліктердің бөлігі болған жағдайда функционалды метадеректердің бірнеше нысандарын қамтитын ішкі жүйелер, бұл бөлімде сервистің экспорттық процедуралары және осы ішкі жүйенің басқа объектілерінен шақыруға ғана арналған функциялар болуы мүмкін.
Жаппай жалпы модульдер үшін осы бөлімді функционалды атрибутқа сәйкес бөлімдерге бөлу ұсынылады. Бөлімдердің алдында түсініктеме беріледі, оны осындай жолмен шығару ұсынылады. Мысалы:
//////////////////////////////////////////////////// /////////////////////////////// Ақпараттық базаны жаңарту
1.3. Нысан модульдеріне, менеджерлерге, жазбалар жиынтығына, өңдеулерге, есептерге және т.с.с. арналған бөлімдерді жобалау үлгісі:
//////////////////////////////////////////////////// //////////////////////////////// // SOFTWARE ИНТЕРФАКСЫ ////////////// // //////////////////////////////////////////////////// ////////////// // ОҚИҒАЛАР ПРОЦЕССОРЛАРЫ //////////////////////////////// ///////////////////////////////////////////////// // ҚЫЗМЕТ ТӘРТІБІ ЖӘНЕ ФУНКЦИЯЛАР
- «Бағдарлама интерфейсі» бөлімі басқа конфигурация модулдерінде немесе басқа бағдарламаларда (мысалы, сыртқы байланыс арқылы) пайдалануға арналған экспорттық процедуралар мен функцияларды қамтиды. Бұл бөлімде тек объектінің, оның формалары мен командаларының модульдерінен шақыруға арналған экспорттау функциялары мен процедураларын орналастыру қажет емес. Мысалы, объект модулінде толтыруды өңдеуден және форма пәрменін өңдеудегі құжат формасынан шақырылатын құжаттың кестелік бөлігін толтыру процедуралары объект модулінің бағдарламалық интерфейсі болып табылмайды, өйткені модульдің өзінде және сол объектінің формаларында ғана аталады. Оларды орналастыру керек бөлімінде «Пайдалы процедуралар мен функциялар.»
- «Оқиғаларды өңдеушілер » бөлімі объект модуліне арналған оқиғаларды өңдеушілерді қамтиды ( Prizavisi , PRO және т.б.).
- «Пайдалы процедуралар мен функциялар» бөлімінде жалпы модульдердегідей мақсат бар.
1.4. Пішін модульдеріне арналған бөлімді жобалау шаблоны:
//////////////////////////////////////////////////// //////////////////////////////// // ФОРМАНЫҢ ОҚИҒАЛАРЫН ҚОЛДАНУШЫ ///////////// //////////////////////////////////////////////////// /////////////// // ФОРМАНЫҢ ҚҰРАМЫ ЭЛЕМЕНТТЕРІН ОҚУШЫЛАР //////////////////////////// //////////////////////////////////////////////////// // // ОҚИҒАЛАРДЫҢ ПРОГРАММАЛАРЫ ////////////////////////////////////////// //////////////////////////////////////// // ФОРМАТОРҒА АРНАЛҒАН ПРОЦЕССОРЛАР /////// //////////////////////////////////////////////////// ///////////////////////// // ҚЫЗМЕТ ТӘРТІБІ МЕН ФУНКЦИЯЛАРЫ
- «Форма оқиғаларын өңдеушілер» бөлімінде форма оқиғаларын өңдеудің процедуралары бар: Сервер құру , ашу және т.б.
- «Пішін элементтерін өңдеушілер» бөлімінде форманың негізгі бөлігінде орналасқан элементтерді өңдеуге арналған процедуралар бар (формадағы кестелермен байланысты емес барлық нәрсе).
- «Форма кестесінің оқиғалар өңдеушілері <форма кестесінің атауы>» тарауларында кесте мен кесте элементтерін өңдеушілерге арналған процедуралар бар. Өңдеу процедуралары үшін әр кестенің жеке бөлімі болуы керек.
- « Пәрмендерді өңдеушілер» бөлімінде форма командаларын өңдеуге арналған процедуралар бар (атаулары форма командаларының Action қасиетінде көрсетілген).
- «Пайдалы процедуралар мен функциялар» бөлімінде жалпы модульдердегідей мақсат бар.
Қараңыз: Пішін модульдерін құру ережелері
2. Бағдарламалық жасақтама модульдерінің бөлімдеріне қойылатын жалпы талаптар.
2.1. Модуль тақырыбы - модульдің басында түсініктеме. Модуль тақырыбында қысқаша сипаттама және қолдану шарттары берілген.
Мысалы:
//////////////////////////////////////////////////// ////////////////////////////// // Клиент процедуралары және жалпы мақсаттағы функциялары: // - формалардағы тізімдермен жұмыс істеу үшін; // - журналмен жұмыс жасау; // - өңдеу әрекеттері үшін қолданушы орындалуда редакциялау // көптік мәтін , мысалы, құжаттардағы түсініктемелер; // - басқа. // ////////////////////////////////////////////////// /////////////////////////////////
Пішін модульдері үшін тақырып пішінінің сипаттамасын орналастыру ұсынылады.
2.2. Айнымалы сипаттама бөлімі . Өзгермелі атаулар генералға сәйкес тағайындалады айнымалы атау ережелері , және оларды қолдану мақалада сипатталған. Бағдарламалық модульдерде жаһандық айнымалыларды қолдану .
Модульдің барлық айнымалылары олардың мақсатын түсіну үшін жеткілікті түсініктеме берілуі керек. Түсініктемені айнымалы мәлімделген жолға орналастыру ұсынылады.
Мысал:
Пем валютасыЕсеп экспорты; // Бухгалтерлік есеп жүргізілетін валюта Perem Address Экспортты қолдайды; // Қате туралы хабарламалар жіберілетін электрондық пошта мекенжайы
2.3. Бағдарламалық жасақтама интерфейсі Экспорттық процедуралар мен оның бағдарламалық интерфейсін құрайтын функциялар айнымалы сипаттамадан кейін бірден орналастырылады. Мұндай процедуралар мен функциялар басқа конфигурация объектілері немесе басқа бағдарламалар (мысалы, сыртқы байланыс арқылы) пайдалануға арналған, сондықтан олар модульдегі «көрінетін жерде» орналасуы керек.
Сондай-ақ қараңыз: процедуралар мен функциялардың сипаттамасы.
2.4.1 Оқиғаларды өңдеушілерді, командалар мен форма элементтерін қалыптастыру . Пішін модуліндегі қызмет процедуралары мен функцияларына дейін форма оқиғаларын өңдеушілер, сонымен қатар командалар мен форма элементтеріне арналған оқиға өңдегіштері орналасқан.
Әдістемелік ұсыныс (пайдалы кеңестер)
Бір форма элементінің өңдегіштерін пішіндік редактордың қасиеттер тақтасында оларды орындау ретіне сәйкес орналастыру ұсынылады. конфигураторда .
2.4.2. Әр оқиғаның өңдеудің өзіндік рәсімі болуы керек. Егер бірдей әрекеттерді форманың әр түрлі элементтерінде болған кезде орындау керек:
қажетті әрекеттерді орындайтын жеке процедура (функция) құрыңыз
әр форма элементі үшін әдепкі аты бар жеке өңдегіш жасаңыз
әр өңдеушіден қажетті процедураны (функцияны) шақырыңыз.
Мысалы, қате:
& OnClient орындау процедурасы (Элемент) таңдау параметрлері = Жаңа сәйкестік (); Опцияларды таңдау. Қою («Автор», Автор бойынша); Опцияларды таңдау. Қою («атқарушы», атқарушы); Тізімді таңдауды орнатыңыз (тізім, таңдау параметрлері); EndProcedure & Өзгерту арқылы басқарушыға (элементті) өзгерту арқылы авторландырудың тәртібі туралы (анықталмаған); EndProcedure
дұрыс:
PerformIndicator-ке арналған OnClient процедурасы (Элемент) SetSelection (); Автордың өзгеруі (элемент) бойынша таңдау процедурасы мен клиент процедурасының аяқталу процедурасы (); EndProcedures & OnServer процедурасы SetSelection () таңдау параметрлері = Жаңа сәйкестік (); Опцияларды таңдау. Қою («Автор», Автор бойынша); Опцияларды таңдау. Қою («атқарушы», атқарушы); Тізімді таңдауды орнатыңыз (тізім, таңдау параметрлері); EndProcedure
Бұл талап оқиға өңдегіш процедураларының логикасы модульдік кодта қолдануға арналмағанына, бірақ тікелей платформа арқылы шақырылатындығына байланысты. Осы екі сценарийді бір процедурада араластыру оның логикасын қиындатады және оның тұрақтылығын төмендетеді (шақырылған сценарийдің орнына - платформадағы оқиға кезінде - процедуралық код кодтан басқа тікелей қоңырауларға сенуі керек).
2.5. Нысан модульдеріне арналған оқиға өңдегіштері және нысан менеджері экспорттан кейін орналастырылады, бірақ қызметтік процедуралар мен модуль функциялары алдында.
Әдістемелік ұсыныс (пайдалы кеңестер)
Орнатылған тілдің сипаттамасында оларды орындау тәртібін ұстанатын өңдегіштерді орналастыру ұсынылады.
2.6. Қызметтік процедуралар мен оқиғалар өңдеушілері болып табылмайтын, бірақ модульдің ішкі орындалуын құрайтын модуль функциялары оқиғалар өңдеушілерінің қасында орналасқан.
Егер жалпы модуль бірнеше метадеректер нысандарын қамтитын функционалдық ішкі жүйенің бөлігі болса, онда бұл бөлімде сервистің экспорттау процедуралары және осы ішкі жүйенің басқа объектілерінен шақыруға арналған функциялар болуы мүмкін.
Табиғаты немесе жұмыс логикасы бойынша бір-бірімен байланысты процедуралар мен функцияларды бірге орналастыру ұсынылады. Модульдің процедуралары мен функцияларын серверге, клиентке және функцияларға контекссіз нақты топтау ұсынылмайды, өйткені мұндай «технологиялық» тапсырыс беру модульдің логикасын түсінуді қиындатады, әзірлеушінің назарын оны іске асырудың егжей-тегжейіне аударады.
2.7. Инициализация бөлімінде модуль немесе нысан (форма) айнымалы мәндерін баптайтын мәлімдемелер бар. Мысалы:
Қолдау мекенжайы = «[email protected]»; // Техникалық қолдау қызметіне хабарласу мекен-жайы Perform Initialization ();
Тақырып бойынша басқа материалдар:
мәліметтер базасын жаңарту , оқиға өңдеушілер , бағдарламалық интерфейс , өңдеушілер , процедуралар , өрнек , тақырып , процедураның соңы , функциялары , интерфейсі , сипаттамасы , айырбас буфері , көшіру , бөлімі , алмасу , формалары , объект , элемент , конфигурациялау , конфигурациялары , құжат
Бөлімдегі материалдар: 1С: Кәсіпорын 8.2 / Жасақтаушылар / Код жазу кезіндегі келісімдер
Тақырып бойынша басқа материалдар:
Процедуралар мен функциялардың сипаттамасы
Таңдалған объект үшін масштабтаудың ерекшеліктері
1С: Кәсіпорын 8.2 платформасындағы конфигурацияларды 8С нұсқасымен үйлесімділік режимінсіз 1С: Кәсіпорын 8.3 платформасына көшіру
Процедуралар мен функциялардың атаулары
Артықшылықты режимді пайдалану
Біз 1c модулінің құрылымы , қызмет процедуралары мен функциялары , модуль, менеджер модуліне қоңырау шалу процедурасы 1c 8 2, процедураны басқа модульден қалай шақыруға болады 1c, ағылшын модулінің тақырыбы, 1c модульдің өңделетін формасынан, 1c 8 2 менеджер модулінен процедураны шақыру, 1
