> ## 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)を参照してください。

<Columns cols={2}>
  <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="Field Settings.png" width="720" height="1744" data-path="images/box-sign/Validation.png" />
  </Frame>
</Columns>

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

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

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

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

<h2 id="custom-regular-expression-validation">
  カスタム (正規表現) 検証
</h2>

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)を参照してください。

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

<h3 id="regex-pattern-requirements">
  正規表現パターンの要件
</h3>

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

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

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

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

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

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

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

#### 電話番号

| ユースケース           | 正規表現パターン                                                                 | 説明                                                                                              |
| ---------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
| 米国の電話番号          | <code>^(\\+1\[-.\s]?)?(\\(?\d{3}\\)?)\[-.\s]?\d{3}\[-.\s]?\d{4}\$</code> | 条件を満たしている例: \* 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>  | 条件を満たしている例: \* 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の署名リクエストまたはテンプレートでは使用できません。