パーセンテージ

はじめに

NocoBase では、パーセンテージ（Percent） を使用して割合データを保存・表示できます。

パーセンテージフィールドは、完了率、割引率、コンバージョン率、構成比などの業務データに適しています。本質的には数値フィールドですが、画面上での表示や入力がパーセンテージの意味に適した形式になっています。

通常の金額、数量、評価などを扱う場合は、数値のほうが適しています。

適用シーン

パーセンテージは、次のような業務シーンに適しています。

プロジェクトの完了率、タスクの進捗率
割引率、税率、手数料率
コンバージョン率、達成率、構成比
評価の重み付け、按分比率

作成時の設定

データテーブルの「Configure fields」ページで「Add field」をクリックし、「パーセンテージ」を選択すると、パーセンテージフィールドを作成できます。

20240512175847

設定	説明
Field interface	フィールドのインターフェースタイプ。パーセンテージは `percent` に対応し、画面上での入力方法と表示方法を決定します。
Field display name	画面上に表示されるフィールド名。「完了率」「割引率」「コンバージョン率」などが該当します。業務担当者がすぐに理解できる名称を使用することをおすすめします。
Field name	API、リレーションフィールド、権限、ワークフローなどで内部参照するためのフィールド識別名です。作成後は通常変更せず、英字、数字、アンダースコアのみ使用でき、先頭は英字である必要があります。
Field type	データ層におけるフィールドのタイプです。パーセンテージフィールドでは通常 `double` を使用しますが、精度の要件に応じて `decimal` を選択することもできます。
Default value	デフォルト値。レコードの新規作成時にユーザーが入力しなかった場合、自動的にデフォルト値が入力されます。
Validation rules	バリデーションルール。最小値、最大値、必須入力かどうかなどを制限できます。
Description	フィールドの説明。フィールドの意味、入力要件、データソース、管理担当者などを記載するのに適しています。

注意

フィールド名は、作成後にページブロック、権限、ワークフロー、API から参照されます。作成前に命名を確認し、後からの変更による設定調整の負担を避けてください。

フィールドの特性

パーセンテージフィールドのデフォルト動作は次のとおりです。

特性	説明
デフォルトの Field interface	`percent`。
デフォルトの Field type	`double`。
選択可能な Field type	`float`、`double`、`decimal`。
ページコンポーネント	編集モードではパーセンテージ入力コンポーネントを使用します。
フィルター	数値フィルターに対応しており、より大きい、より小さい、範囲、空、空でないなどの条件を指定できます。
並べ替え	テーブルブロックでの並べ替えに対応しています。
バリデーション	数値範囲、必須入力などのバリデーションに対応しています。

設定の編集

作成後、フィールド右側の「Edit」をクリックすると、パーセンテージフィールドの設定を編集できます。フィールドの編集は、NocoBase におけるフィールドの表示方法や使用方法を調整するために行います。たとえば、表示名、説明、デフォルト値、バリデーションルール、フィールド固有の設定などを変更できます。

フィールドがメインデータベースですでに同期されているテーブルに由来する場合、編集時には通常、フィールドマッピングを行います。つまり、データベースのフィールドを NocoBase の Field type と Field interface にマッピングします。

設定	編集可否	説明
Field display name	はい	画面上のフィールド表示名を変更します。フィールド識別名は変更されません。
Field name	いいえ	フィールド識別名は、作成後、通常は編集フォームから変更できません。
Field interface	条件付きで可	メインデータベースのフィールドまたは同期フィールドは、フィールドマッピング時に調整できます。変更すると、ページ上での入力、表示、バリデーションの方法に影響します。
Field type	条件付きで可	メインデータベースのフィールドまたは同期フィールドは、フィールドマッピング時に調整できます。変更前に、既存データを新しいタイプで利用できるか確認する必要があります。
Default value	はい	レコード新規作成時のデフォルト値を調整します。
Validation rules	はい	フィールドのバリデーションルールを調整します。
Description	はい	フィールドの意味、入力要件、データソース、管理担当者などを補足します。

注意

Field type や Field interface の切り替えは、単に表示名を変更するだけではありません。フィールドの保存方法、入力コンポーネント、バリデーションルール、フィルター条件、ワークフロー変数の使用方法に影響します。既存データが多い場合は、データ形式が適合するか事前に確認してください。

フィールドの削除

フィールド右側の「Delete」をクリックすると、パーセンテージフィールドを削除できます。メインデータベースでは、複数のフィールドを選択して一括削除することもできます。

メインデータベースで新規作成したパーセンテージフィールドを削除すると、通常はデータベース内の実際の列と、その列に保存されている既存データも同時に削除されます。データベースから同期したフィールドや外部データソースからマッピングしたフィールドを削除する場合の影響範囲は、対応するデータソースとフィールドの種類によって異なります。

警告

フィールドを削除すると、ページブロック、フォーム、フィルター、権限、ワークフロー、API、インポート・エクスポート、既存データに影響する可能性があります。削除前に、そのフィールドが業務設定で引き続き参照されていないか確認してください。

ページ設定での使用

パーセンテージフィールドは、業務フォーム、ダッシュボード、グラフ、レポートで割合を表すのに適しています。 20260709225150

シーン	用途
フォームブロック	完了率、割引率、税率などの割合を入力します。
テーブルブロック	割合データを表示、並べ替え、フィルタリングします。
グラフブロック	構成比、コンバージョン率などの指標を表示します。
ワークフローと権限	条件フィールドとして判定に使用します。たとえば、完了率が 100% に達しているかどうかを判定できます。

#パーセンテージ

#はじめに

#適用シーン

#作成時の設定

#フィールドの特性

#設定の編集

#フィールドの削除

#ページ設定での使用

#関連リンク