1C: საწარმო 8.2 /
დეველოპერებისთვის /
კოდექსის კონვენციები

შინაარსი

1.1. პროგრამულ მოდულში (ზოგადი მოდულები, ობიექტების მოდულები, ობიექტის მენეჯერების მოდულები, ფორმის მოდულები, ბრძანებები და ა.შ.) ზოგადად შემთხვევაში შეიძლება მოიცავდეს შემდეგ ნაწილებს sequences :

ზოგიერთი სექცია შეიძლება იყოს მხოლოდ გარკვეული ტიპის მოდულებში. მაგალითისთვის, ფორმის ელემენტების ღონისძიების მონაწილეები შეიძლება წარმოადგენდნენ მხოლოდ ფორმა მოდულებს და ცვლადის აღწერის განყოფილება და ინიციალიზაციის სექცია არ შეიძლება განისაზღვროს არა-გლობალური ზოგადი მოდულები, ობიექტის მენეჯერის მოდულები, ჩანაწერების კომპლექტი, მუდმივი მნიშვნელობა და სესიის მოდული.

მოდულის კოდის მონაკვეთების გაყოფის მოთხოვნა განისაზღვრება კოდის წაკითხვის გაზრდისა და კოდექსში ცვლილებების შეტანის გამარტივება სხვადასხვა ავტორების მიერ დეველოპერები ) როგორც კოლექტიურ განვითარებაში, ასევე კონკრეტული შესრულების გამოყენების გადაწყვეტილებების დახვეწაში.

1.2. თარგი (ცარიელი კოპირება) სექციები საერთო მოდულები:

////////////////////////////////////////////////// ////////////////////////////// // // //////////// ////////////////////////////////////////////////// ////////////// //////////////////////////////////// //////////////////////////////////////////// / / პროგრამული ინტერფეისი // ////////////////////////////////////////////////// //////////////////////////// მომსახურების პროცედურები და ფუნქციები

• სექცია "პროგრამის ინტერფეისი" შეიცავს ექსპორტის პროცედურებს და ფუნქციებს, რომლებიც განკუთვნილია სხვა კონფიგურაციის ობიექტების ან სხვა პროგრამების გამოყენებით (მაგალითად, გარე კავშირის მეშვეობით).
• სექცია "სასარგებლო პროცედურები და ფუნქციები" შეიცავს პროცედურებსა და ფუნქციებს, რომლებიც ქმნიან საერთო მოდულის შიდა განხორციელებას. იმ შემთხვევებში, როდესაც საერთო მოდული არის ნაწილი ზოგიერთი ფუნქციური ქვედანაყოფები, რომლებიც მოიცავს რამდენიმე მეტადატის ობიექტს, ამ სექციაში ასევე შეიძლება შეიცავდეს მომსახურების საექსპორტო პროცედურები და ფუნქციები, რომლებიც განკუთვნილია მხოლოდ ამ ქვესისტემის სხვა ობიექტებისგან.
  ნაყარი საერთო მოდულისთვის, რეკომენდირებულია ამ სექციის გაყოფა ქვეთავებში, ფუნქციური ატრიბუტის მიხედვით. Subsections წინ უძღვის კომენტარს, რომელიც რეკომენდირებულია მსგავსი გზით გამოსცეს. მაგალითად:

////////////////////////////////////////////////// ////////////////////////////// საინფორმაციო ბაზის განახლება

1.3. თარგების დიზაინის თარგები ობიექტის მოდულები, მენეჯერები, რეკორდული კომპლექტები, მკურნალობა, ანგარიშები და სხვა.

////////////////////////////////////////////////// ////////////////////////////// SOFTWARE INTERFACE ////////////// / ////////////////////////////////////////////////// ////////////// / ღონისძიებების პროვაიდერები //////////////////////////////// ///////////////////////////////////////////////// // // მომსახურების პროცედურები და ფუნქციები

