1C: Korxona 8.2 /
Dasturchilar uchun /
Kod konventsiyalari
Tarkiblar jadvali
1.1. Dastur modulida (umumiy modullar, ob'ektlar modullari, ob'ektlarni boshqarish modullari, shakllar, buyruqlar modullari va boshqalar) umumiy holatda quyidagi bo'limlar bo'lishi mumkin. ketma-ketliklar :
Ba'zi bo'limlar faqat ma'lum bir modulda mavjud bo'lishi mumkin. Masalan, shakl elementlari uchun voqea ishlovchilari faqat forma modullarida mavjud bo'lishi mumkin va o'zgaruvchan tavsif bo'limi va initsializatsiya bo'limini global bo'lmagan umumiy modullar, ob'ektlarni boshqarish modullari, yozuvlar to'plamlari, doimiy qiymatlar va seans modullarida aniqlash mumkin emas.
Modul kodini kodlarga bo'lish talablari kodning o'qilishini oshirish va turli mualliflar tomonidan kodlarga o'zgartirishlarni soddalashtirishga qaratilgan ( ishlab chiquvchilar tomonidan ) jamoaviy rivojlanishda va aniq amalga oshirish uchun amaliy echimlarni aniqlashtirishda.
1.2. Umumiy modullar uchun shablon (nusxa olish uchun bo'sh joy):
//////////////////////////////////////////////////// //////////////////////////////// // // /////////////// //////////////////////////////////////////////////// ////////////// ////////////////////////////////////// ////////////////////////////////////////////// // // SOFTWARE INTERFACE // //////////////////////////////////////////////////// ////////////////////////////// // XIZMAT TARTIBI VA FUNKSIYALARI- "Dastur interfeysi" bo'limida boshqa konfiguratsiya ob'ektlari yoki boshqa dasturlar (masalan, tashqi aloqa orqali) foydalanish uchun mo'ljallangan eksport protseduralari va funktsiyalari mavjud.
- "Utility protseduralari va funktsiyalari" bo'limida umumiy modulning ichki bajarilishini tashkil etadigan protseduralar va funktsiyalar mavjud. Umumiy modul ba'zi narsalarning bir qismi bo'lgan holatlarda funktsional Bir nechta metadata ob'ektlarini o'z ichiga oladigan quyi tizimlar, ushbu bo'limda xizmatlarni eksport qilish protseduralari va ushbu quyi tizimning boshqa ob'ektlaridan chaqirishga mo'ljallangan funktsiyalar ham bo'lishi mumkin.
Ommaviy modullar uchun ushbu bo'limni funktsional atributga ko'ra bo'linmalarga bo'lish tavsiya etiladi. Bo'limlardan oldin sharh yoziladi, uni shu tarzda nashr etish tavsiya etiladi. Masalan:
1.3. Ob'ekt modullari, menejerlar, yozuvlar to'plamlari, muolajalar, hisobotlar va hokazolar uchun bo'limlarni loyihalash uchun shablon:
//////////////////////////////////////////////////// //////////////////////////////// // SOFTWARE INTERFACE ////////////// // //////////////////////////////////////////////////// ////////////// // TADBIRKORLAR //////////////////////////////// ///////////////////////////////////////////////// // XIZMAT TARTIBI VA FUNKSIYALARI- "Dastur interfeysi" bo'limida boshqa konfiguratsiya modullarida yoki boshqa dasturlarda (masalan, tashqi aloqa orqali) foydalanish uchun mo'ljallangan eksport protseduralari va funktsiyalari mavjud. Ushbu bo'limda faqat ob'ektning o'zi, uning shakllari va buyruqlari modullaridan chaqirilishi kerak bo'lgan eksport funktsiyalari va protseduralarini joylashtirish shart emas. Masalan, ob'ekt modulida to'ldirish jarayonidan va hujjat shaklidan buyruqni qayta ishlash moslamasidan chaqiriladigan hujjatning jadval qismini to'ldirish protseduralari dastur interfeysi moduli emas. ular faqat modulning o'zida va bir xil ob'ektning shakllaridan chaqiriladi. Ular joylashtirilishi kerak bo'limda "Foydali dasturlar va funktsiyalar."
- "Voqealar bilan ishlov beruvchilar " bo'limi ob'ekt moduli ( Prizavisi , PRO va boshqalar) uchun hodisalarni boshqaruvchilarni o'z ichiga oladi.
- "Foydalilik protseduralari va funktsiyalari" bo'limi umumiy modullar bilan bir xil maqsadga ega.
1.4. Forma modullari uchun bo'limlar shablonlari:
//////////////////////////////////////////////////// //////////////////////////////// // KORXONA TADBIRLARI //////////////////////////////////////////////////// ///////////////// // Forma shaklidagi elementlarning voqealari egalari /////////////////////////// //////////////////////////////////////////////////// // // VOQEALARNING BOSHQARUVCHILARI TARMOQLARI ////////////////////////////////////////// //////////////////////////////////////// // QO'ShIMChA O'QITUVCHILARI UChUN PROCESSORLAR /////// //////////////////////////////////////////////////// ///////////////////////////XIZMAT TARTIBI VA FUNKSIYALARI- "Voqealar bilan ishlov beruvchilarning formalari " bo'limida forma-hodisalarni qayta ishlash protseduralari mavjud: Serverni yaratish , ochish va hk.
- "Form elementlarini qayta ishlash " bo'limida formaning asosiy qismida joylashgan elementlarni qayta ishlash protseduralari mavjud (shakl jadvallar bilan bog'liq bo'lmagan barcha narsalar).
- "Formalar jadvalining voqea ishlovchilari <Formalar jadvalining nomi" bo'limlarida formalar jadvallari va elementlarning ishlovchilari uchun protseduralar mavjud. Ishlov berish protseduralari uchun har bir jadval o'z bo'limiga ega bo'lishi kerak.
- "Form buyruqlar bilan ishlov berish vositalari" bo'limida forma buyruqlarini qayta ishlash uchun protseduralar mavjud (nomlari form buyruqlarining Action xususiyatida ko'rsatilgan).
- "Foydalilik protseduralari va funktsiyalari" bo'limi umumiy modullar bilan bir xil maqsadga ega.
Shuningdek qarang: Forma modullarini yaratish qoidalari
2. Dasturiy ta'minot modullarining bo'limlariga umumiy talablar.
2.1. Modul sarlavhasi modulning eng boshidagi sharhdir. Modul sarlavhasi qisqacha tavsif va qo'llash shartlarini beradi.
Masalan:
Forma modullari uchun sarlavha ichiga forma parametrlarining tavsifini joylashtirish tavsiya etiladi.
2.2. O'zgaruvchan tavsif bo'limi . O'zgaruvchan nomlar generalga muvofiq belgilanadi o'zgaruvchan ism qoidalari , va ulardan foydalanish maqolada tasvirlangan. Dastur modullarida global o'zgaruvchilardan foydalanish .
Modulning barcha o'zgaruvchilariga ularning maqsadlarini tushunish uchun etarli sharh berilishi kerak. Sharhni o'zgaruvchi e'lon qilingan qatorga joylashtirish tavsiya etiladi.
Masalan:
2.3. Dastur interfeysi Eksport protseduralari va uning dasturiy interfeysini tashkil etadigan funktsiyalar o'zgaruvchilar tavsiflangandan so'ng darhol joylashtiriladi. Bunday protseduralar va funktsiyalar boshqa konfiguratsiya ob'ektlari yoki boshqa dasturlar (masalan, tashqi ulanish orqali) foydalanish uchun mo'ljallangan, shuning uchun ular modulda «ko'rinadigan joyda» joylashgan bo'lishi kerak.
Shuningdek qarang: protseduralar va funktsiyalarning tavsifi.
2.4.1 Voqealar bilan ishlov beruvchilar, buyruqlar va shakl elementlarini shakllantirish . Format modulidagi xizmat ko'rsatish protseduralari va funktsiyalaridan oldin formaning ishlov beruvchilari, shuningdek buyruqlar va shakl elementlari uchun hodisalarni qayta ishlash vositalari joylashgan.
Uslubiy tavsiyanoma (foydali maslahat)
Bir shakl elementlarini ishlov beruvchilarni form muharririning xususiyatlar panelida ularni bajarish tartibiga rioya qilgan holda joylashtirish tavsiya etiladi. konfiguratorda .
2.4.2. Har bir tadbirda o'z ishlov berish protsedurasi bo'lishi kerak. Agar bir xil xodisalar shaklning turli elementlarida ro'y berganda bajarilishi kerak bo'lsa:
kerakli amallarni bajaradigan alohida protsedura (funktsiya) yarating
har bir forma elementi uchun standart nom bilan alohida ishlov beruvchini yarating
har bir ishlov beruvchidan kerakli protsedurani (funktsiyani) chaqiring.
Masalan, noto‘g‘ri:
& OnClient-ni bajarish uchun dastur (Element) ni tanlash parametrlari = Yangi moslik (); Tanlovni tanlash. Joylashtirish ("Muallif", Muallif tomonidan); Variantlarni tanlash. Joylashtirish ("Ijrochi", Ijrochi); Ro'yxat tanlovini sozlash (ro'yxat, tanlov parametrlari); EndProcedure & Buyurtmachini o'zgartirish orqali ijrochiga o'zgartirish (element) bo'yicha buyurtma berish tartibi to'g'risida (aniqlanmagan); EndProcedureto‘g‘ri:
& PerformIndicator-ga onClient protsedurasi (band) SetSelection (); Muallif tomonidan o'zgartirilgan (Element) o'rnatishni tanlash () bo'yicha tugatish tartibi va mijoz protsedurasida; EndProcedures & OnServer protsedurasi SetSelection () Tanlash parametrlari = Yangi muvofiqlik (); Tanlovni tanlash. Joylashtirish ("Muallif", Muallif tomonidan); Variantlarni tanlash. Joylashtirish ("Ijrochi", Ijrochi); Ro'yxat tanlovini sozlash (ro'yxat, tanlov parametrlari); EndProcedureUshbu talab, hodisalarni qayta ishlash protseduralari mantiqlari modul kodini ishlatishga mo'ljallanmaganligi sababli to'g'ridan-to'g'ri platforma tomonidan chaqirilishi bilan bog'liq. Ushbu ikki stsenariyni bitta protsedurada aralashtirish uning mantig'ini qiyinlashtiradi va uning mustahkamligini pasaytiradi (ko'zda tutilgan qo'ng'iroq stsenariyining o'rniga - platformadagi voqea - protsedura kodi koddan boshqa to'g'ridan-to'g'ri qo'ng'iroqlarni hisobga olishi kerak).
2.5. Ob'ekt modullari uchun tadbirlarni qayta ishlash moslamalari va ob'ekt menejeri eksport qilinganidan keyin joylashtirilgan, ammo yordamchi protseduralar va modul funktsiyalari oldida.
Uslubiy tavsiyanoma (foydali maslahat)
O'rnatilgan tilning tavsifida ularni bajarish tartibiga rioya qilgan holda ishlov beruvchilarni joylashtirish tavsiya etiladi.
2.6. Favqulodda vaziyatlarda ishlov beruvchilar bo'lmagan, ammo modulning ichki bajarilishini tashkil etadigan yordamchi protseduralar va modul funktsiyalari hodisalarni qayta ishlash vositalarining yonida modulga joylashtirilgan.
Agar umumiy modul bir necha metadata ob'ektlarini o'z ichiga oladigan funktsional quyi tizimning bir qismi bo'lsa, ushbu bo'limda xizmatlarni eksport qilish protseduralari va faqat ushbu quyi tizimning boshqa ob'ektlaridan chaqirishga mo'ljallangan funktsiyalar mavjud bo'lishi mumkin.
Tarkibi yoki ishning mantig'i bo'yicha bir-biri bilan bog'liq protseduralar va funktsiyalarni birgalikda joylashtirish tavsiya etiladi. Modul protseduralari va funktsiyalarini kontekstsiz serverga, mijozga va funktsiyalarga aniq guruhlash tavsiya etilmaydi, chunki bunday "texnologik" buyurtma modul mantig'ini tushunishni murakkablashtiradi va ishlab chiqaruvchining e'tiborini uni amalga oshirish tafsilotlariga yo'naltiradi.
2.7. Initsializatsiya bo'limida modul yoki ob'ekt (shakl) ning o'zgaruvchilarini initsializatsiya qiladigan iboralar mavjud. Masalan:
Qo'llab-quvvatlash manzili = "[email protected]"; // Texnik yordam bilan bog'lanish uchun manzilni bajaring Initialization (); Mavzu bo'yicha boshqa materiallar:
ma'lumotlar bazasini yangilash , voqea ishlovchilari , dasturiy interfeysi , ishlov beruvchilar , protseduralar , naqsh , sarlavha , protsedura oxiri , vazifalari , interfeysi , tavsifi , clipboard , nusxa ko'chirish , bo'lim , almashish , shakllari , ob'ekt , element , sozlash , konfiguratsiyalar , hujjat
Bo'lim materiallari: Kodni yozish paytida 1C: Enterprise 8.2 / Ishlab chiquvchilar / Shartnomalar
Mavzu bo'yicha boshqa materiallar:
Protseduralar va funktsiyalarning tavsifi
Tanlangan ob'ekt uchun masshtablash xususiyatlari
1C: Enterprise 8.2 platformasidagi konfiguratsiyalarni 8C versiyasi bilan muvofiqlik rejimisiz 1C: Enterprise 8.3 platformasiga o'tkazish
Protseduralar va funktsiyalarning nomlari
Imtiyozli rejimdan foydalanish
Biz quyidagilarni topamiz: 1c modulning tuzilishi , xizmat ko'rsatish protseduralari va funktsiyalari , modul, menejer modulini chaqirish protsedurasi 1c 8 2, protsedurani boshqa moduldan qanday chaqirish kerak 1c, ingliz modulining sarlavhasi, ishlov berish formasidan 1c protsedura, 1c 8 2 menejer modulidan protsedurani chaqirish, 1
