Editing StarTeam APEs

You can add new fields to or edit the existing fields of a StarTeam Extensions form using your favorite Java development tool. These forms are called alternate property editors (APEs). When you use a StarTeam JavaBean component, you will need to select the correct component that matches the type of field you are using, and after the component is placed on the form, you will need to set the propertyName attribute. The propertyName attribute should have the application field name that you wish to display in this component in the form.

Where applicable, the JavaBeans are composed of an editor component and a text label showing the name of the property being edited. By default, the text shown by the label is the display name of the StarTeam property associated with the JavaBean (set via the propertyName JavaBean property). When you edit the JavaBean in a visual form designer such as JBuilder, the label's text will be the internal identifier for the property, that is, the value of the propertyName property of the JavaBean. When the form is run, that text is replaced with the display name of the property (defined by StarTeam metadata about the property). For example, the StarTeam Status field has the same display name and internal identifier. However, the custom status field used in the change request samples has the display name Workflow Status and the internal identifier Usr_StarFlowStatus. In the latter case, you see Usr_StarFlowStatus in JBuilder and Workflow Status when the form runs.

You can control the behavior of this label by doing any of the following:

Supplying alternate text for the label

Set the labelTextOverride property of the JavaBean. The text you supply will be seen in JBuilder and when the form runs.

Turning the label off so that it is not seen at any time

Set the showLabel property to false. To turn the label back on later, you would set the showLabel property to true.