[Top] [Prev] [Next] [Bottom] [Contents]

colspecFCheck

colspecFCheck (Framework master and Data Control)
colspecFCheckN (for detail where N is required and is the 
detail number)

Definition

A string specifying a field validation operation. Field validation operations are applied to the column values of a row set before they are sent to a server process for insert and delete operations. If any field check fails for any value of a column, the operation is prevented and a "human" understandable message is displayed.

This parameter works with both the master view and the detail views.

For the master view the parameter name is "colspecFCheck".
For the detail views the parameter name is "colspecFCheckN", where N is the detail number.

Parameter Name

In both cases, the colspec must be replaced with valid column specification.

You can use either of these two methods:

Use the name of the column. The column name must match the column in the row set exactly.
Use colN as the colspec method where N is the number of the column in the row set (zero based). Examples

The following two examples show a field check param name using the two colspec methods:

<param name="au_idFCheck2" ...

<param name="col0FCheck2" ...

Both are set for detail number two.

The first assumes that a column "au_id" is in the row set.
The second applies the check to the 0th column in the row set.

Parameter Value

The value for this parameter also has two formats.

One specifies the class name of the field check class.
The other adds an additional parameter string which is sent to the field check object. The class specification must be a relative to the codebase specification for the applet. The class must implement the interface Sa.SaFieldCheck. If the class specified by the value of this parameter is not derived as stated above, then no check is applied. If the class cannot be found, then no check is applied. The class must either contain no constructor or one with no parameters and the constructor should be public. If not, then the class will not be loadable, and no check is applied. Examples

The following two examples show a field check param value using the two value spec methods:

<param ... value="SaC.SSN" >

<param ... value="SaC.Pattern=### ###-####" >

The first uses a check to see if the data input by the user is in a valid Social Security Number format using the SaC.SSN class. The second checks that the data entered by the user is in the format of the pattern specified after the = character. This example is a phone number with area code. It uses the class SaC.Pattern, which takes a pattern parameter.

[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com

Copyright © 1997, Bluestone. All rights reserved.