You are here: Reference Guides > Designer Form Controls (A-Z) > Ws.Comment

Ws.Comment

This control can be used to replace the Comments area that is presented by Ws.ProcessControl.

NOTE: This does not act as a replacement for the historical comments within the Ws.ProcessControl

Download example (.wssln file)

WS.comment properties

Property

Description

Auto Clear At Begin

Clears the contents of the specified form field when the form is started.

Auto Clear At End

Clears the contents of the specified form field when the form is submitted.

Comment XPath

Specifies the field that will be retrieved by the workflow engine to use as the comment for the assignment completion.

Example

The example below shows the comment of "Originator Comment" for the Originator and "Approver Comment" for the Approver. Auto Clear at Begin and Auto Clear at End have been selected in order to keep the Comments Text Box clear of any text. The entire comments trail will be shown in the Winshuttle History.

 

Originator Submission:

Approver Submission:

Once the Originator clicks Save and Route, the comments are recorded on the Winshuttle History, and then cleared from the text box.

Once the Approver clicks Approve/Reject, the comments are stored on the Winshuttle History then cleared from the text box.

Tip: Since the Multi-Line and Rich Text Boxes are not supported, expand the Text Box to the ideal size. Then edit the text box properties to make it a multi-line text box and enable Word Wrap. See the example below.