データエディタ¶

データエディタは、CMS に定義したカスタムデータ型（コレクション）の データ を編集する画面です。お知らせ・製品・求人など、繰り返し型の構造化データを扱う日々の編集作業は、この画面で行います。

このページでは、日々のデータ編集 と、コレクション定義の管理 という 2 つの操作を扱います。それぞれ起点となる入口が異なる点に注意してください。

操作	起点
データの編集	ヘッダーのエディタドロップダウン > データエディタからコレクションを開きます
コレクション定義の管理	サイト設定 > データエディタから開きます

用語の整理¶

用語	意味
コレクション	スキーマ（データ型）の定義 — フィールド構成・バリデーション・UI 表示形式を含む
データ	コレクション内の個別レコード（例: 1 件のニュース記事）
データエディタ	データを編集する画面

「コレクション = テーブル定義」「データ = レコード」と捉えると分かりやすいです。

画面構成¶

データエディタの画面は次の領域で構成されます。

領域	内容
左サイドバー	コレクション一覧
上部	検索 / フィルタ / ソート / 操作ボタン（新規 / 一括削除）
中央	データ一覧（ページネーション付き）
編集ドロワー（行を開いた場合）	画面右からスライドして開く編集フォーム

データエディタ全景

コレクションの管理¶

サイト設定 > データエディタ から開きます。データの編集とは別の起点です。

コレクションの確認¶

各コレクションには次のような情報が含まれます。

項目	説明
定義	フィールド名・データ型・必須／任意・UI 表示形式
スペック	コレクションの仕様情報
JSON スキーマ	コレクション定義の JSON スキーマ表現

フィールド定義 UI で設定できる項目¶

各フィールドには以下を設定します。

設定	内容
フィールド名	内部識別子（コレクション内で一意）
表示ラベル	データエディタで表示する見出し
型	文字列 / 長文 / 数値 / 真偽値 / 日付 / 日時 / 選択肢 / 参照 / 画像 / ファイル / リスト
必須	このフィールドへの入力を必須にするか
一意	コレクション内で重複を許さないか
既定値	新規データ作成時の初期値
バリデーション	最小・最大値（数値）、最小・最大文字数（文字列）、正規表現、形式（メール / URL / 電話）
UI 表示形式	テキスト入力 / テキストエリア / セレクト / ラジオ / チェックボックス / 日付ピッカー / リッチエディタ
説明文	データエディタで入力ヘルプとして表示
並び順	データエディタの一覧でのカラム表示順
検索対象	この項目をキーワード検索の対象にするか
公開時挙動	API 経由で取得可能か、内部のみか

選択肢型では「選択肢の名前と値」のペアを複数定義します。参照型では参照先のコレクションを指定し、表示用に使うフィールドも選びます。

データの一覧¶

ページネーション¶

データは既定のページサイズで分割表示され、ページ番号や「次へ / 前へ」で遷移します。

検索¶

画面上部の検索ボックスにキーワードを入力すると、コレクション内のテキスト系フィールドを横断的に検索します。

フィルタ¶

フィールド型	フィルタ方式
選択肢	チェックボックス / セレクト
日付	期間指定
真偽値	true / false
数値	範囲指定
参照	参照先のデータで絞り込み

複数フィルタは AND で結合されます。

ソート¶

カラムヘッダをクリックすると、昇順／降順を切り替えられます。複数フィールドでの並び替えは、コレクション定義側で「既定の並び順」として設定しておくこともできます。

データの新規作成¶

画面上部の 新規作成 ボタンをクリックします。
フィールドに値を入力します。必須フィールドが未入力の場合は保存できません。
画像フィールドでは、コンテンツ管理のファイル一覧から選択するダイアログが開きます。
保存をクリックします。
入力値がバリデーションを通過すると一覧に追加されます。

保存しただけでは公開されません。コレクションのデータも他のコンテンツと同様に、ワークフロー申請を経て公開されます。

データの編集¶

