> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# シリアル番号

> YiDAのシリアル番号コンポーネントについて、各エディションの対応状況、フォーム内での自動化ID生成方法、シリアル番号ルールの定義、属性設定、リセット方法、および具体的な利用シーンを詳しく解説します。

| 機能            | Freeプラン | ベーシック版 | プロフェッショナル版 | 専用版 |
| ------------- | ------- | ------ | ---------- | --- |
| シリアル番号コンポーネント | 非対応     | 対応     | 対応         | 対応  |

## 利用シーン

* 事前に設定したルールに基づき、システムが自動的にフィールドを生成してシリアル番号情報を発行するシーン。例：発注書、プロジェクト依頼書など。1つのフォームには \[シリアル番号] コントロールを1つのみ配置できます。
* フォーム設計ではコードの作成が頻繁に必要になりますが、シリアル番号フィールドを利用すれば自動化IDの生成を簡単に実現できます。例：在庫管理でシリアル番号を用いて注文番号や在庫番号を設定する、商品管理でシリアル番号フィールドを用いて商品に番号を付与するなど。

## フィールド概要

シリアル番号フィールドとは、フォーム内で固定パターンの連番を設定する機能です。ユーザーが手動で入力する必要はなく、フォームデータを送信すると連番が自動的に生成されます。

**コンポーネントのスコープ説明：**

YiDAの通常フォームおよびワークフローフォームのページタイプに適用され、各フォームで使用できるシリアル番号コンポーネントは1つのみです。カスタムページには現在対応していません。

## フィールド属性

### 一般属性

シリアル番号コンポーネントの一般属性は以下のとおりです。

* タイトル：変更可能
* 説明：カスタマイズ可能
* ステータス：通常、閲覧のみ、非表示

### シリアル番号ルール

ビジネスニーズに応じてシリアル番号の生成ルールをカスタマイズできます。シリアル番号ルールには **固定文字**、**自動カウント**、**送信日時**、**フォームフィールド** の4種類を追加でき、具体的な設定方法は以下のとおりです。

シリアル番号ルールの定義は、手動での追加、削除、並び替え、編集に対応しています。

* デフォルトルール：「自動カウント」ルールがデフォルトで提供されており、削除できません。
* 追加：「ルールを追加」ボタンをクリックし、追加するルールを選択します。「自動カウント」「送信日時」「フォームフィールド」に対応しています。
* 並び替え：ルール定義のドラッグ＆ドロップによる並び替えに対応しており、シリアル番号の表示コンテンツを並び替えできます。
* 削除：シリアル番号ルールの右側にある削除ボタンをクリックすると、「自動カウント」以外のルールを削除できます。
* 編集：該当するシリアル番号ルールをクリックし、必要に応じて設定します。

#### 自動カウント

自動カウントは、シリアル番号のプリセットデフォルトルールです。関連する属性は以下のとおりです。

* カウント桁数：デフォルトは4桁で、1から始まる増分シーケンスです。例：1、2、3…99、1000…。範囲は2〜5桁で、カウント桁数によりシリアル番号の最大値を制限できます（上限は5万インスタンスデータ）。カウント桁数の最大値に達した場合、カウントは再度開始されます。例：カウント桁数を4に設定し、カウントが9999に達すると、0からカウントが再開されます。
* 桁数固定：デフォルトでオン。クリックしてオン／オフを切り替えられます。オンの場合、固定された桁数で表示されます。例：カウント桁数が4で現在のカウントが1のとき、桁数固定がオンの場合はシリアル番号が0001と表示され、オフの場合は1と表示されます。
* リセットサイクル：シリアル番号のカウントを再開する条件を指します。デフォルトでは自動リセットに対応していませんが、日、月、または年単位でのリセットに対応しています。

<Note>
  注意：

  * リセットサイクル中にカウントが最大値に達した場合、カウントは0から再開されます。
  * 初期値がリセットされても、リセットロジックがトリガーされない限り、新たに追加されるシリアル番号は現在のルールに従って増分し続けます。手動リセットまたはリセット条件が満たされて初めてリセットがトリガーされ、新しい初期値からカウントが開始されます。
</Note>

* 初期値：カウントの開始数値、つまりカウントを何番から開始するかを指します。システムのデフォルト初期値は1です。

#### 送信日時

送信日時のフォーマットはシステムの **プリセットフォーマット** に対応しています。ドロップダウンから5種類のプリセット日付フォーマット（年、年-月、年-月-日、年-月-日-時-分、年-月-日-時-分-秒）を直接選択でき、タイムゾーン設定にも対応しています。

<Note>
  このルールはシリアル番号コンポーネント内で1つのみ設定可能であり、重複して設定することはできません。
