Как быстро, при помощи расширений, доработать движения регламентированного учета в ERP 2.4 или KA 2

Программирование - Практика программирования

ERP KA расширение

48
Для тех, кому предстоит поработать с отражением документов в регламентированном учете в конфигурациях ERP 2 и KA 2.

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

Возвращаясь к заголовку, в этой статье, на простом примере, я расскажу, как это можно сделать.

Сокращения:

РУ – регламентированный учет

УУ – управленческий учет

Итого что мы имеем:

  • конфигурация: ERP 2.4.5.24;
  • версия платформы 8.3.12.1616.

P.S. В конфигурации комплексная автоматизация 2 можно использовать такой же алгоритм, какой будет описан ниже.

Некое лирическое отступление:

Есть некоторые спорные моменты - как быть если нужно добавить некоторые объекты в систему? На проектах, команда разработчиков, частью которой я являюсь, договорилась, что все новые объекты конфигурации, мы добавляем именно в основную конфигурацию, а всю новую логику мы выносим в расширение. С чем это связано? С тем, что нет четкой уверенности, как поведет себя платформа, например, с данными новых реквизитов при отключении расширения. Есть мнение что им может прийти конец. Риск – дело благородное, но у клиента на этот счет может быть иное мнение. Плюс ко всему, новые объекты конфигурации не сильно осложняют последующие обновление конфигурации, да конфигурация «вскрыта», но сравнение и объединение пройдет быстро.

Постановка задачи:   

Необходимо добавить подразделение в табличную часть товары в документе «Реализация товаров и услуг».

Типовое поведение системы подразумевает, что подразделение у нас устанавливается на вкладке «Дополнительно». А нам надо, чтобы подразделение было в табличной части «Товары».

Решение:

Для начала нам нужно добавить новый реквизит «Подразделение» в табличную часть документа «Приобретение товаров и услуг». Не забываем добавить префикс у нового реквизита.

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

Третьим этапом, мы выясним, что все запросы для движений регистра бухгалтерии «хозрасчетный» находятся в модуле менеджера нашего документа, нам останется только их отредактировать. Открываем в расширении модуль менеджера объекта «реализация товаров и услуг». Ищем нужные нам функции, содержащие соответствующие тексты запросов. Весьма важно, чтобы у нас внезапно не упала база с красной ошибкой, перед началом работы добавить область:

#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда

#КонецЕсли

Пример как это может выглядеть приведен ниже:

Здесь видно, что при помощи директивы «&Вместо» мы подменяем функции модуля менеджера основной конфигурации, на нужные нам (копируем код и правим).

Далее осталось только отредактировать запрос в нашей новой функции:      

///////////////////////////////////////////////////////////////////////////////////////////////
|	НЕОПРЕДЕЛЕНО КАК МестоУчетаДт,
|	Операция.ВалютаВзаиморасчетов КАК ВалютаДт,
//+ Некоторый комментарий
//  Операция.Подразделение КАК ПодразделениеДт,
|	РеализацияТоваровУслугТовары.ИС_Подразделение КАК ПодразделениеДт,
//- Некоторый комментраий
|	ЕСТЬNULL(Расчеты.НаправлениеДеятельности, Операция.НаправлениеДеятельности) КАК НаправлениеДеятельностиДт,
///////////////////////////////////////////////////////////////////////////////////////////////
	
///////////////////////////////////////////////////////////////////////////////////////////////
|	ЗНАЧЕНИЕ(Справочник.Склады.ПустаяСсылка) КАК МестоУчетаКт,
|	ЗНАЧЕНИЕ(Справочник.Валюты.ПустаяСсылка) КАК ВалютаКт,
//+ Некоторый комментарий
//  Операция.Подразделение КАК ПодразделениеКт,
|	РеализацияТоваровУслугТовары.ИС_Подразделение КАК ПодразделениеКт,
//- Некоторый комментарий
|	Операция.НаправлениеДеятельности КАК НаправлениеДеятельностиКт,
|	ЗНАЧЕНИЕ(ПланСчетов.Хозрасчетный.ПустаяСсылка) КАК СчетКт,
///////////////////////////////////////////////////////////////////////////////////////////////

Теперь про движения по регистру бухгалтерии в целом. Тот маленький кусочек, который мы рассмотрели, это часть единого механизма отложенного отражения в РУ. В ERP движения по УУ и РУ разделены, это преследует разные цели в т.ч. производительность. При проведении документа, если это требуется, в регистре сведений «Документы к отражению в регламентированном учете» делается запись, которая является маркером, по которому определяется нужно отразить документ в РУ или нет. После этого обработка «Отражение документов в регламентированном учете», по запросу пользователя или регламентным заданием, опираясь на маркер, собирает сведения по отражению. Вот тут мы снова возвращаемся к модулю менеджера, где для каждого документа уже есть свой алгоритм формирования данных – запросы. Тут же мы можем не только дорабатывать существующие запросы, но и добавлять свои (можно скопировать запрос наиболее похожий на тот который мы в итоге хотим получить и дописать его). Все запросы в итоге объединяются в один, в процедуре которая указана ниже.

