guixt solution sd-0021 guixt solution sd-0021 page 1 of 32 so a ... va0x_read_atp.txt ... this is...

GuiXT Solution SD-0021

of 32

So A

Solution # SD-0021 Version # 1.0.0.2 Functional Area SALES AND DISTRIBUTION UI Platform DS Transactions VA01, VA02, VA03 Short Description CREATE, CHANGE, DISPLAY SALES ORDERS Date Created 04/29/2009 Created by Synactive, Inc


of 32

TABLE OF CONTENTS GuiXT Development Business Rules ................................................................... 5 General Script Naming Convention ..................................................................... 6

GuiXT Scripts ...................................................................................................................... 6 Input Scripts ......................................................................................................................... 6

General Variable Naming Convention ................................................................. 7 GuiXT Development Scripts Listing ................................................................... 8

GuiXT Scripts ...................................................................................................................... 8 ESESSION.TXT....................................................................................................................................... 8 SAPLSMTR_NAVIGATION.E0100.TXT .............................................................................................. 8 SAPLSMTR_NAVIGATION.E0101.TXT .............................................................................................. 8 SAPMV45A.E0101.TXT ......................................................................................................................... 8 SAPMV45A.E0102.TXT ......................................................................................................................... 8 SAPMV45A.E4001.TXT ......................................................................................................................... 8 SAPMV45A.E4002.TXT ......................................................................................................................... 8 SAPMV45A.E4003.TXT ......................................................................................................................... 9 SAPMV45A.E4413.TXT ......................................................................................................................... 9 SAPMV45A.E5002.TXT ......................................................................................................................... 9 SAPMV45A.E5003.TXT ......................................................................................................................... 9 SAPDV70A.E0100.TXT .......................................................................................................................... 9 SAPLMGMM.E4000.TXT....................................................................................................................... 9 SAPLATP4.E0400.TXT........................................................................................................................... 9 SAPLV09C.E5000.TXT........................................................................................................................... 9 SAPLV45C.E0100.TXT........................................................................................................................... 9 SAPLV60F.E4001.TXT ......................................................................................................................... 10 SAPLSPO1.E0100.TXT ......................................................................................................................... 10 VA02_CLEAR4001.TXT....................................................................................................................... 10 VA0X_DELTABS.TXT......................................................................................................................... 10 VA0X_DELHDRMENU.TXT............................................................................................................... 10 VA0X_DELITMTABS.TXT.................................................................................................................. 10 VA0X_DELITMMENU.TXT ................................................................................................................ 10 VA0X_DELMENU.TXT ....................................................................................................................... 10 VA0X_TABS.TXT................................................................................................................................. 10 VA0X_SCREENS.TXT ......................................................................................................................... 11

Input Scripts ....................................................................................................................... 11 VA01_CALL_SHIPTO.TXT ................................................................................................................. 11 VA01_NEXT.TXT ................................................................................................................................. 11 VA02_NAVIGATE.TXT ....................................................................................................................... 11 VA02_READDATA.TXT...................................................................................................................... 11 VA02_SEARCH.TXT ............................................................................................................................ 11 VA03_NAVIGATE.TXT ....................................................................................................................... 12


of 32

VA03_READDATA.TXT...................................................................................................................... 12 VA0X_ADDR.TXT................................................................................................................................ 12 VA0X_CALL_READ_TEXT.TXT ....................................................................................................... 12 VA0X_CHGTAB1.TXT......................................................................................................................... 12 VA0X_CHGTAB2.TXT......................................................................................................................... 12 VA0X_CREATE_WITH_REF.TXT...................................................................................................... 13 VA0X_CREATEPOCC.TXT................................................................................................................. 13 VA0X_DELROWS.TXT........................................................................................................................ 13 VA0X_FILLTABLE.TXT...................................................................................................................... 13 VA0X_GETPARTNERINFO.TXT........................................................................................................ 13 VA0X_GETQNUM.TXT....................................................................................................................... 13 VA0X_GETUPDATEPRC.TXT............................................................................................................ 14 VA0X_NAVTXT.TXT........................................................................................................................... 14 VA0X_OUTPUT.TXT ........................................................................................................................... 14 VA0X_PARTNERPOP.TXT ................................................................................................................. 14 VA0X_QM.TXT .................................................................................................................................... 14 VA0X_QUOTE_CANCEL.TXT ........................................................................................................... 14 VA0X_READ_ATP.TXT ...................................................................................................................... 14 VA0X_RESET_COLUMNS.TXT ......................................................................................................... 15 VA0X_RESET_VARIABLES.TXT ...................................................................................................... 15 VA0X_RETRIEVE_MATTEXT.TXT................................................................................................... 15 VA0X_SAVE.TXT................................................................................................................................. 15 VA0X_SCRNAV.TXT........................................................................................................................... 15 VA0X_SHOW_OUTPUT.TXT ............................................................................................................. 15 VA23_GOTO.TXT................................................................................................................................. 16 VA0X_WRITEVALUES.TXT............................................................................................................... 16 VA0X_GETHDRITMDATA.TXT ........................................................................................................ 16 VA0X_GETSHPCONDDESC.TXT ...................................................................................................... 16 VA0X_QUOTE_SCREEN.TXT ............................................................................................................ 16 VA0X_WRITE_CONTACT.TXT ......................................................................................................... 16 MM03_NAVMRP.TXT ......................................................................................................................... 17 SET_SBLOCK.TXT............................................................................................................................... 17 NAVIGATION_TOGGLESAP.TXT..................................................................................................... 17 BACK_FROM_OUTPUT.TXT ............................................................................................................. 17 NEXT_SCREEN.TXT............................................................................................................................ 17 ONPOPUP.TXT ..................................................................................................................................... 17 RETURN.TXT........................................................................................................................................ 18 BACK.TXT............................................................................................................................................. 18