• სექცია "პროგრამის ინტერფეისი" შეიცავს ექსპორტის პროცედურებსა და ფუნქციებს, რომლებიც განკუთვნილია სხვა კონფიგურირების მოდულებში ან სხვა პროგრამებში (მაგალითად, გარე კავშირის საშუალებით). ამ სექციაში არ არის აუცილებელი ექსპორტის ფუნქციები და პროცედურები, რომლებიც განკუთვნილია მხოლოდ ობიექტის მოდულებიდან, მისი ფორმებითა და ბრძანებებით. მაგალითად, ობიექტის მოდულის შევსების პროცესის შევსება და დოკუმენტის სახით ფორმა ბრძანების დამმუშავებლის ცხრილის ნაწილში დასახლების პროცედურები არ არის ობიექტის მოდულის პროგრამის ინტერფეისი ეწოდება მხოლოდ მოდულში და იგივე ობიექტის ფორმებიდან. ისინი უნდა განთავსდეს განყოფილებაში "კომუნალური პროცედურები და ფუნქციები."
• "ღონისძიების ჰოლდინგის " სექცია შეიცავს ობიექტის მოდულს ( პრეზავისი , პრო და ა.შ.)
• განყოფილება "კომუნალური პროცედურები და ფუნქციები" იგივეა, როგორც ზოგადი მოდულები.

1.4. სექციის დიზაინის თარგი ფორმა მოდულები:

////////////////////////////////////////////////// / / / / / / / ///////// ფორუმის მოვლენები ////////////////////////////////////////////////// /////////////// / ფორმის შედგენის ელემენტების დამლაგებლები //////////////////////// ////////////////////////////////////////////////// // / / / / / / / / / / / / / / / / / / / / / / / ////////////////////////////////////// / პროექტების გუნდები /////// ////////////////////////////////////////////////// /////////////////////// // სერვისის პროცედურები და ფუნქციები

• სექცია "ფორმა ღონისძიების ჰოლდინგები" შეიცავს ფორმა ღონისძიების დამამუშავებელ პროცედურებს: სერვერის შექმნაზე , გახსნას და ა.შ.
• სექცია "ფორმა ელემენტის ჰოლდინგები" შეიცავს ფორმის ძირითად ნაწილში არსებულ პროცედურებს (ყველაფერი, რაც არ არის დაკავშირებული ცხრილის ცხრილთან).
• განყოფილებაში "ფორმის ცხრილის თარიღის შემსრულებლები <ფორმის ცხრილის სახელი>" ფორმაში მოცემულია ცხრილისა და მაგიდის ელემენტების ჰანართების პროცედურები. გამტარუნარიანობის პროცედურებისათვის თითოეულ მაგიდას უნდა ჰქონდეს საკუთარი დანაყოფი.
• განყოფილება "ფორმა ბრძანებულები" შეიცავს ფორმა ბრძანებულების ხელსაწყოს წესებს (რომელთა სახელებიც მითითებულია ფორმის ბრძანებების სამოქმედო საკუთრებაში).
• განყოფილება "კომუნალური პროცედურები და ფუნქციები" იგივეა, როგორც ზოგადი მოდულები.

იხილეთ აგრეთვე: ფორმის მოდულების შექმნის წესები

2. ზოგადი მოთხოვნები პროგრამული უზრუნველყოფის მოდულების მონაკვეთებზე.

2.1. მოდულის ჰედერი არის კომენტარი მოდულის დასაწყისში. მოდულის სათაური მოკლე აღწერა და გამოყენების პირობები.
მაგალითად:

////////////////////////////////////////////////// //////////////////////////// // ზოგადი დანიშნულების კლიენტის პროცედურები და ფუნქციები: / - ფორმების სიებთან მუშაობა; / / - შესვლა შესვლა; // - გადამუშავების ქმედებებისთვის მომხმარებელი მიმდინარეობს რედაქტირება / მრავალჯერადი ტექსტი მაგალითად, დოკუმენტში კომენტარებს; // - სხვა. / / ///////////////////////////////////////////////// ////////////////////////////////

ფორმის მოდულისთვის, რეკომენდირებულია სათაურის პარამეტრების პარამეტრების აღწერა.

2.2. ცვლადი აღწერილობა სექცია . ცვლადი სახელები ენიჭება ზოგადად ცვლადი სახელების წესები და მათი გამოყენება აღწერილია სტატიაში. გლობალური ცვლადების გამოყენება პროგრამული მოდულებში .

