項目拡張手順(Docker利用)
以下は、[Docker Hubで公開されているプリザンターの公式Dockerイメージ](https://hub.docker.com/r/implem/pleasanter)を利用する手順です。
## 概要
Enterprise Editionを利用中の環境において、プリザンターで使用できる項目数を拡張・拡張した項目数を変更する手順です。
Community Editionでは[分類項目](/ja/manual/table-management-class)、[数値項目](/ja/manual/table-management-num)、[日付項目](/ja/manual/table-management-date)、[説明項目](/ja/manual/table-management-description)、[チェック項目](/ja/manual/table-management-check)、[添付ファイル項目](/ja/manual/table-management-attachments)の各項目ごとに26個、最大156個の項目を利用できます。
**Enterprise Editionではこの項目数を拡張できます**。
| DB | Enterprise Editionで利用できる項目の上限数 |備考|
| ---- | ---- | ---- |
| PostgreSQL | 6つの項目種別の合計で最大900個まで ||
| MySQL | 6つの項目種別の合計で最大256個まで |プリザンター1.4.9.0以降で使用可能|
拡張した項目の名前には、分類001、分類002、…のように"001"からの連番が添えられます。Community Editionのアルファベットが添えられた項目もそのまま使用できます。
## 注意事項
1. 項目拡張を行うと期限付きテーブル(Issuesテーブル)、記録テーブル(Resultsテーブル)のテーブル構造を変更します。特に項目数を削減する場合にはテーブルから項目そのものを削除するため、項目拡張で増やした項目に登録したデータが消滅します。項目拡張を行う前には必ずバックアップを取得してください。
1. ver1.4.5以前で実行する場合はCodeDefinerのコマンドが変更されているため、以下ページを参照してください。
[ver1.4.6以降で初回インストール時のCodeDefinerの手順について](https://pleasanter.org/ja/manual/codedefiner-changed-steps)
1. 本ページの手順は、プリザンターをすぐに試したいユーザのために、PostgreSQLコンテナをプリザンターと同一のDocker構成に含めた複数コンテナ構成を採用しています。この構成は**本番運用を想定したものではありません**。
1. 本番運用では、データベースコンテナが性能上のボトルネックになります。 **別ホスト上のデータベース** とすることを強く推奨します。
## 前提条件
1. 本手順はEnterprise Editionにアップグレード済みであることを前提とします。
## 操作手順
1. コンテナの停止
1. データベースのバックアップ
1. Issues.jsonおよびResults.jsonの編集、格納
1. コンテナイメージのビルド
1. CodeDefinerの実行
1. 項目拡張の確認
## 操作手順
### 1. コンテナの停止
1. 以下のコマンドを実行してください。起動中のコンテナを停止します。
```
docker compose down
```
### 2. データベースのバックアップ
利用中の環境に応じてデータベースのバックアップを作成してください。
・[FAQ:PostgreSQL データベース バックアップ・リストア手順(Docker利用)](/ja/manual/faq-postgresql-backup-restore-docker)
・[FAQ:MySQL データベース バックアップ・リストア手順(Docker利用)](/ja/manual/faq-mysql-backup-restore-docker)
### 3. Issues.jsonおよびResults.jsonの編集、格納
1. [ダウンロードセンター](https://pleasanter.org/dlcenter)から、起動するプリザンターと同一バージョンのモジュールをダウンロードしてください。
1. ダウンロードしたzipファイルを解凍してください。
1. 解凍したフォルダからDocker用資源の配置先フォルダに以下のフォルダをコピーしてください。
・コピーするフォルダ:\pleasanter\Implem.Pleasanter\App_Data\Parameters\ExtendedColumns フォルダをコピー
・コピー先:\app_data_parameters フォルダ内に配置し、\app_data_parameters\ExtendedColumns フォルダを作成
```text
📁\pleasanter
+-- 📁app_data_parameters
| +-- 📁ExtendedColumns ←貼り付け
| |
| +-- 📄パラメータファイル
|
+-- 📁license
| +-- 📄Implem.License.dll
|-- 📄.env
|-- 📄compose.yaml
```
なお、すでにコピー済み(2回目以降の項目拡張・削減)の場合、上記1.~3.を実施する必要はありません。
1. コピー先のExtendedColumnsフォルダ内にあるIssues.jsonおよびResults.jsonを編集してください。
```
📁\pleasanter
+-- 📁app_data_parameters
| +-- 📁ExtendedColumns
| | + 📄Issues.json ←編集
| | + 📄Results.json ←編集
| |
| +-- 📄パラメータファイル
|
+-- 📁license
| +-- 📄Implem.License.dll
|-- 📄.env
|-- 📄compose.yaml
```
##### Issues.json:期限付きテーブル
```json
{
"TableName": "Issues",
"ReferenceType": "Issues",
"Class": 0,
"Num": 0,
"Date": 0,
"Description": 0,
"Check": 0,
"Attachments": 0
}
```
##### Results.json:記録テーブル
```json
{
"TableName": "Results",
"ReferenceType": "Results",
"Class": 0,
"Num": 0,
"Date": 0,
"Description": 0,
"Check": 0,
"Attachments": 0
}
```
##### 設定内容
|項目|内容|
|:----|:----|
|Class|分類項目に追加する項目数|
|Num|数値項目に追加する項目数|
|Date|日付項目に追加する項目数|
|Description|説明項目に追加する項目数|
|Check|チェック項目に追加する項目数|
|Attachments|添付ファイル項目に追加する項目数|
### 4. CodeDefinerの実行
1. CodeDefinerを以下のように実行してください。Dockerイメージを使用する場合に限り、バージョンアップ時のコマンドに /l、/zの引数設定が必要です。
```bash
docker compose run --rm codedefiner _rds /l "<言語>" /z "<タイムゾーン>"
```
|引数|設定例|説明|
|:--|:--|:--|
|/l|ja|[Service.json](/ja/manual/service-json)のDefaultLanguageの値を書き換えます(※1)|
|/z|Asia/Tokyo|[Service.json](/ja/manual/service-json)のTimeZoneDefaultの値を書き換えます(※1)|
言語とタイムゾーンの詳細は、以下のマニュアルページを参照してください。
[FAQ:プリザンターでサポートしている言語とタイムゾーンのパラメータの設定値を知りたい](https://pleasanter.org/manual/faq-supported-language)
日本語環境で利用する場合は、以下のコマンドとなります。
```bash
docker compose run --rm codedefiner _rds /l "ja" /z "Asia/Tokyo"
```
1. 途中で 「Type "y" (yes) if the license is correct, otherwise type "n" (no).」 と表示されたら **y** を入力してください。
バージョン1.4.8以降では、[Enterprise Edition](/ja/manual/enterprise-edition-restriction-database)である旨のメッセージが表示されます。ライセンス情報の表示は、利用するCLIによって文字化けする可能性があります。

#### Configurator.CheckColumnsShrinkage: The columns will be shrinked.と表示された場合
バージョン1.4.8以降では、CodeDefiner実行時に項目数の削減が起こる場合、エラーメッセージ「Configurator.CheckColumnsShrinkage: The columns will be shrinked.」が表示されて終了し、CodeDefinerは実行されません。
当該エラーメッセージが表示された場合は、下図のように削減する項目が表示されます。パラメータファイルおよびライセンスが正しく適用されているか再度確認してください。

バージョン1.4.8以降で項目数の削減を許容する場合は、引数「/f」を指定して、CodeDefinerを実行してください。
```bash
docker compose run --rm codedefiner _rds /l "ja" /z "Asia/Tokyo" /f
```
### 5. コンテナの再作成と再起動
以下のコマンドを実行してください。項目が追加されたコンテナの再作成と再起動を行います。
```
docker compose up -d pleasanter
```
### 6. 項目拡張の確認
1. ブラウザで次のURLを開き、プリザンターへログインしてください。
```text
http://localhost:50001
```
1. 以下を確認してください。
1. 任意のテーブルを開き、ナビゲーションメニューの「管理」-[テーブルの管理](/ja/manual/table-management)の[エディタ](/ja/manual/table-editor)タブにて、[選択肢一覧](/ja/manual/table-management-choices-text)に拡張した項目(分類001、数値001など)が表示されること
1. 拡張した項目を設定したテーブルの「レコードの編集画面」を開き、項目がすべて表示していること
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/service-json">パラメータ設定:Service.json</a><span>2026/06/09 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-editor">テーブル機能:レコードのエディタ画面</a><span>2023/04/12 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management">テーブルの管理</a><span>2025/12/09 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-class">テーブルの管理:項目:分類</a><span>2025/12/09 up</span></li>
<li><a href="/ja/manual/table-management-num">テーブルの管理:項目:数値</a><span>2025/12/09 up</span></li>
<li><a href="/ja/manual/table-management-date">テーブルの管理:項目:日付</a><span>2025/12/09 up</span></li>
<li><a href="/ja/manual/table-management-description">テーブルの管理:項目:説明</a><span>2025/12/09 up</span></li>
<li><a href="/ja/manual/table-management-check">テーブルの管理:項目:チェック</a><span>2025/12/09 up</span></li>
<li><a href="/ja/manual/table-management-attachments">テーブルの管理:項目:添付ファイル</a><span>2025/12/09 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-editor">テーブルの管理:エディタ</a><span>2026/02/10 up</span></li>
<li><a href="/ja/manual/table-management-editor-columns">テーブルの管理:エディタ:エディタの設定</a><span>2026/04/27 up</span></li>
<li><a href="/ja/manual/table-management-choices-text">テーブルの管理:エディタ:項目の詳細設定:選択肢一覧</a><span>2025/11/27 up</span></li>
<li><a href="/ja/manual/table-management-choices-text-depts">テーブルの管理:エディタ:項目の詳細設定:選択肢一覧:組織</a><span>2023/04/25 up</span></li>
<li><a href="/ja/manual/table-management-choices-text-groups">テーブルの管理:エディタ:項目の詳細設定:選択肢一覧:グループ</a><span>2023/04/25 up</span></li>
<li><a href="/ja/manual/table-management-choices-text-users">テーブルの管理:エディタ:項目の詳細設定:選択肢一覧:ユーザ</a><span>2023/04/25 up</span></li></ul></article>
<ul><li><a href="/ja/manual/enterprise-edition-restriction-database">データベースによる制限事項</a><span>2025/02/14 up</span></li></ul></article>
<ul><li><a href="/ja/manual/enterprise-edition-upgrade">Community EditionからEnterprise Editionへのアップグレード手順</a><span>2026/06/10 up</span></li>
<li><a href="/ja/manual/enterprise-edition-upgrade-docker">Community EditionからEnterprise Editionへのアップグレード手順(Docker利用)</a><span>2026/07/17 up</span></li></ul></article>
<ul><li><a href="/ja/manual/enterprise-edition-renew-license">ライセンス更新手順</a><span>2025/02/14 up</span></li>
<li><a href="/ja/manual/enterprise-edition-renew-license-docker">ライセンス更新手順(Docker利用)</a><span>2026/07/17 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />



