intra-mart Accel Platform スクリプト開発モデル プログラミングガイド 第17版 2021-12-01

バリデーションルール リファレンス

required

値が入力されているかを検証します。パラメータが存在しないまたは空文字の場合はエラーとします。
設定値が false の場合は検証を行いません。

設定値

true または false

設定例

required: true

エラーメッセージ

ロケール エラーメッセージ
en {0} is required.
ja {0}は必須です。
zh_CN {0}为必须项目。

alpha

値がアルファベットであるかを検証します。アルファベット以外の文字が含まれている場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。

設定値

true または false

設定例

alpha: true

エラーメッセージ

ロケール エラーメッセージ
en Enter alphabets for {0}.
ja {0}は英字を入力してください。
zh_CN 请在{0}中输入英文字母。

alphanumeric

値がアルファベットまたは数字であるかを検証します。アルファベットと数字以外の文字が含まれている場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。

設定値

true または false

設定例

alphanumeric: true

エラーメッセージ

ロケール エラーメッセージ
en Enter alphanumeric for {0}.
ja {0}は英数字を入力してください。
zh_CN 请在{0}中输入英文数字。

numeric

値が数字であるかを検証します。数字以外の文字が含まれている場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。

設定値

true または false

設定例

numeric: true

エラーメッセージ

ロケール エラーメッセージ
en Enter numeric for {0}.
ja {0}は数字を入力してください。
zh_CN 请在{0}中输入数字。

digits

数値の整数部、小数部の桁数を検証します。指定した桁数より大きい場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。

設定値

[数値1, 数値2]

  • 数値1 - 整数部の最大桁数
  • 数値2 - 小数部の最大桁数

設定例

digits: [3, 2]

エラーメッセージ

ロケール エラーメッセージ
en Enter integers of {1} digit and decimals of {2} digit for {0}.
ja {0}は{1}桁の整数、および{2}桁の小数で入力してください。
zh_CN 请以{1}位的整数以及{2}位的小数来输入{0}。

lowercase

値がアルファベット小文字であるかを検証します。アルファベット小文字以外の文字が含まれている場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。

設定値

true または false

設定例

lowercase: true

エラーメッセージ

ロケール エラーメッセージ
en Enter alphabets and lower case characters for {0}.
ja {0}は英字かつ小文字で入力してください。
zh_CN 请在{0}中输入小写英文字母。

uppercase

値がアルファベット大文字であるかを検証します。アルファベット大文字以外の文字が含まれている場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。

設定値

true または false

設定例

uppercase: true

エラーメッセージ

ロケール エラーメッセージ
en Enter alphanumeric and upper case characters for {0}.
ja {0}は英字かつ大文字で入力してください。
zh_CN 请在{0}中输入大写英文字母。

integer

値が整数型の数字であるかを検証します。整数型の数字ではない場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。

設定値

true または false

設定例

integer: true

エラーメッセージ

ロケール エラーメッセージ
en Enter integers for {0}.
ja {0}は整数を入力してください。
zh_CN 请在{0}中输入整数。

decimal

値が実数型の数字であるかを検証します。実数型の数字ではない場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。

設定値

true または false

設定例

decimal: true

エラーメッセージ

ロケール エラーメッセージ
en Enter numeric for {0}.
ja {0}は数値を入力してください。
zh_CN 请在{0}中输入数值。

minlength

値の最小文字数を検証します。指定した長さより文字数が小さい場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。

設定値

数値

設定例

minlength: 6

エラーメッセージ

ロケール エラーメッセージ
en Enter more than {1} character for {0}.
ja {0}は{1}文字以上で入力してください。
zh_CN 请在{0}中输入{1}位以上的字符。

maxlength

値の最大文字数を検証します。指定した長さより文字数が大きい場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。

設定値

数値

設定例

maxlength: 50

エラーメッセージ

ロケール エラーメッセージ
en Enter within {1} character for {0}.
ja {0}は{1}文字以内で入力してください。
zh_CN 请输入{0}在{1}字符以内。

min

数字の最小値を検証します。設定値より値が小さい場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。

設定値

数値

設定例

min: 6

エラーメッセージ

ロケール エラーメッセージ
en Enter numeric greater than {1} for {0}.
ja {0}は{1}以上の数値で入力してください。
zh_CN 请输入{0}比{1}大的数值。

max

数字の最大値を検証します。設定値より値が大きい場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。

設定値

数値

設定例

max: 6

エラーメッセージ

ロケール エラーメッセージ
en Enter numeric less than {1} for {0}.
ja {0}は{1}以下の数値を入力してください。
zh_CN 请输入小于{1}的数值来输入{0}。

range

数字の範囲を検証します。設定値より値が大きい場合、または小さい場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。

設定値

[数値1, 数値2]

  • 数値1 - 最小値
  • 数値2 - 最大値

設定例

range: [0, 12]

エラーメッセージ

ロケール エラーメッセージ
en Enter between the range of {1} and {2} for {0}.
ja {0}は{1}から{2}までの範囲で入力してください。
zh_CN 请输入{0}在{1}到{2}的范围之间。