Функция ТекстОтраженияВРеглУчете() Экспорт
	
	ТекстыОтражения = Новый Массив;
	
	//////////////////////////////////////////////////////////////
	ТекстыОтражения.Добавить(ТекстПередачаНаКомиссию());
	//+ Некоторый комментарий
	ТекстыОтражения.Добавить(ТекстНашНовыйЗапрос());
	//- Некоторый комментарий
	//////////////////////////////////////////////////////////////
	
	Возврат СтрСоединить(ТекстыОтражения, ОбщегоНазначенияУТ.РазделительЗапросовВОбъединении());
	
КонецФункции

Вот собственно и все, надеюсь эта информация будет полезна и поможет решить похожие задачи.

48

См. также

Специальные предложения

Лучшие комментарии
10. VladimirL 836 26.11.18 18:56 Сейчас в теме
(9)
Тогда после обновления в отчете мы увидим какие из таких "опасных" процедур были изменены.

В этом правиле нужно будет учесть возможность переименования метода в исходной конфигурации. Либо продумать несколько этапов автоматической проверки, где только один из них - это АПК.

Идея для автоматизации конечно классная, если АПК уже умеет работать с расширениями. Хотелось бы увидеть пример реализации ))
Остальные комментарии
Избранное Подписка Сортировка: Древо
1. karshev 26.11.18 15:00 Сейчас в теме
Хорошая статья, актуальная
2. KVIKS 26 26.11.18 15:30 Сейчас в теме
Пора вкуривать расширения
3. acsent 1121 26.11.18 16:08 Сейчас в теме
полностью выносить процедуру в расширение - обернется потом проблемой, что вы не будете знать когда основной код поменяется, а в вашей доработке нет.
И еще хорошо, если сразу упадет, а если просто данные будут не те выдавться
sank84; Sintson; VladimirL; +3 Ответить
4. katenok86 244 26.11.18 16:10 Сейчас в теме
(3)Да за это не люблю использовать в расширении конструкцию вместо. Лучше пусть ух будет не совсем типовое обновление, зато при обновлении видно ляжет ли корректно доработка в типовой релиз
18. artfa 29 28.11.18 12:59 Сейчас в теме
(4) и я того же мнения, если расширение, то при каждом обновлении нужно будет отслеживать изменения в коде конфы, тогда как если изменения в самой конфе, при обновлении их сразу увидишь.
Расширение, очень любят клиенты, мол конфа на поддержке, обновим сами, ага, обрадовались, как только изменения коснутся расширения, то база либо упадет, либо ещё хуже, расширение будет работать, но не правильно.
5. logarifm 1020 26.11.18 16:16 Сейчас в теме
Чушь. Куда и что упадет. Для этого делается ОДНО расширение в конфигурации - с типом "Исправление". Например ИсправлениеШтатногоФункционала и только в такие расширения пихать блоки ВМЕСТО. И при обновлении учитывать такие блоки!!!
BuriyLesha; Shmell; +2 Ответить
6. nomadon 341 26.11.18 16:27 Сейчас в теме
(5)
упадет с красной ошибкой
13. SanchoD 57 27.11.18 10:06 Сейчас в теме
(6) У меня расширения просто игнорируются при запуске базы, если в них какие-то рассогласования с новым релизом. Ни разу база не падала. Максимум появлялась ошибка при каких-либо манипуляциях с объектом, функционал по которому вынесен в расширение.
7. Shmell 79 26.11.18 16:36 Сейчас в теме
(5) добавлю - даже если разработчиков несколько - можно сделать хранилище расширения с таким типом...
8. VladimirL 836 26.11.18 18:15 Сейчас в теме
(5)
При переходе на новый релиз сложнее увидеть что изменилось и требует адаптации. Нужно именно отдельно "учитывать такие блоки", то есть самостоятельно сравнивать тексты методов.

При этом часто нужно трехстороннее сравнение-объединение кода из нового релиза, старого релиза и нашей версии кода. Это легко обеспечивается KDiff3 при изменениях модулей исходной конфигурации, но с расширениями пока не работает. Большие подвижки в этом без применения внешних инструментов обещает EDT, но опять же не в отношении расширений конфигурации. Их придется дорабатывать для нового релиза опять же вручную.

