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