Найти в Дзене
Vedateka

Основные Стандарты 1С при написании кода

Имена процедур и функций должны быть:
Примеры: Неправильно: ВыполнитьПроверкуСПараметрами
Правильно: ЗаполнитьИменаРеквизитовПоХозяйственнойОперации
Комментарии обязательны для:
Важно: Не дублировать название функции в комментарии.
Называть типы параметров и возвращаемых значений. Параметры должны быть: Понятными: избегать сокращений типа P1, P2.
Передаваться явно: не использовать переменные модулей или реквизиты формы.
Располагаться логично: сначала общие, затем частные.
Если параметров больше 7, их следует объединить в структуру. Общие модули предназначены для: Размещения бизнес-логики, а не обработчиков форм.
Логически оформленных процедур и функций, решающих конкретные задачи.
Названия модулей должны отражать их суть, без лишних уточнений. Если строка кода длиннее 120 символов, ее нужно переносить. Ключевые слова, операторы и знаки должны располагаться в начале новой строки. Дублирование кода приводит к ошибкам и усложняет поддержку. Избавляйтесь от него, объединяя повторяющи
Оглавление

Стандарт 647: Имена процедур и функций

Имена процедур и функций должны быть:

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


Примеры:

Неправильно: ВыполнитьПроверкуСПараметрами
Правильно: ЗаполнитьИменаРеквизитовПоХозяйственнойОперации

Стандарт 453: Описание процедур и функций


Комментарии обязательны для:

  • Экспортных процедур и функций.
  • Сложных функций с нестандартной логикой.


Важно: Не дублировать название функции в комментарии.
Называть типы параметров и возвращаемых значений.

Стандарт 640: Параметры процедур и функций

Параметры должны быть: Понятными: избегать сокращений типа P1, P2.
Передаваться явно: не использовать переменные модулей или реквизиты формы.
Располагаться логично: сначала общие, затем частные.
Если параметров больше 7, их следует объединить в структуру.

Стандарт 469: Правила создания общих модулей

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

Стандарт 444: Перенос выражений

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

Стандарт 440: Использование дублирующего кода

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

Стандарт 438: Проверка на пустую результативность выполнения запроса

Используйте метод РезультатПустой, чтобы избежать лишних обращений к базе данных.

Стандарт 758: Псевдонимы источников данных в запросах

Псевдонимы должны быть: Осмысленными: отражать суть таблицы.
Читаемыми: без сокращений до одного символа.

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

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

Стандарт 729: Оптимизация кода для производительности

Выбирайте только нужные данные.
Избегайте сложных запросов и вложенных подзапросов.
Минимизируйте количество таблиц в запросе.

Стандарт 657: Обращение к виртуальным таблицам

Условия, относящиеся к виртуальной таблице, должны передаваться в параметры таблицы, а не в секцию ГДЕ.

Стандарт 477: Самодостаточность регистров

Регистры должны быть независимы от регистраторов. Все необходимые данные должны храниться внутри регистра.

Стандарт 648: Ответственное чтение данных

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

Стандарт 783: Правильное использование транзакций

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

Стандарт 465: Обработка событий и поведение объектов

В обработчиках событий важно: Не изменять содержимое объекта после записи.
Проверять флаг ОбменДанными.Загрузка для предотвращения лишних действий.

Стандарт 781: Безопасное хранение паролей

Пароли лучше не хранить в базе данных. Используйте безопасное хранилище паролей из БСП для зашифрованного хранения.

Стандарт 499: Перехват исключений в коде

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

Стандарт 693: Использование объектов типа "Структура"

Структуры должны быть: Понятными: не передавайте более 3 значений в конструктор.
Четкими: создавайте структуры с полным набором свойств.

Стандарт 781: Особенности сортировки в таблице значений

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


Вернутся на уровень выше.