Правила и приемы доработки типовых конфигураций 1С для облегчения их дальнейшей поддержки и обновления

Программирование - Практика программирования

В первую очередь, статья адресована разработчикам 1С, но надеюсь, что интересно будет не только им.

Видео:

Для тех кому лень читать всю статью, предлагаю посмотреть видео, в котором изложены все приведенные в данной статье принципы:

Ну а всем остальным, добро пожаловать под кат.

   


Правила и приемы доработки типовых конфигураций 1С для облегчения их дальнейшей поддержки и обновления

Итак, когда мы делаем некоторый проект (под словом «Мы» я понимаю всех людей, которые заняты в автоматизации бизнес-процессов), то надеемся, что потом он плавно перетечет в поддержку. Как правило, если все выполнено хорошо и заказчик доволен, так и происходит.

Поддержку характеризует очень специфический набор задач – это могут быть задачи на консультацию из разряда «откуда здесь взялись такие числа» или на исправление каких-то непонятных ошибок и т.д. Но, так как практически все проекты заключаются в адаптации какого-то типового решения под нужды заказчика, то конфигурацию при поддержке приходится периодически обновлять на новые релизы:

  • Если соблюдать некоторые правила разработки, то, потратив совсем незначительные трудозатраты на этапе проекта, в будущем можно будет сэкономить на поддержке и обновлении конфигураций.
  • И наоборот, если на этапе проекта были какие-то ошибки, поспешность, неправильное оформление кода, то потом это может вылиться в настоящий ад поддержки и обновления.

Приходилось ли кому-нибудь обновлять конфигурацию, переписанную без всяких опознавательных знаков? Понимаете ли вы, какая это боль – сравнивать старую конфигурацию поставщика с новой конфигурацией, вручную разобрать каждый случай «дважды измененных» при сравнении с текущей конфигурацией и т.д. Это все довольно проблематично.

   


9 простых правил оформления модификаций в типовых конфигурациях

Итак, 9 простых правил оформления модификаций, которые позволят вам значительно облегчить процесс обновления. Я не утверждаю, что вы должны делать так и никак по-другому, я просто хочу с вами поделиться тем, как это делаем мы, какие правила работают в нашей компании. А брать их или не брать к себе в команду – это уже решать вам.

   

1.     Концепция минимизации «разрушений» типовой конфигурации

Первое – это даже не правило, это некая концепция минимизации «разрушений» типовой конфигурации.

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

   

2.     Комментирование изменений кода

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

