Web Development Toolkit

Web Development Toolkit Custom Tags

 

Web Development Toolkit tags are available for the retrieval of the Agile EDM contents. The tags are implemented in templates, which must be JSP files. The following are available
Web Development Toolkit tags:

<EWDT:edbcustom></ EWDT:edbcustom>
<EWDT:edb></ EWDT:edb>
<EWDT:edbft></EWDT:edbft>
<EWDT:edbm1></EWDT:edbm1>
<EWDT:edbm></EWDT:edbm>
<EWDT:edbff></EWDT:edbff>
<EWDT:edbfv></EWDT:edbfv>
<EWDT:edbrepeat></EWDT:edbrepeat>
<EWDT:edbsm></EWDT:edbsm> 
<EWDT:edbf></EWDT:edbf>

The general rule, like in HTML and XML: each start tag must be terminated by the appropriate end tag. At this time, only the <EWDT:edb> </EWDT:edb> tag may be nested
within the <EWDT:edbrepeat> </EWDT:edbrepeat> loop tag.

 

<EWDT:edbcustom>

  The edbcustom tag is used in jspcustom.jsp to specify the root directory for the custom web client artefacts and the path to the templates from within the custom root directory. Jspcustom.jsp is the entry point to Agile e6 for the custom web client.
 

Example:

<EWDT:edbcustom customRoot='custom_web' templatePath='templates> <\EWDT:edbcustom>

  • The path to the uncompiled templates (JSPs)
    <agile e5-e6 installation> /epclt/<web presentation service environment>/webapps/ROOT/custom_web/templates
  • The path to compiled templates (JSPs)
    <agile e5-e6 installation> /epclt/<web presentation service environment>/webapps/ROOT/WEB-INF/classes/custom_web/templates
 

<EWDT:edb>

   The edb tag has several uses. Nothing is retrieved if an unknown parameter is specified.

Create a url that will invoke a user exit.

Examples:

  • Query
    <EWDT:edb valueName='usx' usx='LIST_A' params='iwf_lis_ent(EDB-DOCUMENT EDB-DOC-SLI) & iwf_sel_lis' template='WWW-DOC-QRY.jsp'></EWDT:edb>
  • LogiView call
    <EWDT:edb valueName='usx' usx='LIST_A' params='lgv_nosel_run(EWDT/queryItem(K%))' template='WWW-ART-SLI.jsp'>

    ‘K%’ will be passed to the EP_STRING variable and the LogiView-Code might look as follows:

    10     RES = @iwf_lis_ent("EDB-ARTICLE EDB-ART-SLI")   
    20     field_set_qry(widget_id(),"T_MASTER_DAT.PART_ID",EP_STRING)
    30     RES = @wdh_upd_lis() 

  • Update of a particular document (e.g. url from document form)
    <EWDT:edb valueName='usx' usx='iwf_edt_lis' params='' template='WWW-DOC-UPD.jsp'></EWDT:edb>">
  • Open the classification list of a particular item
    <EWDT:edb valueName='usx' usx='xsml_frm_typ' params='' template='WWW-ART-GRP-RLI.jsp'></EWDT:edb>">

Retrieve mask contents and parameters.

Example:

<EWDT:edb valueName='fld_val' fieldName='T_MASTER_DAT.PART_ID'></EWDT:edb>

Retrieve various configuration parameters.

Example:

<EWDT:edb valueName="language"></EWDT:edb>

   
 

Supported Tag Attributes

 

Attribute Name

Description

Available Entries

Attribute required when valueName is

valueName

Name of value or type of value to be retrieved.

See entry list below.

See entry list below.

usx

Name user exit to be invoked.

Any user exit.

usx

params

Parameter list for user exit.

Required parameters for user exit.

usx

template

JSP template filename for the result of invoked user exit.

A JSP filename which is appropriate to present the result.

usx

cmd

 

back

SCRIPT_NAME, only required for back button.

fieldName