一覧で対象行をクリックすると、画面右から 編集ドロワー がスライドして開きます。
フィールドを変更して保存をクリックします。
変更点は申請情報にまとめて、申請から申請します。

バリデーション¶

種類	動作
必須	未入力の場合、保存ボタンが押せず、エラーが表示されます
文字数	上限を超えるとエラーが表示されます
形式（メール、URL など）	形式が一致しない場合にエラーが表示されます
参照整合	参照先のデータが削除済みの場合に警告が表示されます

エラー時はフィールド直下に赤字で内容が表示されます。

データの削除¶

1 件ずつ削除¶

削除対象を選択します。
削除をクリックします。
確認ダイアログで承認します。

一括削除¶

複数のデータをまとめて削除するときに使用します。

一覧の行頭チェックボックスで対象を複数選択します。
画面上部の 一括削除 をクリックします。
確認ダイアログで件数を確認のうえ、承認します。

削除も他の変更と同様に、ワークフロー申請の対象になります。

インポート・エクスポート¶

インポート・エクスポートは、左サイドバーのコレクションを右クリック して開くコンテキストメニューから実行します。表示条件は次のとおりです。

データを保持するタイプのコレクションでのみメニューが表示されます。
インポート は、対象コレクションへの編集権限がないユーザーには表示されません。

データのインポート¶

外部データをコレクションに一括で取り込みます。

左サイドバーで対象コレクションを右クリックし、インポート を選びます。
CSV または JSON ファイルを選択します。拡張子から自動判定 されるため、形式の事前指定は不要です。
インポート確認画面で次を選びます。
既存データの 上書き か追加か
主キー（ユニーク識別子）の指定
差分プレビューで「追加 N 件・更新 N 件・スキップ N 件」を確認します。
実行をクリックします。

インポートでは既存データの上書き／追加を選択できます。意図しない上書きを避けるため、確認画面の差分を必ず確認してください。

インポート失敗時の挙動¶

症状	原因	対処
「形式エラー」	CSV のヘッダがコレクション定義のフィールド名と一致していない	ヘッダ行を見直す。エクスポートしたファイルを雛形にすると確実
「バリデーションエラー: N 件」	必須未入力・型不一致	エラーレポートをダウンロードして該当行を修正
「文字コードエラー」	UTF-8 以外で保存されている	UTF-8 で保存し直す

データのエクスポート¶

コレクションのデータを CSV または JSON でエクスポートできます。

左サイドバーで対象コレクションを右クリックし、エクスポート を選びます。
出力形式（CSV / JSON）を選びます。
フィルタ適用時は、そのフィルタ条件に該当するデータだけが出力されます。

コレクション定義のインポート・エクスポート¶

コレクション定義そのものを別サイトに移行する場合は、定義のインポート／エクスポートを使います。データは含まれず、スキーマのみが移行対象です。

データの履歴¶

データ単位の変更履歴を遡って確認できます。

編集ドロワー内の履歴タブを開きます。
変更時刻・変更者・差分が表示されます。
必要に応じて過去のバージョンに戻せます（戻す操作も申請対象）。

サイト全体の申請情報履歴は履歴を参照してください。

前提状態とエラー時の見え方¶

症状	想定原因	対処
新規作成ボタンが押せない	編集権限がない	ユーザーと権限を確認
新規コレクションボタンが非表示	サイト管理権限がない	サイト管理者に依頼
フィールドの型変更ができない	既存データがあるため、互換性のない変更が制限されている	既存データを変換するか、バックアップ後に削除
右クリックメニューにインポート / エクスポートが出ない	対象コレクションがデータ保持タイプではない、またはインポート権限が不足している	コレクションの種類と権限を確認
保存しても一覧に表示されない	フィルタ条件で除外されている	フィルタを解除して再確認
「他のユーザーが編集中です」と表示される	同じデータを別のユーザーが開いている	編集者に連絡、または時間をおいて再開

次に読むページ¶

データバインディング — データをテンプレートから参照する
コンテンツ管理 — データ内で参照する画像の操作
ワークフローと承認 — データの変更を公開するまで