Scripts Process Flow........................................................................................... 19 GuiXT Modified Screen: VA02 overview screen .............................................................. 19

SAPMV45A.E4001.TXT ....................................................................................................................... 19 Input Scripts ........................................................................................................................ 20

VA02_READDATA.TXT...................................................................................................................... 20 Input Scripts ........................................................................................................................ 22


of 32

VA0X_GETSHPCONDDESC.TXT ...................................................................................................... 22 Scripts Process Flow........................................................................................... 24

GuiXT Modified Screen: VA01 Create With Reference Pop Up screen ........................... 24 SAPLV45C.E0100.TXT......................................................................................................................... 24

Input Scripts ........................................................................................................................ 25 VA0X_CALL_READ_TEXT.TXT ....................................................................................................... 25

Input Scripts ........................................................................................................................ 26 VA0X_QUOTE_SCREEN.TXT ............................................................................................................ 26

Input Scripts ........................................................................................................................ 27 VA23_GOTO.TXT................................................................................................................................. 27

Input Scripts ........................................................................................................................ 27 VA0X_WRITEVALUES.TXT............................................................................................................... 27

Scripts Process Flow........................................................................................... 29 GuiXT Modified Screen: VA01, VA02 Order Overview Screen....................................... 29

SAPMV45A.E4001.TXT ....................................................................................................................... 29 Input Scripts ........................................................................................................................ 30

VA0X_SAVE.TXT................................................................................................................................. 30


of 32

GuiXT Development Business Rules Below are the rules taken into consideration for GuiXT Customized screens.

1. GuiXT Screens are displayed based on the value of below global variable. a. If V[l_val=GUIXT]


of 32

General Script Naming Convention GuiXT Scripts Purpose: For Screen Interface. Dictates how the screen appears to the user GuiXT Script Names cannot be altered. It is a must to keep the same name as the system suggested. This is how GuiXT scripts are linked to SAP Screen. Typical GuiXT Script Name: SAPMV45A.E4001.TXT SAPMV45A ABAP Program Name E 1 Character Language Key

4001 Screen Number .TXT File Extension (Text Files)

Input Scripts Purpose: Facilitates synchronization of data with SAP Screens. Facilitates multiple screen navigation and screen level data validation Input scripts can be assigned any name. Following naming convention is followed for Input Scripts TCODE_PURPOSE.TXT (Example: VA02_READDATA.TXT) TCODE Transaction Code for which the script refers to (Example: VA02, Change Sales Order) PURPOSE Action that is performed by the input script (Example: READ for reading the sales order information)


of 32

General Variable Naming Convention For all variables following naming convention is used Note: Variable Names are CASE SENSITIVE z_tcode_field z Used as variable prefix tcode Lower Case Transaction Code for which the variable refers to (Example: mm01 for create material) field Lower Case field name referring to SAP field (Example: bum for Base Unit of Measure) z_va0x_cardnum Variable is used to capture the credit card number that has been

entered by the user while creating a sales order.


of 32

GuiXT Development Scripts Listing GuiXT Scripts ESESSION.TXT Purpose: Holds the current version number of the scripts that exist in web repository. Every time a new script has been uploaded to web repository, this number should be changed in order for GuiXT to cache the scripts again in local directory. SAPLSMTR_NAVIGATION.E0100.TXT Purpose: Main Menu which GuiXT interface is designed on. Screen contains pushbuttons to initiate the required transactions which are create, change and display order. SAPLSMTR_NAVIGATION.E0101.TXT Purpose: Main Menu which GuiXT interface is designed on. Screen contains pushbuttons to initiate the required transactions which are create, change and display order. SAPMV45A.E0101.TXT Purpose: VA01 initial screen on which the first GuiXT interface is designed. Screen includes two layout options that will be displayed based on the user selection on how to create order. These options are creating order with PO or with credit card. SAPMV45A.E0102.TXT Purpose: VA02, VA03 initial screen on which the first GuiXT interface is designed. Screen includes a search pushbutton which lets user to search for previously created orders. Depending on the transaction required action is triggered on the screen to navigate change or display order. SAPMV45A.E4001.TXT Purpose: VA01, VA02, VA03 overview screen on which the first GuiXT interface is designed. Screen includes different layouts to be shown to the user depending on the transaction they initiate. Same screen is shared by create, change and display transactions. Screen also executes the functionality to delete unwanted menu items. (va0x_delmenu.txt) SAPMV45A.E4002.TXT Purpose: VA01, VA02, VA03 header screen on which the first GuiXT interface is designed on. Different tabs exist on header screens in order to enter various kinds of data. Unwanted tabs and header menu items are removed with include files that get executed on this screen. (va0x_deltabs.txt , va0x_delhdrmenu.txt)


