ObjectForm Control

The form control provides a way to input data described by the TurnObjects. The form layout is presented to the user in the same order and style that is defined in the system configuration file. Required fields and regular expression validators are also automatically added to the form. A SuccessMessage property is displayed when the form has been submitted. Notification emails of the form's submission can be sent by specifying the EmailNotification property. It is possible to load the form by setting the TargetKey to a valid primary key on the target object.

Configuration

Property	Short Description
TargetObjectName	Name of the object in the TurnSystem that will be represented by this control.
TargetSystemName	Name of the TurnSystem that will be used by this control.
TargetKey	Primary key of the item to load into the form.
EmailNotification	Send an email to the specified addresses when the item is submitted.

Appearance

Property	Short Description
SubmitButtonText	Text on the submit item button.
PreviewButtonText	Text on the preview item button.
CancelButtonText	Text on the cancel button.
EditButtonText	Text on the edit button.
SuccessMessage	Text the user will see on submission of the form.
CssPrefix	Controls will use the style with the specified prefix.

Behavior

Property	Short Description
EnableSecurity	Determines if the control will be constrained by the current users security rights.
IsPreviewed	The item will be presented for review by the user before the final submission is done.

Form Events

The following interfaces can be inherited on a page that the form control is on. The methods can then be used to customized the operation of the form when a specific event occurs.

IObjectFormPreSave

This interface has a method that gets fired just before the form has been submitted. The TurnObject is passed to the method so that custom operations can be performed.

void OnFormPreSave(IBaseObejct targetObject);

IObjectFormCancel

This interface has a method that gets fired if the cancel button is pressed.

void OnFormCancel(object sender, System.EventArgs e);

IObjectFormSubmit

This interface has a method that gets fired after the form has been submitted.

void OnFormSubmit(object sender, System.EventArgs e);