特殊な入力形式

少し複雑な項目である、画像やカスタムフィールドグループのインポートをする方法を紹介します。

メディアのカスタムフィールド

メディアのIDを指定して、メディアのカスタムフィールドをインポートします。
ポイントは「フィールド名」のカラムと「フィールド名@media」のカラム両方に「メディアID」を設定することです。

"entry_title","hoge","hoge@media"
"メディアのフィールドテスト",41,41
"メディアのフィールドテスト2",36,36

ブロックエディターのカスタムフィールド

登録したいカスタムフィールドのフィールド名の後ろに 「@block-editor」をつけることでカスタムフィールドのブロックエディターをインポートすることができます。

ブロックエディターにて対応しているHTMLの範囲のみ入稿することが可能です。すべてのHTMLの記法に対応しているわけではないため、ご注意ください。利用できるフォーマットはブロックエディターの基本ブロックと同様です。

"entry_title","hoge@block-editor"
"メディアのフィールドテスト","<p>ブロックエディターフィールドの値</p>"
"メディアのフィールドテスト2","<p>ブロックエディターフィールドの値</p>"

画像のカスタムフィールド

画像のカスタムフィールドは archivesディレクトリに画像を別途アップロードする必要がありますが、 CSVにアップロードされたパスを書くことで、CSVインポートすることができます。

画像のカスタムフィールドには、多くの関連変数があります。すべて指定しなくてもよいですが、少なくとも「フィールド名@path」は指定しましょう。

"entry_title","hoge@path","hoge@x","hoge@y","hoge@alt"
"画像のフィールドテスト","001/202012/4e82948f2a5ce6e6a856d61bf0a1057473cf8997e3c7e7f2da9faa0019935d0e.png",300,169,"代替テキスト"
"画像のフィールドテスト2","001/202012/4e82948f2a5ce6e6a856d61bf0a1057473cf8997e3c7e7f2da9faa0019935d0e.png",300,169,"代替テキスト"

指定可能な項目

ファイルのカスタムフィールド

ファイルのカスタムフィールドは archivesディレクトリにファイルを別途アップロードする必要がありますが、 CSVにアップロードされたパスを書くことで、CSVインポートすることができます。

ファイルのカスタムフィールドには、多くの関連変数があります。

"entry_title","hoge@path","hoge@baseName","hoge@fileSize","hoge@originalName"
"ファイルのフィールドテスト","001/202012/aaa.pdf","aaa.pdf",347794,"サンプル.pdf"
"ファイルのフィールドテスト2","001/202012/bbb.pdf","bbb.pdf","サンプル2.pdf"

指定可能な項目

カスタムフィールドグループ

カスタムフィールドグループは、複数の値を入れないといけないので、複雑ですがCSVでインポートすることができます。
複雑なので、例をだして、それにそって説明していきます。

例の仕様

• 「testGroup」というカスタムフィールドグループ名

• 「testGroup」は2つのテキストフィールドを持つ（inputA, inputB）

• 今回入力したい値は2レコードで、値は下の画像のような値をいれたい

例の仕様を満たすCSV

上記の仕様を満たすCSVは以下のようになります。

"entry_title","@testGroup[1]","@testGroup[2]","inputA[1]","inputA[2]","inputB[1]","inputB[2]"
"フィールドグループのテスト","inputA","inputB","aaaaa","AAAAAA","bbbbbb","BBBBBB"

ポイント

まず「グループ名」を @グループ名[添字] という形で、グループ内のフィールド数分用意します。
今回は、inputA と inputB の2つ なので、 "@testGroup[1]","@testGroup[2]" を追加しています。
この項目の値には、グループ内のフィールド名を指定します。今回の場合は inputA, inputB になります。

グループ名とフィールド名が指定できたら、グループ内のフィールド値を添字を使って、 レコード数分 指定していきます。 今回は、2レコードなので、"inputA[1]","inputA[2]","inputB[1]","inputB[2]" を追加しています。
この項目の値は、それぞれフィールドに入れたい値を設定することになります。

