Procedure for Adding an Attribute to a Webform

Open the needed webform:

1. Select Object > Find.

   The Find Objects dialog box opens.

2. Select Web Form from the Object pull-down list.
3. Enter the name of the needed web form. You can use the * wildcard.
4. Click Find.
5. Click the needed Web Form to select it, then select Object > Open > Edit.

   The Edit Web Form dialog box opens.

Click Add.

The Add Field dialog box opens showing the Expression tab.

On the Expression tab:

1. Click the ellipsis button for the Expression field. The Select Pattern dialog box opens.
2. Click the Attribute check box and click Filter.
3. Select the needed attribute.
4. Click OK.
5. Select the Business Objects option button.

Enter basic details:

1. Click the Basics tab.
2. Enter the Name for the field as a string resource key using this format:

   emxAPPNAME.STRINGID

   where:
   

   • APPNAME is the product name
   • STRINGID is the identifying name used to map the name of this field to an entry in the string resources file

   For example, if you want the name to show as "Thickness" in English, on a page titled "Create Custom Part" in Engineering Central, you would enter the name using this format:

   emxEngineeringCentral.CreateCustomPart.Thickness

   Add a line to the emxAPPLICATION_NAMEStringResources.properties file in this format:

   emxAPPNAME.STRINGID=STRING_VALUE

   where:
   

   • APPNAME is the product name
   • STRINGID is the identifying name used to map the name of this field to an entry in the string resources file
   • STRING_VALUE is the English text to display

   In our example, you would enter:

   emxEngineeringCentral.CreateCustomPart.Thickness="Thickness"

   See Internationalizing Business Process Services Products for details on adding this string resource to properties files for other languages.

3. Enter a Description for the field.

Enter link details:

If the field will not be clickable by the end user, skip this step.

1. Click the Link tab.
2. Enter the Href, the URL for the page that opens when the user clicks the field.
3. Enter the Alt text that displays when the user hovers the mouse over the field.
4. If you have defined a JSP to retrieve a range of values to populate the field with, enter the URL for that page in the RangeHref box.
5. Enter the UpdateURL, the URL for the page to display after the field is updated.

Enter settings for the field:

1. Click the Settings tab.

   Typical settings used to define a field include (see Form Fields for more info):
   

   • Registered Suite. The application the column belongs to.
   • format. How the data in the column should be displayed.
   • Field Size. How long, in pixels, to make the field.
   • Field Type. How the data for the field is populated.
   • Input Type. For edit mode, how the user enters data.
   • Access Expression, Access Function, Access Mask, Access Program. Define who has access to the column.
   • Editable. For edit mode, defines if the user can edit the field

2. For each setting, enter the Name and Value, then click Set. See Settings for Fields in Web Form Objects for details about the available settings.

Define who has access to the field:

If you want this field accessible to all users who have access to the form, skip this step.

1. Click the Access tab.

   Avoid adding specific users. Typically, use this tab to grant access based on a person's role to the field.

2. Click Add.
3. Select the needed role. You can use the Name box and Filter button to search for the needed roles.
4. Click OK.
5. Click User [All] then click Remove.

Click OK to save and close the Add Field dialog box.

In the Edit Web Form dialog box, place the field where you want it to appear in the form by clicking the field, then clicking Move Up or Move Down until it shows in the needed location.

Click Edit to save the web form.