email

値が e-mail アドレスのフォーマットであるかを検証します。 e-mail アドレスのフォーマットではない場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。
以下のような値をe-mailアドレスとして認識します。
foo@example.com
foo.bar@baz.org
aaa@bbb.ccc
ドットが連続していたり、@の直前にドットが存在する場合は e-mail アドレスとして認識されません。
foo..bar@baz.org
foo.@bar.org

設定値

true または false

設定例

email: true

エラーメッセージ

ロケール エラーメッセージ
en Enter mail address format for {0}.
ja {0}はメールアドレス形式で入力してください。
zh_CN 请以邮件地址的形式输入{0}。

url

値が URL のフォーマットであるかを検証します。 URL のフォーマットではない場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。
URL のフォーマットの検証は RFC 7230 に準拠しています。
以下のような値は URL として認識します。
http://example.com
https://example.com
ftp://example.com
http://user:password@localhost:8080
http://localhost:8080/imart/home?p1=v1&p2=v2#fragment
http://192.168.1.109/imart/home?p1=v1&p2=v2#fragment
https://example.com:8080/%E3%83%91%E3%82%B9?p=%E5%80%A4#%E3%81%82
http://localhost:8080#%E3%81%86%E3%81%88
https://example.com/index.html;jsessionid=1234
https://xn--l8jegik.jp
以下のような値は URL として認識しません。
www.example.com
/menu/sitemap
mailto:user@example.com
file://localhost/share
https://あいうえお.jp
http://localhost/パス
http://localhost/imart#フラグメント

設定値

true または false

設定例

url: true

エラーメッセージ

ロケール エラーメッセージ
en Enter URL format for {0}.
ja {0}はURL形式で入力してください。
zh_CN 请以URL的形式输入{0}。

equals

値が設定値と同じ文字列であるかを検証します。設定値と同じ文字列ではない場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。

設定値

文字列

設定例

equals: 'foo'

エラーメッセージ

ロケール エラーメッセージ
en {0} should be equal to {1}.
ja {0}は{1}と等しくなければなりません。
zh_CN {0}必须与{1}相等。

contains

値に設定値の文字列が含まれているかを検証します。設定値の文字列が含まれていない場合はエラーとします。
パラメータが存在しないまたは値が空の場合は検証を行いません。

設定値

文字列

設定例

contains: 'foo'

エラーメッセージ

ロケール エラーメッセージ
en {0} must contain {1}.
ja {0}には{1}が含まれていなければなりません。
zh_CN {0}必须包含{1}。

isIn

値が設定値の文字列に一致するものが有るかを検証します。設定値に一致するものが無い場合はエラーとします。
パラメータが存在しない場合は検証を行いません。

設定値

[文字列1, 文字列2, ...]

設定例

isIn: ['foo', 'bar', 'baz']

エラーメッセージ

ロケール エラーメッセージ
en Enter any of [{1}] for {0}.
ja {0}には[{1}]のうちいずれかを入力してください。
zh_CN 请选择“{1}”的范围内的其中一个来输入{0}。

regex

値が正規表現に一致するかを検証します。正規表現に一致しない場合はエラーとします。
パラメータが存在しない場合は検証を行いません。

設定値

正規表現オブジェクト

設定例

regex: /^[a-zA-Z0-9]+$/

エラーメッセージ

ロケール エラーメッセージ
en Format of {0} is not correct.
ja {0}の形式が正しくありません。
zh_CN {0}的格式不正确。

file

値がファイルアップロードであるかを検証します。ファイルアップロードではない場合はエラーとします。
パラメータが存在しない場合は検証を行いません。
設定値が false の場合は検証を行いません。

このバリデーションルールを使用する場合は、送信されるフォームに必ず enctype=”multipart/form-data” を設定してください。
設定されていないフォームにこのバリデーションルールを使用するとサーバエラー(HTTPステータス 500)の画面が表示されます。

設定値

true または false

設定例

file: true

エラーメッセージ

ロケール エラーメッセージ
en {0} is not a file.
ja {0}がファイルではありません。
zh_CN {0}不是文件。

mimeType

ファイルの内容から MIME Type 判別し、設定値に記述された条件に合致しているかを検証します。条件に合致しない場合はエラーとします。
パラメータが存在しない場合は検証を行いません。

このバリデーションルールを使用する場合は、送信されるフォームに必ず enctype=”multipart/form-data” を設定してください。
設定されていないフォームにこのバリデーションルールを使用するとサーバエラー(HTTPステータス 500)の画面が表示されます。

設定値

{
include: [文字列, 文字列, ...],
exclude: [文字列, 文字列, ...]
}
  • include - 許可するMIME Type
  • exclude - 除外するMIME Type

設定例

mimeType: {
  include: ['text/html', 'application/msword'],
  exclude: ['application/octet-stream']
}

エラーメッセージ

ロケール エラーメッセージ
en {0} has file format not allowed.
ja {0}は許可されていないファイル形式です。
zh_CN {0}为未经许可的文件格式。