</Note>

#### 固定文字

固定文字は、異なるビジネス向けのシリアル番号を区別するために使用できます。シリアル番号ルールに固定文字を追加し、「固定文字」の後のテキストボックスに追加する文字を手動で入力します。このルールは複数定義の追加に対応しています。

* 固定文字の主な用途は2つあります。

* 対応する特殊文字：\_ - + = /  ( ) \< > \[ ] \{ } . \~ 、# % & \* 。その他の文字は現在制限されていません。合計文字数は10文字です。

#### フォームフィールド

シリアル番号を設計する際、フォームのフィールドをシリアル番号の一部として使用したい場合があります。これはフォームフィールドを追加することで実現できます。現在対応しているフォームフィールドは、**一行テキスト、日付、数値、ドロップダウン選択、選択、日付、住所、国/地域** です。このルールは複数定義の追加に対応しています。

### シリアル番号のリセット

フォームにすでに送信済みデータがある場合、シリアル番号を手動でリセットできます。リセット後、シリアル番号は設定された初期値からカウントを再開します。

<Warning>
  注意：

  リセット後、シリアル番号は設定されたルールに従って初期値からカウントを再開するため、シリアル番号が重複する可能性があります。この設定は新規作成データのみに有効であり、操作は取り消せません。慎重に実行してください。
</Warning>

| **リセット前**<br /> | **リセット後**<br /> |
| --------------- | --------------- |

## 注意事項

* 1つのフォームに追加できるシリアル番号フィールドは1つのみです。
* 一括編集・インポートには対応していません。シリアル番号は重複する可能性があります（リセットは許可されています）。
* シリアル番号フィールドはメインテーブルにのみ追加でき、サブフォームには追加できません。
* 非表示かどうかに関わらず、シリアル番号フィールドは常にデータを送信します。
* シリアル番号は、ビジネスルールやJSによる変更に対応していません。
* Freeプランは現在シリアル番号コンポーネントに対応していません。
* シリアル番号コンポーネントの機能スコープは以下のとおりです。

| **シリアル番号コンポーネントに対応するYiDA機能モジュール** | **スコープ説明**                                                                                                                      |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **関連フォーム**                        | • 同期表示、並び替え、フィルター検索、同期更新に対応<br />• 関連フォームでのシリアル番号参照に対応<br />• 主／副情報フィールドとしての設定に対応、データ入力に対応                                      |
| **データ管理ページ**                      | • 表示、並び替え、フィルター検索に対応<br />• Excelエクスポートに対応<br />• 一括編集・インポートには現在対応しておらず、シリアル番号は重複する可能性があります（リセットは許可されています）                      |
| **フォーム設定**                        | • デフォルト値のデータ連動に対応<br />• ビジネスルールによりシリアル番号をターゲットフォームに入力可能<br />• フォーム数式検証に対応<br />• 権限フィールド設定に対応<br />• 印刷デザイナーはシリアル番号コンポーネントに対応 |
| **ワークフローデザイナー**                   | • フィールド権限の制御に対応<br />• ノード送信ルール - 検証ルール／関連アクションに対応                                                                              |
| **統合と自動化**                        | • データ作成、データ更新、単一データ取得／複数データ取得ノードがシリアル番号コンポーネントに対応。つまり、統合と自動化を通じて生成されるフォームは、シリアル番号の自動入力に対応しています<br />• コネクタパラメータ設定、メッセージ通知に対応    |
| **レポート**                          | • レポートおよびビューテーブルでの表示に対応                                                                                                         |

### レガシーシステムのシリアル番号をシリアル番号コンポーネントにアップグレード

すでにシステムシリアル番号設定が有効になっている既存フォームでは、システムシリアル番号をシリアル番号コンポーネントに置き換えることが可能で、シリアル番号の利用範囲を拡大できます。

**フォームシステムシリアル番号を同期** をクリックします。システムシリアル番号がシリアル番号コンポーネントにアップグレードされた後、統合と自動化やその他の機能スコープ内でコンポーネントを使用できます。

<Warning>
  ただし、この操作は取り消せず、現在のフォームで新たに追加されたデータのみに有効です。同時に、シリアル番号のカウントロジックは、コンポーネント設定ルールに基づいて再計算・生成されます。慎重に実行してください。
</Warning>

| **アップグレード前：フォーム設定 > システムシリアル番号**<br /><br />システムシリアル番号設定<br /><br />システムシリアル番号詳細 | **アップグレード後：フォームデザイナー > シリアル番号コンポーネント**<br /><br />システムシリアル番号アップグレード<br /><br />シリアル番号コンポーネントにアップグレード済み |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |