Рекомендации по доработки расширений сторонними специалистами

Материал из Документация ПКБ «Витебск»
Версия от 14:47, 22 мая 2025; Кладов Пётр (обсуждение | вклад) (Новая страница: «=Рекомендации по разработке= Мы ''не рекомендуем'' вносить изменения в разработанные нашей компанией расширения. Они является самостоятельными тиражными продуктами, совместимость которого с текущими версиями конфигурации поддерживает наша компания....»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

Рекомендации по разработке

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

В случае необходимости срочной доработки или адаптации расширения под нестандартную версию конфигурации необходимо учитывать следующее.

При разработке расширения мы используем специальные префиксы, например, «пкбзуп», «пкбка» и т. п. Чтобы не создавать возможные конфликты доработок, мы рекомендуем использовать свой префикс, отличный от префикса разработчика.

Также мы рекомендуем изучить и использовать систему стандартов и методик разработки на платформе 1С:Предприятие (доступна по адресу https://its.1c.ru/db/v8std).

При заимствовании процедур и функций мы рекомендуем максимально использовать аннотацию «ИзменениеИКонтроль» для того, чтобы с одной стороны — чётко отделить изменения от оригинального кода, а с другой стороны — объединить их таким образом, чтобы и оригинальный код, и изменения было проще исследовать в совокупности.

Обновление версии конфигурации

Каждая версия расширения предназначена для работы с конкретной версией конфигурации. При обновлении конфигурации необходимо обновить и расширение до подходящей версии. Не обновлённое вместе с конфигурацией расширение, скорее всего, будет ограниченно работоспособно или неработоспособно вовсе.

На случай, если по какой-то причине нет возможности обновить расширение, но понадобилось обновить конфигурацию, мы даём рекомендации, как этих проблем можно избежать. Эти рекомендации предназначены для разработчиков, хорошо понимающих принципы программирования и разработки расширений в 1С. Если вы не являетесь разработчиком, этот раздел для вас не представляет ценности.

Главной проблемой при обновлении конфигурации может стать то, что её разработчики внесли некоторые изменения в заимствованные расширением процедуры и функции. Основные типовые конфигурации разработаны в режиме совместимости 1С 8.3.14 или выше. Поэтому в наших расширениях используется аннотация «ИзменениеИКонтроль». Это значительно облегчает сравнение текстов процедур в расширении с текстами процедур оригинальной конфигурации с помощью любого удобного вам средства сравнения файлов, например, TortoiseGitMerge или встроенного инструмента Total Commander.

Любые другие отличия между исходными текстами требуют анализа и принятия индивидуальных решений в каждом конкретном случае отдельно. Это может быть глобальное изменение логики работы, изменение имён объектов конфигурации (модулей, реквизитов) или переменных или просто изменение форматирования кода.