of 32

SAPMV45A.E4003.TXT Purpose: VA01, VA02, VA03 item details screen on which the first GuiXT interface is designed. Screen contains only the tabs and menu items that users have to enter data and use for navigation. SAPMV45A.E4413.TXT Purpose: VA01 Create with Reference overview screen on which the first GuiXT interface is designed. Users create sales orders with reference to a quote from this screen by selecting quote price and entering the long text for the order to be copied. Screen also displays the type of order reason to the user as static or dynamic. SAPMV45A.E5002.TXT Purpose: VA01, VA02, VA03 header details condition/pricing screen on which the first GuiXT interface is designed. Screen contains only the tabs and menu items that users have to enter data and use for navigation. SAPMV45A.E5003.TXT Purpose: VA01, VA02, VA03 item details condition/pricing screen on which the first GuiXT interface is designed. Screen contains only the tabs and menu items that users have to enter data and use for navigation. SAPDV70A.E0100.TXT Purpose: VA01, VA02, VA03 output screen on which the first GuiXT interface is designed. Users navigate to this screen to check the output that has been created on the order. Output saving functionality happens in the overview screen so it is disabled from the output screen. Not all of the pushbuttons and menu items are used by the user therefore non-used menu items and pushbuttons are removed from the screen. SAPLMGMM.E4000.TXT Purpose: MM03 MRP screen on which the first GuiXT interface is designed. Users can navigate to MRP tab of material display from sales order to check the MRP status of the material. From this screen, user is navigated back to the sales order screen or to the main menu. SAPLATP4.E0400.TXT Purpose: VA01, VA02 ATP quantity screen on which the first GuiXT interface is designed. Users can not exit and cancel sales order transaction other than in overview screen. This has been created as a business rule and implemented in this screen. Therefore cancel and exit buttons are removed from the screen. Users can only exit, cancel and save in overview screen. SAPLV09C.E5000.TXT Purpose: VA01, VA02, VA03 PARTNER TAB CONTACT DETAILS POPUP screen on which the first GuiXT interface is designed, which initiates a process to capture the partner information. SAPLV45C.E0100.TXT Purpose: VA01 CREATE WITH REFERENCE POP UP screen on which the first GuiXT interface is designed to capture the quote number that is entered by the user and take user to the item selection screen where user can choose which line item to copy to the order.


of 32

SAPLV60F.E4001.TXT Purpose: VA01, VA02 PAYMENT CARDS screen on which GuiXT interface is designed to delete unwanted tabs and menu items. Authorization block checkbox is also deleted from this screen since it has been carried to the overview screen for user to modify it easily. SAPLSPO1.E0100.TXT Purpose: VA01, VA02 YES/NO/CANCEL POP UP. This pop up comes up during the deletion of line items in overview screen or when user hits back, cancel or exit buttons. A process is initiated in this pop up to clear the line items in the order if user has chosen to delete line items based on a flag which the value of it is checked in the process. VA02_CLEAR4001.TXT Purpose: Include script which gets executed in overview screen. It clears the unwanted tabs and pushbuttons in overview screen. VA0X_DELTABS.TXT Purpose: Include script which gets executed in header screens. It clears out unwanted tabs on header screens. VA0X_DELHDRMENU.TXT Purpose: Include script which gets executed in header screens. It clears out unwanted menu items on header screens. VA0X_DELITMTABS.TXT Purpose: Include script which gets executed in item screens. It clears out unwanted tabs on item screens. VA0X_DELITMMENU.TXT Purpose: Include script which gets executed in item screens. It clears out unwanted menu items on item screens. VA0X_DELMENU.TXT Purpose: Include script which gets executed in item screens. It clears out unwanted menu items in overview screens. VA0X_TABS.TXT Purpose: Include script which gets executed based on the screen display in overview section of sales order. Overview screen includes three different layout sections which are controlled by a global variable in the process. (V[va0x_scrn]). Depending on the value of this variable, process executes the corresponding layout to the user. VA0X_TABS.TXT gets executed on two of these layouts and it contains the common code for both layouts.


of 32

VA0X_SCREENS.TXT Purpose: Include script which gets executed on VA01, VA02, VA03 transactions. It holds the common code for all sales order transactions. For each sales transaction, the condition that it gets executed is different since the navigation scheme for create, change and display are different. Input Scripts VA01_CALL_SHIPTO.TXT Purpose: Script call a function module to retrieve the ship-to name based on the ship-to code and company code. Invoked From: SAPMV45A.0101.TXT VA01_NEXT.TXT Purpose: Based on the sales order entry type (credit card or purchase order number) and order method, script navigates to create order, gets the partner information based on sold-to party and populates it on the overview screen first layout. User can modify the partner information. Invoked From: SAPMV45A.0101.TXT VA02_NAVIGATE.TXT Purpose: Script reads the order data that has been created previously by comparing the old order number that is on the change screen with the new one user enters. Consequently, every time, script does not execute read of the information thus creating efficiency. Script gets executed for change sales order. Invoked From: SAPMV45A.0102.TXT VA02_READDATA.TXT Purpose: Script reads the general order information, and navigates to header details to read purchase order, payment card, order status, delivery block data. It navigates to item conditions screen to get the list price of the material. Script gets executed for change sales order. Invoked From: SAPMV45A.4001.TXT VA02_SEARCH.TXT Purpose: Script gets executed from change screen. Script processes a pop up screen and takes user to the search list screen for the sales orders that fit into the search criteria. Invoked From: SAPMV45A.0102.TXT


