1C: Poduzeće 8.2 /
Za programere /
Konvencije o kodovima

Sadržaj

1.1. U programskom modulu (opći moduli, moduli objekata, moduli upravitelja objekata, moduli obrazaca, naredbe, itd.) U općem slučaju sljedeći odjeljci mogu biti prisutni u sljedećem sekvenca :

Neki dijelovi mogu biti prisutni samo u modulima određene vrste. Na primjer, rukovatelji događaja za elemente obrasca mogu biti prisutni samo u modulima obrazaca, a odjeljak opisa varijable i sekcija inicijalizacije ne mogu se definirati u ne-globalnim općim modulima, modulima upravitelja objekata, skupovima zapisa, konstantnim vrijednostima i modulima sesija.

Zahtjev za podjelom koda modula u odjeljke namijenjen je povećanju čitljivosti koda i pojednostavljenju uvođenja promjena u kodove različitih autora ( programeri ) kao u kolektivnom razvoju, te u usavršavanju aplikativnih rješenja za određene implementacije.

1.2. Odjeljak predloška (prazno za kopiranje) za uobičajene module:

////////////////////////////////////////////////// ////////////////////////////// // // //////////// ////////////////////////////////////////////////// ////////////// //////////////////////////////////// //////////////////////////////////////////// // // SOFTVERSKI INTERFACE ////////////////////////////////////////////////// //////////////////////////// // SERVISNI POSTUPCI I FUNKCIJE

• Odjeljak "Programsko sučelje" sadrži izvozne postupke i funkcije namijenjene za korištenje u drugim konfiguracijskim objektima ili drugim programima (na primjer, putem vanjske veze).
• Odjeljak "Postupci i funkcije komunalnih usluga" sadrži postupke i funkcije koje čine unutarnju implementaciju zajedničkog modula. U slučajevima kada je zajednički modul dio nekih funkcionalna podsustavi koji uključuju nekoliko objekata metapodataka, ovaj odjeljak može sadržavati i procedure izvoza usluga i funkcije namijenjene samo za pozivanje iz drugih objekata ovog podsustava.
  Za skupne zajedničke module preporuča se podijeliti ovaj odjeljak na pododjeljke, u skladu s funkcionalnim atributom. Podsekcijama prethodi komentar, koji se preporuča izdati na sličan način. Na primjer:

////////////////////////////////////////////////// ////////////////////////////// // Ažuriranje baze podataka

1.3. Predložak za dizajn odjeljaka za objektne module, upravitelje, skupove zapisa, tretmane, izvješća itd.

////////////////////////////////////////////////// ////////////////////////////// // SOFTVERSKO SUČELJE ////////////// // ////////////////////////////////////////////////// ////////////// // PROCESORI DOGAĐANJA //////////////////////////////// //////////////////////////////////////////////// // // POSTUPCI I FUNKCIJE USLUGA

• Odjeljak "Programsko sučelje" sadrži postupke i funkcije izvoza namijenjene za upotrebu u drugim konfiguracijskim modulima ili drugim programima (na primjer, putem vanjske veze). U ovom odjeljku nije potrebno izvoziti funkcije i postupke koji se namjeravaju pozivati ​​samo iz modula samog objekta, njegovih oblika i naredbi. Na primjer, procedure za popunjavanje dijela tablice dokumenta koje se poziva iz obrade punjenja u objektnom modulu i iz obrasca dokumenta u obrascu naredbe obrasca nisu programsko sučelje objektnog modula, jer nazivaju se samo u samom modulu i iz oblika istog objekta. Oni bi trebali biti postavljeni u odjeljku "Komunalne procedure i funkcije."
• Odjeljak "Rukovatelji događajima" sadrži rukovatelje događaja za modul objekta ( Prizavisi , PRO , itd.)
• Odjeljak "Postupci i funkcije komunalnih usluga" ima istu svrhu kao u općim modulima.

1.4. Predložak za dizajn odjeljka za module obrasca:

