こんにちは。エンジニアのりゅーそうです。

本日の更新情報をお知らせします。コンテンツ一覧画面から、コンテンツデータをCSV形式でエクスポートできるようになりました！
今回のアップデートにより、コンテンツ一覧で表示しているデータを、ビューのフィルター条件で絞り込んだうえでCSVファイルとして出力できます。
※本機能は、Teamプラン、Businessプラン、Enterpriseプランでのご提供となります

利用方法

コンテンツ一覧画面から、以下の手順でCSVエクスポートを実行できます。

コンテンツ一覧画面を開き、必要に応じてビューのフィルターやキーワード検索、ソートを設定します。

［CSVエクスポート］ボタンをクリックします。

ダイアログが開くので、内容を確認します。
エクスポート名はCSVのファイル名に使用されるので、管理しやすい名前をつけると良いかと思います。
※{エクスポート名}-{APIエンドポイント}-{タイムスタンプ}.csv のようなファイル名となります。

エクスポート対象のデータは、現在のビューで表示されている条件（フィルター・キーワード検索・ソート）に基づきます。

［エクスポートを開始］ボタンをクリックします。


エクスポートが完了すると、管理画面上に「エクスポートが完了しました」という通知が表示されます。

また、指定のメールアドレス宛にCSVのダウンロードリンクが届きます。メール内のリンクから、エクスポートしたCSVファイルをダウンロードできます。

※ダウンロードするには、同一ブラウザセッションでのmicroCMSのログインとAPI読み取り権限が必要です。

コンテンツ運用の「確認しやすさ」を支える機能

microCMSでは、コンテンツを作成するだけでなく、作成したコンテンツを確認したり、運用状況を整理したりする場面も多くあります。
たとえば、公開済みの記事だけを一覧で確認したい、特定のカテゴリに属するコンテンツを棚卸ししたい、外部の表計算ソフトでデータを見ながらチームで確認したい、といったケースです。

これまでも管理画面上でコンテンツ一覧を確認することはできましたが、今回のCSVエクスポートにより、管理画面の外でもデータを扱いやすくなりました。
出力されるCSVのデータはCSVエクスポートを実行するメンバーの権限設定にもとづき、読み取り権限のあるデータのみが出力されます。

こうした「必要なデータを必要な形で取り出せる」機能は、日々の運用を支えてくれる良い機能だと思っています。
出力されるCSVのデータ形式は以下のドキュメントもご参照ください。
https://document.microcms.io/manual/csv-export#h595066b8d9

ビューのフィルター条件を使ってエクスポート

CSVエクスポートでは、ビューのフィルター条件で絞り込んだコンテンツ一覧を出力できます。
そのため、すべてのコンテンツをエクスポートしてから手元で絞り込むのではなく、管理画面上で必要な条件に絞ったうえでCSVにできます。

たとえば以下のような使い方ができます。

• 公開済みコンテンツだけを出力して、公開状況を確認する
• 特定カテゴリのコンテンツだけを出力して、記事の棚卸しをする
• 更新日時で絞り込んで、一定期間内に更新されたコンテンツを確認する
• チーム内の確認用に、必要なコンテンツ一覧をCSVで共有する

「今見ている一覧を、そのまま扱いやすい形で取り出せる」という体験を目指しています。

コンテンツデータのバックアップにも活用

CSVエクスポートは、コンテンツデータのバックアップ用途としても活用できます。
たとえば、大きな編集作業を行う前や、定期的な運用確認のタイミングでコンテンツ一覧をCSVとして保存しておくことで、その時点のデータを手元に残しておけます。

CSVエクスポートはコンテンツデータを復元するための専用バックアップ機能ではありません。ただ、公開中のコンテンツや特定条件に合うコンテンツを一覧として保管しておけることは、日々の運用における安心材料のひとつになると思います。
コンテンツ運用では、「今どうなっているか」を確認できることと同じくらい、「過去のある時点でどうだったか」を後から見返せることも大切です。CSVエクスポートを、そうした記録を残す手段としてもご活用ください。

※コンテンツの再インポート時の仕様についてはよくある質問の「Q. エクスポートしたCSVを再インポートするには？」をご覧ください。 エクスポートしたデータを再インポートしても、元のコンテンツを完全に復元できるとは限りませんのでご注意ください。
https://document.microcms.io/manual/csv-export#h08562665f0

注意事項

CSVエクスポートをご利用いただく際は、以下の点にご注意ください。

• ダウンロードリンクにアクセスできるのは、エクスポートを実行したユーザーのみです
• ダウンロードリンクの有効期限は24時間です
• エクスポート対象のAPIおよびコンテンツの読み取り権限が必要です
• データ量が多い場合、エクスポートの実行には30分以上かかる場合があります
• エクスポート実行中にコンテンツやAPIスキーマが編集された場合、その変更がエクスポート結果に反映される場合があります

正確なデータが必要な場合は、エクスポートの実行中に対象コンテンツやAPIスキーマの編集作業を控えていただくことをおすすめします。
その他注意事項やデータ形式の詳細などはドキュメントにまとめていますので、ご参照ください。
https://document.microcms.io/manual/csv-export

おわりに

今回のアップデートにより、microCMS上のコンテンツデータをより柔軟に取り出せるようになりました。

コンテンツ運用では、作ることと同じくらい、あとから確認できることや、チームで状態を共有できることも大切です。CSVエクスポートが、日々の運用を少しでも進めやすくする機能になれば嬉しいです。
ぜひご活用ください！


microCMSでは、今後もコンテンツ運用をより便利にする改善を進めてまいります。ご意見・ご要望は管理画面右下のチャット、公式X、メールからお気軽にご連絡ください。

引き続きmicroCMSをよろしくお願いいたします！