Иными словами автоматика в этом случае не помогает выполнить процесс обновления. Когда измененных методов немного, то это не проблема, но если доработки серьезные, то риск учесть не все изменения сильно повышается. Проблема возникает и при изменении сигнатур методов, даже платформенная проверка конфигурации на некорректные вызовы не отлавливает все ошибки, в то время как при проверке основной конфигурации отрабатывает корректно. Сталкивался с этим при переходе с ERP 2.2 на 2.4 c обновлением БСП.
9. kozlov.alians 48 26.11.18 18:29 Сейчас в теме
Да, механизм расширений имеет некоторые недостатки, но в любом из таких случаев мы можем поступить двумя методами:
- отказаться от использования;
- что-нибудь придумать.

Не плохой вариант использовать АПК (автоматическая проверка конфигураций). Для каждой такой доработки создать правило, по которому можно проверить контрольную сумму исходной и обновленной процедуры/функции. Для скорости определить настройки проверки, где указать только нужные объекты конфигурации и только нужные правила. Тогда после обновления в отчете мы увидим какие из таких "опасных" процедур были изменены.

Да, при этом останется риск, что кто-то забудет это сделать, но это уже организационный вопрос.

P.S. Расширения динамично развиваются, так что есть вероятность, что и этот недуг будет скоро побежден. Думаю отличный повод написать на партнерский форум.
G.Shatrov; +1 Ответить
10. VladimirL 836 26.11.18 18:56 Сейчас в теме
(9)
Тогда после обновления в отчете мы увидим какие из таких "опасных" процедур были изменены.

В этом правиле нужно будет учесть возможность переименования метода в исходной конфигурации. Либо продумать несколько этапов автоматической проверки, где только один из них - это АПК.

Идея для автоматизации конечно классная, если АПК уже умеет работать с расширениями. Хотелось бы увидеть пример реализации ))
11. kozlov.alians 48 26.11.18 19:03 Сейчас в теме
(10)
если АПК уже умеет работать с расширениями
умеет.

Хотелось бы увидеть пример реализации ))
Почему бы и нет, думаю тема будет интересной, можно написать статью. :)
VladimirL; +1 Ответить
12. HAMMER_59 75 27.11.18 07:22 Сейчас в теме

//+ Некоторый комментарий
// Операция.Подразделение КАК ПодразделениеДт,
| Операция.Подразделение КАК ПодразделениеДт,
//- Некоторый комментраий
| РеализацияТоваровУслугТовары.ИС_Подразделение КАК ПодразделениеДт,


Какой интересный запрос.
14. kozlov.alians 48 27.11.18 10:15 Сейчас в теме
15. the1 321 27.11.18 11:51 Сейчас в теме
Я в таких случаях использую конструкцию &После (вместо &Вместо))))

Пусть конфигурация сделает все по-своему, а уж расширение что-то доделает по-своему, а что-то переиначит в результатах работы конфигурации. Да, производительность пострадает, зато совместимость выиграет.
16. Tavalik 1688 27.11.18 14:30 Сейчас в теме
А потом вы обновляетесь на 2.4.6 и внезапно обнаруживаете, что тексты движения запросов в регистры поменялись чуть более, чем полностью, а текстов запросов для формирования проводок больше НЕТ в модуле менеджера документа. Вам, по ходу, это еще предстоит пройти )

А по вашему методу, будет отрабатывать старый, не актуальный текст запроса, так же как и с проводками.

Поэтому, мы все же делаем вставки в типовой код, хоть это и ведет к усложнению обновления.

Но за статью спасибо.
artfa; VladimirL; o.egorova.omsu; +3 Ответить
19. katenok86 244 28.11.18 13:03 Сейчас в теме
(16)А куда они делись? Еще не обновляли ни кого на 2.4.6
20. Tavalik 1688 28.11.18 15:16 Сейчас в теме
(19)
Вынесли в общие модули.
21. ikolegov 29.11.18 09:38 Сейчас в теме
(16) Только что с превеликим трудом почти перешли с 2.1 на 2.4.5 (конфа сильно переписана). Хотите сказать, что и переход на 2.4.6 будет мучительным?
22. Alexjas25 12.12.18 15:11 Сейчас в теме
(16)Виталий, ну комментарий Ивана про АПК и отдельное правило для данной функции как раз об этом. После обновления автоматическая проверка сразу оповестит, что "что-то пошло не так".
Без АПК, конечно, это будет сложно отловить.
17. Lukich66 82 28.11.18 09:53 Сейчас в теме
Только начал осваивать Ка2 и чем дальше,тем интереснее. А тут сразу доработать движения регламентированного учета? Т.е фирма 1с уже все новые вещи выпускает недоделанными, а для тех кому хоцтса- расширения? М-да-а-а.
Оставьте свое сообщение