////////////////////////////////////////////////// ////////////////////////////// // RUKOVANJE DOGAĐAJIMA FORME ///////////// ////////////////////////////////////////////////// /////////////// // RUKOVATELJI DOGAĐANJA ELEMENTA OBLIKA FORMA //////////////////////////// ////////////////////////////////////////////////// // // PROCESORI DOGAĐAJA TABELA ////////////////////////////////////////// ////////////////////////////////////// // PROCESORI ZA TIMOVE FORME /////// ////////////////////////////////////////////////// /////////////////////// // SERVISNI POSTUPCI I FUNKCIJE

• Odjeljak “Obrađivači događaja u obrascu” sadrži postupke za rukovatelje događajima obrasca: o stvaranju poslužitelja , otvaranju itd.
• Odjeljak "Rukovatelji elementima obrasca" sadrži procedure za obradu elemenata smještenih u glavnom dijelu obrasca (sve što nije povezano s tablicama na obrascu).
• U odjeljcima “Rukovatelji događaja u tablici obrazaca <ime tablice forme>” postoje procedure za rukovatelje tablica obrazaca i elemenata tablice. Za postupke rukovatelja, svaka tablica mora imati svoju vlastitu particiju.
• Odjeljak “Form dizajneri naredbi” sadrži procedure za rukovatelje naredbi obrasca (čija se imena navode u svojstvu Action naredbi obrasca).
• Odjeljak "Postupci i funkcije komunalnih usluga" ima istu svrhu kao u općim modulima.

Vidi također: Pravila za izradu modula obrazaca

2. Opći zahtjevi za dijelove softverskih modula.

2.1. Zaglavlje modula je komentar na samom početku modula. Naslov modula daje kratak opis i uvjete primjene.
Na primjer:

////////////////////////////////////////////////// //////////////////////////// // // Klijentske procedure i funkcije opće namjene: // - za rad s popisima u formama; // - za rad s logom; // - za radnje obrade korisnik u tijeku uređivanje // multiline tekst , na primjer, komentari u dokumentima; // - drugo. // ////////////////////////////////////////////// ////////////////////////////////

Za module modula, preporuča se da u zaglavlje stavite opis parametara obrasca.

2.2. Odjeljak s opisom varijable . Imena varijabli dodjeljuju se prema općem pravila imena varijable , a njihova uporaba opisana je u članku. Korištenje globalnih varijabli u softverskim modulima ,

Sve varijable modula trebale bi imati komentar koji je dovoljan za razumijevanje njihove svrhe. Komentar se preporuča postaviti u istu liniju gdje je varijabla deklarirana.
primjer:

Pem CurrencyAccounting Izvoz; // Valuta u kojoj se vodi računovodstvo Perem adresa podržava izvoz; // Adresa e-pošte na koju se šalju poruke o pogrešci

2.3. Sučelje softvera Izvozne procedure i funkcije koje sačinjavaju programsko sučelje postavljaju se odmah nakon opisa varijabli. Takvi postupci i funkcije namijenjeni su za uporabu drugim objektima konfiguracije ili drugim programima (na primjer, putem vanjske veze), stoga ih treba smjestiti na "vidljivo mjesto" u modulu.

Vidi također: Opis postupaka i funkcija.

2.4.1 Obrađujte obrađivače događaja, naredbe i elemente obrasca . Prije servisnih procedura i funkcija u modulu obrasca nalaze se rukovatelji događaja u obrascu, kao i rukovatelji događajima za naredbe i elemente obrasca.

Metodička preporuka (koristan savjet)

Preporučuje se da rukovatelji jednog elementa obrasca budu smješteni zajedno, pridržavajući se redoslijeda koji slijedi u ploči svojstava urednika obrasca. u konfiguratoru ,

2.4.2. Svaki događaj mora imati vlastitu proceduru rukovanja. Ako se iste radnje obavljaju kada se događaji odvijaju u različitim elementima obrasca:

• stvorite zasebnu proceduru (funkciju) koja obavlja potrebne radnje

• za svaki element obrasca izradite zasebni upravljač s zadanim nazivom

• pozovite potrebnu proceduru (funkciju) od svakog rukovatelja.

Na primjer, pogrešno:

