添付ファイル（非推奨）

概要

注意

添付ファイルフィールドは非推奨になりました。ファイルテーブルまたは添付ファイル URLフィールドの使用をおすすめします。

NocoBase では、添付ファイル（Attachment）を使用してファイルをアップロードし、そのファイルレコードを現在の業務レコードに関連付けます。

添付ファイルフィールドは通常、ファイルテーブルに関連付けます。ファイル本体はファイルストレージエンジンに保存され、ファイル名、サイズ、URL、MIME タイプなどのメタ情報はファイルテーブルに保存されます。

外部ファイルへのリンクを保存するだけの場合は、添付ファイル URLまたは URLを選択してください。

利用シーン

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

契約書の添付ファイル、請求書、経費精算の証憑
製品画像、従業員の身分証明書、プロジェクト文書
チケットのスクリーンショット、課題の添付ファイル
業務レコードに関連付けられた複数のファイル

作成時の設定

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

20240512180916

設定	説明
Field interface	フィールドのインターフェースタイプ。添付ファイルは `attachment` に対応し、ページ上での入力方法や表示方法を決定します。
Field display name	画面上に表示されるフィールド名。例：「契約書」「請求書」「製品画像」など。業務担当者がすぐに理解できる名称を使用することをおすすめします。
Field name	API、リレーションフィールド、権限、ワークフローなどで内部参照するためのフィールド識別名。作成後は通常変更せず、使用できるのは英字、数字、アンダースコアのみで、先頭は英字にする必要があります。
Field type	データ層におけるフィールドの型。添付ファイルフィールドは通常、ファイルテーブルのファイルレコードに関連付けるリレーションフィールドです。
Default value	デフォルト値。レコードの新規作成時にユーザーが入力しなかった場合、自動的にデフォルト値を設定できます。
Validation rules	バリデーションルール。必須かどうかを制限できます。ファイル数、サイズ、タイプは通常、アップロードコンポーネントまたはファイルストレージの設定で制御します。
Description	フィールドの説明。フィールドの意味、入力要件、データソース、管理担当者などを記載するのに適しています。

注意

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

フィールドの特性

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

特性	説明
デフォルトの Field interface	`attachment`。
デフォルトの Field type	`belongsToMany`。
選択可能な Field type	`belongsToMany` などのリレーションタイプ。具体的な内容はファイルフィールドの設定に準じます。
ページコンポーネント	編集モードでは添付ファイルアップロードコンポーネントを使用します。
フィルター	通常は、空かどうか、関連ファイルがあるかどうかで絞り込みます。
並べ替え	通常、並べ替えには使用しません。
バリデーション	必須などの基本的なバリデーションに対応します。アップロード制限はコンポーネントの設定に準じます。

編集時の設定

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

ページ設定での使用

添付ファイルフィールドは、フォーム、詳細、ファイル管理のシーンに適しています。 20260709231642

シーン	用途
フォームブロック	1 つまたは複数のファイルをアップロードします。
詳細ブロック	添付ファイルを表示、プレビュー、ダウンロードします。
テーブルブロック	添付ファイルの数や添付ファイルへの入口を表示します。
ワークフロー	添付ファイルを承認、通知、エクスポートに関連するファイルとして使用します。

#添付ファイル（非推奨）

#概要

#利用シーン

#作成時の設定

#フィールドの特性

#編集時の設定

#フィールドの削除

#ページ設定での使用

#関連リンク