of 32

VA03_NAVIGATE.TXT Purpose: Script reads the order data that has been created previously by comparing the old order number that is on the change screen with the new one user enters. Consequently, every time, script does not execute read of the information thus creating efficiency. Script gets executed for display order. Invoked From: SAPMV45A.0102.TXT VA03_READDATA.TXT Purpose: Script reads the general order information, and navigates to header details to read purchase order, payment card, order status, delivery block data. It navigates to item conditions screen to get the list price of the material. Script gets executed for display sales order. Invoked From: SAPMV45A.4001.TXT VA0X_ADDR.TXT Purpose: Script navigates to partner tab and looks for three partner type which are ship-to (AP), bill-to (RE) and contact (WE). If it finds any of these, it opens the partner details pop up for address verification. Invoked From: VA0X_SCREENS.TXT VA0X_CALL_READ_TEXT.TXT Purpose: Script executes two function calls to read the quotation text and internal order comments for the quotation number entered by the user while creating a sales order with reference to a quote. After reading, it copies the long text to order. Invoked From: SAPLV45C.E0100.TXT VA0X_CHGTAB1.TXT Purpose: Script navigates user to the second layout section (TAB1) of the overview screen where users create, modify or view sales order data in overview table. There are many columns in this table so they are separated in different views. Tab1 and Tab2 segments in overview table hold these columns. Invoked From: VA0X_SCREENS.TXT VA0X_CHGTAB2.TXT Purpose: Script navigates user to the third layout section (TAB2) of the overview screen where users create, modify or view sales order data in overview table. There are many columns in this table so they are separated in different views. Tab1 and Tab2 segments in overview table hold these columns. Invoked From: VA0X_SCREENS.TXT


of 32

VA0X_CREATE_WITH_REF.TXT Purpose: Script navigates user to create with reference quote selection pop up for user to enter a quote and initiate the process to go to line item selection screen. Invoked From: VA0X_TABS.TXT VA0X_CREATEPOCC.TXT Purpose: Script navigates user to the create order with credit card menu which is one of the order creation methods that user can choose from the main menu. Invoked From: SAPLSMTR_NAVIGATION.E0100.TXT, SAPLSMTR_NAVIGATION.E0101.TXT VA0X_DELROWS.TXT Purpose: Script navigates through the line items in the overview screen and deletes the items that user selected to delete. It stores the deleted line items into guixt variables to reset the value of guixt columns of these line items after deletion. Invoked From: VA0X_TABS.TXT VA0X_FILLTABLE.TXT Purpose: Script populates the list price user enters; when creating a sales order with reference to a quote in line item selection screen for the quote on condition/pricing screen for the material that has been copied from the quote. It gets the delivery block value for the order if there is any and displays the shipping condition description to the user. Invoked From: VA0X_TABS.TXT, SAPMV45A.E4413.TXT VA0X_GETPARTNERINFO.TXT Purpose: Script gets the partner address information for the partners that user enters in overview screen. Overview screen is divided into three sections. The first section is where users view and retrieve the partner information. Users can view address information for ship-to bill-to and contact partner types. Script gets executed in this section to retrieve the corresponding information. Invoked From: VA0X_SCREENS.TXT VA0X_GETQNUM.TXT Purpose: Script navigates to header data in the order and stores the notification number to a global variable to display it to the user in the order overview screen. Invoked From: SAPMV45A.E4001.TXT


of 32

VA0X_GETUPDATEPRC.TXT Purpose: Script runs through the pricing elements in header condition screen and stores information such as freight, tax and net value to display this information to the user in order overview screen. Invoked From: VA0X_TABS.TXT VA0X_NAVTXT.TXT Purpose: Script executes Enter commands which take user to the requested text sections in header text screen. Each command gets executed based on the text that user has selected. The selected text is controlled by a global variable which is used to create the condition to execute the “Enter” commands. Invoked From: VA0X_TABS.TXT VA0X_OUTPUT.TXT Purpose: Depending on the order communication method that user has selected from the options given to him by GuiXT (fax, e-mail or telephone), script creates the corresponding output in the order. If there is already same kind of an output that has been created, script updates the output. Invoked From: VA0X_TABS.TXT VA0X_PARTNERPOP.TXT Purpose: Script displays the partner alternatives for each partner type and let user to select any of those. If entered partner is wrong, alternatives are not being proposed. In this case, script displays the previous (correct) values which have been stored before the proposal of alternatives for the partners. Invoked From: VA0X_SCREENS.TXT VA0X_QM.TXT Purpose: Script navigates user to quality management module to the transaction “QM01” to create the notification with notification type “ZC” Invoked From: SAPMV45A.E4001.TXT VA0X_QUOTE_CANCEL.TXT Purpose: Script cancels the create order with reference to a quote and returns the user to the main menu. Invoked From: SAPMV45A.E4413.TXT VA0X_READ_ATP.TXT Purpose: Script navigates to confirmed quantity screen for each line item and gets the available to promise quantity for each of them. Invoked From: VA0X_SCREENS.TXT