& OnClient procedura za izvršavanje odabira parametara aplikacije (elementa) = Nova usklađenost (); Odabir mogućnosti: Zalijepi ("Po autoru", Po autoru); Mogućnosti odabira: Zalijepi ("izvršni", izvršni); Postavite odabir popisa (popis, opcije odabira); KonetsProtsedury & O Klijentu Postupak za pisanje promjenom (elementom) do izvršne vlasti promjenom (nedefinirano); KonetsProtsedury

ispravno:

& OnClient Postupak za izvođenje indikatora (stavka) SetSelection (); Završite postupak & Na klijenta Postupak po autoru Promjena (Element) Instalacija odabira (); EndProcedures & OnServer Procedura SetSelection () Parametri odabira = Nova usklađenost (); Odabir mogućnosti: Zalijepi ("Po autoru", Po autoru); Mogućnosti odabira: Zalijepi ("izvršni", izvršni); Postavite odabir popisa (popis, opcije odabira); KonetsProtsedury

Ovaj zahtjev je zbog činjenice da logika postupaka rukovatelja događaja nije namijenjena za upotrebu u kodu modula, već se pozivaju izravno platformom. Miješanje tih dvaju scenarija u jednoj proceduri nepotrebno komplicira njegovu logiku i smanjuje njezinu robusnost (umjesto jednog predviđenog scenarija poziva - nakon događaja s platforme - kod procedure mora računati na druge izravne pozive iz koda).

2.5. Rukovatelji događaja za objektne module i objektni upravitelj smješteni su nakon izvoza, ali prije uslužnih procedura i funkcija modula.

Metodička preporuka (koristan savjet)

Preporučuje se da u opisu ugrađenog jezika postavite rukovatelje koji odgovaraju redoslijedu koji slijedi.

2.6. Pomoćni postupci i funkcije modula koje nisu obrađivači događaja, ali čine unutarnju implementaciju modula, smještene su u modul pored rukovaoca događaja.

U slučajevima kada je zajednički modul dio funkcionalnog podsustava koji uključuje nekoliko objekata metapodataka, ovaj odjeljak može sadržavati i postupke izvoza usluga i funkcije namijenjene samo za pozivanje iz drugih objekata ovog podsustava.

Preporučuje se da se postupci i funkcije međusobno po prirodi ili logici rada postavljaju zajedno. Ne preporučuje se eksplicitno grupirati postupke i funkcije modula u poslužitelj, klijent i funkcije bez konteksta, jer takvo „tehnološko“ naručivanje komplicira razumijevanje logike modula, skrećući pažnju razvojnog programera na detalje njegove implementacije.

2.7. Sekcija inicijalizacije sadrži izjave koje inicijaliziraju varijable modula ili objekta (forme). Na primjer:

Adresa za podršku = "[email protected]"; // Adresa za kontaktiranje tehničke podrške Izvršite inicijalizaciju ();

Ostali materijali na temu:
ažuriranje baze podataka , rukovatelje događajima , sučelje softvera , rukuju , postupci , predložak , zaglavlje , kraj postupka , funkcije , sučelje , opis , međuspremnik , za kopiranje , odjeljak , razmjena , oblik , objekt , element , konfiguriranje , konfiguracija , dokument

Materijali iz odjeljka: 1C: Enterprise 8.2 / Programeri / Sporazumi prilikom pisanja koda

Ostali materijali na temu:

Opis postupaka i funkcija

Značajke skaliranja za odabrani objekt

Prijenos konfiguracija na 1C: Enterprise 8.2 platformu na 1C: Enterprise 8.3 platformu bez načina kompatibilnosti s verzijom 8.2

Nazivi postupaka i funkcija

Korištenjem povlaštenog načina rada

Nalazimo: strukturu modula 1c , servisne postupke i funkcije , modul, postupak poziva 1c 8 2 upravljačkog modula, kako pozvati proceduru iz drugog modula 1c, zaglavlje modula za engleski jezik, 1c iz postupka modula za pozivanje procesiranja, 1c 8 2 pozvati proceduru iz modula upravitelja, 1