＊ 添字は「1」から始まるのでご注意ください。

管理ページから CSV 形式のデータをユーザー情報に変換してインポートできます。エンタープライズライセンスまたは無制限ユーザーオプションが必要です。

カスタムフィールド値での既存ユーザー特定（後述）は プロフェッショナル以上のライセンス で利用できます。

インポート方法

管理ページ > インポート > ユーザー（CSV）から実行します。CSV ファイルを選択し、「インポートを実行する」ボタンを押下します。

CSV ヘッダーとして使える項目名、入力例、デフォルト値の一覧は インポート画面に常時表示されています。一次情報として最新の管理画面をご参照ください。

主な仕様

すべての項目は任意

CSV のヘッダーに必須項目はありません。user_code / user_mail を省略・空欄にした場合は、システム側でデフォルト値が自動的に割り当てられます。

初期パスワードの扱い

新規ユーザー作成時に user_pass を省略・空欄にした場合、推測不可能なランダムな初期パスワード が自動生成されます。インポートされたユーザーはそのままではログインできないため、パスワードリセット案内などで本人に設定してもらう運用となります。

既存ユーザーの更新時に user_pass を省略・空欄にした場合は、これまでどおり既存のパスワードがそのまま維持されます。

カスタムフィールド

CSV のヘッダーに、ユーザー側で定義されているカスタムフィールド名を指定すると、カスタムフィールドとして取り込まれます。複数項目のチェックボックスのように同名で複数値を持つフィールドは、field_check_box[1] のように添字（1 始まり）を指定してください。

詳しくは CSV ファイルからのインポートをご覧ください。

既存ユーザーの上書き

既存ユーザーを上書きしたい場合は、次の 2 つの方法から選べます。

user_id を指定する方法

CSV に user_id 列を含めて対象ユーザーの ID を指定すると、一致するユーザーが上書きされます。

カスタムフィールドの値で特定する方法（プロフェッショナル以上）

CSV のヘッダー名の先頭に *（アスタリスク）を付けることで、そのフィールドの値で既存ユーザーを特定して上書きできます。外部システムの社員番号・会員番号などと紐付けて運用したい場合に便利です。

たとえば *member_id というヘッダーで M-00123 という値を渡した場合、

サンプル CSV

最小構成（新規ユーザーを一括登録）

user_code,user_mail,user_pass,cfd_addr,cfd_zip,cfd_tel
appleple,info@example.com,password,名古屋市中村区名駅3-18-5 モンマートビル5F,450-0002,052-485-8577

上記のCSVファイルで取り込まれた項目は以下のようにカスタムフィールドとして取り込まれます。

補足

• 文字コードは UTF-8 を推奨します。

• 値の先頭を str-data_ にしたデータは、表計算ソフトで文字列として扱われ、値の自動変換を防止できます。インポート時はこの先頭の文字は無視されます。数値や日付のデータでお使いください。

WordPressとの連携や移行を容易にするため、WXR（WordPress eXtended RSS）形式でのエントリーエクスポート機能が Ver. 3.2 から利用できます。

• WXR形式でのエクスポートに対応
  WordPressがサポートするXMLベースのWXR形式でエントリーデータを出力可能。

• ブログ単位でのエクスポート
  複数ブログを運用している環境でも、特定のブログ単位でデータをエクスポート可能。

• エントリー、カテゴリー、ユーザー情報を含む
  エクスポートデータには、エントリー本文だけでなく、カテゴリー情報や投稿ユーザー情報も含まれます。

• メイン画像をサムネイルとして出力
  各エントリーに紐づくメイン画像を、WXRの<wp:postmeta>としてサムネイル情報に含めています。

