Blue Prism guide to expanding the SAP function library.pdf - Data Sheet Expanding the SAP function library Contents Introduction 2 Pre-Requisites 2

Blue Prism guide to expanding the SAP function library.pdf...

This preview shows page 1 - 4 out of 13 pages.

Commercial in Confidence Page 1 of 13 Data Sheet Expanding the SAP function library Contents Introduction ............................................................................................................................................ 2 Pre-Requisites ......................................................................................................................................... 2 Procedure ............................................................................................................................................... 2 Editing the SAPElements file ............................................................................................................... 3 Editing the Actions file ........................................................................................................................ 4 Functions for working with SAP controls ............................................................................................ 5 SAPGetProperty .............................................................................................................................. 5 SAPSetProperty ............................................................................................................................... 5 SAPInvokeMethod .......................................................................................................................... 6 Testing new functions ......................................................................................................................... 7 Example of adding a new action to an existing control .......................................................................... 8 Appendix 1: List of Argument Data Types ............................................................................................ 10 Appendix 2: List of SAP Controls ........................................................................................................... 10 Appendix 3: Useful references ............................................................................................................. 12 Troubleshooting ................................................................................................................................... 13
Image of page 1
Commercial in Confidence Page 2 of 13 Expanding the SAP function library Introduction Introduction Although Blue Prism provides accessibility to most of the main controls and functions which SAP exposes via its Application Programmable Interface (API) there are some controls and functions which have not been implemented as standard within the SAP product. Instead, Blue Prism have created a method to enable controls and functions to be added to the list of exposes items which can be spied and interacted with. This document explains the procedure to expose these features and make them available. This procedure is not expected to be attempted by the majority of customers. If you need assistance with creating and validating new methods then please raise a support request for help. Pre-Requisites It is assumed that the following software products are installed and configured before using this procedure:- Blue Prism v4.2.43 or higher SAP GUI for Windows ( tested against v720 ) Procedure In order to extend the functionality of how Blue Prism interacts with an SAP control it is only necessary to amend two important XML files. There are two files that define the Elements that can be worked with (i.e. the SAP controls and their component parts) and the Actions that can be performed with those controls. The XML files are:- SAPElements.XML Actions.XML Both of these files can be found in the default Blue Prism installation directory, e.g. The two XML configuration files are read by the Blue Prism application when the Interactive Client is started. Once the changes have been added to these files then they will be available in the Application Modeller interface.
Image of page 2
Commercial in Confidence Page 3 of 13 Expanding the SAP function library Procedure Editing the SAPElements file The SAPElements XML file contains a list of SAP controls, and provides Blue Prism with information about how to interact with these controls. A typical SAPElements file will contain a description of a number of controls. Here is the XML description of the SAP Treeview control:- <element id="SAPCtrlTree"> <apptype>SAP</apptype> <name>SAP Treeview</name> <helptext>A SAP Treeview</helptext> <sapidentification>GuiCtrlTree,GuiShell/Tree</sapidentification> <readquery action="GetSelectedNodeKey">sapgetproperty propname=selectedNode</readquery> <readquery action="GetNodeText">sapinvokemethod methodname=getNodeTextByKey arguments=$key$</readquery> </element> id a bespoke unique name used by Blue Prism to identify the SAP control apptype - will always be
Image of page 3
Image of page 4

You've reached the end of your free preview.

Want to read all 13 pages?

  • Summer '09
  • ramana rao
  • Subroutine, SAP Controls

  • Left Quote Icon

    Student Picture

  • Left Quote Icon

    Student Picture

  • Left Quote Icon

    Student Picture