Сравнение страниц

Хранилище конфигурации

• Все конфигурации должны быть подключены к хранилищам конфигураций

• Расширения допускается не подключать к хранилищам

...

• Каждый разработчик должен работать под своим именем. Для этого он должен получить у Администратора хранилища логин/пароль и право захвата объектов в конфигурации

• Обновление рабочей конфигурации происходит под универсальным пользователем. Под этим пользователем не допускается внесение изменений в конфигурацию

Расширения

Расширения могут быть использованы в двух случаях:

• Поставщик конфигурации реализовал исправление ошибки

• Для внесения срочного изменения конфигурации

...

• в

...

• конфигурацию

Базы для разработчиков

• Каждому разработчику необходимо иметь собственную копию базы с конфигурацией, которую ему необходимо изменять

• Для получения копии необходимо обратиться к Администратору баз данных

• После получения копии ее необходимо отключить от хранилища и подключить с логином/паролем, полученным Администратором хранилища

...

При необходимости создания новых объектов разработчик должен

...

захватить корень хранилища

...

создать все объекты, которые ему необходимы для решения задачи (в том числе подсистемы и т.д.).

...

Создание новых объектов конфигурации

Новый объект конфигурации должен иметь префикс PRO_ (независимо от разработчика, подрядчика)

Подсистема

Новый объект конфигурации должен быть размещен в подсистеме PRO_…

Если требуется добавить объект в штатную подсистему, то необходимо сначала создать в этой подсистеме подсистему PRO_…

Исключения

Исключениями являются объекты, входящие в обновляемые подсистемы сторонних разработчиков, таких как: Diadoc. PAPI, ПИТ и т.п.

Если объекты таких подсистем не находятся на поддержке и не планируется их обновление, префикс должен быть PRO_

Добавление собственных реквизитов и табличных частей в стандартные объекты

Если реквизит или табличная часть добавляется в стандартный объект конфигурации, то он должен иметь префикс PRO_

Если реквизит или табличная часть добавляется в собственный объект конфигурации, специальных префиксов у него быть не должно

Как создать новый объект конфигурации

• Захватить корень хранилища и подсистемы, в которых будет размещен объект

• Создать все объекты, которые необходимы для решения задачи, в том числе подсистемы. Включить все объекты в необходимые подсистемы

• Создать роли на доступ к объектам, включить новые роли в те же подсистемы, в которые включен новый объект

• Если новый объект - Константа, разместить ее на общей форме PRO_Настройки, расположив в группе по смыслу значения

• Проверить, что конфигурация собирается без ошибок (особенно при создании регистров)

• вытолкнуть все новые объекты в хранилище

• отпустить корень хранилища. Это необходимо делать до создания модулей всех реквизитов объектов (кроме обязательных)

• Поместить в хранилище все созданные объекты, оставив захваченными

• Отпустить корень хранилища

Как заменить реквизит или объект на новый

Бывают ситуации, когда необходимо перенести реквизит из расширения в основную конфигурацию, или заменить один реквизит другим (был текстовый реквизит, стал перечислением, ссылкой и т.п.). Общий алгоритм следующий:

• Переименовать старый реквизит - добавить в начало префикс Удалить_

• При переименовании учесть изменение кода модулей

• Добавить новый реквизит с новым типом

• Изменить код модулей таким образом, чтобы он работал с новым реквизитом

• Написать обработку заполнения данных из старого реквизита в новый

• Передать обработку Главному разработчику для выполнения после обновления рабочей конфигурации

Расширения

Расширения могут быть использованы в двух случаях:

• Поставщик конфигурации реализовал исправление ошибки

• Для внесения срочного изменения конфигурации

В дальнейшем функционал расширения должен пройти рефакторинг и внесение в основную конфигурацию

Дополнительные обработки и отчеты

Дополнительные отчеты и обработки (далее просто Обработки) допускается использовать для очень редко выполняемых задач.

Текст внешней обработки не может быть автоматически протестирован при изменении / обновлении конфигурации, поэтому нет никаких гарантий работоспособности обработок на длительном периоде.

Все отчеты и обработки, запускаемые хотя бы раз в квартал, должны быть перенесены в основную конфигурацию.

Примером обработки, которая не будет перенесена в основную конфигурацию является обработка Диадок. Она поддерживается компанией-разработчиком, не изменяет структуру базы данных.

При разработке отчета и обработки

В процессе разработки обработки необходимо создать объект в конфигурации, после чего его можно выгрузить во внешнюю обработку/отчет для доработки, оставив объект конфигурации в захваченном виде.

При завершении разработки объект в конфигурации заменить на внешнюю обработку/отчет и поместить в хранилище

Комментарий в тексте модуля

Комментарии должны содержать специальные символы для идентификации кода при обновлении.

Комментарии должны быть достаточно понятными, чтобы пояснять работу модуля или комментируемого оператора.

Тексты комментариев должны составляться по правилам русского языка, в деловом стиле, быть эмоционально сдержанными и не содержать слов, не относящихся к функциональности программы. 

