Custom Validation function reference phone book icon

The Custom Validation Function text box intention is to provide the designer a means to specify a JavaScript function name for the client side custom validation. And that function should either be in the forms settings Custom JavaScript section or in an included JavaScript file. So it isn't a bug.

I can see your confusion by glancing at the label of the field, but there is a tooltip when you click on the box next to it to describe the feature. As seen here.

Also the Help documentation by clicking on the help button in the screen shot provides further information to assist designers.

_________

Use custom validation: Enables the value entered into the control to be validated by a JavaScript function.

If Yes is selected:

Custom validation function: Specify the JavaScript function name for the client side custom validation. Note: The JavaScript function is to be specified in the Custom JavaScript section within the form's Settings.

E.g. The property should be ClientValidate when the following function is added to the custom JavaScript in the form.

function ClientValidate(source, arguments)

{

      if (arguments.Value % 2 == 0){

        arguments.IsValid = true;

      } else {

        arguments.IsValid = false;

      }

}

_________

The insert reference book icon next to the input box is extremely helpful when using the custom validation so you can provide Common, Item Property, or an inline function assisted value as a parameter to the JavaScript function doing the validation.

You are correct, the label alone may not be exactly clear, but hopefully the available help information built into the product can assist in the gaps.

IMHO, no the label should not be changed. As custom to me means outside of normal operations. Since there 4 normal operations to validations (Compare to, Use Range Validation, Use a Regular Expression, Validation Rules), custom would have to be when my validation need is not met by these 4. Oh, and the 5th being is it required or not.

Also, IMHO, I find the help documentation the best I've ever seen for a product. What I posted came straight out of the help document. The help is Contextual also!! So from the Single Line of Text control settings, I click on Help, and I immediately see the text I copied and pasted under Validation. It thoroughly defines how to use validation on the control. That should be very useful for designers, and when I train, I encourage designers to use it and always demo its usefulness.