> ## 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.

# テキスト入力の検証の使用

<div className="article_labels_list" style={{display: 'none'}} dangerouslySetInnerHTML={{__html: "has_image , End User , Box Sign , Overview , Article , Product Utilization , Established"}} />

ユーザーは、受信者が特定の形式、スタイル、数値範囲に基づいて入力できるデータの種類を許可または制限するよう \[**テキスト入力**] フィールドを構成できます。 これらの検証設定は、署名リクエストを送信する際や再利用可能なテンプレートを作成、変更、利用する際に、ドキュメントの準備ページ内で構成します。

## テキスト入力の検証の構成

署名リクエストまたは再利用可能なテンプレート内で \[**テキスト入力**] フィールドの検証設定を構成するには、以下の手順に従います。

1. リクエストまたはテンプレートに \[**テキスト入力**] フィールドを追加します。
2. フィールドの設定を構成する \[**テキスト入力**] フィールドを選択します。
3. \[**検証**] セクションをクリックして展開します。
4. 検証オプションを選択します。
   * **あらかじめ定義されている検証の種類**: 数字、メール、日付、郵便番号、SSNなど標準的な形式から選択します。
   * **カスタム (正規表現)**: 組織固有の要件に合わせて独自の検証パターンを作成します。 設定の手順および例については、[カスタム (正規表現) 検証](#custom-regular-expression-validation)を参照してください。

<Frame>
  <img src="https://mintcdn.com/product-docs/kY6O1CxZeJPunHf3/images/box-sign/Field-Settings.png?fit=max&auto=format&n=kY6O1CxZeJPunHf3&q=85&s=be1c94d94384d145ac8b61fc672ec32f" alt="Field Settings.png" width="1440" height="3344" data-path="images/box-sign/Field-Settings.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/product-docs/kY6O1CxZeJPunHf3/images/box-sign/Validation.png?fit=max&auto=format&n=kY6O1CxZeJPunHf3&q=85&s=d7b7c2d052d525bc9f94ebd75f301316" alt="Validation.png" width="720" height="1744" data-path="images/box-sign/Validation.png" />
</Frame>

<Note>
  * テキスト入力検証が設定されているフィールドは、読み取り専用フィールドとして構成できません。また、複数行のデータ入力には対応していません。
  * あらかじめ定義されている検証はテンプレートタグでサポートされていますが、\[カスタム (正規表現)] オプションはサポートされていません。 テンプレートタグの詳細については、[タグを使用したテンプレートの作成](/ja/box-sign/templates/creating-templates-using-tags)を参照してください。 \[カスタム (正規表現)] オプションの詳細については、以下の[カスタム (正規表現) 検証](#custom-regular-expression-validation)を参照してください。
  * テキスト入力の検証はすべて、公開APIでサポートされています。 詳細については、[Box SignのAPIリファレンス](https://developer.box.com/ja/reference/resources/sign-request/)を参照してください。
</Note>

## サポートされている検証の種類

次の表に、\[**テキスト入力**] フィールドでサポートされているさまざまな検証を示します。

| <strong>検証オプション</strong> | <strong>検証の要件</strong> | <strong>有効な入力の例</strong> |
| - | - | - |
| なし (デフォルトのオプション) | • 検証は適用されません | 該当なし |
| 数値 | • 数字のみ (0～9) を使用できます<br />• スペースは使用できません<br />• 負号は使用できません<br />• 以下の小数点の区切り記号は任意です:<br />  • ピリオド (.)<br />  • コンマ (,)<br />• 小数点はスペースまたは改行の前後に配置できません | • 12345<br />• 12,345<br />• 12.345 |
| メール | • メールの構文: [example@mail.com](mailto:example@mail.com)<br />• 最低限、入力は<em>*@*</em>.*形式に従う必要があります。この形式の*はそれぞれ、任意の英数字を表します (先頭に数字を使用できないドメインは除きます)。<br />• 実際のメールアドレスに対する検証は行われません。 | • [user@box.com](mailto:user@box.com)<br />• [user100@box.com](mailto:user100@box.com)<br />• [user@100box.com](mailto:user@100box.com)<br />• [user@box.100.com](mailto:user@box.100.com) |
| 日付 | • YYYY-MM-DD (ISO標準) (デフォルトのオプション)<br />• MM/DD/YYYY (米国)<br />• DD/MM/YYYY (英国、EU)<br />• YYYY/MM/DD (日本、中国、韓国) | • 2025-05-22<br />• 05/22/2025<br />• 22/05/2025<br />• 2025/05/22 |
| 郵便番号 | • 郵便番号 (米国) (デフォルトのオプション)<br />• 5桁の数値コード: #####<br />• 郵便番号 (ZIP+4) (米国)<br />  • 9桁の数値コード: #####-####<br />• 郵便番号 (日本)<br />  • 7桁の数値コード: ###-#### | • 12345<br />• 12345-6789<br />• 100-0001 |
| SSN (社会保障番号) | • 米国向け<br />• 9桁の数値コード: ###-##-#### | 000-00-0000 |
| カスタム (正規表現) | 送信者が定義したカスタム正規表現パターン。 詳細については、<a href="#custom-regular-expression-validation">カスタム (正規表現) 検証</a> セクションを参照してください。 | パターンによって異なる |

## カスタム (正規表現) 検証

Box Signには、標準的な検証オプション以外に、組織または地域固有の要件を満たす必要があるフィールド用に検証をカスタマイズするための \[**カスタム (正規表現)**] オプションが用意されています。

カスタム検証では、**正規表現**を使用します。正規表現とは、フィールドに許容される入力の特定のパターンを表現する文字の並びのことです。

<Note>
  正規表現のカスタム検証は、公開APIでサポートされています。 詳細については、[Box SignのAPIリファレンス](https://developer.box.com/ja/reference/resources/sign-request/)を参照してください。
</Note>

### カスタム検証の設定

カスタム検証を構成するには、以下の手順に従います。

1. \[**検証**] ドロップダウンメニューから \[**カスタム (正規表現)**] を選択します。
2. \[**正規表現パターン**] フィールドに正規表現パターンを入力します。 署名者の入力が無効な場合に表示する \[**エラーメッセージ**] を入力します。
3. (推奨) フィールドに入力すべきデータを署名者に示すために、\[**フィールド名 (ラベル)**] フィールドに入力します。

<Frame>
  <img src="https://mintcdn.com/product-docs/kY6O1CxZeJPunHf3/images/box-sign/Regex.png?fit=max&auto=format&n=kY6O1CxZeJPunHf3&q=85&s=50d191bad67243e07175ab3066079020" alt="Regex.png" width="720" height="1744" data-path="images/box-sign/Regex.png" />
</Frame>

正規表現パターンで使用されている形式が有効かつサポートされていることを確認してください。 無効またはサポートされていない場合、フィールドに検証を適用できません。 正規表現パターンが無効な場合は「無効なパターンです」、正規表現パターンがBox Signのガイドラインでサポートされていない場合は「サポートされていないパターンです」という２つの入力エラーが表示される可能性があります。 サポートされている構文および制限事項については、[正規表現パターンの要件](#regex-pattern-requirements)を参照してください。

署名者がデータを入力すると、システムによってそのデータがパターンと照合されます。 入力が一致しない場合は、定義したエラーメッセージがフィールドに表示されます。

### 正規表現パターンの要件

カスタム正規表現パターンが正常に機能するように、以下のガイドラインに従ってください。

**サポートされている文字:**

* Unicode文字 (`\p{L}`)
* Unicode数字 (`\p{N}`)
* 空白 (`\s`)
* 一般的な句読点: `- ( ) . , ' \ / @ _ : % ! ? ^`
* 一般的な国際通貨記号: `$ € £ ¥ ₹ ₩ ₽ ₺ ₫ ₴ ₱`

**Box Signでサポートされていない正規表現パターン:**

* 後方参照との一致 (`\\[1-9]`)
* 入れ子になった量指定子 (`++, **`)
* 後読み (`(?<=, (?<!`)
* 再帰的チェックおよび条件付きチェック (`(?R), (?&)`)

### 正規表現パターンの例

有効かつサポートされている正規表現パターンの有用な例を以下に示します。

#### 電話番号

| ユースケース | 正規表現パターン | 説明 |
| - | - | - |
| 米国の電話番号 | <code>^(\\+1\[-.\s]?)?(\\(?\d\{3}\\)?)\[-.\s]?\d\{3}\[-.\s]?\d\{4}\$</code> | 条件を満たしている例:<br /><br />• 123-456-7890<br />• (123) 456-7890<br />• 1234567890<br />• +1-123-456-7890 |
| 日本の電話番号 | <code>^(\\+81\[-.\s]?)?(0?\d\{1,4})\[-.\s]?\d\{1,4}\[-.\s]?\d\{4}\$</code> | 条件を満たしている例:<br /><br />• 03-1234-5678<br />• 045-123-4567<br />• 090-1234-5678<br />• +81-90-1234-5678 |
| 国際的な形式 (柔軟性が高い) | <code>^\\+?\[0-9]\[0-9\s.\\-]\{6,14}\$</code> | • 数字の間にスペース、ピリオド、ハイフンを使用可能<br />• 7～15桁 (ITU標準の範囲)<br />• 「+」は省略可 |
| 国際的な形式 (E.164準拠) | <code>^\\+?\d\{7,15}\$</code> | • スペースまたは特殊文字は使用不可<br />• 7～15桁を使用可能<br />• 「+」は省略可 |

#### 英数字識別子

| ユースケース | 正規表現パターン | 説明 |
| - | - | - |
| 英数字のみ | <code>^\[A-Za-z0-9]+\$</code> | 英字と数字のみ、長さの制限なし |
| 英数字とアンダースコア | <code>^\[A-Za-z0-9\_]+\$</code> | 英字、数字、アンダースコア |
| 英数字とハイフン | <code>^\[A-Za-z0-9-]+\$</code> | 英字、数字、ハイフン (契約書ID、追跡番号で一般的) |
| 英数字とアンダースコアおよびハイフン | <code>^\[A-Za-z0-9\_-]+\$</code> | 英字、数字、アンダースコア、ハイフン |
| 接頭辞 + 数字 (例: ABC-12345) | <code>^\[A-Za-z]\{2,5}-\d\{3,10}\$</code> | 請求書番号やドキュメント番号で一般的 |

#### その他のよく見られるパターン

| ユースケース | 正規表現パターン | 説明 |
| - | - | - |
| 番地 | ^\[0-9A-Za-z\s.,'-]+\$ | 数字、英字、ハイフン、ピリオド、コンマが使用可能 |
| 大文字のみ | ^\[A-Z]+\$ | 大文字のみ使用可能 |
| 小文字のみ | ^\[a-z]+\$ | 小文字のみ使用可能 |

## 既知の制限事項

* テキスト入力の検証は、CFR Part 11の署名リクエストまたはテンプレートでは使用できません。