この機能追加により、データのポータビリティが向上します。
WXR形式という標準フォーマットでエクスポートできるため、他のCMSやツールとの互換性が高く、柔軟な運用が可能になります。

• ユーザーの安心感
  将来的なサイト移行やバックアップにも対応できることで、長期的な視点でも安心してご利用いただけます。

• ベンダーロックインの回避
  特定のCMSに依存しないデータ設計を実現し、ユーザー側での選択肢と自由度を確保します。

• データ解析や再利用のしやすさ
  XMLベースの形式により、他システムでのデータ解析やフォーマット変換などの再利用にも適しています。

Ver. 3.0.0 よりエントリーのエクスポート・インポートができるようになりました。

エントリー管理で選択したエントリーを zip ファイルとして書き出し（エクスポート）、別のブログ・別サイトの a-blog cms に取り込む（インポート）機能です。次のような場面で使えます。

• 検証環境で作成したエントリーを本番環境に反映する

• 別のブログにサンプルエントリーを複製する

• サイトリニューアル時に旧サイトから一部のエントリーだけ引っ越す

対象になるデータ・ならないデータ

エクスポート・インポートされるもの:

• エントリー本文と公開設定（タイトル、日時、ステータスなど）

• カスタムフィールド

• ユニット（本文中の画像・テキストなどのブロック）

• タグ

• サブカテゴリー

• 本文・フィールドから参照している画像やファイル（メディアライブラリの実体ごと）

• 位置情報（ジオ）

エクスポート・インポートされないもの（引っ越し後に別途手作業が必要です）:

• リビジョン履歴（過去の編集履歴）。インポート後のエントリーは「作業領域」1件分の状態からのスタートになります。

• 関連エントリーの設定。必要な場合はインポート後に手動で組みなおしてください。

• コメント

必要な権限

エントリーのエクスポート・インポートは「編集者」権限を持つユーザーが操作できます（「投稿者」権限では操作できません）。

ロール機能を使ってユーザーごとに権限を細かく設定している場合は、次のすべてにチェックが入っているロールが必要です。

• エントリー権限:「エントリーの投稿・編集」「自分のエントリー以外も管理」「エントリーの削除」

• カテゴリー権限:「カテゴリーの作成」「カテゴリーの編集・削除」

• タグ権限:「タグの編集・削除」

エクスポートの手順

1. 管理画面でエクスポート元のブログを開き、「エントリー」の一覧画面を表示します。

2. エクスポートしたいエントリーのチェックボックスにチェックを入れます（一度に選択で切る件数には制限があります。それ以上ある場合は複数回に分けてエクスポートしてください）。

3. 一括操作から「エクスポート」を選び、「実行」ボタンをクリックします。

4. zip ファイルがダウンロードされます。このファイルを取り込み先の環境にアップロードするまで保管しておいてください。

インポートの手順

1. インポート先のブログを開き、エントリー管理画面からその他 >「インポート」に進みます。

2. インポート後のエントリーのステータスを選びます（非公開／下書き／公開／エクスポート時のステータスのまま、から選択）。

3. エクスポートでダウンロードした zip ファイルをアップロードします。

4. 「インポートを実行する」をクリックすると、現在開いているブログに新規エントリーとして追加されます。

5. エラーが表示された場合でも、成功したエントリーはそのまま登録されています。一覧画面で取り込み結果を確認し、必要であれば失敗した分だけ再度エクスポート・インポートしてください。

運用・移行時の注意点

• 常に新規作成です。既存エントリーの上書き更新はできません。 同じ zip を誤って2回インポートすると、同じ内容のエントリーが重複して作成されます。エントリーコードが重複する場合は自動的に別のコードが割り振られます。

• カテゴリーは自動作成されません。 インポート先に同じカテゴリーコードのカテゴリーが存在しない場合、そのエントリーは「カテゴリーなし」として取り込まれます。カテゴリー構成を合わせてからインポートしてください。

