Versions Compared

Version Old Version 4 New Version Current
Changes made by

Xiaoyan Kong (Unlicensed)

Xiaoyan Kong (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
用意されているバリデータこのドキュメントでは、用意されている次のバリデータの使用方法について説明します。 用意されているバリデータ

このドキュメントでは、用意されている次のバリデータの使用方法について説明します。
 
バリデータ
説明
requiredFieldValidator
フィールドに値が含まれているかどうかを検証します。
stringLengthValidator
フィールドに指定した範囲の長さの値が含まれているかどうかを検証します。この検証は、入力されたデータの量に基づいて行われます。
integerValidator
フィールドに有効な整数が含まれているかどうかを検証します。
decimalValidator
フィールドに有効な 10 進数または浮動小数点数が含まれているかどうかを検証します。
rangeValidator
フィールドに指定した範囲の整数または 10 進数が含まれているかどうかを検証します。この検証は、入力されたデータの実際の値に基づいて行われます。
dateValidator
フィールドに指定した日付フォーマットの値が含まれているかどうかを検証します。
currencyValidator
フィールドに指定したロケールに基づく有効な通貨金額が含まれているかどうかを検証します。
validatorChain
一度に実行する一連のバリデータを指定します。

...


バリデータ宣言
Code Block
<validator:requiredFieldValidator
xmlns="http://nexaweb.com/validator"
id="usernameValidator"
value="username.text"
onSuccess="macro://success.execute()"
onFailure="macro://failure.execute()" />
 

検証する要素
<textField id=“username” text=“” />

stringLengthValidator

stringLengthValidatorは、すべてのバリデータに共通する属性に加えて、次の属性を持っています。
...

バリデータ宣言
 Code Block
<validator:stringLengthValidator
xmlns=“http://nexaweb.com/validator”
id=“passwordValidator”
value=“password.text”
minimum=“8”
maximum=“15”
onSuccess=“mco://myMco.validPassword()”
onFailure=“mco://myMco.invalidPassword()” />
 

検証する要素
<passwordField id=“password” text=“” />

minimum 属性の値として 8 を指定すると、8 文字以上で最大文字数が無制限の範囲が作成されます。
...

バリデータ宣言
 Code Block
<validator:rangeValidator
xmlns=“http://nexaweb.com/validator”
id=“weightValidator”
value=“weight.text”
minimum=“2.5”
maximum=“5.8”
format="0.0"
locale="en_US"
onSuccess=“mco://myMco.validWeight()”
onFailure=“mco://myMco.invalidWeight()” />
 

検証する要素
<textField id=“weight” text=“” />

dateValidator

dateValidatorは、すべてのバリデータに共通する属性に加えて、次の属性を持っています。
...

バリデータ宣言
 Code Block
<validator:dateValidator
xmlns=“http://nexaweb.com/validator”
id=“birthValidator”
value=“birthdate.text”
format="yyyy/MM/dd"
locale="es_ES"
onSuccess=“mco://myMco.validBirthdate()”
onFailure=“mco://myMco.invalidBirthdate()” />
 

検証する要素
<textField id=“birthdate” text=“” />

currencyValidator

currencyLengthValidatorは、すべてのバリデータに共通する属性に加えて、次の属性を持っています。
...

バリデータ宣言
 Code Block
<validator:dateValidator
xmlns=“http://nexaweb.com/validator”
id=“totalValidator”
value=“total.text”
prefix=“¥”
locale="ja_JP"
onSuccess=“mco://myMco.validTotal()”
onFailure=“mco://myMco.invalidTotal()” />
 

検証する要素
<textField id=“total” text=“” />

バリデータ チェーン

UI ファイルの同じフィールドまたは異なるフィールドで一連のバリデータを実行する validatorChainを作成できます。
...
validatorChain要素タグには、次の属性が含まれます。
 Code Block
<validator
<validator:validatorChain


xmlns:val=http://nexaweb.com/validator


id=“loginValidator”


onSuccess=
“mco
“mco://myMco.login()”


onFailure=
“macro
“macro://failure.execute(‘invalid username and or password’)”


failFast= >


<validator:Validator />

<validator

<validator:validatorReference />


</validator:
validatorChain>
validatorChain>
 
次の表に、validatorChainの属性についての説明を示します。
バリデータ タグ要素
説明
バリデータ チェーンの開始タグです。
id=“ ”
特定のバリデータ チェーンに一意の ID を指定します。
onSuccess=“ ” 
チェーン内のすべてのバリデータの検証が成功したときに実行する MCO またはマクロ (たとえば、成功のメッセージを表示する) を指定します。
onFailure=“ ”
チェーン内のいずれかのバリデータの検証が失敗したときに実行する MCO またはマクロ (たとえば、失敗のメッセージを表示する) を指定します。
failFast=
チェー ン内のいずれかのバリデータの検証が失敗したときに、チェーンの実行を停止するかどうかを指定します。この属性は、デフォルトから変更する場合にのみ設定 します。デフォルトは true です。この属性を false に設定すると、バリデータ チェーンはチェーン内のいずれかのバリデータの結果に関係なく、チェーン内のすべてのバリデータが実行されるまで、実行を継続します。
<validator:Validator /> または <validator:validatorReference />
チェーン内に含める各バリデータまたはバリデータ参照を指定します。
バリデータ チェーンの終了タグです。

例: 
バリデータ宣言
<validator
 
 Code Block
<validator:requiredFieldValidator xmlns:validator="http://nexaweb.com/validator"


id="passwordRequiredValidator"


value="password.text"


onSuccess=""


onFailure="macro://failureMacro.execute('Password required')" /> 


バリデータチェーン宣言
<validator  
 Code Block
<validator:validatorChain xmlns:validator="http://nexaweb.com/validator"> id="myValidator">
 <validator

 <validator:validatorReference validator="passwordRequiredValidator" />
 <validator

 <validator:stringLengthValidator value="password.text" minimum="8" maximum="20" onSuccess="mco://myMco.login()"     onFailure="macro://failureMacro.execute( 'Password must be between 8 and 20 character')" />
 <

 </validator:
validatorChain>
validatorChain>


バリデートする要素
		 <textField id="password" text="" onTextChange="validator://myValidator.execute()" /> 
この例では、validatorChain, myValidatorは２つのバリデータを含んでいます。: passwordRequiredValidator, はチェーン外で宣言し、レファレンスにより特定されます。stringLengthValidatorはチェーン内でのみ、宣言されます。
バリデータレファレンス
Shortcut syntaxとして、validator referenceを使用し、validator chainで以前宣言されたvalidatorを参照することができます。
validatorReference tag要素は以下のように表現されます :
		 <validator:validatorReference xmlns:validator="http://nexaweb.com/validator" validator="usernameValidator" /> 
次の表はvalidatorReference 属性の説明を提供しています :
Validator タグ 要素説明
<validator:validatorReference
 xmlns:validator=“http://nexaweb.com/validator”		Validator referenceのタグを開く
validator=“ ”この UI で宣言されるバリデータの ID を特定する