У нас в компании мы используем следующую схему:

  • В начале изменения находится открывающий комментарий (начинается со знаков //++)
  • В конце – закрывающий комментарий (начинается со знаков //--)
  • А те изменения, который выполнил разработчик, находятся в середине.

Это – обязательное правило для любых изменений.

У открывающего и закрывающего комментария указывается метка изменения. Она содержит в себе следующие составляющие:

  • Префикс проекта – по умолчанию мы используем ФТО
  • Доменное имя разработчика. Оно формируется очень удобно: компания большая, распределенная, и если ты разработчика не знаешь, но его надо о нем что-то спросить, можно взять его ник из этой метки, поставить справа @fto.com.ru и отправить ему письмо, чтобы таким образом с ним связаться.
  • Дальше идет дата изменений. Когда изменения идут в рамках нескольких задач, эти связки комментариев могут быть вложенными одна в другую, и не всегда понятно, к какому открывающему блоку относится этот закрывающий комментарий, поэтому мы ориентируемся на дату. Кроме этого, по дате сразу видно, когда была сделана модификация: три года назад, полгода назад или вчера.
  • Затем идет номер задачи, который ставится только в открывающем комментарии. Почему только там? Чтобы при глобальном поиске по номеру задачи в выборку попадало только начало изменений кода, от которого дальше уже можно вниз смотреть, иначе будет двоиться. Например, при передаче задачи на code-review очень удобно искать именно по метке.

Примеры

Вот так выглядит вставка кода:

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

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

Отдельное правило работает для добавления процедур, функций и глобальных переменных модулей. В этом случае закрывающий комментарий ставится на той же строке, что и ключевое слово КонецПроцедуры. Зачем это сделано? Для того чтобы было удобно переносить модификации с помощью «попроцедурного сравнения».

Здесь на картинке видно, что используя «попроцедурное сравнение» можно просто выделить эту процедуру при объединении, и она вся полностью (вместе с метками) перенесется. Или наоборот, можно снять напротив нее галочку, чтобы не переносить.

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

   

3.     Добавление объектов верхнего уровня

Следующее правило – это добавление в конфигурацию объектов верхнего уровня (справочников, документов, регистров и т.д.).

Это правило заключается в том, что имена объектов обязательно должны начинаться с префикса. Для чего?

  • Во-первых, это визуально выделяет добавленный элемент в конфигурации и в коде сразу видно, что это – наш добавленный объект.
  • Во-вторых, достигается уникальность имени, потому что поставщик может добавить свой объект с тем же именем. И если мы будем использовать свой префикс, то это гарантирует, что наше имя будет уникально. 

Синонимы объектов должны начинаться с префикса в круглых скобках. Это позволяет выделить наш добавленный объект в интерфейсе.

Конечно же, это очень спорное правило, и его применение нужно согласовывать с заказчиком. Наших клиентов такая схема устроила, поэтому она у нас прижилась и попала в правила. Но тут решать только вам и клиенту – надо так делать или не надо.

Ну и последнее правило: комментарии ко всем добавленным объектам должны содержать специальную метку с именем разработчика и номером задачи. Эта метка аналогична открывающему комментарию из модуля, только без специальных символов – с ее помощью я всегда могу понять, кто, когда и по какой задаче добавил этот объект.

Итак, подытожим:

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

   

4.     Добавление подчиненных объектов

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

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

  • В типовой объект конфигурации
  • Или в какой-то объект, который был добавлен ранее в рамках проекта.

Рассмотрим каждую из этих ситуаций отдельно.

Для добавления подчиненных объектов в типовые объекты конфигурации действуют следующие правила.

  • Имена должны начинаться точно так же с префикса. За счет этого мы добиваемся уникальности имени и визуально тоже всегда понятно, что это – наш объект.

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

  • Ну и наконец, комментарий точно так же содержит специальную метку, чтобы было понятно, кто, когда и зачем.

Итак, давайте подытожим, как происходит добавление подчиненных объектов в типовые объекты конфигурации:

  • Имена задаются с префиксом,
  • Синонимы по общим правилам
  • И комментарии содержат специальную метку.

А если мы добавляем подчиненные объекты в те объекты, которые были ранее добавлены в рамках проекта и уже содержат в своем имени префикс, то:

  • Их имена не должны содержать префикса, потому что и так понятно, что объект уже уникален, и как-то еще специально его выделять нет необходимости.

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

  • А комментарий содержит специальную метку только в том случае, когда этот подчиненный объект добавлен в рамках другой задачи. Потому что если у меня в задаче написано, что нужно добавить документ, у которого есть такие-то реквизиты, мне для каждого реквизита ставить такую метку не надо. Но если задача совсем другая – я обязательно ставлю метку, чтобы было понятно, зачем я это сделал.

А теперь подытожим, как добавляются подчиненные объекты в объекты, добавленные в рамках проекта:

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

Если это правило объединить для обоих случаев и «разложить по полочкам», то получится следующая табличка:

  • Новые объекты:
    • Имя начинается с префикса.
    • Синонимы – с префиксом в круглых скобках.
    • Комментарий содержит метку.
  • Подчиненные объекты, которые мы добавляем в типовые объекты:
    • Имена начинаются с префикса,
    • Синоним по общим правилам
    • В комментарий ставим метку.
  • А если мы добавляем подчиненные объекты в объекты, добавленные в рамках проекта, то
    • Для них никаких специальных правил не действует,
    • Но если задача другая, то в комментарий точно так же ставим метку.

   

5.     Добавление предопределенных элементов

Следующее правило – добавление предопределенных элементов.

Здесь точно так же можно выделить две ситуации:

  • Когда мы добавляем предопределенный элемент в типовой объект конфигурации (в справочник, в план видов характеристик)
  • И когда мы добавляем предопределенный элемент в объект, добавленный в рамках проекта.

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

  • Его имя точно так же должно начинаться с префикса. Тем самым мы гарантируем уникальность его имени и сможем сразу визуально определить наш добавленный элемент.
  • Код и наименование будут формироваться по общим правилам,
  • Но метку тут, к сожалению, поставить некуда. Поэтому найти этот добавленный предопределенный элемент глобальным поиском по задаче не получится.

А если мы добавляем предопределенные элементы в объекты, добавленные в рамках проекта, то

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

Итак, если провести аналогию с предыдущей таблицей, то:

  • Предопределенные элементы для типовых объектов добавляются с префиксом,
  • А все остальные – по общим правилам, никаких специальных добавлять префиксов не надо.

   

6.     Использование общих модулей и их строгая структура

Следующее правило касается использования общих модулей и организации для них строгой структуры.

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

Во-вторых, обратите внимание, что общие модули добавляются по правилам добавления объектов верхнего уровня (имя и синоним с префиксом, метка в комментарии и т.д.)

В-третьих, имена модулей должны быть аналогичны соответствующим типовым модулям.

Не нужно изобретать велосипед: называем так же, как принято в типовых конфигурациях – для каждой функциональности свой модуль, соответствующий общепринятым в 1С обозначениям. Например:

  • ФТО_ОбщегоНазначенияКлиент,
  • ФТО_ОбщегоНазначенияСервер,
  • ФТО_ОбщегоНазначениеГлобальный,
  • ФТО_РегламентныеЗаданияСервер
  • И т.д.

А какие-то большие отдельные задачи можно (и, наверное, нужно) выносить в отдельные общие модули.

   

7.     Использование подписок и их строгая структура

Следующее правило – это использование подписок и их строгая структура. В чем его суть?

Подписки следует использовать для обработки различных событий, связанных с типовыми объектами, таких как:

  • Перед записью
  • При записи
  • И т.д.

  • Можно конечно взять и отредактировать модуль типового объекта, вставив свой код в соответствующую процедуру. Но это – плохой способ.
  • Лучше вместо этого добавить подписку на обработку этого события.

Подписка добавляется согласно следующим обговоренным правилам:

  1. Для всех однотипных событий в системе добавляется только одна подписка. Например, если мне нужно для различных справочников в событии «Перед записью справочника» задействовать свой алгоритм, то для всех этих справочников я использую только одну добавленную подписку «Перед записью справочника».
  2. В источнике выделяются все объекты в рамках этого класса (например, все справочники)
  3. Для добавленной подписки создается отдельный модуль, который называется точно так же (просто для удобства).
  4. В основном обработчике события определяется условие, анализирующее вид объекта (вид справочника).
  5. И уже в зависимости от вида объекта выполняются те или иные действия.

Могу показать на примере. Предположим, есть такая задача: при проведении документа «Авансовый отчет» делать записи в добавленный ранее регистр накопления.

Сначала мы добавляем общий модуль ФТО_ДокументыОбработкаПроведения по всем правилам.

Далее мы добавляем подписку, в которой:

  • В качестве источника указываем ДокументОбъект ( все документы);
  • В качестве обработчика – наш добавленный выше модуль.

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

Подписка одна, а действия могут быть различными. Также можно управлять еще и очередностью вызова процедур.

В результате, порядок действий для создания подписки такой:

  • Одна подписка,
  • Один общий модуль
  • И ничего другого уже не надо: модуль документа остается неизменным – в «дважды измененных» он уже не покажется.

   

8.     Редактирование форм

Следующее правило – редактирование форм.

Здесь точно так же выделим два момента, две ситуации:

  • Когда мы редактируем типовые формы;
  • И когда мы редактируем формы, добавленные в рамках проекта.

Первая ситуация – это редактирование типовых форм, форм типовых объектов. Это самый спорный пункт правил. В свое время, еще во времена обычных форм, когда проекты в основном делались на УПП, у нас было много дискуссий по поводу того, что делать с формами. Какие были варианты?

  • Прямое редактирование обычных форм заключается в том, что я просто меняю форму вручную. При этом варианте каждый раз, когда поставщик вносит в эту форму свои изменения, мне необходимо все свои правки переносить заново. Плохой способ.
  • Другой способ – это создание копии формы. Это когда я делаю с типовой формы копию, назначаю ее основной и вношу в нее свои изменения. Но опять же, если эту форму меняет поставщик, мне нужно перенести его изменения в свой вариант вручную. Не самый лучший способ.
  • Еще один вариант – это создание отдельной вкладки. Создаем на форме отдельную вкладку и на ней размещаем свои элементы. Понятно, что этот способ не гибкий, потому что иногда свой элемент нужно вставить куда-то именно в определенное место формы. Или нужно изменить свойства типовых элементов, обработчик им новый назначить и т.д. Поэтому это не гибкий способ – он тоже не очень хорошо работает.
  • В результате мы выбрали способ полностью программного редактирования форм. Новым разработчикам, которые не сталкивались с этим способом, поначалу кажется, что программно редактировать форму очень сложно. Но на самом деле – нет. Из своей практики скажу, что надо просто набить руку. Кроме того, у нас давно написаны модули с экспортными процедурами по программному изменению форм, и все это делается довольно легко. Когда появились управляемые формы, мы эту практику программного изменения форм также полностью перенесли и на управляемые формы. Тем более, что редактировать управляемую форму программно стало вообще легко – с обычными формами не сравнить.

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

В конфигурациях на базе БСП 2 (таких, как ERP, Бухгалтерия и т.д.) добавился обработчик СобытияФорм.ПриСозданииНаСервере(), который среди прочего, заходит еще и в переопределяемый модуль.

И вот в переопределяемом модуле можно добавить свой код – например, в процедуру ПриСозданииНаСервере(). Здесь я определяю имя формы, и в зависимости от него вызываю ту или иную процедуру, где добавляю элементы программно.

Кажется, что это сложно, что эта схема – громоздкая, но на деле, если все проекты делаются по таким правилам, то разработчик, получая задачу, уже сразу знает, куда ему смотреть, где что добавлять. Поэтому мне кажется, что это очень удобно.

Кроме того, в конфигурациях на базе БСП 2 переопределены еще и другие обработчики форм – такие как ПриЧтенииНаСервере(), ПередЗаписьюНаСервере() и т.д. И в этих обработчиках также можно активно использовать переопределение вызываемых процедур. Тем более что поставщиком переопределяемый модуль теоретически не меняется, и там можно без боязни конфликтов писать свой код.

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

   

9.     Принципы работы с ролями

И последнее правило – это принципы работы с ролями.

Принципы работы с ролями заключаются в следующем:

  1. Если возможно, то типовые роли следует всегда оставлять неименными. Нужно хорошо подумать, действительно ли необходимо изменить именно типовую роль или можно поступить как-то по-другому.
  2. Права на добавленные объекты конфигурации мы назначаем в новых, специально созданных ролях. Поэтому когда я добавляю в конфигурацию отчет, и для него нет подходящей заранее добавленной нами роли, я создаю отдельную роль. И потом уже эта роль добавляется в нужные профили. А типовые роли не меняются.
  3. И если есть изменения в RLS, то они оформляются по правилам редактирования модулей.

Например, если мне нужно поменять RLS, то я ставлю открывающий комментарий, комментирую старый код, потом дописываю свой и ставлю закрывающий комментарий. Всегда понятно: кто, зачем (в рамках какой задачи) и когда я менял.

Итак, я перечислил все девять простых правил оформления модификаций.

   


Дополнительные объекты и приемы, облегчающие жизнь

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

   

1.     Самоидентификация тестовых баз

Первый прием – это самоидентификация тестовых баз.

Суть в том, что:

  • есть некоторая константа, в которой хранится адрес рабочей продуктивной базы.
  • При старте системы происходит проверка этого адреса: соответствует он адресу рабочей базы или не соответствует.
  • И если не соответствует (база не рабочая), то происходит замена заголовка системы.

На скриншоте показано, как это выглядит. Это особенно полезно тогда, когда у разработчиков (или у консультантов) открыто много баз (рабочая, тестовая, разработческая и т. д.) и они могут нечаянно ошибиться и поменять данные в рабочей базе. А если заголовок изменен, то уже «на автомате» – глаза в левый верхний угол, смотришь, что это за база – ага, тестовая, можно менять.

Таким образом, мы делаем изменение данных в информационных базах более безопасным.

Кроме того, проверку значения этой константы полезно также применять при выполнении некоторых регламентных заданий. А именно:

  • обмены данными,
  • уведомления пользователей,
  • какие-то рассылки,
  • тяжелые регламентные задания.
  • И т.д.

Когда разработчик создает такое регламентное задание, он обязательно должен сделать проверку – а рабочая ли это база или нет. Понятно, что по идее, на всех тестовых базах регламентные задания должны быть отключены в консоли кластера. Но всегда есть человеческий фактор, когда кто-то создал новую базу, загрузил в нее свежие данные, что-то поменял и в результате произошел какой-то критичный обмен с рабочими базами. А потом разборки – почему так произошло? Поэтому мы перед критичными регламентными заданиями всегда делаем проверку – рабочая это база или нет.

В конфигурациях на базе БСП 2 есть похожий механизм: если расположение информационной базы меняется, то задается вопрос – это копия базы или база была перемещена. В принципе, этого механизма может быть достаточно, но опять-таки, может вмешаться человеческий фактор, кто-то не поймет, что происходит и нажмет не на ту кнопку. Поэтому, на мой взгляд, константа надежнее.

   

2.     Обработка инициализации

Следующий прием – обработка инициализации.

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

Зачем это нужно? Часто при добавлении в конфигурацию новой функциональности необходимо произвести какие-то действия в самой базе данных: например, добавили предопределенный элемент справочника, и теперь нужно заполнить его реквизиты. Баз на проекте может быть очень много и заполнять эти данные вручную – это конечно, плохо. Правильнее:

  • Увеличить версию обработки инициализации;
  • Описать в коде порядок программного заполнения данных;
  • И после этого новая версия обработки автоматически через хранилище попадет во все нужные базы, запустится там и выполнит все необходимые действия.

На схеме этот порядок работы показан так:

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

В результате везде, во всех базах данные обновлены.

   

3.     Справочник предопределенных значений

Следующий прием – это справочник предопределенных значений.

Часто возникает необходимость обращаться из кода к существующим элементам справочника, которые не являются предопределенными. Понятно, что лучше создать предопределенный элемент, но так сложилось, что элемент не может быть предопределенным, а нему все равно обратиться.

Какие тут есть варианты реализации?

  • Обратиться к элементу по наименованию. Понятно, что наименование поменялось – код перестал работать. Плохо.
  • Обратиться по коду. Чуть лучше, но код тоже может поменяться. Не очень хорошо.
  • Обратиться по внутреннему идентификатору. Тогда при переносе этот код тоже не будет работать. Вообще все эти три случая не будут работать, если мы переносим модификацию из одной базы в другую базу. Не очень хорошо.
  • Предлагается завести справочник предопределенных значений.

Этот справочник содержит в себе только один реквизит с типом СправочникСсылка (ссылка на все справочники).

Если мне в рамках задачи нужно обратиться к какому-то элементу, я в этот справочник добавляю предопределенный элемент (например, Контрагент_Агроимпульс)

И потом уже в коде обработки инициализации либо руками я заполняю значение этого справочника нужным мне контрагентом.

Соответственно, после этого я смогу обратиться к этому контрагенту через справочник предопределенных значений. За счет этого достигается то, что:

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

   

4.     Просмотр временных таблиц в отладчике

Ну и последний прием – это просмотр временных таблиц в отладчике.

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

  • И назвать как-нибудь коротко, например ВТ()

В этом случае:

  • Я ставлю точку останова в месте, где у меня есть запрос.
  • В окне «Вычислить выражение» пишу ВТ(Запрос);
  • Нажимаю «Рассчитать» и получаю структуру временных таблиц запроса, чтобы просмотреть, что там за данные.

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

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

   


Заключение

Всем спасибо. У меня есть небольшой сайт, на этом сайте в подробном изложении выложены все эти правила и не только они – заходите, читайте, пишите мне на почту или в скайп.

Мне эта тема интересна, я готов по ней общаться. Мне правда важно, чтобы у вас тоже все получилось.

Ссылки:

   


***************

Данная статья написана на основе доклада, представленного автором на конференции Infostart в 2016 году. Приглашаем вас на новую конференцию INFOSTART EVENT 2017 COMMUNITY.

Скачать файлы

Наименование Файл Версия Размер
Правила и приемы доработки типовых конфигураций 1С для облегчения их дальнейшей поддержки и обновления
.docx 7,13Mb
10.07.17
768
.docx 7,13Mb 768 Скачать

См. также

Комментарии
1. Антон Степанов (Stepa86) 883 18.07.17 21:40 Сейчас в теме
Немного покритикую

1) Если использовать выгрузку в гит, то можно не указывать комментарии в своих модулях и не указывать кучу комментариев если код был изменен по нескольким задачам, а просто оставить одно обрамление, что это не типовой код, а наш. Просматривать историю и искать авторов в гите конечно чуток сложнее, чем по комментариям восстановить, но зато код намного чище, да и искать виновника обычно нужно не так часто, если выполняется код-ревью. Код-ревью в гите, кстати, вообще сказка

2) Если использовать сторонние программы для сравнения (я использую P4, он вроде как бесплатен для небольших команд) то быстро понимаешь, что зря не пользовался ими раньше при обновлении. Обновление модулей становится проще в 10 раз. И тут всплывает ньюанс. Такие программы сравнивают построчно, а не попроцедурно, и если что то было закомментировано, а в поставке добавили пробел - получили двойное изменение. Поэтому я предпочитаю по максимуму код от типовой не трогать, а решать только добавлением новых строчек - возврат, окружать Если Ложь Тогда итп

