テキスト入力の検証の構成
署名リクエストまたは再利用可能なテンプレート内で [テキスト入力] フィールドの検証設定を構成するには、以下の手順に従います。- リクエストまたはテンプレートに [テキスト入力] フィールドを追加します。
- フィールドの設定を構成する [テキスト入力] フィールドを選択します。
- [検証] セクションをクリックして展開します。
- 検証オプションを選択します。
- あらかじめ定義されている検証の種類: 数字、メール、日付、郵便番号、SSNなど標準的な形式から選択します。
- カスタム (正規表現): 組織固有の要件に合わせて独自の検証パターンを作成します。 設定の手順および例については、カスタム (正規表現) 検証を参照してください。
注:
- テキスト入力検証が設定されているフィールドは、読み取り専用フィールドとして構成できません。また、複数行のデータ入力には対応していません。
- あらかじめ定義されている検証はテンプレートタグでサポートされていますが、[カスタム (正規表現)] オプションはサポートされていません。 テンプレートタグの詳細については、タグを使用したテンプレートの作成を参照してください。 [カスタム (正規表現)] オプションの詳細については、以下のカスタム (正規表現) 検証を参照してください。
- テキスト入力の検証はすべて、公開APIでサポートされています。 詳細については、Box SignのAPIリファレンスを参照してください。
サポートされている検証の種類
次の表に、[テキスト入力] フィールドでサポートされているさまざまな検証を示します。| 検証オプション | 検証の要件 | 有効な入力の例 |
|---|---|---|
| なし (デフォルトのオプション) |
| 該当なし |
| 数字 |
|
|
| メール |
| |
| 日付 |
|
|
| 郵便番号 |
|
|
| SSN (社会保障番号) |
| 000-00-0000 |
| カスタム (正規表現) | 送信者が定義したカスタム正規表現パターン。 詳細については、カスタム (正規表現) 検証セクションを参照してください。 | パターンによって異なる |
カスタム (正規表現) 検証
Box Signには、標準的な検証オプション以外に、組織または地域固有の要件を満たす必要があるフィールド用に検証をカスタマイズするための [カスタム (正規表現)] オプションが用意されています。 カスタム検証では、正規表現を使用します。正規表現とは、フィールドに許容される入力の特定のパターンを表現する文字の並びのことです。注: 正規表現のカスタム検証は、公開APIでサポートされています。 詳細については、Box SignのAPIリファレンスを参照してください。
カスタム検証の設定
カスタム検証を構成するには、以下の手順に従います。- [検証] ドロップダウンメニューから [カスタム (正規表現)] を選択します。
- [正規表現パターン] フィールドに正規表現パターンを入力します。 署名者の入力が無効な場合に表示する [エラーメッセージ] を入力します。
- (推奨) フィールドに入力すべきデータを署名者に示すために、[フィールド名 (ラベル)] フィールドに入力します。
正規表現パターンの要件
カスタム正規表現パターンが正常に機能するように、以下のガイドラインに従ってください。 サポートされている文字:- Unicode文字 (
\p{L}) - Unicode数字 (
\p{N}) - 空白 (
\s) - 一般的な句読点:
- ( ) . , ' \ / @ _ : % ! ? ^ - 一般的な国際通貨記号:
$ € £ ¥ ₹ ₩ ₽ ₺ ₫ ₴ ₱
- 後方参照との一致 (
\\[1-9]) - 入れ子になった量指定子 (
++, **) - 後読み (
(?<=, (?<!) - 再帰的チェックおよび条件付きチェック (
(?R), (?&))
正規表現パターンの例
有効かつサポートされている正規表現パターンの有用な例を以下に示します。電話番号
| ユースケース | 正規表現パターン | 説明 |
|---|---|---|
| 番地 | ^[0-9A-Za-z\s.,’-]+ | 大文字のみ使用可能 |
| 小文字のみ | ^[a-z]+$ | 小文字のみ使用可能 |
英数字識別子
| ユースケース | 正規表現パターン | 説明 |
|---|---|---|
| 英数字のみ | ^[A-Za-z0-9]+ | 英字、数字、アンダースコア |
| 英数字とハイフン | ^[A-Za-z0-9-]+ | 英字、数字、アンダースコア、ハイフン |
| 接頭辞 + 数字 (例: ABC-12345) | ^[A-Za-z]{2,5}-\d{3,10}$ | 請求書番号やドキュメント番号で一般的 |
その他のよく見られるパターン
| ユースケース | 正規表現パターン | 説明 |
|---|---|---|
| 米国の電話番号 | ^(+1[-.\s]?)?((?\d)?)[-.\s]?\d[-.\s]?\d</code></td><td><p>条件を満たしている例:</p><ul><li data-list-item-id="e6a18ef1b0d0ebed5b439d40300636f89">123-456-7890</li><li data-list-item-id="eec1eb329b642343baeac5735cc4b1f39">(123) 456-7890 </li><li data-list-item-id="eb77db78776a1d296c7685ccfc7d17c22">1234567890</li><li data-list-item-id="e6f0513925f85a07e6479e9eb240190dd">+1-123-456-7890</li></ul></td></tr><tr><td>日本の電話番号</td><td><code>^(\+81[-.\s]?)?(0?\d\{1,4})[-.\s]?\d\{1,4}[-.\s]?\d{4} | 条件を満たしている例:
|
| 国際的な形式 (柔軟性が高い) | ^+?[0-9][0-9\s.-]{6,14}</code></td><td><ul><li data-list-item-id="eed2d1c171e09972239f17ce59a56a7fd">数字の間にスペース、ピリオド、ハイフンを使用可能</li><li data-list-item-id="e0e139e99064bb58223ddcb8e6250630f">7～15桁 (ITU標準の範囲)</li><li data-list-item-id="e660729b709fe1882a4e2902bb163b832">「+」は省略可</li></ul></td></tr><tr><td>国際的な形式 (E.164準拠)</td><td><code>^\+?\d\{7,15} |
|
既知の制限事項
- テキスト入力の検証は、CFR Part 11の署名リクエストまたはテンプレートでは使用できません。