Please also have a look in our OnlineHelp for further information.

This article shows how to execute some custom action,
e.g. open the SAP-GUI for the current row (purchase order number).

Using common BOARD techniques and a correctly configured DataView component (details omitted for brevity, please reference the BOARD Documentation if needed) gives us the following view, containing a table with Purchase information.

Clipboard02

We want to open the SAP-GUI with some parameters, so let us use the “Quantity” column as an example target for executing some abstract actions.

prototyping

1.As a first step we should implement the hidden logic (so we could bind it later to some UI-object).
BOARD operates with the notion of “Procedures”, which can be assigned to an object, e.g. in DataView. Procedures in turn consist of “Actions” in BOARD.

Clicking on “Process Modeling” in the design mode leads to the view, in which you can select a database, where the procedures should be managed. Then it is possible to add new ones (we are going to add two).

Clipboard07

A. To be able to open the SAP-GUI (windows executable with parameters) we can use a command-line file (cmd). For this purpose we could use the “Launch Action”, specifying the path to the command batch.

Clipboard10

The batch-file contains primitive commands to read the file with the purchase order number (next action, export parameter) and launch SAP-GUI with this parameter.

for/f "tokens=*"%%A in (c:\temp\POExport.txt) do (
"C:\\Program Files (x86)\\SAP\\FrontEnd\\SAPgui\\sapshcut.exe"-user="User"-command="*ME23 RM06E-BSTNR=%%A;"-type="Transaction"
-gui="/H/ecc.theobald-software.com/S/sapdp00"-client="800"-sid="ECC"-reuse=1-max
)

B. To pass the parameter from DataView to the GUI, which can be read with this CMD-Script, we could use “Extract” of the available BOARD actions.

Clipboard09

The parameter to be exported must be configured, that is done by going to the “Configure Layout” window (near the file name and path the parameter needs to be exported to).

exportactionparameters

After getting these two actions added to the procedure, its actions-view looks like in the image bellow.

Clipboard11

2.Now we need to trigger the Procedure from DataView’s column for each row.
In the “Edit Mode“ right-click on the DataView component and select “Layout” in the menu. There are “Block Options” inside the “Options” tab.

Clipboard05

At the bottom of the page the fields of DataView are listed, we could let a particular field act like a button, selecting “Button” for the “Appearance” column. To change default behavior (none) we need to click “Configure”.

Clipboard06

Within the tab “Procedure” you can select previously designed action-sequences (procedures) from a dropdown. Clicking on the “Add” button, we are effectively binding the click on the cell with the selected procedure.

Result:
By clicking on the row (within a Quantity column) the SAP-GUI should appear, the user will be prompted to enter the password and will eventually see the requested form.

result