タスクレベル検証の JavaScript インターフェース

タスクレベル検証の JavaScript インターフェースの定義を以下に示します。

構文

public boolean validate(
   BLTHContext context,
   String attributeValue,
   StringRef changedValue,
   StringRef errorMessage
   );

パラメータ

context

入力パラメータ

現在のタスクセッション情報の取得方法が含まれるオブジェクトを指定します。

attributeValue

入力パラメータ

検証される属性の値を指定します。

changedValue

出力パラメータ

検証されるユーザ入力値を置換するオプションの変換値を提供します。変換が必要でない場合は、null を返します。

errorMessage

出力パラメータ

検証が失敗すると、ユーザへのメッセージを表示します。

メッセージは AttributeValidationException で表示されます。メソッドが false を返すと、CA Identity Manager によりこの例外が生成されます。

コメント

出力パラメータ changedValue および errorMessage はデータ型 StringRef です。以下の例で示されるように、StringRef は、値を割り当てるフィールド参照が含まれる事前定義済みデータ型です。

正しい形式の電話番号にプレフィックス 1 を追加します。
```
changedValue.reference="+1 " + phoneNumber;
```

不適切な形式の番号に対しては、エラーメッセージを提供します。

errorMessage.reference="Phone number " + phoneNumber + 
            " does not match the format nnn-nnn-nnnn.";

戻り値

True attributeValue の値は有効であるとみなされるか、または changedValue で変換された値が返されます。
False attributeValue は無効であるとみなされます。 CA Identity Manager により、errorMessage が含まれる AttributeValidationException が生成されます。

ディレクトリレベル検証用の JavaScript インターフェースの定義を以下に示します。

構文

public boolean validate(
   String attributeValue,
   StringRef changedValue,
   StringRef errorMessage
   );

パラメータ

attributeValue

入力パラメータ

検証される属性の値を指定します。

changedValue

出力パラメータ

検証されるユーザ入力値を置換するオプションの変換値を提供します。変換が必要でない場合は、null を返します。

errorMessage

出力パラメータ

検証が失敗すると、ユーザへのメッセージを表示します。

メッセージは AttributeValidationException で表示されます。メソッドが false を返すと、CA Identity Manager によりこの例外が生成されます。

コメント

正しい形式の電話番号にプレフィックス 1 を追加します。
```
changedValue.reference="+1 " + phoneNumber;
```

不適切な形式の番号に対しては、エラーメッセージを提供します。

errorMessage.reference="Phone number " + phoneNumber + 
             " does not match the format nnn-nnn-nnnn.";

戻り値

True -- attributeValue の値は有効であるとみなされるか、または changedValue で変換された値が返されます。
False -- attributeValue は無効であるとみなされます。 CA Identity Manager は、errorMessage が含まれる AttributeValidationException を生成します。