3) Для префиксации очень удобным оказался префикс "_" и "*" для синонимов. Они коротки и они выводят новые объекты вверх при сортировке, а обычно новые объекты нужны чаще, чем типовые. Для разработки коробочного решения такая префиксация не подходит, конечно.

4) Предопределенные элементы стоит добавлять только в те объекты, где их до этого не было, иначе если с новой типовой придет новый предопределенный объект, будет весело в любом случае. Тут ждем 8.3.11. Если все таки пришлось изменить предопределенные, то оставляю комментарий в корневом объекте, чтоб при сравнении объединении было видно и 1. что набор предопределенных изменений конфликтует 2. комментарий к объекту был изменен

5) Не понимаю этого фанатизма в использовании подписки для изменения логики в одном документе. В случае обновления если использовать п.2 проблем не возникает вообще, а вот убить кучу времени на выяснение логики работы документа при проведении, когда часть вынесена в подписки - это вообще запросто
Krio2; quadrodecor; ShonLe; citicat; hulio; mrXoxot; chebser; Altair777; +8 Ответить
7. Виталий Онянов (Tavalik) 580 19.07.17 08:13 Сейчас в теме
(1)
Ну что ж, отвечаю:

1) Гитом не пользуемся. Наверное стоит попробовать, но пока хватает и хранилища. Если наш код становится уж совсем "зеленым", то делаем рефакторинг. В этом случае, весь старый, уже точно не имеющий смысла закомментированный код удаляем. В крайнем случае, остается история в хранилище.

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

