Оформление текстов запросов

🟡Ключевые слова запросов пишите заглавными, сами запросы — только структурированно, не в одну строку.

🟡Явно задавайте псевдонимы полям и используйте КАК, особенно для полей с вложенными реквизитами.

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

🟡При программной сборке запроса документируйте этапы и оставляйте части, которые открываются в конструкторе.

🟡Даны типовые примеры «Неправильно/Правильно» для замены полей, временных таблиц и пакетных запросов.

#std437
https://v8std.ru/std/437/

Проверка на пустой результат выполнения запроса

🟡Когда нужно только проверить наличие строк, используйте Пустой() — это быстрее, чем выгружать результат.

🟡Не вызывайте Пустой(), если дальше все равно будете выбирать/выгружать данные — это лишний вызов.

#std438
https://v8std.ru/std/438/

Описание процедур и функций

🟡Пишите комментарии к процедурам и функциям — их видят в подсказках и в EDT.

🟡Экспортные методы документируйте обязательно, внутренние — только если есть нюансы.

🟡Описание должно объяснять назначение, а не повторять имя.

🟡Структура комментария: Описание → Параметры → Возвращаемое значение → Пример.

// Проверяет доступность ролей для текущего пользователя.
//
// Параметры:
//  ИменаРолей - Строка - имена ролей через запятую.
//
// Возвращаемое значение:
//  Булево - Истина, если доступна хотя бы одна роль.
//
Функция РолиДоступны(ИменаРолей) Экспорт

#std453
https://v8std.ru/std/453/

Правила образования имен переменных

🟡Имя берите из предметной области — сразу понятно назначение.

🟡Пишите слитно, каждое слово с заглавной буквы; предлоги и местоимения тоже с заглавной.

🟡Не начинайте имя с подчеркивания.

🟡Не используйте имена из одного символа (кроме счетчиков цикла).

🟡Булевы переменные называйте по истинному смыслу: ЕстьОшибки, ЭтоТоварТара.

#std454
https://v8std.ru/std/454/

Структура модуля

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

🟡Разделы оформляйте областями и не оставляйте пустых.

🟡Публичный интерфейс — сверху, чтобы его было видно первым.

🟡Обработчики событий располагайте выше служебных методов и группируйте по элементам формы.

🟡Не вызывайте обработчики напрямую из кода — оставьте их только для платформы.

🟡Используйте заготовленные шаблоны оформления модулей

#std455
https://v8std.ru/std/455/

Общие требования к конфигурации

🟡Используйте только штатные и документированные возможности платформы.

🟡Закладывайте работу в разных средах: СУБД, ОС, браузеры.

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

🟡Поддержите минимальную работу в обычном приложении для администраторов.

🟡Не оставляйте мертвый код и мертвые метаданные.

🟡Сортируйте метаданные по имени, а подчиненные — по проектной логике.

#std467
https://v8std.ru/std/467/

Ограничение на использование оператора Перейти

🟡Перейти ухудшает читаемость и структуру кода.

🟡Используйте Если, Иначе, Возврат, циклы — это проще и надежнее.

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

#std547
https://v8std.ru/std/547/