概要

NocoBase では、円(Circle) を使用して円形の範囲を保存します。

円フィールドは、サービス半径、配送範囲、店舗のカバー範囲などの業務データに適しています。

範囲が円形でない場合は、ポリゴンを選択してください。中心位置だけが必要な場合は、を選択してください。

適用シーン

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

  • 店舗のサービス半径
  • 配送カバー範囲
  • デバイスの影響範囲
  • 特定の地点を中心とした検索範囲

作成時の設定

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

20240512181522

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

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

フィールドの特性

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

特性説明
デフォルトの Field interfacecircle
デフォルトの Field typecircle
選択可能な Field typecircle
ページコンポーネント編集モードでは、地図描画コンポーネントを使用します。
フィルター空間フィルター機能は、地図プラグインとデータソースの機能によって異なります。
ソート通常、ソートには使用しません。
バリデーション必須項目などの基本的なバリデーションに対応しています。

編集時の設定

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

ページ設定での使用

円フィールドは、サービス範囲やカバー範囲のシーンに適しています。 20260710145031

シーン用途
フォームブロック円形の範囲を描画します。
詳細ブロック円形の範囲を表示します。
地図ブロック地図上にカバー範囲を表示します。
ワークフロー範囲に関連するデータとして、プロセスに利用します。

関連リンク

  • フィールド — フィールドの役割、分類、マッピングロジックについて説明します
  • 通常テーブル — 通常テーブルでフィールドを作成・管理します
  • — 中心位置を保存します
  • ポリゴン — 円形でない範囲を保存します