Create Process Files
This section explains how to create a Process file for the following technologies:
Transaction
This topic describes how to record an SAP transaction flow using Process Runner. The file is saved as an .itf file (Innowera Transaction module File).
To create a Transaction Process file,
- Select File > New Process > New Transaction or select Transaction (TX) available on the left side of the New Process window.
- In the Transaction Code box, enter the transaction code.
- To force Process Runner to run the transaction in batch input mode and to stop the transaction when it encounters COMMIT statement, select Run in batch input mode and Stop on COMMIT. When you do not select this option, the transaction runs in non-batch input mode (as you would run normally in SAP GUI) and forces Process Runner to continue the transaction even when it encounters COMMIT statement. Some of the transactions must be run in non-batch input mode.
- Optionally, select More... for additional recording options. The Options window appears.
- On the Basic Record Options tab, enter the following details:
- Run in batch input mode and Stop on COMMIT: Allows transaction to run in non-batch input mode (as you would run normally in SAP GUI) and force Process Runner to continue the transaction even when it encounters COMMIT statement. Some of the transactions must be run in non-batch input mode.
- Record Controls (Static recording only): Allows Process Runner to record the SAP control framework objects, such as ALV grid or tree view, in static mode. You can run the transaction with such control but the input to these controls cannot be changed at runtime. Do not map and change any value that is sent to the control object as it is not effective and your recording might not work. Mapping to values outside of the control object should work as usual and you should perform mapping as required. We recommend that you use this option only when required or suggested by an expert or insightsoftware support engineer.
- Background Mode: Runs the transaction in background simulation for successful run.
- File Name (optional): Adds the file name for the Process file before recording. If this field is left empty, then Process Runner automatically generates a name for the Process file.
- Excel Data file (optional): Indicates that an external Excel file that has data must be uploaded or downloaded to or from SAP. Provide the correct worksheet name of the selected Excel file.
- Select OK. The changes to the options on the Basic Record Options tab are saved.
- On the Advanced Record Options tab, enter the following details:
- Get Screen descriptions from SAP: Retrieves the readable screen descriptions from SAP for all the screens were passed during recording. This requires special authorization in SAP; if users do not have required permission, then Process Runner displays a warning message and continue with generating file.
- Get Field descriptions from SAP(recommended): Allows Process Runner to get descriptive and more readable field information from SAP. If you select this checkbox, the recording might take a little longer, even though there is no impacts on how the transaction runs.
- For all Active Fields: Instructs Process Runner to automatically generate F4 Help for all the active fields.
- For all Inactive Fields: Instructs Process Runner to automatically generate F4 Help for all the inactive fields.
- Automatically map fields that I enter or change: Allows to automatically map input fields.
- Automatically download all output (display only) fields: Allows to automatically map the output fields. This option automatically enables and assigns Excel column IDs for the output fields found in the recording.
- Automatically backup fields that I enter or change to another column: Automatically downloads all the input fields; you can keep a record of what the values were before the upload.
- Automap all check mark ("X") to Excel: Allows the recorded checkboxes to be automatically mapped to the Excel columns after the recording is completed.
- Select OK. The changes to the options on the Advanced Record Options tab are saved.
- On the Basic Record Options tab, enter the following details:
- Select Start Recording. The Connector for SAP window appears. For information about how to record different types of transactions, see the tutorials in the Transaction section.
BAPI/RFM
This topic describes how to create a BAPI/RFM template using Process Runner. The file is saved as an .iff file (Innowera Function module File).
To create a BAPI/RFM Process file,
- Select File > New Process > New RFM/BAPI or select BAPI/RFM (BA) available on the left side of the New Process window.
- In the BAPI/RFM Name box, enter the BAPI/RFM name.
- To retrieve the SAP documentation of the BAPI/RFM, select the pop-up icon. A pop-up window appears with the documentation about the BAPI/RFM that you can download and view.
- Optionally, select More... for additional recording options. The Options window appears.
-
On the Basic Record Options tab, enter the following details:- File Name (optional): Adds the file name for the Process file before recording. If this field is left empty, then Process Runner automatically generates a name for the Process file.
- Excel Data file (optional): Indicates that an external Excel file that has data must be uploaded or downloaded to or from SAP. Provide the correct worksheet name of the selected Excel file.
- Select OK. The changes to the options on the Basic Record Options tab are saved.
- On the Advanced Record Options tab, enter the following details:
- Automap return fields: Maps the standard BAPI return fields to Excel columns automatically beginning from the specified column ID. Process Runner can automatically detect standard return fields and map them as SAP to Excel downloads.
- Get BAPI/RFM documentation from SAP: Retrieves and saves the SAP standard documentation for the selected function module in your logon language.
- Get Descriptions: Retrieves the field descriptions from SAP in your logon language.
- Get F4 Help Configuration: Allows Process Runner to automatically generate F4 Help for all the fields.
- Select OK. The changes to the options on the Advanced Record Options tab are saved.
-
- Select OK. The Connector for SAP window appears. For information about how to record different types of BAP/RFM transactions, see the tutorials in the Record and Run BAPI File in Process Runner section.
GUI Scripting
This topic describes how to record a GUI Scripting SAP transaction flow using Process Runner. The file is saved as an .isf file (Innowera Script File).
To create a GUI Scripting Process file,
- Select File > New Process > New GUI Script or GUI Script (GS) available on the left side of the New Process window.
- In the Transaction Code box, enter the transaction code.
- To refresh the list of current active GUI Scripting enabled SAP sessions, click Refresh/Get GUI Session.
- Optionally perform the following steps:
- To get notified if a script is attached to a running GUI, select Warn On Attach.
- To get notified if a script opens a connection, select Warn On Connection.
- To close the current active running GUI Session after the recording operation is concluded, select Also close GUI Session.
- Optionally, select More... for additional recording options. The Options window appears.
- On the Basic Record Options tab, enter the following details:
- File Name (optional): Adds the file name for the Process file before recording. If this field is left empty, then Process Runner automatically generates a name for the Process file.
- Excel Data file (optional): Indicates that an external Excel file that has data must be uploaded or downloaded to or from SAP. Provide the correct worksheet name of the selected Excel file.
- Select OK. The changes to the options on the Basic Record Options tab are saved.
- On the Advanced Record Options tab, enter the following details:
- Script Language: Indicates the script language that Process Runner must use.
- Context Menu: Tells Process Runner how the mouse right-clicks must be recorded.
- Automap: Performs mapping automatically based on the recording performed and eliminates the need for manual mapping activity. You can change the mapping from the Mapper tab.
- Select OK. The changes to the options on the Advanced Record Options tab are saved.
- On the Basic Record Options tab, enter the following details:
- Select Start Recording. The Connector for SAP window appears. For information about how to record different types of GUI Scripting transactions, see the tutorials in the GUI Scripting section.
Note: The GUI Session is displayed and a 'barbershop pole' icon is displayed in the lower half of the SAP GUI to let the you know that GUI Scripting is active.
If GUI Scripting is enabled and you still cannot use GUI Scripting with Process Runner, it is possible that your SAP GUI installation did not install SAP GUI Scripting interface. Go to Control Panel, Add or Remove Program options and find SAP GUI front end. Select Change and ensure that SAP GUI Scripting is selected. If not, select and install that component.
Data Extractor
This topic describes how to create a Data Extractor Process file using Process Runner. The file is saved as an .ide file (Innowera Data Extractor File).
You can extract existing table data from SAP into an Excel File. Use the custom Data Filter conditions for data extraction to get the relevant data.
Refer to the video to understand how to create a Data Extraction automation script.
To create a Data Extractor Process file,
- Select File > New Process > New Data Extractor or Data Extractor available on the left side of the New Process window.
- In the Table/View Name, enter the SAP table or view name.
- If you do not know table name or if you want to find out table joins, select DD Explorer.
A list of all tables and views as found in standard ECC6 system is displayed.
The following screenshot illustrates the steps to find a table joins between
VBAKandVBAP. Refer to the video to understand how to use the SAP Data Dictionary Explorer functionality. - Optionally, select More... for additional recording options. The Options window is displayed.
- On the Basic Record Options tab, enter the following details:
- File Name (optional): Adds the file name for the Process file before recording. If this field is left empty, then Process Runner automatically generates a name for the Process file.
- Excel Data file (optional): Indicates that an external Excel file that has data must be uploaded or downloaded to or from SAP. Provide the correct worksheet name of the selected Excel file.
- Select OK. The changes to the options on the Basic Record Options tab are saved.
- On the Advanced Record Options tab, enter the following details:
- Automap all fields: Maps automatically the return fields to Excel columns.
-
Get fields description: Retrieves the field descriptions from SAP in your logon language.
Screenshot: Advanced recording options
- Select OK. The changes to the options on the Advanced Record Options tab are saved.
- On the Basic Record Options tab, enter the following details:
- Select OK. The Connector for SAP window appears. For information about how to record different types of Data Extractor transactions, see the tutorials in the Data Extractor section.
Note: You can also use custom Z or Y tables and table joins that are not displayed in the SAP Data Dictionary Explorer window; you can directly enter the Z or Y table name in the New Process window.
Note: The list is based on ECC6. If you are using a different system, the selected table or view may not be available in your system; however, you can directly enter the table or view name in the New Process window. Process Runner dynamically validates this table or view after you log on to the SAP system.
Note: While SE16 or SE17 access may not be required, you must have a table-level authorization to use any table or view. If you do not have the required access, an authorization error is displayed.
OData File
This topic describes how to record an OData file in Process Runner. The file is saved with.iof (Innowera OData File) extension.
To create an OData file,
- Select File > New Process, or select New Process on the Home tab. The New Process window appears.
- Select OData(OD) from the left side.
- Select Start Recording. The Connector for SAP window appears with the SAP systems configured for OData.
Note: If you have not yet added an OData-enabled SAP system to the connector, select Add Server and configure the connection before proceeding. For more information, see Add non-SAP GUI System.
- Select the SAP system and then select Logon.
- In the New Process window, enter or select the name of the OData service in the OData Service field. For example, ZAPI_SALES_ORDER_SRV.
- In the Entity Set field, select the entity set from the drop-down list. For example, A_SalesOrder. An entity set is a collection of records of the same type exposed by the OData service, such as sales orders, customers, or materials.
- In the Operation field, select the operation to perform based on selected entity set. The following operations are available:
- GET (Read): Retrieves data from SAP into Excel.
- POST (Create): Creates new records in SAP using data from Excel.
- PATCH (Update): Updates existing records in SAP using data from Excel.
- Select Load Schema. Process Runner connects to the SAP OData service and retrieves the schema. A field selection list appears, showing all available fields for the selected entity set, including any navigation properties.
- Select the check boxes next to the fields you want to retrieve. Use Select All or Unselect All to manage your selection. Mandatory fields are selected by default and cannot be cleared.
- Select OK. Process Runner builds the OData interface and opens the process file as a new file with the Mapper tab open.