• モジュールユニットも自動作成されません。 本文中にモジュールユニットを挿入している場合、インポート先に同じモジュールが存在しないと、そのユニットは中身が空の状態で取り込まれます。事前に同じモジュールを用意しておいてください。

• リッチテキスト内の画像はそのまま取り込まれ、変換処理は行われません。インポート後に表示崩れがないか確認してください。

• 異なるバージョンの a-blog cms 間でのインポートは動作保証されていません。 できるだけ同じバージョン同士で利用してください。

• インポート後は検索結果やページの表示内容が変わるため、キャッシュを使っているサイトでは反映状況もあわせて確認してください。

Ver. 3.2.25 よりフォームのエクスポート・インポートができるようになりました。

フォーム（メールフォーム）1件分の設定を書き出し（エクスポート）、別のブログ・別サイトの a-blog cms に取り込む（インポート）機能です。次のような場面で使えます。

• よく使う問い合わせフォームのひな形を別のブログにも展開する

• 検証環境で調整したフォーム設定を本番環境に反映する

• サイトリニューアル時に旧サイトのフォーム設定を引き継ぐ

対象になるデータ

フォームの設定画面に入力する内容がまるごと対象です。

• メール送信先・送信元（宛先、Cc、Bcc、返信先、管理者向け通知の宛先）

• 完了メール・管理者通知メールの件名・本文テンプレート

• 入力項目とその必須・バリデーション設定

• 投稿ログを残すかどうかなどのフォーム自体の設定

添付ファイルやフォームログはフォーム設定自体には含まれないため、エクスポートファイルにも含まれません。

必要な権限

• エクスポート: ロール機能を使っている場合は「フォームデータの閲覧」または「フォーム設定の編集・削除」のいずれかの権限があれば実行できます。ロール機能を使っていない場合は、コンフィグの設定に応じて「編集者」または「管理者」権限が必要です（デフォルトは「編集者」）。

• インポート: ロール機能を使っている場合は「フォーム設定の編集・削除」権限が必要です。ロール機能を使っていない場合はエクスポートと同じ権限が必要です。

エクスポートの手順

1. エクスポートしたいフォームの編集画面を開きます。

2. 画面上部の「エクスポート」ボタンをクリックします。

3. yamlファイルがダウンロードされます。一度にエクスポートできるのは1フォームずつです。 複数のフォームを移行する場合はフォームごとに繰り返してください。

インポートの手順

1. インポート先のブログでフォーム一覧を開き、「インポート」に進みます。

2. エクスポートでダウンロードしたファイルをアップロードします。

3. 「インポートを実行する」をクリックします。

4. 画面にインポート結果が表示されます。フォームコードが読み取れないなど不正なデータがあった場合は、そのデータだけスキップされ、警告として一覧表示されます。

運用・移行時の注意点

• 同じフォーム（フォームコードが同一）が既に存在する場合、確認なしで内容が上書きされます。 本番環境のフォームを誤って上書きしないよう、インポート前に対象フォームを一度エクスポートしてバックアップを取っておくことを推奨します。

• 上書きされた場合でも、そのフォームに紐づく既存の問い合わせログや、エントリーとの関連付けはそのまま維持されます。フォーム設定だけが差し替わります。

• 同じフォームコードが存在しない場合は、新しいフォームとして追加されます。

• 異なるバージョンの a-blog cms 間でのインポートは動作保証されていません。 できるだけ同じバージョン同士で利用してください。

問い合わせ内容（投稿データ）のダウンロードは別機能です

フォーム編集画面の「投稿データ」から進める画面は、来訪者がフォームに入力して送信した内容（ログ）を CSV でダウンロードするための機能です。ここまで説明したフォーム設定のエクスポート・インポートとは完全に別の機能なので混同しないよう注意してください。

• 出力形式は YAML ではなく CSV です。

• ダウンロードのみで、アップロードして復元する機能はありません。 誤って削除・上書きした投稿データを、このファイルから戻すことはできません。