3) Часто бывает, что эту же конфигурацию модифицирует еще кто-то (например сторонняя организация или же свои специалисты). Тогда префикс "_" не подойдет. А в целом, почему бы и нет.

4) Не понял, почему не надо добавлять предопределенные элементы? При сравнении проблем нет. Если приходит предопределенный элемент из новой конфигурации поставщика, то проблем тоже не вижу. Наши объекты добавлены с префиксом, совпадения имен быть не может.

5) Ну тут дело привычки. У нас все разработчики знают и используют правила, поэтому время на разбор и понимание логики не тратится. Подписка то всего одна, а уже в ней по каждому типу документа вызываются необходимые обработчики.

6) Абсолютно согласен. Типовые роли не трогаем (или только в самом крайнем случае). Это стало особенно актуально в конфигурациях на БСП 2, где на каждый объект, как правило, есть одна или две роли. В этом случае на все свои добавленные объекты также создаем отдельные роли. А дальше уже идет настройка профилей и групп пользователей.

8) Наверное вы правы, но вроде как пока хватает и просто функции ВТ().

9) Согласен. Это очень хорошая мотивация. Но вот только беда, что стажеру или молодому специалисту не очень то доверишь обновление конфигурации. Тут только строгое соблюдение правил и обязательное код-ревью.
8. Антон Степанов (Stepa86) 883 19.07.17 08:22 Сейчас в теме
(7) 1) Если у вас постоянно проходит код-ревью, то очень рекомендую поупражняться с выгрузкой в гит

