openform

Open a Beas window, SAP window or create new Beas Window:

 

[parent].openform (string windowname,Parameter1,Parameter2...); // open window with parameter defined in object

[parent].openform (object); // Create new window
[parent].openform (string windowname,object); // open window with parameter defined in object
 

Without parent:

openform (string windowname,object/parameter);

 

With openform you can open a new window:

openform ("beas_id",ParameterList)  // Open Beas Form by Beas-Id. See Beas window names
openform ("fo_id",ParameterList)  // Open SAP Form or third AddOns by SAP-Form-Uid

window.openform ("psr-filename",{object})  // Open Beas Form from current window as parent window
 

Create own window

window.openform(object)

 

Example:

window.openform("beas_ItemMasterData_Edit","RM"}); // Open Beas Item Frrm for item "RM" as modal form
openform("fo_2050",1025); // Open SAP Form "Sales Order" DocEntry=1025

window.openform("artikel_edit.psr",{s_parm1:"RM",modal:true}); // Open Beas Item Frrm for item "RM" as modal form
 

Related to parent window:

Type

Description

window.openform(x)

Example: Current window is item browser

let boyWin=window.openform (/* the item window*/);
// the script continue here in the item browser window 
// but is waiting for all post events...
// in boyWin the reference from item window is saved:
// Write informaiton in description field in child window
boyWin.dw_1.description[1]="Screw 6x3 Din 34.22";

macro.openform(x)

Example: Current window is item browser

macro.window.openform (/* the item window*/);
// waiting for all posted events
// and continue script in opened window
dw_1.description[1]="Screw 6x3 Din 34.22";

application.openform(x)
openform(x)

let boyWin=application.window.openform(/* the item window*/);
// waiting for all posted events
// continue on current window and not on opened window
// but you can use the reference to communicate with opened window
boyWin.dw_1.description[1]="Screw 6x3 Din 34.22";

 

Open existing window

First parameter is the Window-psr-file, the fo_[SAPFormID] or beas_[beasFormId]

If the psr-file name defined, the system search for this file in the project folder and then in standard folder.

 

Second parameter define additional properties by object or parameter list. SAP Forms support only 1 parameter.

openform (string windowname,Parameter1,Parameter2...); // open window with parameter defined in object

openform (string windowname,object); // open window with parameter defined in object
 

hmtoggle_plus1Parameter by Parameter List

 

Define all Parameters as Parameter List, example:

window.openform("beas_Routing_Pos_Edit","FP",10,"modal");

 

Related to window type we've different functionality

 

Open window by SAP-Id

 

Only first parameter supported. All other ignored. Example:

application.openform("fo_2561","C001") ; // open Business Partner "C001"

 

Open window by Beas-ID

In beas_[beasFormId] the Parameter List is defined. Additional keyword new, delete and modal supported

application.openform("beas_WorkOrderBOM_Edit",6002253,10,10); // open Work order BoM Window
application.openform("beas_WorkOrderBOM_Edit",6002253,10,"new"); // create new BoM Entry

 

Open window by PSR File Name

In this variant Parameters autoamtically copied to str_parm, example:

application.openform("fert_ftstlpos_edit.psr",6002253,10,10); // open Work order BoM Window
First Parameter linked to s_parm1, belnr_id, docentry, second to s_parm2, belpos_id, linenumber and so on

Complete Link

Parameter 1

Linked to

1

s_parm1, c_parm1, belnr_id, docentry

2

s_parm2, c_parm2, belpos_id (pos_id, if only 2 Parameters)

3

s_parm3, c_parm3, pos_id

 

Additional Keywords "modal", "new" and "delete" supported from second Parameter

Example

application.openform("fert_ftstlpos_edit.psr",6002253,10,10,"delete"); // delete Bill of Material position
application.openform("fert_ftstlpos_edit.psr",6002253,10,"new"); // create new entry

 
hmtoggle_plus1Parameter by Object

Second parameter can be defined as Object

Example:

application.openform("fert_ftstlpos_edit.psr",{belnr_id:6002253,belpos_id:10,pos_id:10}); // open Work order BoM Window

This is supported for open by PSR-File name and Beas-Window-Id, but NOT for SAP Forms

application.openform("beas_WorkOrderBOM_Edit",{belnr_id:6002253,belpos_id:10,pos_id:10}); // open Work order BoM Window

 

 

Type

Description

s_parm1 - s_parm5

c_parm1 - c_parm5

dt_parm1 - dt_parm2

Define all str_parm variables.  Example: Open item window: s_parm1 present the item code

window.openform("artikel_edit.psr",{s_parm1:"RM"});
List of all str_parm parameter see str_parm object

DocEntry

Document DocEntry (= str_parm.docentry and str_parm.belnr_id)

LineNumber

Document Line (= str_parm.linenum and str_parm.belpos_id)

LineNumber2

Document Line 2 ( = str_parm.pos_id)

belnr_id,belpos_id,pos_id

References to str_parm.belnr_id, belpos_id, pos_id

 

Additional object properties supported

Property

Description

newentry:true

with b_parm1 the form will go in "new entry" mode

deleteentry:true

with this property the deleteentry event will be execute

command

Note: the commands executed Before the document is created. (form_open event)

If you want to send commands for the document, you must use the post function

command=post=...

Note: All commands executed as BeasScript

modal:true

Will open the window in modal form. Next script line will be executed after closing the window

xxx

All other parameters present a variable, which you want to send to the window, example:

 

openform("myWindow.psr",{as_itemcode:"FP"});

in the opened window the variable "as_itemcode" will be "FP"

 

Return value

openform return
SAP-Forms: nothing

hmtoggle_plus1Beas-Forms: the window instance

Not modal forms return the instance of the opned window

let lw=application.openform("windowname",parameter);

 

Example:

let ll_docEntry=6002253;

let lw=application.openform("beas_WorkOrderBOM_Edit",ll_docEntry,10,10); // open Work order BoM Window

// next line will be executed after complete opening of the child window
lw.title="MyWindow-Title" // replace title in opened window
 

 
hmtoggle_plus1Modal Beas-Forms: return object

If you open a form modal, the script is waiting up to closing the modal form

Modal forms return an object with

- All fields from dw_1

- String returnText

- String returnValue

- boolean returnOk: return "true", if closed by "OK" otherwise "False"

- str_parm object from current window

 

In the modal form you can define the return values with

window.setReturnValue("valueName","value");

Example:

window.setReturnValue("s_parm1","test"); // set str_parm.s_parm1 property from return Value 

window.setReturnValue("myValue",23); // set Property "myValue" with 23

see window.setReturnValue

 

let f=application.openform("myModalForm","modal");
if (f.returnOk != true) return -1

 

 

 

Create new Beas window

if first parameter is an object, the system opens a completely new window: See new Form.

Create new SAP Window: Use SAP UI-API objects: sbo_forms.Add