Комментарии в 1С

Что означают варианты сравнения в отчетах 1с 8.2?

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

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

Комментирование кода 1С

Комментирование кода — это внесение пояснений в тест модулей, которые не является обязательными и не влияют на алгоритм (не исполняются)

Производится только с помощью последовательности «//», при этом комментарием считается все, что находится после.

Пример комментария:

Перем ЭтоНеКомментарий;\\ А это уже комментарий \\Это тоже комментарий

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

Возможно использование в подряд идущих комментариев:

//Это первая строка комментария //Это вторая строка комментария //Строка комментария после пустой строки // Перем А;//Эта переменная не объявится

Горячие клавиши

ctrl + / — добавить комментарий в выделенных строках;

ctrl + shift + / — удалить комментарий в выделенных строках

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

Установка и снятие комментария интерактивно по кнопкам:

Выделяется код и нажимаются на панели «Модуль» соответствующие кнопки «Добавить комментарий» и снять «Комментарий»

или более длинный путь:

Меню «Текст\Блок\Добавить комментарий» или «Текст\Блок\Удалить комментарий»

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

  • описания сложных участков кода или алгоритма
  • логического отделения блоков непрерывного кода, в данном случае поле «\\» ничего не пишется
  • описания функций и процедур
  • выделения изменений в код типовых конфигураций, при обновлении упростит разбор
  • описания ситуации внесения изменений, даты
  • отметка ошибочного или сомнительного кода, в процесcе code review (анализа качества кода 1С)

Правила комментирования кода действуют и для языка запросов 1С, но важно отметить, что при использовании Конструктора запроса(визуального средства разработки запроса к базе), комментарии удаляются полностью, а не снимается признак «\\».

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

Настроить это можно в меню «Сервис\Параметры» далее вкладки «Модули\Группировка»

Там же на вкладке «Модули\Редактирование» возможно отключить или поменять цвет выделения комментария с зеленого (по умолчанию)

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

1с шаблоны текста

Admin 12 марта, 2019

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

В первую очередь включаем в параметрах конфигуратора автозамену (Меню Сервис/Параметры):

Автозамена

Включив все это дело, я отвлекся на какую то задачу и с ужасом заметил, что теперь стали работать все стандартные шаблоны, встроенные по умолчанию. Каждый раз написав”Если” Или “Цикл” или еще что-нибудь (“Функция”, “Процедура” и т.д.), происходила автозамена или выбор вариант подстановки кода в модуль, что меня совсем не устраивало:

Стандартные шаблоны

Немного разобравшись с функционалом шаблонов я все таки догадался как можно отключить стандартные настройки. Переходим в сами шаблоны через меню “Сервис / Шаблоны текста” или комбинацию клавиш “ctrl+shift+T” и через настройку отключаем их:

Отключаем стандартные шаблоны

Теперь избавившись от ненужного хлама (Для меня это был хлам!), самое время создать свои шаблоны подстановки кода:

Добавляем новые шаблоны

Для себя я в первую очередь выделил 4 основных шаблона, которые будут мне в первое время приносить счастье:

1С (Код)Личные шаблоны

Директивы “&НаКлиенте&НаСервере” я специально написал вместе, что бы после появления шаблона двойным кликом удалять ненужную. При желании можно сделать и больше шаблонов функций, под разные директивы (например “ффс” – функция на сервере, “ффк” – функция на клиенте, “ффб” – на сервера без контекста…).

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

Конструктор “Вставка”

Теперь написав в коде конструкцию “/**” или “/*” и нажав “пробел” я сразу же получу готовый код комментария:

1С (Код)

1 2 3 4 //{Чак Норрис 11.03.2019} //{Чак Норрис 11.03.2019 //}

Или сразу опишу функцию под свой шаблон “фф”:

1С (Код)

1 2 3 4 5 6 7 8 9 &НаКлиенте&НаСервере Функция ИмяФункции() Результат = Неопределено; Возврат Результат; КонецФункции

Теперь у меня нету нервного срыва когда мне нужно написать комментарий – я просто жму 2 кнопки и сразу же забываю об этом. Если покопаетесь в настройках то можете так же найти еще много чего полезного: “Использовать автозамену в комментариях”, “Включать в контекстное меню” и т.д.

Так же не забываем что шаблоны эти хранятся в файлах “*.st” и любой шаблон всегда можно подключить в любой конфигуратор на любом компьютере. Делаем один универсальный шаблон под себя и используем его когда хотим и где хотим:

Файлы шаблонов “*.st”

Всем удачи! Программируем быстро и качественно!