Contents:
Related pages:
SAPEX allows to extract SAP objects to a defined path within the SAP server.
Using this local approach, you can donwload all the SAP objects within the SAP server and later execute Kiuwan Local Analyzer.
- Please, visit Installation of SAP Extractor for instructions.
Overall procedure
The procedure to fully integrate Kiuwan with your SAP system takes two main steps:
To install some Kiuwan utilities into your SAP system that will be used during operation
- Please, visit Installation of SAP Extractor for instructions.
Run the adequate procedures depending on your operative needs
Create and analyze application Baselines
Run automatically Kiuwan analyses on Deliveries (Transport Orders)
- This section explains how to perform Baseline analyses.
- To perform analyses on Deliveries (transport orders) please visit (new) Local use - Automated audit before release of a transport order
Modeling ABAP code in Kiuwan
Previously to describe the extraction and operative mechanisms, you should think of how to model Abap code into Kiuwan.
Kiuwan always works with the concept of application.
In Kiuwan terms, an application is the analysis unit, i.e. a set of source code files that has some functional meaning for you and, consequently, needs to be analyzed as a whole.
Once you define a Kiuwan application, you indicates Kiuwan the source root directory, i.e. the directory that contains the source code files of that application.
Kiuwan will analyze those source code files as a unit, providing comprehensive results.
Besides, you can always govern you applications by organizing them by portfolios that define the real dimensions that are important for you and your organization.
There are as many ways to model that relationship as Kiuwan's users and organizations. Nevertheless, we suggest an approach that has been proven very useful and adequate in Kiuwan implantations on SAP systems.
This approach consists on modeling a SAP package as a Kiuwan application.
Doing this way, there is a direct relationship between SAP functional units and Kiuwan applications.
In this documentation you will find procedures to execute baseline and deliveries analyses, but please remember that explained procedures are based on mapping “SAP Package” to “Kiuwan Application”.
If this assumption is not applicable to your case, please contact us.
Extract ABAP source code
SAPEX allows to extract SAP objects to a defined path within the SAP server.
The extraction mechanism will download SAP objects related to the SAP package they belong.
It will create a directory for every package where all the pertaining objects will be placed. As you will see below, you can define exactly what objects to extract.
As before mentioned, the approach is to model a SAP package as a Kiuwan application.
As there will be a directory for every downloaded package, you can model application names with the same names as the packages, and configure every app’s source directory to the package directory.
IMPORTANT: Abap Code Extractor does not delete previous content of extraction directory. So, you need to delete it before a new extraction.
After the extraction finishes, you will have to run Kiuwan (in this step Kiuwan is not automatically invoked).
SAPEX presents the following sections:
Objects to download
This section allows to filter the objects to download (Programs, Function modules, Classes and Web Dynpros)
Additional downloads
This option allows to select to download also the screens and assocaietd texts
Export options
Physical path where the extractor will download requested objects (if the directory does not exists the extractor will create it)
Run program ZKW_SAPEX_CODE (using transaction SA38):
By selecting 'Local directory', you may export source code to a local directory, that could be analyzed with a locally-deployed Kiuwan Local Agent directly.
When extracting code associated with a change request/task:
- fill the 'Change request(s)' parameter.
- you may enable 'Add subrequests?' if code for child tasks should be included.
When extracting code associated with one or more package(s):
- fill the 'Package(s)' parameter (it could be used for filtering when selecting by change request).
'Programs', 'Function modules', 'Classes' and 'Web Dynpros' checks
- allows to include/exclude the matching code elements
- ranges may be used to filter by name the elements to export (leave empty for no filter).
'Language'
- is used to gather description text for the target element in the chosen language (but it does not alter the exported code).
If 'Only custom objects' is chosen:
- only items with names starting with 'Y' or 'Z' will be exported.
- this pattern could be changed to a custom namespace (like '/MyOrg/') if needed.
Take care when deactivating the 'Only custom objects' checkbox:
- A too-wide number of objects could be selected, in particular SAP code not related to custom software.
The options in 'Additional downloads':
- allow you to choose exporting dynpro flow logic ('Screens') or text-pools ('Texts').
'Export to..':
- you may select a SAP system directory ('Server directory') or a 'Local directory'.
- 'Simulation' checkbox allows you to test the export before storing files, to ensure that the selected elements are the intended ones.
After executing the program (click on the 'execute' button before the parameters or using F8 key), the exported items are displayed:
- 'Path' is the file pathname, relative to the export directory chosen.
- 'Type' is the kind of source code item exported:
- CLAS for class, INTF for interface, FUGR for function group, FUNC for function module, INCL for include file, WDYN for WebDynpro component, WDYC for WebDynpro controller, WDYW for WebDynrpo window, WDYV for WebDynrpo view, etc.
- _STA and _ERR are reserved for extraction statistics and errors, respectively.
- 'Name' is the item name.
- 'Message' is either the description for the exported item, or error message.
Extract ABAP metadata
Besides ABAP source code, Kiuwan analysis is also based on SAP metadata.
KAPEX allows you to export the selected information ('metadata') from SAP system, creating .txt files in the selected directory.
If SAP metadata is available, that information will be used by Kiuwan, thus providing more accurate results.
Run program ZKW_SAPEX_METADATA (using transaction SA38):
Run analysis
You can execute Kiuwan Local Analyzer from within SAP server.
When Kiuwan Local Analyzer is deployed in the SAP system, you may provide analysis parameters, previously to export the code (by clicking on the 'Export code' button), and then launch the analysis (by clicking on the 'Analyze' button, or pressing F8 key).
Run program ZKW_ANALYSIS (using transaction SA38):