2) Я тоже очень долго был консервативен, а потом попробовал и внезапно стало очень удобно, чем по типовому. Рекомендую себя пересилить и еще раз попробовать.

4) Вроде при двойном изменении можно только или все взять из поставки или оставить как есть, объединить не получается, как и с типами

8) Очень рекомендую использовать при разработке инструменты разработчика. Прям вот самое первое, что я делаю на любом проекте - подключаю ИР, вкрячивая в конфу или через внешние файлы. А теперь еще можно и как расширение подключать.
10. Екатерина Н (katenok86) 241 19.07.17 09:15 Сейчас в теме
(8) В последней платформе типы объединяются. А предопределенные объединяются уже давно.
12. Антон Степанов (Stepa86) 883 19.07.17 09:19 Сейчас в теме
(10) Типы только в 8.3.11 будут объединятся же, или я что то уже пропустил? https://wonderland.v8.1c.ru/blog/obedinenie-sostava-obektov-i-tipov/
13. Екатерина Н (katenok86) 241 19.07.17 09:23 Сейчас в теме
35. ффф ыыы (zqzq) 16 20.07.17 08:45 Сейчас в теме
(1)
2) Если использовать сторонние программы для сравнения (я использую P4, он вроде как бесплатен для небольших команд) то быстро понимаешь, что зря не пользовался ими раньше при обновлении. Обновление модулей становится проще в 10 раз.

Поддерживаю полностью. Использую KDiff3, пробовал разные, этот самый удобный и функциональный, посимвольно сравнивает + поддержка трёхсторонего сравнения.
2. Антон Степанов (Stepa86) 883 18.07.17 22:06 Сейчас в теме
6) Типовые роли лучше вообще не трогать. Сколько раз менял, столько раз имел проблемы. Если и менять, то прям в комментарии к объекту писать что именно изменено. РЛС в типовых не менял ни разу, видимо изза того, что я так и не смог раскурить что происходит в БСП или в документообороте.

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

8) Про справочник предопределенных значений хорошая идея, утащу к себе. У нас есть похожий механизм под кодовым названием "Экспериментальные функции". Если есть старый алгоритм чего то и мы разработали новый, но не очень в нем уверены, то старый не удаляем, а переключаем с помощью значения в предопределенном элементе в справочнике, типа так Если Справочники.ЭкспФункции.ИспользоватьНовыйАлгоритм.Включена Тогда НовыйАлгоритм() Иначе СтарыйАлгоритм() КонецЕсли

8) Про просмотр временных таблиц. Если вкрячить инструменты разработчика, то так же появится метод от() который передаст в нужную консоль запрос, компоновку или еще чего. Крайне полезно при отладке чего то тяжелого.