of 32

VA0X_RESET_COLUMNS.TXT Purpose: Script runs on the pop up that appears during the deletion of selected line items by the user. It clears out the guixt variables that are created as columns in All items table which hold values from different screens. Invoked From: SAPLSPO1.E0100.TXT VA0X_RESET_VARIABLES.TXT Purpose: Script resets all variables start with z_va0 and it also resets the textboxes. Set V[z_va0*] “” copytext toText="z_va0x_carracc" fromString="" Invoked From: VA0X_SCREENS.TXT VA0X_RETRIEVE_MATTEXT.TXT Purpose: Script finds the line item user has selected to update the material text for. It selects the line item, navigates to the item text screen. It searches for the material text option and once it finds that options, it stores the particular text to a global variable to display it to the user in a textbox on TAB2 section of overview screen. Invoked From: VA0X_SCREENS.TXT VA0X_SAVE.TXT Purpose: Script saves the order after checking for data entries in required fields and populating user entries in corresponding SAP fields. Invoked From: VA0X_TABS.TXT VA0X_SCRNAV.TXT Purpose: Script determines the screen that user should navigate to. Sales order menu screens and sales order overview screen layouts are displayed to the user depending on the value of the global variable that has been determined in this script. Invoked From: SAPMV45A.E4001.TXT VA0X_SHOW_OUTPUT.TXT Purpose: Script navigates to the output screen in sales order change. Enter "/Menu=4,14,1,1" Invoked From: SAPMV45A.E4001.TXT


of 32

VA23_GOTO.TXT Purpose: Script navigates to the display quotation screen for the quotation that has been chosen to create with reference to and gets the corresponding incoterms and order reason information to display on quote item selection screen. Invoked From: VA0X_QUOTE_SCREEN.TXT VA0X_WRITEVALUES.TXT Purpose: Script puts the values returned from the new session into the old session in the corresponding guixt fields in quote item selection screen. Script runs in a special function called returnvalues. This function stores the values from the quotation to local values (parameters) which are called in this script to set their values in the global guixt fields Invoked From: VA0X_QUOTE_SCREEN.TXT VA0X_GETHDRITMDATA.TXT Purpose: Script has the same logic as “VA0X_GETUPDATEPRC.TXT”. It gets the pricing elements from the pricing screen and displays them to the user in overview screen. This script gets triggered while user tries to delete line items because item pricing gets updated for each line item. Invoked From: VA0X_RESET_COLUMNS.TXT VA0X_GETSHPCONDDESC.TXT Purpose: Script runs a function module to check the shipping condition description based on the shipping condition code entered by the user. The function module only runs if the entered shipping condition code is not the same as the previously entered one by the user. Invoked From: VA02_READDATA.TXT, VA03_READDATA.TXT, VA0X_FILLTABLE.TXT VA0X_QUOTE_SCREEN.TXT Purpose: Script gets executed from another input script. During create with reference, user is navigated to quote item selection screen. During this navigation process, this script is getting called and it simply processes another input script (va23_goto) which gets certain information for the quotation entered to be displayed in the item selection screen. Invoked From: VA0X_CALL_READ_TEXT.TXT VA0X_WRITE_CONTACT.TXT Purpose: Script navigates to the partner tab and updates the order communication method in the partner details pop up. For any errors happening in this process, script returns the error to the user. Script is an include file which gets executed from “next_screen” input script. Invoked From: NEXT_SCREEN.TXT


of 32

MM03_NAVMRP.TXT Purpose: Script navigates to MRP view for the material entered in the order for user to look at the MRP info. “US21” plant is defaulted in this process to navigate to MRP view. Invoked From: VA0X_TABS.TXT SET_SBLOCK.TXT Purpose: Script sets the value of the user selection to a global variable to show the corresponding status block from the status screen in order overview screen. Invoked From: VA0X_TABS.TXT NAVIGATION_TOGGLESAP.TXT Purpose: Script toggles between the SAP native view and GuiXT views by controlling the value of global “V[l_val]” variable. Invoked From: SAPLSMTR_NAVIGATION.E0100.TXT, SAPLSMTR_NAVIGATION.E0101.TXT BACK_FROM_OUTPUT.TXT Purpose: Script navigates back to the order overview screen from output screen. It knows which layout to display to the user in overview screen by checking the value of “V[va0x_scrn]” variable. This variable gets different value depending on the layout to be shown to the user. Invoked From: SAPDV70A.E0100.TXT NEXT_SCREEN.TXT Purpose: Script runs through several validations and gets the order header info. While doing this, it also sets the order communication method in partner details pop up by running “va0x_write_contact.txt”. It runs this script to set the values while reading others because, at the end of this process, it displays user another layout in overview screen. Invoked From: VA0X_SCREENS.TXT ONPOPUP.TXT Purpose: Script gets the updated contact from partner details screen and check the first two characters. Depending on the value of the first two characters, it determines whether to make the sold-to party guixt field read only or not. Invoked From: SAPLV09C.E5000.TXT


