ユーザーは、受信者が特定の形式、スタイル、数値範囲に基づいて入力できるデータの種類を許可または制限するよう [テキスト入力] フィールドを構成できます。 これらの検証設定は、署名リクエストを送信する際や再利用可能なテンプレートを作成、変更、利用する際に、ドキュメントの準備ページ内で構成します。Documentation Index
Fetch the complete documentation index at: https://docs.box.com/llms.txt
Use this file to discover all available pages before exploring further.
テキスト入力の検証の構成
署名リクエストまたは再利用可能なテンプレート内で [テキスト入力] フィールドの検証設定を構成するには、以下の手順に従います。- リクエストまたはテンプレートに [テキスト入力] フィールドを追加します。
- フィールドの設定を構成する [テキスト入力] フィールドを選択します。
- [検証] セクションをクリックして展開します。
- 検証オプションを選択します。
- あらかじめ定義されている検証の種類: 数字、メール、日付、郵便番号、SSNなど標準的な形式から選択します。
- カスタム (正規表現): 組織固有の要件に合わせて独自の検証パターンを作成します。 設定の手順および例については、カスタム (正規表現) 検証を参照してください。
注
- テキスト入力検証が設定されているフィールドは、読み取り専用フィールドとして構成できません。また、複数行のデータ入力には対応していません。
- あらかじめ定義されている検証はテンプレートタグでサポートされていますが、[カスタム (正規表現)] オプションはサポートされていません。 テンプレートタグの詳細については、タグを使用したテンプレートの作成を参照してください。 [カスタム (正規表現)] オプションの詳細については、以下のカスタム (正規表現) 検証を参照してください。
- テキスト入力の検証はすべて、公開APIでサポートされています。 詳細については、Box SignのAPIリファレンスを参照してください。
サポートされている検証の種類
次の表に、[テキスト入力] フィールドでサポートされているさまざまな検証を示します。| 検証オプション | 検証の要件 | 有効な入力の例 |
|---|---|---|
| なし (デフォルトのオプション) | * 検証は適用されません | 該当なし |
| 数字 | * 数字のみ (0～9) を使用できます * スペースは使用できません * 負号は使用できません * 以下の小数点の区切り記号は任意です:
* 小数点はスペースまたは改行の前後に配置できません | * 12345 * 12,345 * 12.345 |
| メール | * メールの構文: example@mail.com * 最低限、入力は@.形式に従う必要があります。この形式のはそれぞれ、任意の英数字を表します (先頭に数字を使用できないドメインは除きます)。 * 実際のメールアドレスに対する検証は行われません。 | * user@box.com * user100@box.com * user@100box.com * user@box.100.com |
| 日付 | * YYYY-MM-DD (ISO標準) (デフォルトのオプション) * MM/DD/YYYY (米国) * DD/MM/YYYY (英国、EU) * YYYY/MM/DD (日本、中国、韓国) | * 2025-05-22 * 05/22/2025 * 22/05/2025 * 2025/05/22 |
| 郵便番号 | * 郵便番号 (米国) (デフォルトのオプション) * 5桁の数値コード: ##### * 郵便番号 (ZIP+4) (米国)
* 郵便番号 (日本)
| * 12345 * 12345-6789 * 100-0001 |
| SSN (社会保障番号) | * 米国向け * 9桁の数値コード: ###-##-#### | 000-00-0000 |
| カスタム (正規表現) | 送信者が定義したカスタム正規表現パターン。 詳細については、カスタム (正規表現) 検証セクションを参照してください。 | パターンによって異なる |
カスタム (正規表現) 検証
Box Signには、標準的な検証オプション以外に、組織または地域固有の要件を満たす必要があるフィールド用に検証をカスタマイズするための [カスタム (正規表現)] オプションが用意されています。 カスタム検証では、正規表現を使用します。正規表現とは、フィールドに許容される入力の特定のパターンを表現する文字の並びのことです。注: 正規表現のカスタム検証は、公開APIでサポートされています。 詳細については、Box SignのAPIリファレンスを参照してください。
カスタム検証の設定
カスタム検証を構成するには、以下の手順に従います。- [検証] ドロップダウンメニューから [カスタム (正規表現)] を選択します。
- [正規表現パターン] フィールドに正規表現パターンを入力します。 署名者の入力が無効な場合に表示する [エラーメッセージ] を入力します。
- (推奨) フィールドに入力すべきデータを署名者に示すために、[フィールド名 (ラベル)] フィールドに入力します。
正規表現パターンの要件
カスタム正規表現パターンが正常に機能するように、以下のガイドラインに従ってください。 サポートされている文字:- Unicode文字 (
\p{L}) - Unicode数字 (
\p{N}) - 空白 (
\s) - 一般的な句読点:
- ( ) . , ' \ / @ _ : % ! ? ^ - 一般的な国際通貨記号:
$ € £ ¥ ₹ ₩ ₽ ₺ ₫ ₴ ₱
- 後方参照との一致 (
\\[1-9]) - 入れ子になった量指定子 (
++, **) - 後読み (
(?<=, (?<!) - 再帰的チェックおよび条件付きチェック (
(?R), (?&))
正規表現パターンの例
有効かつサポートされている正規表現パターンの有用な例を以下に示します。電話番号
| ユースケース | 正規表現パターン | 説明 |
|---|---|---|
| 米国の電話番号 | ^(\+1[-.\s]?)?(\(?\d\)?)[-.\s]?\d[-.\s]?\d$ | 条件を満たしている例: * 123-456-7890 * (123) 456-7890 * 1234567890 * +1-123-456-7890 |
| 日本の電話番号 | ^(\+81[-.\s]?)?(0?\d)[-.\s]?\d[-.\s]?\d$ | 条件を満たしている例: * 03-1234-5678 * 045-123-4567 * 090-1234-5678 * +81-90-1234-5678 |
| 国際的な形式 (柔軟性が高い) | ^\+?[0-9][0-9\s.\-]$ | * 数字の間にスペース、ピリオド、ハイフンを使用可能 * 7～15桁 (ITU標準の範囲) * 「+」は省略可 |
| 国際的な形式 (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]-\d$ | 請求書番号やドキュメント番号で一般的 |
その他のよく見られるパターン
| ユースケース | 正規表現パターン | 説明 |
|---|---|---|
| 番地 | ^[0-9A-Za-z\s.,’-]+$ | 数字、英字、ハイフン、ピリオド、コンマが使用可能 |
| 大文字のみ | ^[A-Z]+$ | 大文字のみ使用可能 |
| 小文字のみ | ^[a-z]+$ | 小文字のみ使用可能 |
既知の制限事項
- テキスト入力の検証は、CFR Part 11の署名リクエストまたはテンプレートでは使用できません。