Name of field value to be retrieved for current mask.

Any field specified in the current mask.

fld_val

 

Entry list

Entry

Description

Required Attributes

Example of returned Value

c_id

Unambiguous definition of a data record.

none

1000034002

Ent

Specification of the entity.

none

EDB-ARTICLE

ewdtFrame

Hidden frame for FMS operations.

none

<iframe name="msgframe" id="msgframe" src="/empty.html" style="visibility:
hidden; width:0px; height:0px;"></iframe>

ewdtFrameName

Name of hidden frame for target attribute of HTML anchor (<a></a>) tag.

none

msgframe

fld_val

Name of field to retrieve data.

none

ART-1200-B

fld_width Returns the field width of a field with the tag attribute name "fieldName". It has to be used with the attribute "valueName". If the virtual width of that field is greater than 0 the virtual width will be returned, otherwise, the width will be returned. none <td class="clsLevel"><EWDT:edb valueName='fld_width' fieldName='T_MASTER_DAT.PART_VERSION'></EWDT:edb></td>
fld_length Returns the field length of a field with the tag attribute name "fieldname". It has to be used with the attribute "valueName". none <td class="clsLevel"><EWDT:edb valueName='fld_length' fieldName='T_MASTER_DAT.PART_VERSION'></EWDT:edb></td>

@GROUP

Current user’s group.

none

DEMOEP

language

Standardized language selection upon the program start.

none

GER

out_hits

Number of the located data records in the result list.

none

23

rowid

Row identifier for records in a list.

none

1

SCRIPT_NAME

URL to the custom entry point of the Agile EDM web presentation service.

 

/custom/runusx?reqid=3&instanceid=mf

@USER

Current user.

none

DEMOEP

usx

URL to the invoke a user exit.

usx, params

/custom/runusx?usx=LIST_A&param=iwf_lis_ent(EDB-DOCUMENT%20EDB-DOC-SLI)
%20%26%20iwf_sel_lis&tpl=WWW-DOC-QRY.jsp&reqid=0&instanceid=mf"

ver_view

Current version view.

 

Development

wdg_max_rec

Mask limit.

none

100

wdg_title

Title of the current mask.

none

Article

message

Returns the Agile EDM system widget messages. It allows to print out these messages in a JSP file.

Attribute Value Description
clear true The message buffer will be deleted.
  false The message will not be deleted and the old message will be shown the next time.

If this attribute is missing the default value will be set to "false".

none <td><EWDT:edb valueName='message' clear='true'></EWDT:edb></td>
 

<EWDT:edbft>

 

The edbft tag is used for retrieving field titles. All visible boxes of the current mask may be used as names.

Example:

<EWDT:edbft fieldName="T_MASTER_DAT.PART_ID"></EWDT:edbft>

Supported Tag Attributes

Attribute Name

Description

Example of returned value

fieldName

Name of the field for the title.

Item number.

 

<EWDT:edbm1>

 

The edbm1 tag is used for outputting menu selections in a form (e.g. drop-down menu). Each selection is output into an HTML <option> tag. The edbm1 tag makes defined scripting variables available. These allow the calling of JSPs to control the presentation without performing the process that is involved to determine the content.

Example:

<select id="T_DOC_DAT.CHK_NAME" name="T_DOC_DAT.CHK_NAME" value="">
  <option></option>
  <EWDT:edbm1 fieldName="T_DOC_DAT.CHK_NAME">
    <option value="<%=value%>">
      <%=selectionText%>
    </option>
  </EWDT:edbm1>
</select>

Supported tag attributes

Attribute Name

Description

Example of returned value

fieldName

Name of the field that contains a menu.

Menu items from EDB-CHK-MEN.

 

<EWDT:edbm>

This tag is used for outputting menu selections in a custom fashion.

Example:

<script language="JavaScript" src="/javascript/ewdt/www30.js"></script>

<script language="javascript">

// >>>>>>>>>>>> CREATE_MENU_OBJECTS (edbm2) <<<<<<<<<<<<<<<