ყველა მოდულის ცვლადი უნდა იყოს გათვალისწინებული კომენტარი საკმარისი იმისათვის, რომ გავიგოთ მათი მიზანი. კომენტარში რეკომენდირებულია განთავსდეს იგივე ხაზი, სადაც ცვლადი გამოცხადდა.
მაგალითი:

Pem ვალუტის ექსპორტი; / / ვალუტა, რომელშიც აღრიცხვა ინახება პერმი მისამართი მხარს უჭერს ექსპორტს; / / ელფოსტის მისამართი, სადაც შეცდომის შეტყობინებები იგზავნება

2.3. პროგრამული ინტერფეისი ექსპორტის პროცედურები და ფუნქციები, რომლებიც ქმნიან პროგრამირების ინტერფეისს, ჩაირთვება ცვლადის აღწერიდან. ამგვარი პროცედურები და ფუნქციები განკუთვნილია სხვა კონფიგურაციის საშუალებებით ან სხვა პროგრამებით (მაგალითად, გარე კავშირის საშუალებით) გამოსაყენებლად, ამიტომ მათ უნდა განთავსდეს მოდულში "ხილული ადგილი".

აგრეთვე იხილე: პროცედურების აღწერა და ფუნქციები.

2.4.1 ფორმა ღონისძიების დამმუშავებლები, ბრძანებები და ფორმა ელემენტები . ფორმის მოდულში მომსახურების პროცედურებისა და ფუნქციების შესრულებამდე, ფორმის ღონისძიების მონაწილეები განლაგებულია, აგრეთვე ღონისძიებების დამლაგებლები ბრძანებებისა და ფორმის ელემენტებისათვის.

მეთოდური რეკომენდაცია (სასარგებლო რჩევა)

რეკომენდირებულია, რომ ერთი ფორმის ელემენტის შემსრულებლები განთავსდეს ერთმანეთთან, შეესაბამებოდეს მათ შემდგომს რედაქტორის საკუთრების პანელში. კონფიგურატორი .

2.4.2. თითოეული ღონისძიება უნდა ჰქონდეს საკუთარი დამმუშავებლის პროცედურა. თუ იგივე ქმედებები უნდა შესრულდეს, როდესაც მოვლენები ხდება სხვადასხვა ელემენტებში:

• შექმნას ცალკე პროცედურა (ფუნქცია), რომელიც ასრულებს აუცილებელ ქმედებებს

• თითოეული ფორმის ელემენტისთვის, ცალკე დამმუშავებლის შექმნის სახელით

• მოვუწოდებთ საჭირო პროცედურას (ფუნქცია) თითოეული დამმუშავებლისგან.

მაგალითად, არასწორი:

& Executive Approval for OnClient Procedure (Element) შერჩევის პარამეტრები = ახალი შესაბამისობა (); Paste (ავტორი ავტორი ავტორი, ავტორი); პარამეტრები შერჩევა (პასპორტი ("აღმასრულებელი", აღმასრულებელი); შეარჩიეთ სია შერჩევა (სია, შერჩევა პარამეტრები); EndProcedure და ავტორიზაციისათვის კლიენტის პროცედურის შეცვლაზე (ელემენტის) აღმასრულებლის მიერ შეცვლის (დაუდგენელი) მიხედვით; EndProcedure

სწორი:

და OnClient საპროცესო შესრულება Indinator (საქონელი) SetSelection (); დამასრულებელი პროცედურა და კლიენტის პროცედურა ავტორი ავტორი რედაქტირება (ელემენტი) ინსტალაციის ინსტალაცია (); EndProcedures & OnServer Procedure SetSelection () შერჩევა პარამეტრების = ახალი შესაბამისობა (); Paste (ავტორი ავტორი ავტორი, ავტორი); პარამეტრები შერჩევა (პასპორტი ("აღმასრულებელი", აღმასრულებელი); შეარჩიეთ სია შერჩევა (სია, შერჩევა პარამეტრები); EndProcedure

ეს მოთხოვნა გამომდინარეობს იმ ფაქტის გამო, რომ ღონისძიების დამუშავების პროცედურების ლოგიკა არ არის განკუთვნილი მოდულის კოდის გამოყენებაზე, მაგრამ პირდაპირ პლატფორმას უწოდებენ. ამ ორი სცენარის შერწყმა ერთ პროცედურაში ზედმეტად ართულებს თავის ლოგიკას და ამცირებს მისი სიმტკიცე (ნაცვლად ერთი ზარის სცენარის ნაცვლად - პლატფორმის შემთხვევაში - პროცედურის კოდექსი ითვალისწინებს კოდიდან პირდაპირ ზარებს).

2.5. ობიექტის მოდულების და ობიექტის მენეჯერის ღონისძიების ღონისძიებები ექსპორტის შემდეგ განთავსდება, მაგრამ კომუნალური პროცედურების და მოდულის ფუნქციებამდე.

მეთოდური რეკომენდაცია (სასარგებლო რჩევა)

რეკომენდებულია ხელი მოაწეროს ხელით, რომლებიც შეესაბამება ჩანერგილი ენის აღწერას.

2.6. კომუნალური პროცედურები და მოდული ფუნქციები , რომლებიც არ არიან მოვლენის დამმუშავებლები, მაგრამ მოდულის შიდა განხორციელებაა, მოთავსებულია ღონისძიების მომდევნო მოდულში.

იმ შემთხვევებში, როდესაც საერთო მოდული ფუნქციონალური ქვესისტემის ნაწილია, რომელიც მოიცავს რამდენიმე მეტადატის ობიექტს, ამ სექციაში ასევე შეიძლება შეიცავდეს მომსახურების საექსპორტო პროცედურები და ფუნქციები, რომლებიც განკუთვნილია მხოლოდ ამ ქვესისტემის სხვა ობიექტებიდან.

ერთმანეთთან დაკავშირებული პროცედურები და ფუნქციები ბუნების ან ლოგიკის მეშვეობით არის რეკომენდებული ერთად. არ არის რეკომენდირებული მოდულის პროცედურები და ფუნქციები, რომლებიც სერვერზე, კლიენტსა და ფუნქციებში კონტექსტის გარეშე არ შედიან, რადგან ასეთი "ტექნოლოგიური" შეკვეთა ართულებს მოდულის ლოგიკის გააზრებას, დეველოპერის ყურადღების გადატანას მისი განხორციელების დეტალებზე.

2.7. საწყისი განყოფილება შეიცავს განცხადებებს, რომლებიც მოდულის ან ობიექტის (ფორმის) ცვლადების ინიციალიზებას ახდენენ. მაგალითად:

მხარდაჭერა მისამართი = "[email protected]"; / მისამართი ტექნიკური დახმარების დასაკავშირებლად. შესრულების ინიციალიზაცია ();

სხვა მასალები თემაზე:
მონაცემთა ბაზის განახლება , ღონისძიების handlers , პროგრამული ინტერფეისი , ელ , პროცედურები , ნიმუში , სათაურით , პროცედურის დასრულება , ფუნქციები , ინტერფეისი , აღწერა , ბუფერში , კოპირება , სექცია , გაცვლა , ფორმები , ობიექტი , ელემენტს , კონფიგურაცია , კონფიგურაციები , დოკუმენტი

მასალას სექცია: 1C: საწარმო 8.2 / დეველოპერები / შეთანხმებები კოდის დაწერისას

სხვა მასალები თემაზე:

პროცედურების აღწერა და ფუნქციები

შერჩეული ობიექტის სკალირების მახასიათებლები

1C: საწარმო 8.2 პლატფორმაზე კონფიგურაციების გადაცემა 1C: საწარმო 8.3 პლატფორმაზე თავსებადობის რეჟიმის გარეშე ვერსია 8.2

პროცედურების და ფუნქციების სახელები

პრივილეგირებული რეჟიმის გამოყენება

ჩვენ ვხედავთ: მოდულის 1c სტრუქტურა , სერვისის პროცედურები და ფუნქციები , მოდული, მენეჯერის მოდული ზარის პროცედურა 1c 8 2, თუ როგორ უნდა დარეკოთ პროცედურა სხვა მოდულის 1c, ინგლისური მოდულის ჰედერისაგან, 1 გ დამუშავების ფორმა ზარის მოდულის პროცედურისგან, 1c 8 2 დარეკეთ პროცედურა მენეჯერის მოდულისგან, 1