https://v8std.ru

🔖Ура, товарищи! Стартуем легендарный проект!
Взгляд Ингвара на стандарты 🚗.

Сайт доступен для десктопа🖥 и мобильного📱
Везде красивая подсветка кода.
Есть темная тема.

Первые стандарты:

🟡Общие требования к конфигурации
🟡Работа в разных часовых поясах
🟡Транзакции: правила использования
🟡Проверка на пустой результат выполнения запроса
🟡Структура модуля
🟡Правила образования имен переменных
🟡Имена процедур и функций
🟡Ограничение на использование оператора Перейти
🟡Безопасность прикладного программного интерфейса сервера

О добавлении и изменении статей буду публиковать информацию в канале @v8std

Подписывайся чтобы поговорить о всяком @zeegin

Дополнительные индексы (новый стандарт)

Появились в платформе 8.3.26.

🟡Только для КОРП
🟡Используйте если больше 1 млн записей в таблице
🟡Не делайте отдельную ветку кода под доп. индексы
🟡Старайтесь использовать покрывающий индекс чтобы не делать лишних соединений к реальной таблицей и извлекать данные прямо из индекса

https://v8std.ru/std/791/

Тексты модулей

🟡Пишите на русском
🟡Удаляйте закоментированный код
🟡Удаляйте служебные отметки: TODO, MRG
🟡Без ё, неразрывных пробелов и нестандартных минусов
🟡Используйте табуляцию (4 символа)
🟡НачатьТранзакцию() и ЗафиксироватьТранзакцию() не сдвигает выравнивание
🟡Длина строки не больше 120 символов
🟡Пишите комментарии понятно!

https://v8std.ru/std/456/

Особенности использования в запросах оператора ПОДОБНО

🟡Сравнение выполняется без учета регистра символов
🟡Оператор ПОДОБНО используйте без контатенации шаблона в запросе. Пишите шаблон сразу или берите из параметра.
🟡Если нужна работа на всех СУБД то используйте в паттерне только спецсимволы % (процент) и _ (подчеркивание). На IBM DB2 […] и [^…] не работает.
🟡Спецсимолы из запроса пользователя надо экранировать, иначе запрос может пойти не по плану.

Для поиск по строке Шуруп_10[21] медь~4% надо написать фрагмент.

Шуруп~_10~[21~] медь~~4~%" СПЕЦСИМВОЛ "~"

🟡Запрос.УстановитьПараметр() не экранирует спецсимволы шаблона подобия
🟡Используйте ОбщегоНазначения.СформироватьСтрокуДляПоискаВЗапросе() для формирования шаблонов подобия


https://v8std.ru/std/726/

Работа с параметром «Отказ» в обработчиках событий

🟡Параметру Отказ не присваивайте Ложь.
🟡Если ему присвоить Ложь, то можно случайно сбросить ранее установленный Истина.
🟡Установка Ложь может быть неявной: через булеву функцию. Потому и результат функции тоже не присваивайте.
🟡Вообще это правило подходит для любых возвращаемых булевых параметров, например СтандартнаяОбработка, Выполнение.
🟡Если устанавливаете параметр Отказ в Истина, то объясняйте пользователю что случилось.

https://v8std.ru/std/686/

🏗 Практика по проектированию общих модулей

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

Архитектурные принципы📍
⚪️Функциональная группировка. Выделяйте отдельные модули по назначению: работа с датами, файловая система, интеграции.
⚪️Экспорт только нужного. Внутренние вспомогательные функции не должны быть экспортными.
⚪️Разделение клиентской и серверной логики. Упрощает понимание и избегает ошибок вызова в неправильном контексте.
⚪️Минимизация глобальных модулей. Явное подключение повышает прозрачность кода.
⚪️Документирование кода. Комментарии к процедурам и параметрам ускоряют разработку.

Ошибки, которых стоит избегать📍
〰️Хранение в одном модуле всего подряд (модуль-свалка).
〰️Дублирование кода между модулями.
〰️Жёсткая привязка к конкретным формам или объектам без необходимости.
〰️Злоупотребление экспортными процедурами.

Чек-лист по постфиксам модулей📍
🔹ПолныеПрава - для модулей с признаком Привилегированный.
🔹Глобальный - для глобальных модулей, без добавления Клиент.
🔹Локализация / КлиентЛокализация - для модулей с национальной спецификой.
🔹ПовтИсп / КлиентПовтИсп - для модулей с кэшированием результатов (сервер / клиент).
🔹Переопределяемый / КлиентПереопределяемый - для модулей библиотек, допускающих изменение реализации.

Выжимка с ИТС по теме💡
🔗 Правила создания общих модулей
🔗 Использование привилегированного режима
🔗 Повторное использование возвращаемых значений
🔗 Использование подсистем

// Скриншот-шпаргалку помог нарисовать Copilot.

#НачинающимНаЗаметку #Практика1С