var select_but_menu = new EdbMenu("","B");

noselect_but_menu = new EdbMenu("","B");

var edit_but_menu = new EdbMenu("","B");

var edit_menu = new EdbMenu("FORM_EDT","S");

var select_menu = new EdbMenu("<EWDT:edbf valueName="men_nos"></EWDT:edbf>","S");

<EWDT:edbm menuType="men_nos">

            selection = new EdbSelection("<%=name%>","<%=text%>","<%=description%>",
"<%=usx%>","<%=parameter%>", "<%=access%>","<%=width%>","<%=length%>","<%=row%>","<%=column%>","T");

           select_menu.addMenSelection(selection);

</EWDT:edbm>

Supported tag attributes

Attribute Name

Description

Example of returned value

fieldName

Name of the field that contains a menu.

Menu items from EDB-CHK-MEN.

 

<EWDT:edbrepeat>

The edbrepeat tag is used with result lists to enclose the area that shall be repeated for the individual data records. Example:

<EWDT:edbrepeat>
.
.
.
</EWDT:edbrepeat>

See <EWDT:edbf> tag for full example

 

<EWDT:edbsm>

This tag is used for including a sub-mask as part of a combined mask.

Supported tag attributes

Attribute Name

Description

Available entries

subMaskName

Name of sub-mask to be included.

An appropriate sub-mask to be included as part of a combined mask.

template

JSP template filename for the sub-mask.

A JSP filename, which is appropriate to present the result.

Example:

<EWDT:edbsm subMaskName='EDB-ART-STR-RLI-C' template='/web_root/templates/WWW-ART-STR-RLI.jsp'></EWDT:edbsm>

 

<EWDT:edbf>

This tag is used for outputting mask box contents and mask parameters.

Supported tag attributes

Attribute Name

Description

Available entries

valueName

Names of mask attributes.

See Valuetable below for possible values.

 

Value

Description

but_edt

Edit button name

but_nos

No Select button name

but_sel

Select button name

men_edt

Edit menu name

men_nos

No Select menu name

men_sel

Select menu name

name

Name of mask

title

Title of mask

row

Row position of mask

column

Column position of mask

length

Length of mask

width

Width of mask

sig_flds

Significant fields in mask

entityName

Entity name of mask

hits

Number of records in mask

max_rec

Max records defined in mask

fatent

Parent entity name

fattab

Parent table name

fat_c_id

Parent C_ID

view

View name of mask

edit_mode

"true" if mask in edit mode. "false" otherwise.

Example:

