БСП и стандарты по библиотечной разработке. Как идеалогически правильно использовать БСП?

• Что из библиотеки можно использовать, что нельзя?
• Где искать то что можно использовать?
• БСП такая большая, что в ней невозможно разобраться!

Это самые популярные вопросы, которые возникают у тех, кто первый раз открыл БСП.

Попробуем разобраться:
Стандарт: Разработка конфигураций с повторным использованием общего кода и объектов метаданных https://its.1c.ru/db/v8std#content:2149184200:hdoc
Описывает: что есть программный интерфейс, что служебный программный, а что служебные процедуры и функции.

• Программный интерфейс - это все то, что можно и нужно вызывать. Он версионируется. По нему соблюдается обратная совместимость со старыми версиями библиотеки. Используя его вы гарантируете, что совершаете легальное документируемое действие. Все мотоды программного интерфейса описываются документируемыми комментариями, по которым в дальнейшем собирается синтакс-помощник по БСП, вот он: https://its.1c.ru/db/bspdoc#content:2029:hdoc. (при желании имея поставку БСП можно его собрать самостоятельно, воспользовавшить обработкой в папке ExtFiles/Инструменты разработчика/ГенерацияОписанияПрограммногоИнтерфейса.epf)

• Служебный программный интерфейс - не следует вызывать методы из этой группы. Это то, что нужно для динамической сцепки подсистем внутри самой БСП, благодаря этому интерфейсу можно использовать частичную поставку БСП, например только три базовые подсистемы Базовая функциональность, Обновление версии ИБ и Пользователи. Все остальные подсистемы могут расширять функционал при их наличии, но их отсутствие не препятствует работе с библиотекой. (Подробнее о том какие подсистемы от каких зависят можно посмотреть в документации https://its.1c.ru/db/bspdoc#content:11:hdoc:issogl1_зависимости_между_подсистемами_библиотеки а так же в поставляемой обработке ExtFiles/ПервоеВнедрениеБСП.epf)

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

Хотите следовать хорошему тону и использовать свой код повторно, так же, как в БСП? Используйте готовые шаблоны для разных типов модулей, их можно подсмотреть в стандарте Структура модуля https://its.1c.ru/db/v8std#content:2149184104:hdoc

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