id

値がID、コード系であるかを検証します。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。
ID、コード系は下記の文字で構成されている必要があります。これらの文字以外が含まれている場合エラーとします。
  • 半角英字(a-z)(A-Z)
  • 半角数字(0-9)
  • アンダースコア(_)
  • ハイフン(-)
  • アットマーク(@)
  • ドット(.)
  • プラス(+)
  • エクスクラメーション(!)

設定値

true または false

設定例

id: true

エラーメッセージ

ロケール エラーメッセージ
en Enter ID format for {0}.
ja {0}はID形式で入力してください。
zh_CN 请以ID的形式来输入{0}。

id2

値が URL で利用可能な ID、コード系であるかを検証します。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。
URL 上で利用可能な ID、コード系は下記の文字で構成されている必要があります。これらの文字以外が含まれている場合エラーとします。
  • 半角英字(a-z)(A-Z)
  • 半角数字(0-9)
  • アンダースコア(_)
  • ハイフン(-)
  • アットマーク(@)
  • ドット(.)
ドット(.)は、以下の場合にエラーとします。
  • ドット(.)のみの場合
  • ドット(.)が連続する場合

注意

id2 は intra-mart Accel Platform 2020 Spring(Yorkshire) 以降で利用可能です。

設定値

true または false

設定例

id2: true

エラーメッセージ

ロケール エラーメッセージ
en Please enter {0} with URL of available ID format.
ja {0}はURLで利用可能なID形式で入力してください。
zh_CN 请以URL上可使用的ID形式输入{0}。

userCd

値がユーザコードであるかを検証します。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。
ユーザコードは下記の文字で構成されている必要があります。これらの文字以外が含まれている場合エラーとします。
  • 半角英字(a-z)(A-Z)
  • 半角数字(0-9)
  • アンダースコア(_)
  • ハイフン(-)
  • アットマーク(@)
  • ドット(.)
  • プラス(+)
  • エクスクラメーション(!)

設定値

true または false

設定例

userCd: true

エラーメッセージ

ロケール エラーメッセージ
en Enter user code format for {0}.
ja {0}はユーザコード形式で入力してください。
zh_CN 请以用户代码的形式输入{0}。

date

値がアカウントコンテキストの日時表示形式に含まれている「日付(入力)」と同じフォーマットであるかを検証します。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。
日付と時刻の形式マスタの詳細については「設定ファイルリファレンス 」を参照してください。
「日付(入力)」を示すフォーマット名は IM_DATETIME_FORMAT_DATE_INPUT です。
実際に使用される日付と時刻の形式は、アカウントコンテキストのプロパティから取得します。
アカウントコンテキストに設定されているプロパティの解決順序については、「アクセスコンテキスト仕様書」-「アカウントコンテキスト」を参照してください。

設定値

true または false

設定例

date: true

エラーメッセージ

ロケール エラーメッセージ
en {0} is not a valid date format. ({1})
ja {0}は有効な日付形式({1})ではありません。
zh_CN {0}是不是一个有效的日期格式({1})。

time

値がアカウントコンテキストの日時表示形式に含まれている「時刻(入力)」と同じフォーマットであるかを検証します。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。
日付と時刻の形式マスタの詳細については「設定ファイルリファレンス 」を参照してください。
「時刻(入力)」を示すフォーマット名は IM_DATETIME_FORMAT_TIME_INPUT です。
実際に使用される日付と時刻の形式は、アカウントコンテキストのプロパティから取得します。
アカウントコンテキストに設定されているプロパティの解決順序については、「アクセスコンテキスト仕様書」-「アカウントコンテキスト」を参照してください。

設定値

true または false

設定例

time: true

エラーメッセージ

ロケール エラーメッセージ
en {0} is not a valid time format. ({1})
ja {0}は有効な時刻形式({1})ではありません。
zh_CN {0}是不是一个有效的时间格式({1})。

datetime

値がアカウントコンテキストの日時表示形式に含まれている「日付(入力)」+半角スペース+「時刻(入力)」と同じフォーマットであるかを検証します。
パラメータが存在しないまたは値が空の場合は検証を行いません。
設定値が false の場合は検証を行いません。
日付と時刻の形式マスタの詳細については「設定ファイルリファレンス 」を参照してください。
「日付(入力)」を示すフォーマット名は IM_DATETIME_FORMAT_DATE_INPUT、「時刻(入力)」を示すフォーマット名は IM_DATETIME_FORMAT_TIME_INPUT です。
実際に使用される日付と時刻の形式は、アカウントコンテキストのプロパティから取得します。
アカウントコンテキストに設定されているプロパティの解決順序については、「アクセスコンテキスト仕様書」-「アカウントコンテキスト」を参照してください。

設定値

true または false

設定例

datetime: true

エラーメッセージ

ロケール エラーメッセージ
en {0} is not a valid date-time format. ({1})
ja {0}は有効な日時形式({1})ではありません。
zh_CN {0}是不是一个有效的日期和时间格式({1})。