<script language = "javascript">

             oWDG_WWW_ART_STR_RLI = new EdbForm(oENT_T_MASTER_DAT,"<EWDT:edbf valueName="title"></EWDT:edbf>");

             oWDG_WWW_ART_STR_RLI.FormType = "RL";

             oWDG_WWW_ART_STR_RLI.name= "<EWDT:edbf valueName="name"></EWDT:edbf>";

             oWDG_WWW_ART_STR_RLI.noselMenu  = noselect_menu;

             oWDG_WWW_ART_STR_RLI.selMenu  = select_menu;

             oWDG_WWW_ART_STR_RLI.editMenu = edit_menu;

             oWDG_WWW_ART_STR_RLI.noselButMenu  = noselect_but_menu;

             oWDG_WWW_ART_STR_RLI.selButMenu  = select_but_menu;

             oWDG_WWW_ART_STR_RLI.editButMenu = edit_but_menu;

             oWDG_WWW_ART_STR_RLI.row    = <EWDT:edbf valueName="row"></EWDT:edbf>;

             oWDG_WWW_ART_STR_RLI.column = <EWDT:edbf valueName="column"></EWDT:edbf>;

             oWDG_WWW_ART_STR_RLI.len    = <EWDT:edbf valueName="length"></EWDT:edbf>;

             oWDG_WWW_ART_STR_RLI.width  = <EWDT:edbf valueName="width"></EWDT:edbf>;

             oWDG_WWW_ART_STR_RLI.maxrec = <EWDT:edbf valueName="max_rec"></EWDT:edbf>;

             oWDG_WWW_ART_STR_RLI.signum = <EWDT:edbf valueName="sig_flds"></EWDT:edbf>;

             oWDG_WWW_ART_STR_RLI.UserExit = "WWW_REA_REL_REF_LIS";

             oWDG_WWW_ART_STR_RLI.fatent = "<EWDT:edbf valueName="fatent"></EWDT:edbf>";

             oWDG_WWW_ART_STR_RLI.fattab = "<EWDT:edbf valueName="fattab"></EWDT:edbf>";

             oWDG_WWW_ART_STR_RLI.fat_c_id = "<EWDT:edbf valueName="fat_c_id"></EWDT:edbf>";

             oWDG_WWW_ART_STR_RLI.view= "<EWDT:edbf valueName="view"></EWDT:edbf>";

             oWDG_WWW_ART_STR_RLI.wdg= "<EWDT:edbf valueName="name"></EWDT:edbf>";

             oWDG_WWW_ART_STR_RLI.iHits= <EWDT:edbf valueName="hits"></EWDT:edbf>;

             oWDG_WWW_ART_STR_RLI.iCountOnly = "0";

             var  aofields = new Array();

             aofields[aofields.length] = new EdbFormField("c_id","c_id","I");

             aofields[aofields.length-1].access = "";

             aofields[aofields.length] = new EdbFormField("rel_c_id","rel_c_id","I");

             aofields[aofields.length-1].access = "";

            <EWDT:edbff>

             aofields[aofields.length] = new EdbFormField("<%=name%>","<%=title%>","<%=type%>",
"<%=access%>","<%=access_inp%>","<%=access_upd%>","<%=access_qry%>","<%=menu%>",
"<%=menuType%>",<%=row%>,<%=column%>,<%=rowVis%>,<%=rowVis%>,<%=columnVis%>,<%=columnVis%>,"<%=video%>",
"<%=defaultValue%>","<%=preFldUsx%>","<%=postFldUsx%>","","<%=format%>","<%=rowTitle%>",
"<%=columnTitle%>","<%=lengthTitle%>","<%=widthTitle%>","");

            </EWDT:edbff>

     oWDG_WWW_ART_STR_RLI.addFormFieldArray(aofields);

            var dataArray = new Array();

            <EWDT:edbrepeat>

            dataArray[dataArray.length] = new EdbDataSet(<EWDT:edbfv>'<%=fieldValue%>'<%if(!lastField.booleanValue()){%>,<%}%></EWDT:edbfv>);

            </EWDT:edbrepeat>

            oWDG_WWW_ART_STR_ALI.datasets = dataArray;

</script>

 

<EWDT:edbff>

This tag is used for outputting form fields in customized fashion.

This tag does not take any attribute parameters, instead it makes the field attributes available in the JSP as variables.

(See <EWDT:edbf> for example)

Variable

Description

name

Field name

title

Field title

type

Field type

access

Field access

access_inp

Field access for insert mode

access_upd

Field access for update mode

access_qry

Field access for query mode

menu

Field menu name

menuType

Type of field menu name

row

Field y position

column

Field x position

rowVis

Field virtual width

columnVis

Field virtual length

video

Field video color index

defaultValue

Default value for field

preFldUsx

Pre field user exit

postFldUsx

Post field user exit

format

Field format

width Field width
length Field length

rowTitle

Title y position offset

columnTitle

Title x position offset

lengthTitle

Title length

widthTitle

Title width

 

<EWDT:edbfv>

This tag is used for outputting the value of each field in a recordset.

This tag does not take any attribute parameters, instead it makes the field attributes available in the JSP as variables.

(See <EWDT:edbf> for example)

Variable

Description

fieldValue

Value of field

lastField

Boolean.TRUE if this is the last field