添付ファイル URL

概要

NocoBase では、添付ファイル URL(Attachment URL) を使用して外部ファイルへのアクセス先を保存します。

添付ファイル URL フィールドは、ファイルがすでに外部システム、オブジェクトストレージ、または CDN に保存されており、NocoBase にはアクセス先だけを保存すればよい場合に適しています。

NocoBase でファイルをアップロードして管理する場合は、添付ファイルを選択してください。通常の Web ページアドレスの場合は、URLを選択してください。

適用シーン

添付ファイル URL は、次のような業務シーンに適しています。

  • 外部オブジェクトストレージのファイルアドレス
  • CDN 画像のアドレス
  • サードパーティシステムのドキュメントアドレス
  • 履歴データ移行後のファイルリンク

作成と設定

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

20241017092323

20241017092456

20241017092759

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

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

フィールドの特性

添付ファイル URL フィールドのデフォルトの動作は次のとおりです。

特性説明
デフォルトの Field interfaceattachmentUrl
デフォルトの Field typestring
選択可能な Field typestringtext。実際のフィールド設定に準じます。
ページコンポーネント編集モードでは、URL または添付ファイルアドレスの入力コンポーネントを使用します。
フィルターテキスト系のフィルターおよび空欄判定に対応しています。
並べ替え通常、並べ替えには使用しません。
バリデーションURL 形式、長さ、必須入力などのバリデーションに対応しています。

設定の編集

作成後、フィールド右側の「Edit」をクリックすると、添付ファイル URL フィールドの設定を編集できます。フィールドの編集は、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」をクリックすると、添付ファイル URL フィールドを削除できます。メインデータベースでは、複数のフィールドを選択して一括削除することもできます。

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

警告

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

ページ設定での使用

添付ファイル URL フィールドは、外部ファイルの表示とアクセスに適しています。 20260709231803

シーン用途
フォームブロック外部ファイルのアドレスを入力します。
詳細ブロックファイルリンクを表示します。
テーブルブロックリンクまたはサムネイルへの入口を表示します。
ワークフローファイルアドレスを通知や外部リクエストに使用します。

関連リンク

  • フィールド — フィールドの役割、分類、マッピングロジックについて説明します
  • 通常のテーブル — 通常のテーブルでフィールドを作成・管理します
  • 添付ファイル — NocoBase ファイルをアップロードして関連付けます
  • URL — 通常のリンクを保存します