Стандарты 1С v8std

Изменен стандарт Параметры процедур и функций

Новый пункт 6.3 с рекомендацией избегать лишних пробелов при вызове методов

Избегайте лишних пробелов:
• перед открывающей скобкой
• после открывающей скобки
• перед закрывающей скобкой
• перед запятыми

Неправильно:

НовоеПоле = НовоеПолеФормы ( ИмяПоля , ТипПоля );

#std640
https://v8std.ru/std/640/

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

https://v8std.ru

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

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

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

🟡#std467: Общие требования к конфигурации
🟡#std743: Работа в разных часовых поясах
🟡#std783: Транзакции: правила использования
🟡#std438: Проверка на пустой результат выполнения запроса
🟡#std455: Структура модуля
🟡#std454: Правила образования имен переменных
🟡#std647: Имена процедур и функций
🟡#std547: Ограничение на использование оператора Перейти
🟡#std678: Безопасность прикладного программного интерфейса сервера

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

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

А знаешь ли ты паттерн работы с транзакциями?

Если знаешь, ставь ❤️
Если нет 😢

https://wonderland.v8.1c.ru/blog/novyy-mobilnyy-interfeys-platformy-1s-predpriyatie-8/

А вот и новый интерфейс для мобилки подъехал :)

Похоже с выходом нового интерфейса всю группу стандартов по дизайну можно будет устарить :)

Очень советую посмотреть канал https://t.me/AriN1C, Никита приводит отличные нестандартные но очень приятные приемы работы с Такси, и я очень надеюсь что с новым Воздушным будут новые крутые приемы :)

Вышли обновления по стандартам работы с исключениями:
1. #std499: https://its.1c.ru/db/v8std/content/499
2. #std790: https://its.1c.ru/db/v8std/content/790

Обратите внимание на следующие пункты:
- Использовать категории и коды это хорошо
- Дано разъяснение что ОшибкаКонфигурации это категория ошибок для разработчиков - используйте ее чтобы показать что разработчик косячит
- Новый метод БСП ОбщегоНазначенияКлиентСервер.ЭтоИсключениеСКодомОшибки проверяет код ошибки по всему стеку, в случае если исключение с кодом кто-то обернул в другое исключение и надо понять что исключение с кодом было где то в стеке
- ОбработкаОшибок.ПодробноеПредставлениеОшибки как и раньше для администраторов в журнал
- ОбработкаОшибок.СообщениеОбОшибкеДляПользователя теперь надо использовать для текстов для пользователя вместо ОбработкаОшибок.КраткоеПредставлениеОшибки
- Новый метод БСП ОбщегоНазначенияКлиентСервер.УточнениеИсключения который надо использовать для того чтобы делать тексты исключений понятнее. Кажется этот метод надо раскурить отдельно поподробнее 🙂

Channel created