Редактор замещений.Редактор замещений выглядит достаточно серьезно, но ничего особо сложного при работе с ним нет; как видно на рисунке 10: OBBH-4.png новый код замещения MYEXT для момента позиция документа добавлен в дерево замещений, в котором уже присутствуют другие коды для момента 0002.
Один из кодов REG_SUB я раскрыл, и видно, что в нем уже существует 5 этапов. Фактически этап это - отдельный шаг проверки для строки документа. На каждом шаге вы можете менять любое из допустимых полей позиции документа. При этом учтите, что если на каком-то шаге с порядковым номером, большим относительно вашего этапа, будет изменение того же поля, которое меняете вы, то само собой, система сохранит последнее изменение. При этом вам, как пользователю, ничего не будет сообщено о том, что поле было переопределено несколько раз на разных этапах. Так что, если вы сделали свой этап, а таких этапов уже - «целый вагон», желательно пройтись по всем и посмотреть: не использует ли кто-то уже поле, то же что и вы, для каких-то своих целей? В данном случае, замещение новое, так что этап будет только наш. Для примера, желательно бы конечно назвать наше замещение слева от дерева замещений, например "Замещение MM-IV". Теперь надо добавить свой шаг в замещение. Вопрос почему в дереве оно называется "Этап", а кнопка на панели инструментов называется "Шаг", наверное следует адресовать переводчикам, тем не менее, чтобы создать этап замещения, надо нажать кнопку "Шаг". Система выведет экран, рисунок 11: OBBH-5.png, со списком полей, которые можно замещать.
В принципе можно выбрать первое пустое значение, что значит: хотим создать только экзит без привязки к полям, что замещать решим по ходу дальше, но в данном случае, мы знаем, что хотим замещать текст позиции документа, поэтому, выберем ниже по списку, позицию BSEG-SGTXT и нажмем ОК. Система, спросит: какой тип операции замещения для поля мы хотим использовать? Пример на рисунке 12: OBBH-6.png. Как видим вариантов 3:
- Константа, вариант реализации, когда полю всегда будет присваиваться какое-то определенное значение. Это - весьма полезный вариант, очень часто используется присвоение именно констант: это делается путем создания разных этапов, для каждого этапа определяется свое условие срабатывания, например, по виду документа. Таким образом, можно создать набор соответствующих постоянных присвоений в зависимости от какого-то конечного набора правил. Для поля «текст позиции» это не актуально, но, к примеру, какие-то объекты контировки типа МВЗ/СПП-элементы/Финансовые позиции, очень часто именно так и замещают, в автоматическом режиме.
- Программа пользователя. Обратите внимание: два первых шага, описанные выше, как раз и были подготовкой для работы замещения через программу пользователя.
- Присвоение поле-поле, позволяет копировать значение из любого поля документа в замещаемое поле, например, можно сделать при определенных условиях копирование поля текст заголовка в поле текста позиции.
В данном случае выбираем "программа пользователя" и система вставляет значение в наше замещение (первый этап), рисунок 13: OBBH-7.png.
Целесообразно дать имя этапу, это не обязательно, но очень «кошерно» и впоследствии упростит работу: все ходы записаны и комментированы. Называем эту процедуру, например, "Проводка документа инвентаризации" и переходим к шагу формирования предпосылки и написания самого замещения.
Предпосылки замещений.Предпосылка представляет собой фактически фильтр, по которому будет вызываться ваша программа замещения. Можно работать без предпосылок, но тогда следует учесть, что любая проводка документа FI будет попадать в ваше замещение и вам, во-первых, потребуется рисовать сложную логику фильтрации, чтобы отбирать только интересующие позиции, а во-вторых справляться с ситуацией когда: 50 000 документов FI в месяц это - даже не очень много, а есть системы, где их за сотни тысяч проводится.
Вопрос: Вы уверены, что сделали все правильно?
Вывод: Лучше сделать правильную предпосылку, а уже на уровне программы дописать то, что не получится сделать с помощью редактора предпосылок.
Переходим на ветку дерева "Предпосылка". Справа будет открыто окно создания предпосылки + визуальный редактор, которым можно сделать почти все, а если не все, то всегда можно переключиться на режим эксперта, по меню: "Параметры настройки" - "Экспертный режим" и ввести условия на языке, похожем на ABAP; однако это не совсем ABAP, так что синтаксис все - таки надо поучить в документации. В общем, внешний вид как на рисунке 14: OBBH-8.png, где суть работы заключается в том, что выбирается структура и поле структуры, затем проводится операция с этим полем.
Операция обычно представляет сравнение выбранного поля с чем-то и т.д. Для работы предложены три структуры: заголовок документа, позиции документа и системная структура словаря SYST («абаперам», наверное, объяснять не надо, «неабаперы» могут зайти в SE11 и посмотреть на поля и описание, либо обратиться к «абаперу» это более разумно). Теперь вернемся к фильтру: что надо фильтровать и как, предлагаю начать с исследования документа инвентаризации (вроде как замещение договорились делать для таких типов документов). Порядок формирования документов в системе в принципе следующий: Документ инвентаризации – Документа материала ММ – Финансовый документ FI, значит начинать надо с документа инвентаризации. Для примера нашел документ как на рисунке 15: MI06.png. Транзакция просмотра документов инвентаризации MI06.
Как видим, после подсчета был проведен уже документ материала 4900031463, перейдем к просмотру документа материала, рисунок 16: MB03.png. Транзакция просмотра документов материала MB03, а в ней уже выбираем кнопку RW-Документы.
От документа материала можно перейти к документам FI, пример на рисунке 17: FB03.png. Из данного документа можно сказать, что фильтр будет следующим:
- Вид документа нас будет интересовать WI - Документ инвентаризации. Однако этого мало, так как если человек в FI ошибется, то может и случайно провести в ручном режиме такой документ.
- Ссылочная операция MKPF - Ее мы тоже включим в фильтр, так как это значит, что документ проведен как ссылочный к операции из ММ.
- Код транзакции MI07? Если у вас используется только стандарт и ведомости не проводятся программно (тогда код транзакции может быть другой), то можно включить и код транзакции. В данном случае я код транзакции включу в фильтр.
Примечание: Код транзакции при проводке разниц будет со ссылкой на документы инвентаризации MI07 (на рисунках стоит MI10, это инвентаризация без ссылки).Вот по этим трем параметрам заголовка документа и построим сейчас фильтр. Для получения полной картины желательно проанализировать не один документ инвентаризации, а десяток - другой, да и еще просмотреть другие документы, которые порождаются в системе, чтобы быть точно уверенным, что ваш фильтр будет отбирать только то, что вам нужно, а не сотни других документов, которые, оказывается, тоже попадают под заданные параметры фильтра.
Итак, возвращаемся в конструктор предпосылок. Все поля, которые мы отобрали для фильтра, находятся в заголовке документа. Значит, нам нужна из трех структур именно таблица заголовка. Как видим "Структура BKPF" , Заголовок документа для бухгалтерии, - то что нам нужно, рисунок 18: OBBH-9.png.
Делаем двойной клик мышью на имени структуры BKPF и попадаем в просмотр полей заголовка документа FI. Наши поля выделены на рисунке 19: OBBH-10.png и ниже по списку, еще есть поле кода транзакции.
Теперь – двойной клик мышью на поле BKPF-BLART - Вид документа, и поле будет скопировано в верхний экран, рисунок 20: OBBH-11.png.
Затем кликаете мышью на знаке равно справа от списка полей и в окне ввода условия появится фраза: "Вид документа =", рисунок 21: OBBH-12.png, после чего у вас к выбору из кнопок справа доступными будут кнопки "Константа" и "Комментарий".
Комментировать пока нечего, а вот константу мы знаем, это код вида документа "WI", поэтому выбираем кнопку "Константа" и в появившемся окне или выбираем, или вводим код WI, после чего жмем ОК, и в результате должны получить нечто похожее на рисунке 22: OBBH-13.png. Аналогично добавим ограничения на два других поля.
Между этими полями в качестве условия соединения используется операция AND, т.е. когда совпадут все три условия, то фильтр зафиксирует, что предпосылка сработала и вызовет нашу программу замещения. Общий результат должен быть как на рисунке 23: OBBH-14.png. Обратите внимание, что если вы все правильно сделали, то статус должен быть в виде зеленого светофора.
Таким образом, если все сделано корректно, то в системе будет настроено замещение, которое будет вызывать пользовательскую программу в случае проводки документов инвентаризации. Текст реализации программы будет описан далее.
Примечание. Кнопка информации, рядом со статусом, выдает краткую справку по вводу формул для написания предпосылок.Замещения.Замещения – это то, что произойдет в результате срабатывания фильтра: если предпосылка будет выполнена, система перейдет к ветке замещения и значит, или выполнит нашу программу, или выдаст сообщение и т.д. Так как мы выбрали, что замещением будет программа пользователя, то экран будет представлен как на рисунке 24: OBBH-15.png. Вся работа с этим экраном, состоит в том, чтобы задать имя нашей подпрограммы замещения. Так как подпрограмма нами уже создана, то нажав в поле "ПользПрограмма" кнопку допустимых значений F4, в появившемся окне находим свой код U777 или вводим его руками. После чего сохраняем работу.
Необходимо удовлетворить запрос для переноса, который нужно будет или создать в этом момент, или выбрать из созданных ранее. Затем возвращаемся из экрана конструктора в таблицу БЕ, рисунок 25: OBBH-16.png (или по F3 несколько раз или Shift+F3), и активируем замещение путем задания статуса = 1, в поле "СтепАктивир". В принципе, там может быть еще значение 2 - активировано без пакетного ввода, т.е. при выполнении пакетных вводов наша предпосылка никогда не будет выполняться. Иногда это - источник ошибок, когда в диалоге у пользователя все работает, а при пакетном вводе замещение не срабатывает.
Теперь уже окончательно все сохраняем. Замещение работает и вызывается. Для проверки этого можно провести документ инвентаризации и какой-то простой отпуск или перемещение материала. Мы попадем в точку останова, только при проводке инвентаризационных разниц (можете это проверить у себя в системе).
На следующем шаге уже займемся собственно «абаперством», будем писать код, который должен собственно говоря сформировать строку замещения для поля BSEG-SGTXT.
Примечание: Так как на шаге 4, мы выбрали конкретное поле, рисунок 10: OBBH-5.PNG, то нам нужно модифицировать подпрограмму U777, путем добавления параметра P_SGTXT, т.е. теперь подпрограмма должна выглядеть так:*{ INSERT &$&$&$&$ 1
*---------------------------------------------------------------------*
* FORM U777 *
*---------------------------------------------------------------------*
* Моя прогрмма замещения *
*---------------------------------------------------------------------*
FORM U777 USING p_sgtxt.
ENDFORM.
*
*} INSERT
Если этого не сделать, то в момент проводки инвентаризационных разниц, будет получен дамп, типа не соответствия количества вызываемых параметров. Ну и соответственно надо сказать, что мы замещаем и каким значением. Кстати, если бы мы не указали значение BSEG-SGTXT, тогда параметр указывать было бы не нужно, ну а значение присваивать напрямую в структуру BSEG-SGTXT, которая доступна как глобальная для подпрограммы U777.
Список всех доступных структур для подпрограммы U777 во время работы можно посмотреть в заголовке текста программы ZGGBS000, например, у меня, - это следующие структуры:
TABLES: CSKS,
GLU1,
BKPF,
BSEG,
ACCIT,
ACCHD,
*{ INSERT IDTK911943 1
fila_valsup,
zzprctr,
COBL,
PRPS. "for form U901
* zzper.
TYPE-POOLS: GB002.
Итак, переходим к самому написанию подпрограммы U777. В настоящий момент программа выглядит как:
FORM U777 using p_SGTXT.
break-point.
ENDFORM.
Наша задача теперь присвоить строке комментария позиции документа FI номер документа инвентаризации. В общем виде данная задача решается через доступы к переменным документа инвентаризации, используя технику работы с FIELD-SYMBOLS.
Список доступных структур в подпрограмме U777 приведен выше и видно, что в этом списке отсутствует вообще какое-либо упоминание о документах инвентаризации, однако можно попробовать «добыть» эти данные. Я предлагаю делать это так:
FORM u777 USING p_sgtxt.
DATA: ls_ikpf LIKE ikpf.
FIELD-SYMBOLS: <fs_ikpf> TYPE ANY.
BREAK-POINT.
ASSIGN ('(SAPMM07I)IKPF') TO <fs_ikpf>.
CHECK sy-subrc = 0.
ls_ikpf = <fs_ikpf>.
p_sgtxt = ls_ikpf-iblnr.
UNASSIGN <fs_ikpf>.
ENDFORM. "U777
Так как все работает по цепочке: Документ инвентаризации – Документ материала – Документа FI, то пока транзакция не будет завершена, все данные программ отвечающих за документ материала, документ инвентаризации, с большой вероятностью находятся в памяти, а это значит, что к ним можно попробовать получить доступ. Возможно, кто-то назовет это дыркой в изоляции данных, но я назову это большим благом для разработчика.
Имя главной программы инвентаризации можно получить, просмотрев имя программы к транзакции MI07. Для этого заходим в транзакцию SE93 и там вводим код MI07 и кнопку «Просмотреть», рисунок 26: SE93.png, как видим имя программы SAPMM07I.
Теперь, надо узнать, какие структуры нам нужны, т.е. найти глобальные переменные этой программы, в которых находится номер документа инвентаризации. Я нашел имя структуры через отладчик, это заняло пару минут. Отладка транзакции MI07 с экрана 701. Однако часто имена глобальных структур совпадают с именами таблиц, где хранятся документы порождаемые транзакцией. Таблица заголовка документа инвентаризации это - IKPF, так что другой метод это - поискать имя этой таблицы по тексту программы. Иногда может оказаться, что таблица будет, например MSEG,, а структура будет называться XMSEG. В общем, «есть варианты».
Дальше делаем проводку документа инвентаризационных разниц и попадаем в отладку. Переходим в отладчике к полю ввода просмотра значений переменных и там вводим в скобках имя программы и далее имя структуры, пример на рисунке 27: ABAP.png. Кстати, если мы неправильно нашли структуру, то будет выведено сообщение об ошибке, если же структура доступна, то система покажет значения, находящие в этой структуре. В данном случае это то, что нам надо, а дальше, используя технику работы с ссылками получаем ссылку на эту структуру. Проверяем, удалось ли это сделать. Если удалось, присваиваем ссылку внутренней переменной того же типа, что и структура, и дальше присваиваем в p_sgtxt номер документа инвентаризации. Задача решена, в позиции текста документа FI будет находится номер документа инвентаризации.
Пример на рисунке 28: 4900000000.png - ниже. При таком коде, все позиции будут содержать номер документа инвентаризации. Возможно, мы захотим, чтобы этот номер содержала только позиция документа с уровня счета доход от инвентаризации, тогда все просто, надо проверить, не счет главной книги, а вид операции к позиции. Для счета запаса это будет BSX, а для счета дохода GBB, т.е. можно было бы вставить первой строкой процедуры, что-то типа: CHECK BSEG-KTOSL = ‘GBB’, и тогда номер документа инвентаризации был бы только во второй строке проводки. Можно добавить проверку условия в предпосылки, тогда в самой программе ничего проверять уже не нужно.
В справке по "Проверки, замещения и правила", расписаны операции сравнения и т.д. что большой плюс, на русском... хотя некоторые переводы заставили при чтении задуматься над тем, что имеется в виду. См. ссылку: You are not allowed to view links.
Register or
Login
