# Web Development Toolkit

## Web Development Toolkit Custom Tags

| Web Development Toolkit tags are available for the retrieval of the PLM 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 PLM 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 PLM 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