複数行テキスト

概要

NocoBase では、複数行テキスト(Multi-line text) は、改行を含むテキストや比較的長いテキストを保存するために使用します。

複数行テキストでは、デフォルトで複数行入力欄を使用するため、メモ、説明、対応内容などに適しています。フィルター、権限、ワークフローの条件、API クエリにも利用できます。

通常は 1 行で収まる名称、番号、タイトルなどの場合は、単行テキストを選択するほうが適しています。レイアウト、画像、リッチテキスト機能が必要な場合は、リッチテキストまたは Markdown フィールドを選択してください。

適用シーン

複数行テキストは、次のような業務シーンに適しています。

  • 顧客メモ、注文メモ、チケットの対応内容
  • 詳細な住所、問題の説明、要件の説明
  • 契約条項の概要、プロジェクトの背景説明
  • 改行して入力する必要があるテキスト

作成時の設定

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

20240512165017

設定説明
Field interfaceフィールドのインターフェースタイプ。複数行テキストでは textarea を使用し、ページ上での入力・表示方法を決定します。
Field display name画面上に表示されるフィールド名。「顧客メモ」「対応内容」「詳細な住所」など、業務担当者がすぐに理解できる名称を使用することをおすすめします。
Field nameAPI、リレーションフィールド、権限、ワークフローなどで内部参照するためのフィールド識別名です。作成後は通常変更せず、英字、数字、アンダースコアのみ使用でき、先頭は英字である必要があります。
Field typeデータ層におけるフィールドの型。複数行テキストのデフォルトは text で、元のフィールドに応じて string または json にマッピングすることもできます。
Default valueデフォルト値。レコードを新規作成する際、ユーザーが入力しなかった場合に自動的に設定できます。
Validation rulesバリデーションルール。最小長、最大長、固定長、大文字・小文字、正規表現などを制限できます。
Descriptionフィールドの説明。フィールドの意味、入力要件、データソース、管理担当者などを記載するのに適しています。
注意

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

フィールドの特性

複数行テキストフィールドのデフォルトの動作は次のとおりです。

特性説明
デフォルトの Field interfacetextarea
デフォルトの Field typetext
選択可能な Field typetextjsonstring
ページコンポーネント編集モードでは複数行入力欄を使用します。
フィルター含む、含まない、空、空でないなど、テキスト用のフィルターに対応しています。
並べ替え通常、並べ替えには推奨されません。並べ替えの可否は、使用するデータベースとフィールドタイプによって異なります。
バリデーション最小長、最大長、固定長、大文字・小文字、正規表現などのバリデーションに対応しています。

設定の編集

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

ページ設定での使用

複数行テキストフィールドは、フォームや詳細画面で長い内容を表示するのに適しています。

20260709224428

シーン用途
フォームブロックメモ、説明、対応内容などを入力・編集します。
詳細ブロック比較的長いテキストを表示します。
テーブルブロック概要を表示します。長い内容は通常、省略して表示されます。
ワークフローと権限メモが空かどうかなど、条件フィールドとして判定に使用します。

関連リンク

  • フィールド — フィールドの役割、分類、マッピングの仕組みについて説明します
  • 通常テーブル — 通常テーブルでのフィールドの作成・管理について説明します
  • 単行テキスト — 1 行以内の短いテキストを保存します
  • Markdown — Markdown 形式のコンテンツを保存します
  • リッチテキスト — 複雑なレイアウトのコンテンツを保存します