Буду краток, без излишней воды. Если будут вопросы, прошу писать в комментариях к публикации. Спасибо!
ЗАМЕТКА. В скриншотах использована ДЕМОНСТРАЦИОННАЯ база 1С: ERP релиз 2.5.5.104
Сама обработка будет подходить для любых релизов ERP.
Почему я так уверен?
Так как используется типовой код команды формы документа ЗаказКлиента, который не меняется от релиза к релизу.
А. Какая задача?
А1. Создать обработку заполнения табличной части документа
А2. Обработку необходимо добавить как внешнюю обработку. В форме документа Заказ Клиента должен появится пункт меню Форма-Еще-Обновление цены в строке по виду цен
А3. При разработке обработки должен использоваться типовой код (форма документа, модуль документа, общие модули).
А4. Заимствование и изменение типового кода можно делать в модуле обработки (или в форме обработки).
А5. ЖЕЛАТЕЛЬНО, использование и изменение типового кода свести к минимуму (для того, чтобы обработка поддерживалась на максимальном количестве релизов и версий конфигурации).
Б. Демонстрирую выполнение задачи А по пунктам.
Б1.1. Создаем новую внешнюю обработку в конфигураторе.
Б1.2. Заполняем код в модуле обработки.
Код достаточно типовой, комментировать думаю излишне. На тему данного кода полно других публикаций.
Если появятся вопросы по коду, задавайте в комментариях к публикации.
Б1.3. В обработке добавляем реквизит Ссылка с типом = СписокЗначений
Б1.4. Создаем форму обработки.
В форме обработки переносим реквизит формы Объект.ссылка на форму. Таким образом должно появится поле формы "Ссылка".
У реквизита формы "Объект.Ссылка" тип = СписокЗначений
Б1.5. В коде формы обработки переопределяем процедуру ПриСозданииНаСервере
Важно не просто написать код. Важно в конфигураторе нажать на кнопку "Процедуры и функции" и выбрать нужную типовую функцию модуля формы.
В данной процедуре мы заполняем реквизит Ссылка конкретным документом ЗаказКлиента.
При открытии формы обработки как внешний файл, будет автоматически выбираться данный документ
Б1.6. В коде формы обработки определяем процедуру ВыполнитьКоманду
В данную процедуру передается управление, когда данная обработка запускается из формы документа ЗаказКлиента как пункт меню.
Кроме того, мы будем программно передавать в нее управление с заполнение параметров.
Объясняю по порядку.
Б1.7. Если данную обработку поместить во внешние обработки в режиме 1с Предприятие
то в Заказе Клиента появится пункт меню меню Форма-Еще-Обновление цены в строке по виду цен
Теперь, если запустить обработку по клику на меню в форме документа, запустится код в форме обработки, в процедуре ВыполнитьКоманду(...).
ПРОБЛЕМА в том, что такой код НЕ ОТЛАДИТЬ. Точки останова в конфигураторе срабатывать не будут!
В. КАК Сделать отладку в модуле обработки?
В.1. Мы будем запускать форму обработки как внешний файл в режиме 1С: Предприятие.
В.2. При открытии формы обработки будет срабатывать код процедуры ПриСозданииНаСервере
Будет открываться форма обработки с выбранным ЗаказомКлиента в поле формы Ссылка
В.3. У нас на форме есть кнопка "Выполнить команду".
Определим обработчик команды, которая вызывается нажатием на данную кнопку
Команда "Выполнить команду" (закладка Команды формы обработки) выполняет код процедуры "ВыполнитьКоманду1"
Почему именно такое наименование? Потому что процедура "ВыполнитьКоманду" уже зарезервирована типовым механизмом.
В обработчике команды "ВыполнитьКоманду1" мы выполняем код:
Поясню:
1. Мы создаем и заполняем параметры для запуска типовой процедуры "ВыполнитьКоманду"
2. Мы создаем и заполняем Массив, в который помещаем ссылку на документ, который находится в поле Ссылка.
Этот документ мы могли перезаполнить вручную, либо выбрать несколько документов.
В.4. Далее выполнение кода передается в процедуру "ВыполнитьКоманду"
1. Данная процедура Может запускаться типовым механизмом (см. пункт Б1.7)
а также программным механизмом (пункт В.4.)
2. В коде процедуры мы должны сделать определенные телодвижения, чтобы запуск процедуры обоими методами ничем не отличался (был универсальным)!
Поясню:
1. В начале выполнения процедуры мы проверяем типовой реквизит ВладелецФормы.
2. Если данная процедура запущена типовым механизмом (см. пункт Б1.7) то ВладелецФормы = форма документа из которого запускается пункт меню.
3. Если данная процедура запущена программным механизмом (см. пункт В.4.), то ВладелецФормы = неопределено.
В этом случае, в режиме 1с Предприятие у нас открыта форма обработки.
Нам необходимо открыть форму документа (либо открыть существующую форму документа, если она ранее уже была открыта в 1с режиме предприятие).
После открытия формы, в переменную ФормаДок заполняется ссылка на данную форму.
4. После предыдущих пунктов в переменной ФормаДок у нас есть ссылка на форму документа.
Далее выполнение кода в обоих случаях запуска обработки (см. п. Б1.7 и В.4.) ничем не отличается !
ВАЖНО!!! САМОЕ ГЛАВНОЕ! ВОЗМОЖНА ОТЛАДКА КОДА!
Если поставить точку останова в коде и запустить обработку как внешний файл, то точка останова сработает!
Далее мы на выбор используем ПОДХОДЫ К РАЗРАБОТКЕ:
1. запускаем типовой код формы документа (экспортные процедуры и функции)
2. модуля документа (экспортные процедуры и функции)
3. либо заимствуем код документа в обработку.
Я в большинстве случаев использую подход 3. Потому что экспортных процедур очень мало (спасибо разработчикам типовых конфигураций). Изменять код формы документа или модуля я не практикую.
Что мы делаем:
1. Находим нужный кусок кода или несколько кусков. Собираем нужный нам алгоритм с использованием типовых процедур.
Количество использованных процедур сводим к минимуму.
Для этого желательно найти кусок кода который выполняет большинство нужных операций.
2. Копируем текст Процедур в форму обработки.
3. Заменяем переменные.
Например. Если скопированный код из модуля формы то заменяем переменные
Объект на ТекОбъект (в него передаем данные Объект формы документа).
ЭтотОбъект на ФормаДок (передаем ссылку на форму документа)
Таким образом:
- у нас работает отладка в обработке
- работают типовые процедуры и функции
Задача выполнена по всем пунктам!
