スペース

概要

NocoBase では、スペース(Space) を使用してデータが所属するスペースを記録します。

スペースフィールドは通常、マルチスペースプラグインを有効にした後に表示され、スペース単位でデータを分離するために使用します。一般的な業務フィールドとして自由に変更する用途には適していません。

業務上の部門、地域、プロジェクトなどの分類に使用する場合は、通常のリレーションフィールドまたは選択肢フィールドを作成することをおすすめします。

適用シーン

スペースは、次のような業務シーンに適しています。

  • マルチスペースによるデータ分離
  • スペース単位でのデータフィルタリング
  • スペース単位の権限制御
  • マルチテナント型の業務データの所属管理

作成と設定

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

index-2025-11-01-00-50-45

設定説明
Field interfaceフィールドのインターフェースタイプ。スペースでは space に対応し、ページ上での入力方法と表示方法を決定します。
Field display name画面上に表示されるフィールド名(例:「スペース」)。業務担当者が直接理解できる名称を使用することをおすすめします。
Field nameAPI、リレーションフィールド、権限、ワークフローなどで内部参照するためのフィールド識別名。作成後は通常変更せず、英字、数字、アンダースコアのみ使用でき、先頭は英字である必要があります。
Field typeデータ層におけるフィールドのタイプ。スペースフィールドは通常、スペーステーブルを参照するリレーションフィールドです。
Default valueデフォルト値。レコードの新規作成時にユーザーが入力しなかった場合、自動的にデフォルト値を設定できます。
Validation rules通常、システムまたはスペースコンテキストによって管理されます。
Descriptionフィールドの説明。フィールドの意味、入力要件、データソース、管理者などを記載するのに適しています。
注意

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

フィールドの特性

スペースフィールドのデフォルトの動作は次のとおりです。

特性説明
デフォルトの Field interfacespace
デフォルトの Field typebelongsTo
選択可能な Field typebelongsTo
ページコンポーネントシステムまたはマルチスペース機能によって管理され、ページ上では通常、読み取り専用またはスペースコンテキストに応じて使用されます。
フィルタリングスペース単位でのフィルタリングに対応します。具体的な動作はマルチスペースの設定によって異なります。
並べ替え通常、並べ替えには使用しません。
検証マルチスペース機能によって管理されます。

設定の編集

作成後、フィールド右側の「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、インポート・エクスポート、既存データに影響する可能性があります。削除前に、そのフィールドが業務設定から参照されていないか確認してください。

ページ設定での使用

スペースフィールドは、マルチスペースによるデータ分離や権限管理のシーンに適しています。

シーン用途
テーブルブロックレコードが所属するスペースを表示します。
フィルタブロックスペース単位でレコードをフィルタリングします。
権限スペース単位でデータアクセスを分離します。
ワークフローレコードが所属するスペースをコンテキストとして読み取ります。

関連リンク