9) Чтобы научить программиста дорабатывать конфу так, чтоб легче было обновлять его следует сперва заставить выполнить обновление, чтоб он на все возможные проблемы понатыкался, а уже потом давать правила
chebser; Solovyeff; +2 Ответить
3. Василий Попов (white_sochi) 99 19.07.17 00:16 Сейчас в теме
(2)
По мне так, авторские комментарии в коде это зло, тем более с датой. Максимум обрамление кода комментариями команды - организации. А там уже и blame в гите глянуть можно.

Просто бывают ситуации, что в авторский код залез другой автор и просто забыл еще обрамить своими комментариями, хотя если, допустим второй автор добавляет просто проверку на условие то получается пишет 2 строчки кода и 4 строчки комментариев к ними. Плюс забывают менять даты изменений, что тоже может запутать других.

Для новых алгоритмов используем функциональные опции. Хотя со справочником тоже интересно, надо попробовать.
Сейчас все пытаюсь 4 базы с разными наработками объединить в одну, для удобства поддержки, Как раз нетиповой функционал каждой базы обрамляется функ.опц, Допустим в 3х базах используется одни и тот же функционал, но в 3й еще есть свои дописки, а функционал 4й базы наверняка в скором времени понадобится и в какой нибудь из этих 3х.

На счет обработки инициализации...хотим у себя как раз подобное попробовать, но рабочее название константы пока "Номер сборки" - номер коммита в мастер хранилищи. Т.е добавили роль, написали что в 100500 номере сборки надо сделать обновление вспомогательных данных.

На счет интерактивных изменений форм делаем так, с начало в ветке фичи все делается прям на форме, для быстроты прототипирования и наглядности. Потом декомпелируем форму, но если не успеваем, вешается тех.долг по переносу интерактивных изменений в код
4. Василий Попов (white_sochi) 99 19.07.17 00:18 Сейчас в теме
Номер версии во внешних обработках\отчетах делаем по формату гг.мм.дд, 17.07.19
5. Александр Синиченко (nytlenc) 190 19.07.17 06:07 Сейчас в теме
Офис 2016, файл не открывается. Что за бред оформлять статьи в виде каких-то документов. А если у меня офис вообще не установлен и нет лицензии на его использование, получается статью мне не прочитать? Оформите пожалуйста статью в соответствии с правилами. А так это не статься а просто бесполезный текст.
Прикрепленные файлы:
Brawler; MSK_Step; +2 3 Ответить
6. Виталий Онянов (Tavalik) 580 19.07.17 07:54 Сейчас в теме
(5)
Здравствуйте. Данные правила в открытом доступе:

http://tavalik.ru/pravila-razrabotki-chast-1/
http://tavalik.ru/pravila-razrabotki-chast-2/

И я даже видео записывал, когда готовился к выступлению:
https://youtu.be/KVbZygpQOEc
VladimirL; Maxis; inf012; +3 Ответить
9. Александр Синиченко (nytlenc) 190 19.07.17 09:11 Сейчас в теме
(6) http://tavalik.ru/ никакого отношения к ресурсу (Инфостарт) на котором вы публикуете статью не имеет это первое. Вы нигде в статье не сослались ни на видео которое вы записывали когда готовились к выступлению, ни на ссылки которые указали сейчас в сообщении, документ который вы прикрепили к сожалению тоже не открывается - вывод полезной информации в статье ноль. А еще и имеете неосторожность при этом минусовать вполне адекватные замечания. Тут телепатов нет, все уехали готовиться к INFOSTART EVENT 2017 COMMUNITY. Отрицательно воспринимаете критику? Я понимаю, что возможно там полезной инфы на докторскую диссертацию, но черт возьми, так оформлять статью никуда не годится, зачем вообще добавили ее если нет возможности ее НИКАК прочесть?
16. Виталий Онянов (Tavalik) 580 19.07.17 09:26 Сейчас в теме
(9)
Что вы на меня напали? Критику я воспринимаю адекватно. Я вас не минусовал.
Более того, я вам открою секрет, это даже не я публиковал статью, а модераторы infostart.ru на основании моего выступления.
Все ссылки, кстати, есть в конце статьи. Сожалею, что у вас не получилось открыть документ .docx. Напишите почту в личном сообщении, я вышлю вам PDF версию.
21. Александр Синиченко (nytlenc) 190 19.07.17 09:40 Сейчас в теме
(16)
Что вы на меня напали?

Даже и не думал. Просто хочется, чтобы другие люди которые захотят изучить материал не столкнулись с этими же проблемами.

(16)
не я публиковал статью, а модераторы infostart.ru на основании моего выступления.

Жаль, что модераторы так бездарно (по другому не могу назвать) оформили такую отличную статью...

(16)
Все ссылки, кстати, есть в конце статьи.

Ничего нет. К счастью информацию умею искать хорошо и к сожалению ничего не удалось найти по ссылкам. Единственная ссылка ведет на страницу с информацией об INFOSTART EVENT, там разумеется ничего о статье. Прикладываю подтверждения
Прикрепленные файлы:
20. Василий Попов (white_sochi) 99 19.07.17 09:39 Сейчас в теме
(9) не успел отписаться, что офиса у меня нет, а файл открывается даже в worppad. Самый первый минус мой, только сейчас узнал что минусование анонимно.
38. Роман Озеряный (rozer) 192 20.07.17 15:17 Сейчас в теме
(6) видос сделан качественно ) "расширения" не используете ? До "расширений" тоже добавляли программно на форму но расширения как-то все упростили да и роли тоже а сейчас и ОМ и др. модули можно править расширениям (правда нативных конф 1с под 8.3.10 нет пока)
25. Алексей Гладких (revned) 6 19.07.17 15:20 Сейчас в теме
(5) Есть Open Office, Only office. Бесплатные. Так что все можно посмотреть, не покупая ничего. Да и он-лайн офисы всякие.

Сам практически так же и поступаю, как в статье. Автору спасибо.
quadrodecor; +1 Ответить
32. Александр Синиченко (nytlenc) 190 20.07.17 03:29 Сейчас в теме
(25) тогда смысл вообще писать текст статьи? Давайте будем просто оформлять заголовок и крепить WORD документы, и пусть дальше каждый сам разбирается что там. Поиск по сайту в том числе.
Коллеги. Есть определенные правила и давайте будем все их придерживаться.
11. Екатерина Н (katenok86) 241 19.07.17 09:17 Сейчас в теме
Расширениями не пользуетесь? До сих пор не могу для себя решить если в них польза. Были как положительные так и отрицательные примеры.
28. Андрей К (h00k) 45 19.07.17 17:14 Сейчас в теме
(11)
Расширениями не пользуетесь? До сих пор не могу для себя решить если в них польза.

На текущий момент расширения хорошо подходят для доработки форм и объектов интерфейса, добавления и вывода в интерфейс своих обработок, отчётов и т.п. минуя механизмы БСП в типовых конфигурациях без включения возможности изменения конфигурации. Как только типовые будут переведены на БСП 2.4 возможности применения расширений для доработки полностью типовых конфигураций существенно расширятся.
Для типовых конфигураций с изменённым режимом совместимости все возможности расширений можно использовать уже и сейчас.
Основной нюанс, на текущий момент - для расширений нет встроенных в платформу систем версионирования, поэтому при разработке для контроля версий приходится использовать сторонние решения, такие как Mercurial, Git и т.п.
14. Екатерина Н (katenok86) 241 19.07.17 09:24 Сейчас в теме
Кстати обновление готовите через cf или свою поставку?
17. Антон Степанов (Stepa86) 883 19.07.17 09:28 Сейчас в теме
(14) Если вопрос ко мне, то я выгружаю cf из хранилища разработки, вручную вкатываю его в хранилище РБ, а уже сами РБ обновляю скриптами
19. Виталий Онянов (Tavalik) 580 19.07.17 09:31 Сейчас в теме
(17)
Мы поступаем точно также.
18. Виталий Онянов (Tavalik) 580 19.07.17 09:30 Сейчас в теме
(14)
Пока в расширениях нет возможности создавать свои объекты и реквизиты объектов, никакого смысла в них не вижу. В 8.3.11 вроде такая возможность будет, но тут же мы натыкаемся на режим совместимости типовых конфигураций. Так что расширения не используем.

Почти всегда обновления готовим через файл cf. Хотя есть также опыт и обновления через поставку на территориально распределенных площадках.
15. Александр Синиченко (nytlenc) 190 19.07.17 09:24 Сейчас в теме
Спасибо. Статья очень полезная, почерпнул некоторые полезности для себя. Проголосовал за доклад. В дополнение звездану статью!
22. Олег Парубец (Team leader) 9 19.07.17 10:28 Сейчас в теме
Про БСП обновил знания - спасибо
23. Руслан Шапиев (TheRealStanly) 17 19.07.17 13:05 Сейчас в теме
Спасибо за статью. Всё структурировано и понятно. Как раз собирался что-то подобное писать для наших стажеров и наткнулся на эту публикацию. Забираю.
24. Дмитрий Касминюк (Vortigaunt) 11 19.07.17 14:44 Сейчас в теме
Cпасибо. Очень интересно. Можете привести код функции ВТ() для вычисления временных таблиц, которая описана в статье?
26. Сергей Лесовой (Synoecium) 272 19.07.17 15:47 Сейчас в теме
(24) могу скинуть нашу функцию которая выводит в листы Excel все временные таблицы из переданного запроса, что довольно удобно.
JohnConnor; +1 Ответить
27. Дмитрий Касминюк (Vortigaunt) 11 19.07.17 16:30 Сейчас в теме
(26) Спасибо. Буду признателен.
31. Иван Гончаров (JohnConnor) 25 20.07.17 03:14 Сейчас в теме
(26) можешь скинуть , на почту?
33. Сергей Лесовой (Synoecium) 272 20.07.17 06:21 Сейчас в теме
(31) (27)
отвечу здесь, может еще кому пригодится
https://pastebin.com/QzVYAE3V - выводит все временные таблицы переданного запроса в листы Excel
https://pastebin.com/jQmysAUD - позволяет посмотреть в отладчике конкретную таблицу из запроса. Работает примерно как в статье, но для одной таблицы
JohnConnor; +1 Ответить
29. Дмитрий Касминюк (Vortigaunt) 11 19.07.17 21:16 Сейчас в теме
У меня вопрос к автору. В статье вы пишете о справочнике с предопределенными элементами. А чем он лучше обычных констант?
30. Иван Гончаров (JohnConnor) 25 20.07.17 03:14 Сейчас в теме
спасибо, много взял для себя
34. Сергей Старых (tormozit) 4523 20.07.17 06:58 Сейчас в теме
Откройте для себя отложенную отладку запросов и компоновки и получайте полное удовлетворение https://www.youtube.com/watch?v=hiw_aYVOvFc
Krio2; necropunk; rozer; h00k; zqzq; Stepa86; +6 Ответить
39. Роман Озеряный (rozer) 192 20.07.17 15:19 Сейчас в теме
(34) вам особенно низкий поклон за ИР
36. Андрей Конев (Infector) 96 20.07.17 09:29 Сейчас в теме
По большей части согласен. Могу добавить "отсебятины":
1. часто вместо добавления реквизитов или табличных частей справочников и документов выгодным оказывается удобнее добавить регистр сведений, связанный через измерения с основным объектом, а в ресурсах хранящий необходимую информацию.
2. типовые объекты, куда не успели вмешаться, держим "под замком". Это одновременно индикатор и защита от случайных правок из разряда "лишний пробел"
3. В шаблонах кода очень удобно разместить собственный комментарий. Результат - при нажатии Ctrl + пробел в пустом месте в одной из верхних строк прелагается к вставке личная метка с текущей датой.
4. Касательно нетиповых участков - по возможности используем параметризированные запросы вместо склейки из строк. Сохранение возможности открыть запрос конструктором - небольшой бонус, позволяющий быстро отформатировать исправленный руками запрос и заодно проверить синтаксис (как известно, неправильный запрос конструктором не открывается). Комментирование внутри запроса достаточно бесполезно, т.к. исчезает при вызове конструктора, поэтому проще размещать тексты запросов в отдельных функциях, а перед правкой создавать копию всей функции с видоизмененным именем.
5. Громоздкие функции и процедуры удобнее дробить на мелкие, чем читать все это как сплошной текст.
6. Выигрышь в быстродействии на 5-10% за счет запутывания разрастания и усложнения кода пользователи не оценят. Но большинство оценивает разработку/доработки в короткий срок. Если Вы видите, что схожие подзадачи возникают с завидной регулярностью, чаще всего проще потратить полдня на универсальную функцию или механизм, закрывающие их все разом.
Например, однажды написав и вызвая в своих разработках функцию "ПреобразоватьТаблицуВДерево" скорее всего вы сможете выиграть больше времени по сравнению с описанием этого процесса в каждой отдельно взятой задаче.
37. Олег Филиппов (comol) 3231 20.07.17 15:17 Сейчас в теме
После советов с "авторским комментарием" перестал читать. Как заколебали такие правила, потом умрёшь отучать разработчиков писать авторский комментарий и июзать Blame View.
50. nick perel (nickperel) 2 27.09.17 20:46 Сейчас в теме
(37)
Blame View