Ver. 3.2.29 よりコンフィグセット単位でのエクスポート・インポートができるようになりました。

コンフィグセット1件分の設定（基本設定・編集画面設定・テーマ設定のいずれか）を書き出し（エクスポート）、別のブログ・別サイトの a-blog cms に取り込む（インポート）機能です。次のような場面で使えます。

• 本番環境で作成したコンフィグセットを、同じ構成のステージング環境や開発環境に複製する

• 複数のブログを運用していて、あるブログのコンフィグセットを別のブログでも使う

• コンフィグセットの内容を変更する前に、現状をファイルとして保存しておく

対象になるデータ

選択したコンフィグセット（基本設定・編集画面設定・テーマ設定のいずれか）に保存されている設定値がまるごと対象です。

• ルール別に上書きされた設定は対象になりません。インポート後、必要であればルールごとに再設定してください。

• カテゴリーを参照する設定値は、インポート先のブログに同じカテゴリーコードのカテゴリーが一意に存在する場合のみ引き継がれます。見つからない場合や、同じカテゴリーコードのカテゴリーが複数存在し一意に決まらない場合は未設定にリセットされます。

• メディアを参照する設定値は、インポート先のブログでは引き継がれず、常に未設定にリセットされます。

必要な権限

エクスポート・インポートいずれも、ロール機能を使っている場合は「コンフィグの編集」権限が必要です。ロール機能を使っていない場合は、管理者権限を持つユーザーのみ実行できます。

エクスポートの手順

1. 管理ページの「コンフィグ」（編集画面設定なら「編集画面」、テーマ設定なら「テーマ」）から、コンフィグセット管理画面を開きます。

2. エクスポートしたいコンフィグセットの行にある「コンフィグ」ボタン横のプルダウンから「エクスポート」を選びます。

3. yamlファイルがダウンロードされます。ファイル名は config_set_YYYYMMDD_HHmm.yaml の形式です。

インポートの手順

1. コンフィグセット管理画面上部の「インポート」ボタンから、コンフィグセットインポート画面を開きます。

2. エクスポートでダウンロードしたyamlファイルをアップロードします。

3. 「インポート方法」で「新しいコンフィグセットとして作成する」か「既存のコンフィグセットを上書きする」を選びます。

4. 「インポートを実行する」をクリックします。

運用・移行時の注意点

• 「既存のコンフィグセットを上書きする」を選んだ場合、対象のコンフィグセットの既存の設定内容はすべて失われます。誤って本番環境のコンフィグセットを上書きしないよう、事前にエクスポートしてバックアップを取っておくことを推奨します。

• 上書きは、同じブログ内にある同じ種類（基本設定・編集画面設定・テーマ設定）のコンフィグセットにのみ実行できます。異なる種類のコンフィグセットを上書き先に選んだ場合はエラーになります。

• 「新しいコンフィグセットとして作成する」を選んだ場合、作成されるコンフィグセットの公開範囲は常に「ローカル」（インポートを実行したブログ専用）になります。グローバルなコンフィグセットとして使いたい場合は、インポート後に設定を変更してください。

• 異なるバージョンの a-blog cms 間でのインポートは動作保証されていません。できるだけ同じバージョン同士で利用してください。

「コンフィグの部分エクスポート・インポート」は別機能です

コンフィグの各設定ページ（編集中の画面）から進める「部分エクスポート・インポート」は、ここで説明したコンフィグセット単位のエクスポート・インポートとは別の機能です。混同しないよう注意してください。

• 部分インポートは、yamlにある項目だけを上書きする「部分マージ」です。yamlにない項目は削除されず、既存の設定が保持されます。

• ここで説明したコンフィグセットのエクスポート・インポートは、コンフィグセットそのもの（名前付きの設定のまとまり）を対象に、新規作成または全項目の置き換え（上書き）を行います。