許容文字種で指定した文字のみで構成されるかチェックすることができます。例えばカタカナと空白以外は入力エラーとする、といった設定を行うことができます。

「顧客カナ」項目に入力できる文字種(許容文字種)として、全角カナとスペースを指定しました。

図1 全角カナとスペースは入力できる

許容文字種以外(例:ひらがな)を入力するとエラーになります。

図2 入力エラー
許容文字種のチェックはリアルタイムでは行われません。保存ボタン押下後にサーバ側でチェックされます。

モデル項目の詳細定義「入力チェック」で、許容する文字種に「○」を設定します。
一つでも「○」を設定した場合、それ以外の文字種は入力エラーになります。

図3 許容文字種の設定

数値型項目では、自動的に「半角全角文字(負数は許容)」が「○」になります。
日付型項目では「日付型(yyyy-MM-d,yyyy-MM形式または和暦形式)」が「○」になります。

メールアドレス(「@」はなくてもよい)

入力値にメールアドレス形式の文字列が含まれているかをチェックします。「@」はなくてもよいと判断します。

日付型

次のいずれかの書式で表現された日付かどうかをチェックします。ここで yyyyは年(4桁)、MM は月(2桁)、dd は日(2桁)をそれぞれ表します。

  • yyyy/MM/dd
  • yyyy-MM-dd
  • yyyy.MM.dd
  • yyyyMMdd
  • yyyy/MM
  • yyyy-MM
  • yyyy.MM
  • yyyyMM
  • yyyy年MM月dd日
  • yyyy年MM月
  • yyyy年
  • yyyy

日付型(yyyy-MM-dd)

次のいずれかの書式で表現された日付かどうかをチェックします。ここで yyyyは年(4桁)、MM は月(2桁)、dd は日(2桁)をそれぞれ表します。

  • yyyy-MM-dd
  • yyyy/MM/dd
  • yyyyMMdd

日付型(yyyy-MM)

次のいずれかの書式で表現された日付かどうかをチェックします。ここで yyyyは年(4桁)、MM は月(2桁)、dd は日(2桁)をそれぞれ表します。

  • yyyy-MM
  • yyyy/MM
  • yyyyMM

数字-半角全角文字(負数は許容)

入力値が半角文字または全角文字の数字かどうかをチェックします。数字の前にマイナス符号が含まれる場合も、数値として認めます。

数字-半角文字(負数は許容しない)

入力値が半角文字の数字かどうかをチェックします。数字の前にマイナス符号は含まれないものとして扱います。

数字-全角文字(負数は許容しない)

入力値が全角文字の数字かどうかをチェックします。数字の前にマイナス符号は含まれないものとして扱います。

アルファベット-半角全角文字(大文字、小文字を含む)

入力値に半角全角文字のアルファベット(大文字、小文字を含む)が含まれているかをチェックします。

アルファベット-半角文字(大文字、小文字を含む)

入力値に半角文字のアルファベット(大文字、小文字を含む)が含まれているかをチェックします。

アルファベット-半角文字(大文字のみ)

入力値に半角文字のアルファベット(大文字のみ)が含まれているかをチェックします。

アルファベット-半角文字(小文字のみ)

入力値に半角文字のアルファベット(小文字のみ)が含まれているかをチェックします。

アルファベット-全角文字(大文字、小文字を含む)

入力値に全角文字のアルファベット(大文字、小文字を含む)が含まれているかをチェックします。

アルファベット-全角文字(大文字のみ)

入力値に全角文字のアルファベット(大文字のみ)が含まれているかをチェックします。

アルファベット-全角文字(小文字のみ)

入力値に全角文字のアルファベット(小文字のみ)が含まれているかをチェックします。

ひらがな

入力値に平仮名が含まれているかをチェックします。

カタカナ-半角全角文字

入力値に全角あるいは半角のカタカナが含まれているかをチェックします。

カタカナ-半角文字

入力値に半角のカタカナが含まれているかをチェックします。

カタカナ-全角文字

入力値に全角のカタカナが含まれているかをチェックします。

記号-半角全角文字

入力値に全角あるいは半角の記号が含まれているかをチェックします。ここで「記号」とは以下に示す文字をいいます。

! # $ % & \ ( ) ^
~ [ ] . { } ; : + * ?
_ / -

記号-半角文字

入力値に半角文字の記号が含まれているかをチェックします。

記号-全角文字

入力値に全角文字の記号が含まれているかをチェックします。

スペース

入力値に全角または半角スペースが含まれているかをチェックします。

警告を表示しますが、ここで保存ボタンを押下すると登録自体は妨げないという例を図4に示します。

図4 警告の表示

定義方法

許容文字種の設定で、「○」の代わりに「警告」を設定します。

図5 最大文字数の指定
複数の許容文字種を設定する場合、「○」と「警告」を混在させることはできません。いずれかに統一してください。

許容文字種の必要最低文字数を指定することができます。

図6 最低文字数制限エラー

定義方法

モデル項目の詳細定義にて「入力チェック-文字数チェック」に数値を設定します。 指定しない場合は文字数の制限はかかりません。

図7 必要最小文字数を同時に指定する

許容文字種を指定した場合は、自動的に「文字列(最小)」フィルタが適用されます。

ただし "許容文字種が設定されていても入力フィルタの手動設定を行う" を有効にすると、個別に入力フィルタを指定することができます。

図8 必要最小文字数を同時に指定する

業務仕様によっては、フィルタを手動で変更した方がよい場合があります。

[注意] 許容文字種を設定しているとき、入力フィルタとの組み合わせは動作しないパターンがあります。例えば許容文字種を半角カナとし、入力フィルタを文字列一般とすることはできません。文字列一般フィルタは常に半角カナを全角カナに変換する仕様のため、利用者は絶対に保存できなくなってしまいます。

許容文字として、任意の文字を指定することができます。例えば次のような文字を入力させたいという要件を想定します。

  • 半角英数
  • 半角記号
  • 半角スペース
  • "£" と "€"

次のように「任意の文字」の欄に、許容したい文字を直接、指定します。

図9 任意の文字を指定する
スペースやコンマ、改行などは不要です。複数の文字を連続して指定してください。

実行例

許容できる文字でなければ、入力エラーになります。

図10 入力エラー画面の例
  • このチェックは「保存」などのボタンを押下したタイミングで、サーバ側で行われます。リアルタイムチェックではありません。
  • エラーとなった入力項目は、背景が赤となります。テキスト入力部または日付時刻リストボックスが対象です。
  • 入力対象ではない項目に対する許容文字種チェックを行うことはできません。具体的には計算式で求められる項目や、読み込み専用項目、参照連動項目です。
  • 一覧更新画面(親子モデルにおける、子モデル同時更新画面も含む)では、警告指定は動作しません。
Wagby Developer Day 2018