of 32

RETURN.TXT Purpose: Script disables save functionality on certain screens such as output screens since user is allowed to save only in order overview screen. Invoked From: SAPDV70A.E0100.TXT, SAPLSMTR_NAVIGATION.E0100.TXT, SAPLSMTR_NAVIGATION.E0101.TXT, SAPMV45A.E0101.TXT BACK.TXT Purpose: Script determines which screen to navigate to based on the parameter value that has been set before script gets executed. Invoked From: SAPMV45A.E4001.TXT, VA03_NAVIGATE.TXT, VA0X_SCREENS.TXT, VA0X_TABS.TXT


Scripts Process Flow GuiXT Modified Screen: VA02 overview screen SAPMV45A.E4001.TXT Interface is displayed when va02_navigate script runs. User is taken to this layout for editing payment options.

of 32


of 32

Input Scripts VA02_READDATA.TXT Invoked From: SAPMV45A.E4001.TXT Transaction Code: VA02 – Change Sales Order When Executed: Clicking the Continue without any change’ button on the overview screen. Script Logic: Script navigates through certain sections in the order such as payment cards, purchase order data, shipping, status and item pricing screens to store the corresponding information into guixt variables which are used to display the information to the user in overview screen. Step 1 It reads the payment details and PO number. It navigates to purchase order data. (Enter "=KBES") Step 2 It reads the ordering method and submitted order data and time. It navigates to payment cards. (Enter "=T\05") Step 3 While navigating to payment cards, if confirmed quantity screen is reached, script waits for user to confirm the available quantity and it continues processing after that. Screen SAPLATP4.0500 //confirmation for the material Set V[z_avflg] "X" //set the confirmation screen flag if not V[z_avflg=X] //if flag is reached Enter "/0" //do a simple enter on the screen Endif Step 4 It reads the authorization block and navigates to shipping. (Enter "=T\03") Step 5 It reads the shipping conditions and executes include input script (va0x_getshpconddesc.txt) which gets the shipping condition descriptions of the shipping condition via function module. After the reading the description, it navigates to sales tab and reads the created by value. It navigates to object status after sales tab.


of 32

Step 6 It scrolls through the object statuses and finds the object status that has been checked and reads that value. if V[z_tmp=X] Set V[z_va0x_stat_blk] "&V[z_tmp2]" Set V[z_va0x_stat_blk_old] "&V[z_tmp2]" Set V[z_sflg] "&V[z_tmp2]" goto read_end Endif During this process, it controls looping among the statuses by goto – label structure. Step 7 It navigates to shipping tab and scrolls through the line items in shipping tab. For each item, it reads the delivery block column. set V[zitm] "&cell[All items,Item,&V[relrow_all]]" if V[zitm] set V[z_va0x_block.&V[zitm]] "&cell[All items,Delivery block,&V[relrow_all]]" endif Step 8 Script selects the first material and navigates to item conditions/pricing screen (Enter "=PKO1"). It scrolls through the conditions table and it stores the amount corresponds to condition type PR00 to V[z_va0x_listprice.&V[z_va0x_olditem]] global variable. Label VA0X_ITM_LIST_PRICE if V[z_va01_tmp=PR00] //if it's PR00 set V[z_va0x_listprice.&V[z_va0x_olditem]] "&cell[Table,Amount,1]" else set V[z_va0x_listprice.&V[z_va0x_olditem]] "" //set list price value for the row endif Step 9 It navigates to the next material (Enter “/19”). Each material has a different item number. Script checks whether there are any more materials to navigate or not by checking F[Sales Document Item] sap field. It compares the value of this field with its own previous value each it navigates to a new item. Set V[z_va0x_newitem] "&F[Sales Document Item]" if V[z_va0x_newitem=&V[z_va0x_olditem]] Enter "/3" // back to item overview screen


of 32

else Goto VA0X_ITM_LIST_PRICE Endif As a result of this comparison, if item numbers are the same, it quits scrolling, if not it continues scrolling through the items to capture list price (PR00). Step 10 Script navigates back to sales tab. Input Scripts VA0X_GETSHPCONDDESC.TXT Invoked From: VA02_READDATA.TXT Transaction Code: VA02 – Change Sales Order When Executed: During the input script processing for reading the sales order data. Script Logic: Script calls a function module to get the shipping condition description based on the shipping condition value that as been read from the screen and display that description along with the shipping code to the user in the overview screen. Step 1 Script sets an index for function call read and determines which layout to show to the user. Set V[ridx] "1" //set the counter for RFC read (shipping condition) if not V[va0x_scrn=1] and V[va0x_scrn] Set V[va0x_scrn] "&V[va0x_scrn]" //determine the tab you are on else Set V[va0x_scrn] "2" Endif Step 2 It compares whether shipping condition description is read before or not. if V[z_va0x_ship_condold=&V[z_va0x_ship_cond]] //if old shipping condition is equal to the new one goto script_end //finish executing else Set V[z_va0x_ship_condold] "&V[z_va0x_ship_cond]" //get the shipping condition as old value


of 32