//++PRO, Создает прокси на основе определения веб-сервиса и связывает
// его с точкой подключения веб-сервиса. 
  ...
  Код программы
  ...
//--PRO 

Программирование

• Стандартные объекты не изменяем

Если необходимо изменить стандартный объект

Изменить модуль стандартного объекта

Все изменения должны находится в блоке, у которого написан комментарий

//++PRO Дата и фамилия изменившего, краткое описание что изменено и зачем
//Например, добавлено автоматическое заполнение Направления деятельности из договора, 
//чтобы не было проблем при взаиморасчетах
Код...
//--PRO

Изменить форму стандартного объекта

Все изменения вносятся программно в модуле объекта. В процедуре ПриСозданииНаСервере вызывается функция модуля PRO__СобытияФорм

в модуле объекта формы:
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
...
//++PRO
  PRO__СобытияФорм.ПриСозданииНаСервере(ЭтаФорма);
//--PRO
...
КонецПроцедуры

в общем модуле: 
Процедура ПриСозданииНаСервере(ЭтаФорма) Экспорт 	
	ИмяФормы = ЭтаФорма.ИмяФормы;
	Если ИмяФормы = "Справочник.Контрагенты.Форма.ФормаЭлемента" Тогда
		ПриСозданииНаСервереКорреспонденты(ЭтаФорма);	
	ИначеЕсли ИмяФормы = ... Тогда
		...
	КонецЕсли;
КонецПроцедуры

Процедура ПриСозданииНаСервереКорреспонденты(ЭтаФорма)
  НовыйЭлемент = ЭтаФорма.Элементы.Добавить("PRO_Поклажедатель", Тип("ПолеФормы"), ЭтаФорма.Элементы.ГруппаСтраницы);
  НовыйЭлемент.Вид = ВидПоляФормы.ПолеФлажка;
  НовыйЭлемент.ПутьКДанным = "Объект.PRO_Поклажедатель";
 КонецПроцедуры 

Добавить процедуру/функцию в стандартный модуль объекта

Все процедуры/функции должны начинаться с префикса PRO_…, например PRO_РасчетЗадолженностиНаДату(ДатаЗадолженности)

НЕ писать комментарий перед процедурой/функцией, если необходимо добавить комментарий, то написать его внутри процедуры

Правильно

&НаКлиенте
Процедура PRO_РасчетЦен(Команда)
//Добавлена команда расчета цен, 01.01.2020

	Если Объект.Проведен=Истина Тогда
		PRO_ОбщегоНазначенияСервер.СформироватьОсновнойЗапросЦенообразования(Объект.Ссылка);
	Иначе
		Сообщить("Необходимо провести документ");
	КонецЕсли;
КонецПроцедуры

Неправильно

//++PRO, добавлена команда расчета цен, 01.01.2020
&НаКлиенте
Процедура PRO_РасчетЦен(Команда)
	Если Объект.Проведен=Истина Тогда
		PRO_ОбщегоНазначенияСервер.СформироватьОсновнойЗапросЦенообразования(Объект.Ссылка);
	Иначе
		Сообщить("Необходимо провести документ");
	КонецЕсли;
КонецПроцедуры
//--PRO

Добавление нескольких процедур и функций

Если в штатный модуль добавлено более 2-х собственных процедур/функций, то их необходимо объединить в область и все новые процедуры/функции располагать в этой области

#Область PRO

&НаКлиенте
Процедура PRO_РасчетЦен(Команда)
	Если Объект.Проведен = Истина Тогда
		PRO_ОбщегоНазначенияСервер.СформироватьОсновнойЗапросЦенообразования(Объект.Ссылка);
	Иначе
		Сообщить("Необходимо провести документ");
	КонецЕсли;
КонецПроцедуры

&НаСервереБезКонтекста
Функция PRO_ДоступКРолиПолныеПрава()
	Возврат РольДоступна("ПолныеПрава");
КонецФункции

&НаКлиенте
Процедура PRO_ТоварыПередНачаломДобавления(Элемент, Отказ, Копирование, Родитель, Группа, Параметр)
	...
КонецПроцедуры

&НаСервере
Функция PRO_ЭтоГоспрогорамма()
	...
КонецФункции

#КонецОбласти

Проверка свойств перед записью с последующим отказом

Правильно

&НаСервере
Процедура ПередЗаписью(Отказ)
    Если ПорядокРасчетов <> Перечисления.ПорядокРасчетов.ПоДоговорамКонтрагентов Тогда
		ОбщегоНазначения.СообщитьПользователю(
			"У договора может быть только порядок расчетов ""По договорам"", укажите это свойство на странице ""Расчеты и оформление"" в поле ""Детализация расчетов""",
			Ссылка,,,
			Отказ);
	КонецЕсли;
КонецПроцедуры

Неправильно

&НаСервере
Процедура ПередЗаписью(Отказ)
	Если ПорядокРасчетов <> Перечисления.ПорядокРасчетов.ПоДоговорамКонтрагентов Тогда
		Отказ = Истина;
	КонецЕсли;
КонецПроцедуры
//--PRO

Связанные статьи