К вам все чужие разработки через git попадают?
Никогда не видели код в котором спокойно и тихо в середине модуля всплывет кусок где умножают длину доски на время суток?
У отучением у них проблема...
40. Яков Коган (Yashazz) 2138 20.07.17 19:50 Сейчас в теме
Учитывая зияющие перспективы 1С по расширению данных, означенные извраты должны отойти в прошлое, где им самое место. Ибо всё это - от безысходности, а по-людски оно вообще модульно должно бы делаться) Но за труды респект.
45. nick perel (nickperel) 2 24.09.17 22:14 Сейчас в теме
(40)а как сделать "по-людски"?
1с делает свое. Вы - свое. Все независимо, а конечные данные одни и те же.
Расскажите как же помогут расширения, получить стабильно работающий адаптированный функционал?
А то пока занимался такими же "извратами" я сильно устарел.

Пока заказчиков расширения радуют только тем, что их можно выкинуть вместе с разработчиком. Хотя и не понятно, а как далее работать без расширения, если в нем производились какие-то полезные изменения все тех же конечных данных, а потом перестали? Забить?

Не надо только итс с зазеркальем цитировать. По существу есть что сказать?
41. cartograph cartograph (cartograph) 03.08.17 16:07 Сейчас в теме
42. Александр Васильев (user633533_encantado) 2 03.08.17 18:06 Сейчас в теме
Сам пользуюсь подобными правилами разработки с некоторыми вариациями. Пришел к ним после многих лет обновлений измененных конфигураций.

Идея с процедурой ВТ() полезная, я до такого не додумался.
43. Игорь Колодин (KilloN) 29 22.08.17 15:31 Сейчас в теме
На мой ИМХО самоя крутая вещь при разработке это расширения, ко всему можно привязаться не редактируя модули и формы.
Еще с начала года как 8.3.9 появилась, снял на свой страх и риск с БП 3.0 совместимость с 8.3.8 и вперед.Единственный минут они нормально работают только начиная с 8.3.9. Если режим совместимости меньше то приходится по старинке...
44. nick perel (nickperel) 2 24.09.17 21:47 Сейчас в теме
(43)бп3 часто обновляется. Как часто приходится менять расширение?
Оно ведь слетит при изменении заимствований. Это весьма неприятная тема, так как адаптацию расширения делать придется уже после отказа.
Есть какие-нибудь соображения как с этим быть, кроме отключения автообновления у заказчика и проверки расширения на буферной базе?
46. Игорь Колодин (KilloN) 29 26.09.17 14:35 Сейчас в теме
(44)
Один раз за пол года понадобилось расширение подкорректировать.
В моем случае формы редко заимствовал, в 95% модули объектов и общих форм.
49. nick perel (nickperel) 2 27.09.17 20:38 Сейчас в теме
(46)
В моем случае формы редко заимствовал, в 95% модули объектов и общих форм.

Самое гемор - накладка изменений форм. Как было так и есть.
47. Яков Коган (Yashazz) 2138 26.09.17 22:44 Сейчас в теме
Не надо только итс с зазеркальем цитировать. По существу есть что сказать?

Если эти источники для Вас не по существу, то без комментариев.
48. nick perel (nickperel) 2 27.09.17 20:34 Сейчас в теме
(47)
Не надо только итс с зазеркальем цитировать. По существу есть что сказать?

Если эти источники для Вас не по существу, то без комментариев.

Конечно без комментариев. Откуда им взяться - то.
Оставьте свое сообщение