Endif If there is no old shipping value (z_va0x_ship_condold), script sets the current shipping condition value to the old one and runs the function module. Thus function module only runs once reducing inefficiency. Step 3 Script only runs function module if there is a shipping condition that has been read and if user is on change or display mode for sales order. if V[z_va0x_ship_cond] or V[_transaction=va02] or V[_transaction=va03] call "ISA_GET_SHIPPING_CONDITIONS" -try in.LANGUAGE="&V[_language]" Table.SHIPPING_COND="z_va0x_shpcond" Step 4 The outcome from the function module is in a table structure, therefore script reads data in this table structure line by line (controlled by goto-label structure) and it copies data in each line to a string where it performs a substring operation in that string to get the shipping description. Label continue_nxt CopyText fromText="z_va0x_shpcond" toString="shp" line="&V[ridx]" //get the shipping condition text in table for each line if not Q[ok] //if query is ok goto script_end endif Set V[z_tmp] "&V[shp](1-2)" if V[z_tmp=&V[z_va0x_ship_cond]] //if language is English Set V[z_va0x_ship_condtxt] "&V[shp](3-22)" //get shipping condition text Goto script_end endif //otherwise Set V[ridx] "&V[ridx]" + "1" //increment index goto continue_nxt Label continue_nxt CopyText fromText="z_va0x_shpcond" toString="shp" line="&V[ridx]" //get the shipping condition text in table for each line if not Q[ok] //if query is ok goto script_end endif Set V[z_tmp] "&V[shp](1-2)" if V[z_tmp=&V[z_va0x_ship_cond]] //if language is English Set V[z_va0x_ship_condtxt] "&V[shp](3-22)" //get shipping condition text

GuiXT Solution SD-0021 Goto script_end endif //otherwise Set V[ridx] "&V[ridx]" + "1" //increment index goto continue_nxt

Scripts Process Flow GuiXT Modified Screen: VA01 Create With Reference Pop Up screen SAPLV45C.E0100.TXT Interface is displayed when user creates sales order with reference to a quote.

of 32


of 32

Input Scripts VA0X_CALL_READ_TEXT.TXT Invoked From: SAPLV45C.E0100.TXT Transaction Code: VA01 – Create Sales Order with Reference When Executed: Clicking the “Item selection” button or hitting “Enter” on the screen. Script Logic: Script gets the quotation number and makes a function call to read the quotation long text and internal order comments from the output of the function call. For any exceptions that happen during the call, script displays these errors to the user. Step 1 If any error exists during the copy of reference, script captures these errors from the error pop up and quits executing. Screen SAPMSDYP.0010 if V[_title=Error] //if error exists during copy of reference Set V[z_err] "&F[MESSTXT1]" Set V[z_err] "&V[z_err] &F[MESSTXT2]" //set the error Enter goto script_end //finish executing Endif Step 2 It deselects all the line items and if quotation number exists, it calls the function module twice. Once for getting the quotation long text and once more for getting internal order comments. if V[z_va0x_quote_num] call "Z_GUIXT_READ_TEXT" -try in.ID="ZQTK" in.LANGUAGE="EN" in.NAME="&V[z_va0x_quote_num]" in.OBJECT="VBBK" Table.TEXT="z_va0x_quote_tender_text" -- //EXCEPTIONS call "Z_GUIXT_READ_TEXT" -try in.ID="0008" in.LANGUAGE="EN" in.NAME="&V[z_va0x_quote_num]" in.OBJECT="VBBK" Table.TEXT="z_va0x_internal_order_comments" --//EXCEPTIONS


of 32

Endif Any exceptions that happen during the call are stored into guixt error variables and script quits executing. Errors are displayed to the user. If there are no exceptions happen, function module outcomes are copied into textboxes which are created on item selection screen and data is shown to the user. if not Q[ok] //if query is not ok Set V[z_err] "&V[_exception]" goto script_end Endif Step 3 Script initiates an included inputscript “va0x_quote_screen.txt” which itself initiates a process to fetch incoterms an order reason from a new session for the quotation that has been entered. Input Scripts VA0X_QUOTE_SCREEN.TXT Invoked From: VA0X_CALL_READ_TEXT.TXT Transaction Code: VA01 – Create Sales Order with Reference When Executed: During the input script processing for navigating to item selection of quotation. Script Logic: Script initiates a process automatically when it is getting called and starts a new session to navigate to display quotation to read quote related values. Step 1 Script starts a new session when process reaches quote item selection screen. Step 2 After it initiates the new session, it triggers an input script to read values from the new session to old session where user will eventually be taken to the quote item selection screen. Screen SAPMV45A.4413 Enter "/ova23" process="va23_goto.txt" using quote = "&V[z_va0x_quote_num]"


of 32

Input Scripts VA23_GOTO.TXT Invoked From: VA0X_QUOTE_SCREEN.TXT Transaction Code: VA01 – Create Sales Order with Reference When Executed: During the input script processing for opening a new session from va0x_quote_screen.txt Script Logic: Script navigates to the quotation in new session entered by the user in old session which is stored to a parameter value to be used in this script. Inside the quotation, it reads the incoterms and order reason and returns these values back to the old session. Step 1 It sets the parameter value to the quotation sap field. Set F[Quotation] "&U[quote]" Step 2 Script sets the incoterms and order reason values from sap fields to the global guixt variables and these variables are used in returnvalues function to return the data to the old session which is achieved by executing a process in returnvalues function. set V[INCOTERMS] "&F[Incoterms]" //Gets the incoterms set V[ORDREASON] "&F[Order reason]" //gets order reason Returnvalues "U[INCOTERMS]:&V[INCOTERMS];U[ORDREASON]:&V[ORDREASON];OK:?STAT,process=va0x_writevalues.txt" //returns values from new session Step 3 Script will close the new session. Input Scripts VA0X_WRITEVALUES.TXT Invoked From: VA23_GOTO.TXT


