1C: Kurumsal 8.2 /
Geliştiriciler için /
Kod Kuralları

İçindekiler

1.1. Genel olarak program modülünde (genel modüller, nesne modülleri, nesne yöneticileri modülleri, form modülleri, komutlar, vb.) Aşağıdaki bölümler aşağıda yer alabilir. sekans :

Bazı bölümler yalnızca belirli tipteki modüllerde bulunabilir. Örneğin, form öğeleri için olay işleyicileri yalnızca form modüllerinde bulunabilir ve değişken açıklama bölümü ve başlatma bölümü global olmayan genel modüller, nesne yöneticisi modülleri, kayıt kümeleri, sabit değerler ve oturum modülünde tanımlanamaz.

Modül kodunu bölümlere ayırma zorunluluğu, kodun okunabilirliğini arttırmak ve farklı yazarlar tarafından koda yapılan değişikliklerin uygulanmasını kolaylaştırmak içindir ( geliştiriciler tarafından (toplu gelişimde olduğu gibi) ve belirli uygulamalar için uygulama çözümlerinin geliştirilmesinde.

1.2. Ortak modüller için şablon (kopyalama için boş) bölümleri:

////////////////////////////////////////////////// ////////////////////////////Tr/ // // // //////////// ////////////////////////////////////////////////// ////////////// /////////////////////9/s/ /////////////////////////Tr///////////tr///// // // // YAZILIM ARAYÜZÜ ARAÇ // ////////////////////////////////////////////////// //////////////////////////// // // HİZMET İŞLEMLERİ VE FONKSİYONLARI

• "Program arayüzü" bölümü, diğer konfigürasyon nesneleri veya diğer programlar (örneğin harici bir bağlantı aracılığıyla) tarafından kullanılması amaçlanan ihracat prosedürlerini ve fonksiyonlarını içerir.
• "Yardımcı İşlemler ve İşlevler" bölümü, ortak bir modülün iç uygulamasını oluşturan prosedürleri ve işlevleri içerir. Ortak modülün bir kısmının parçası olduğu durumlarda fonksiyonel Birkaç meta veri nesnesi içeren alt sistemler, bu bölüm ayrıca yalnızca bu alt sistemin diğer nesnelerinden çağrılması amaçlanan servis verme prosedürlerini ve işlevlerini içerebilir.
  Genel ortak modüller için, bu özelliğe göre bu bölümün alt bölümlere ayrılması önerilir. Alt bölümler, benzer şekilde yayınlanması önerilen bir yorumdan önce gelir. Örneğin:

////////////////////////////////////////////////// /////////////////////////////// Bilgi tabanı güncellemesi

1.3. Nesne modülleri, yöneticiler, kayıt kümeleri, işlemler, raporlar, vb. Bölümlerin tasarım şablonu:

////////////////////////////////////////////////// /////////////////////////////Tr // // YAZILIM ARAYÜZÜ ////////////// ////////////////////////////////////////////////// ////////////// // // ETKİNLİKLERİN İŞLEMCİLERİ //////////////////////7/dir/ // // HİZMET PROSEDÜRLERİ VE FONKSİYONLARI

• "Program Arabirimi" bölümü, diğer konfigürasyon modüllerinde veya diğer programlarda (örneğin harici bir bağlantı aracılığıyla) kullanılması amaçlanan ihracat prosedürlerini ve işlevlerini içerir. Bu bölüme, yalnızca nesnenin modüllerinden, formlarından ve komutlarından çağrılması amaçlanan dışa aktarma işlev ve prosedürlerini yerleştirmek gerekli değildir. Örneğin, nesne modülündeki dolum işleminden ve form komut işleyicisindeki belge formundan çağrılan bir belgenin tablo parçasını doldurma prosedürleri, nesne modülünün program arayüzü değildir, çünkü sadece modülün kendisinde ve aynı nesnenin formlarında çağrılır. Yerleştirilmeleri gerekir bölümde "Yardımcı işlemler ve işlevler."
• "Olay İşleyicileri" bölümü , nesnenin modülü için olay işleyicileri içerir ( Prizavisi , PRO , vb.)
• "Fayda Prosedürleri ve Fonksiyonlar" bölümü, genel modüllerde olduğu gibi aynı amaca sahiptir.

1.4. Form modülleri için bölüm tasarım şablonu:

////////////////////////////////////////////////// ////////////////////////////// // // FORST'UN OLAYLARININ BAŞKANLARI ///////////// ////////////////////////////////////////////////// ////////////// // // BİÇİMLENDİRME ŞEKLİ ELEMANLARININ OLAYLARININ ELEMANLARI //////////////////// ////////////////////////////////////////////////// // // OLAY FORMLARININ İŞLEMCİLERİ TABLOLAR /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// di dipps diS diS di di di di di di digse di di lse )se // // // / / / / / / / / / / / / / / / ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////Sataabab/a/////////////////////////////////////////////////////////////////evieşeğiılarıyyüzülupa// ////////////////////////////////////////////////// //////////////////////// // HİZMET İŞLEMLERİ VE FONKSİYONLARI

• “Form olay işleyicileri” bölümü, form olay işleyici prosedürlerini içerir: Bir Sunucu Oluşturma , Açma , vb.
• "Form elemanı işleyicileri" bölümü, formun ana bölümünde bulunan öğeleri işleme prosedürlerini içerir (formdaki tablolarla ilgili olmayan her şey).
• “Form tablosunun olay işleyicileri <form tablosu adı>” bölümlerinde, form tablosunun ve tablo öğelerinin işleyicileri için prosedürler vardır. İşleyici prosedürleri için, her tablonun kendi bölümü olmalıdır.
• “Form komut işleyicileri” bölümü, form komut işleyicileri için prosedürleri içerir (adları, form komutlarının Eylem özelliğinde belirtilir).
• "Fayda Prosedürleri ve Fonksiyonlar" bölümü, genel modüllerde olduğu gibi aynı amaca sahiptir.

Ayrıca bakınız: Form modülleri oluşturma kuralları

2. Yazılım modüllerinin bölümleri için genel şartlar.

2.1. Modül başlığı , modülün başında bir yorumdur. Modül başlığı, kısa bir açıklama ve uygulama koşulları sağlar.
Örneğin:

////////////////////////////////////////////////// ///////////////////////////// // // Genel Amaçlı müşteri prosedürleri ve işlevleri: // - formlardaki listelerle çalışmak için; // - kütükle çalışmak; // - işlemler için kullanıcı devam ediyor düzenlemek // multiline metin , örneğin belgelerdeki yorumlar; // - diğer. // /////////////////////////////////9/s/ ////////////////////////////////

Form modülleri için, başlığa form parametrelerinin bir tanımını yerleştirmeniz önerilir.

2.2. Değişken açıklama bölümü . Genel isme göre değişken isimleri atanır. değişken isim kuralları ve bunların kullanımı makalede anlatılmıştır. Global değişkenlerin yazılım modüllerinde kullanılması .

Tüm modül değişkenlerine amaçlarını anlamak için yeterli yorum yapılmalıdır. Yorumun, değişkenin bildirildiği aynı satıra yerleştirilmesi önerilir.
örnek:

Pem Döviz Kuru Muhasebe İhracat; // Muhasebenin tutulduğu para birimi Perem Adresi İhracatı Destekler; // Hata mesajlarının gönderildiği e-posta adresi

2.3. Yazılım arayüzü İhracat prosedürleri ve programlama arayüzünü oluşturan fonksiyonlar değişkenlerin tanımlanmasından hemen sonra yerleştirilir. Bu gibi prosedürler ve fonksiyonlar diğer konfigürasyon nesneleri veya başka programlar tarafından (örneğin harici bir bağlantı aracılığıyla) kullanılmak üzere tasarlanmıştır, bu nedenle modülde “görünür bir yere” yerleştirilmelidirler.

Ayrıca bakınız: Prosedürlerin ve fonksiyonların açıklaması.

2.4.1 Form olayı işleyicileri, komutları ve form öğeleri . Form modülündeki servis prosedürleri ve işlevlerinden önce, formun olay işleyicileri, komutlar ve form öğeleri için olay işleyicileri bulunur.

Metodik öneri (faydalı tavsiyeler)

Bir form öğesinin işleyicilerinin, form düzenleyici özellikleri panelinde aşağıdaki sıralarına bağlı kalarak bir arada yerleştirilmesi önerilir. konfigüratörde .

2.4.2. Her olay kendi işleyici prosedürüne sahip olmalıdır. Olaylar formun farklı öğelerinde gerçekleştiğinde aynı eylemler gerçekleştirilmesi gerekirse:

• Gerekli işlemleri yapan ayrı bir prosedür (fonksiyon) oluşturmak

• Her form öğesi için, varsayılan ada sahip ayrı bir işleyici oluşturun

• Her işleyiciden gerekli prosedürü (işlevi) çağırın.

Örneğin, yanlış:

& OnClient Uygulamanın Çalıştırılması Prosedürü (Eleman) Seçim Parametreleri = Yeni Uyum (); Seçenekler Seçimi Yapıştır ("Yazara Göre", Yazara Göre); Seçenekler Seçimi Yapıştır ("Executive", Executive); Liste Seçimini Ayarla (Liste, Seçim Seçenekleri); KonetsProtsedury Değişen (Eleman) Olarak Değişim Yaparak İcra İşlemi (Eleman) Değişen İcra İdaresi (Tanımsız); KonetsProtsedury

doğru:

& PerformIndicator (Item) SetSelection () için OnClient Prosedürü; İşlemi Sonlandır ve Müşteri İşleminde İşlemi Yazara Göre (Element) Kurulum Seçimi (); EndProcedures & OnServer Prosedürü SetSelection () Seçim Parametreleri = Yeni Uygunluk (); Seçenekler Seçimi Yapıştır ("Yazara Göre", Yazara Göre); Seçenekler Seçimi Yapıştır ("Executive", Executive); Liste Seçimini Ayarla (Liste, Seçim Seçenekleri); KonetsProtsedury

Bu gereklilik, olay işleyici prosedürlerinin mantığının modül kodunda kullanılması amaçlanmadığından, doğrudan platform tarafından çağrılmasından kaynaklanmaktadır. Bu iki senaryoyu tek bir prosedürde karıştırmak gereksiz yere mantığını zorlaştırır ve sağlamlığını azaltır (öngörülen arama senaryosu yerine - platformdan gelen bir olay üzerine - prosedür kodu koddan doğrudan yapılan diğer çağrıları dikkate almalıdır).

2.5. Nesne modülleri ve nesne yöneticisi için olay işleyicileri dışa aktarmadan sonra ancak yardımcı program prosedürleri ve modül işlevlerinden önce yerleştirilir.

Metodik öneri (faydalı tavsiyeler)

Gömülü dilin açıklamasındaki sıralarını takip ederek işleyicilerin yerleştirilmesi önerilir.

2.6. Olay işleyicileri olmayan ancak bir modülün iç uygulamasını oluşturan yardımcı program prosedürleri ve modül işlevleri , olay işleyicilerin yanına modüle yerleştirilir.

Ortak bir modülün birkaç meta veri nesnesi içeren işlevsel bir alt sistemin bir parçası olduğu durumlarda, bu bölüm yalnızca bu alt sistemin diğer nesnelerinden çağrılması amaçlanan servis verme prosedürlerini ve işlevlerini içerebilir.

Birbirlerine ilişkin işlerin niteliği veya iş mantığı ile ilgili prosedür ve işlevlerin bir araya getirilmesi önerilir. Modülün prosedürlerini ve işlevlerini sunucu, müşteri ve fonksiyonlar bağlamında açık bir şekilde gruplandırmanız önerilmez, çünkü bu “teknolojik” sipariş, modülün mantığının anlaşılmasını zorlaştırır, geliştiricinin dikkatini uygulama detaylarına yönlendirir.

2.7. Başlatma bölümü , modül veya nesnenin değişkenlerini başlatan ifadeler içerir (form). Örneğin:

Destek Adresi = "[email protected]"; // Teknik destek ile bağlantıya geçmek için adres gerçekleştirin Başlatma ();

Konuyla ilgili diğer malzemeler:
veritabanını güncelle . olay işleyicileri . yazılım arayüzü . işleyicileri . prosedürler . şablon . başlık . prosedürün sonu . fonksiyonlar . arayüzey . tanım . pano . kopyalamak . bölüm . takas . şekil . bir nesne . eleman . yapılandırarak . yapılandırma . belge

Bölümden Malzemeler: 1C: Enterprise 8.2 / Geliştiriciler / Kod yazarken anlaşmalar

Konuyla ilgili diğer malzemeler:

Prosedürlerin ve fonksiyonların açıklaması

Seçilen nesne için ölçeklendirmenin özellikleri

1C: Enterprise 8.2 platformundaki konfigürasyonların 8.2 sürümüyle uyumsuz mod olmadan 1C: Enterprise 8.3 platformuna aktarılması

Prosedürlerin ve fonksiyonların isimleri

Ayrıcalıklı modu kullanma

1c modülünün yapısı , servis prosedürleri ve işlevleri , modül, yönetici modülü çağrı prosedürü 1c 8 2, başka bir modül 1c'den bir prosedürün nasıl çağırılacağı, İngilizce modül başlığı, 1c bir işlem formu çağrı modülü prosedüründen, 1c 8 2, yönetici modülünden bir prosedürü çağırır, 1