of 32

Transaction Code: VA01 – Create Sales Order with Reference When Executed: During the input script processing for returning the values from the new session. Script Logic: Script puts the values returned from the new session into the old session in the corresponding guixt fields. Step 1 It sets the values from the new session (parameter values) to the guixt variables defined in old session set V[z_va0x_quote_incoterms] "&U[INCOTERMS]" set V[z_va0x_order_reason] "&U[ORDREASON]" Step 2 Script checks the order reason retrieved from the function module that got executed in “VA0X_CALL_READ_TEXT.TXT” and depending on the order reason, it deselects the items and stops user on the item selection screen with all required data.


Scripts Process Flow GuiXT Modified Screen: VA01, VA02 Order Overview Screen SAPMV45A.E4001.TXT Interface is displayed when user navigates to the order to create materials.

of 32


of 32

Input Scripts VA0X_SAVE.TXT Invoked From: SAPMV45A.E4001.TXT Transaction Code: VA01, VA02 – Create, Change Sales Order with Reference When Executed: Clicking the “Save” button on toolbar Script Logic: Script navigates through shipping, status and additional data tabs to populate the user entries in sap fields after checking certain validations and executes the user action on the screen. If user clicks back or cancel, SAP would ask user to save the data before exiting. GuiXT simulates this action. Step 1 If user selects to create an output for the order but has not created one before save happens, script complains and returns user an error about the complaint. Same kind of validation is valid also for pricing. If pricing does not get updated in the order which means no material has been entered in the order, script returns a pricing error to the user prior to the save. if not V[z_va0x_net_total] or V[z_va0x_net_total=0.00] //if pricing is not in place or has zero value Return "E: Please update pricing!" "-statusline" //return error Endif Step 2 If there is material in the order, script navigates to shipping tab (Enter "=T\06") in order overview to populate the delivery block in All items table. Table scroll logic is used to populate the value. Step 3 If user enters or changes a q-note number, script navigates (Enter "=KZKU") to additional data A to populate the notification number in F[Notification] sap field. Step 4 Script navigates to payment cards (Enter "=KRPL") and sets the authorization block and then navigates to shipping (Enter "=T\03") to update the shipping condition. Step 5 During shipping condition update, if any error happens, script handles the error, displays the error to the user and quits executing.


of 32

if V[_lasterror] //if error exists Set V[z_mess] "&V[_lasterror]" //Set the error message Set F[Shp.Cond.] "&V[z_va0x_ship_condold]" //Set the old value to the field Enter "/3" goto script_end Endif Step 6 If no error happens, script continues from sales tab (Enter "=KKAU") and sets the document currency to the user entry. If currency update gives an error, script displays the error to the user and quits executing. if V[_lasterror] Set F[Doc. currency] "&V[z_va0x_currold]" Set V[z_mess] "&V[_lasterror]" Enter "/3" goto script_end Endif Step 7 If no error happens, script continues from status tab (Enter "=KSTA"). During the navigation to status tab, if confirmed quantity screen comes up, script waits for the user to confirm the quantity. Screen SAPLATP4.0500 //confirmation for the material Set V[z_avflg] "X" //set the confirmation screen flag if not V[z_avflg=X] //if flag is reached Enter "/0" //do a simple enter on the screen Endif After quantity is confirmed, script continues to navigate to status blocks (Enter "=KSTC") and sets the corresponding status to X that user has selected from the overview screen. Screen SAPLBSVA.0300 if V[z_va0x_stat_blk=10] or V[z_va0x_stat_blk=60] //determine the value of status that are selected Set #[8,42] "X" //Select the related radiobutton Endif if V[z_va0x_stat_blk=20] or V[z_va0x_stat_blk=70] Set #[9,42] "X" Endif if V[z_va0x_stat_blk=30] Set #[10,42] "X" Endif if V[z_va0x_stat_blk=40] Set #[11,42] "X" Endif


of 32

if V[z_va0x_stat_blk=50] Set #[12,42] "X" Endif Enter "/3" onError="Continue" Step 8 Script navigates back to the overview screen and executes the user action on the screen. Enter "&U[l_save]" The required action is represented by a parameter (l_save) which the value of it is determined in GuiXT script where the action is defined. Save Action: on "/11" fcode="/0" process="va0x_save.txt" using l_save = "/11" Exit Action: on "/15" fcode="/0" process="va0x_save.txt" using l_save = "/15" Back Action: on "/3" fcode="/0" process="va0x_save.txt" using l_save = "/3" Step 9 Script displays any message to the user and resets the variables.

guixt solution sd-0021 guixt solution sd-0021 page 1 of 32 so a ... va0x_read_atp.txt ... this is...

Documents