Salesforceレポートを一括でフォルダへ移動する

はじめに

レポートをユーザーに自由に作らせていると、公開レポートがどんどん増えて整理されず、気付けばカオスな状態になってるなんてことはあるあるだと思います。いざ整理しようと思っても、UIからだと1個ずつしか移動できないので、数百もあると時間がいくらあっても足りない…。

そこで、一括でフォルダ移動や削除ができる方法を試してみたので、その手順をこの記事にまとめました。同じ方法でダッシュボード等も整理やレポート等をバックアップもできるので、ぜひ参考にしていただけるとうれしいです。

こんな人向け

• 整理したいレポートが数十以上ある
• Salesforceシステム管理者
• レポートなどをバックアップしておきたい
  • 「メタデータをダウンロードする」まででOK。

やりたいこと

6個の公開レポートをフォルダー「Sample」に一括で移動する。

方法

プロジェクトを作成する

コマンドパレット（Ctrl+Shift+P）から「SFDX：マニフェストファイルを使用してプロジェクトを作成」を呼び出す。

「標準」を選択する。

適当な名前を付ける（このプロジェクトフォルダーの名前）。

Salesforce組織へ接続する

コマンドパレットから「SFDX：組織を認証」を呼び出す。

「プロジェクトのデフォルト」を選択する。

組織のエイリアスは特にこだわりなければそのままEnterを押せば「vscodeOrg」になる。

ブラウザでログイン画面が開かれるので、対象のレポートがある組織にログインすると接続が完了する。

VSCodeにOrg Browserタブが表示され、接続した組織のデータが確認できる。「unfiled$public」（公開レポート）直下に並んでいるレポートを一括でSampleフォルダへ移動する。

メタデータをダウンロードする（≒バックアップ）

移動・削除をせず、メタデータをダウンロードで止めておけばバックアップになる。

manifestフォルダのpackage.xmlを開く。

<types>タグに挟まれた部分を↓の記述に書き換える（レポートAPI参照名＝レポートの一意の名前）。

<name>Report</name>
<members>[フォルダAPI参照名]/[レポートAPI参照名]</members>

移動したいレポートの分だけ<members>タグを追加してpackage.xmlを保存する。

package.xmlを右クリックし「SFDX：Retrieve Source in Manifest to Org」を選択すると、レポートのメタデータが取得される。

一括で移動する

移動先のフォルダのAPI参照名と同じ名前のフォルダをローカルに作成する。

エクスプローラー上で対象のレポートを切り取り、移動先のフォルダに貼り付けする。

reportsフォルダを右クリックし、「SFDX：Deploy This Source to Org」をクリックする。

正常に完了すると、Salesforce上でSampleフォルダにレポートが移動していることが確認できる。

一括で削除する

「メタデータをダウンロードする」までは同じ手順で、削除したいレポートのメタデータを右クリックで「SFDX：Delete from Project and Org」を選択する。正常に完了すると、このプロジェクトとSalesforce組織の両方からレポートが削除される。

ごみ箱には残るので間違って削除した場合も復元できる。安心。

トラブルシューティング

今後の課題

今回この方法を試すうえで、できたらもっと楽なのにと感じた点。調べる限りよさげな方法見つからなかったのでとりあえず備忘として置いておく。

• 一括で組織内のすべてのレポートやダッシュボードのメタデータを取得する方法はない?
• フォルダのAPI名一覧を取得する方法(SOQLを使えばいい?)
• 定期的にメタデータをバックアップする方法を確立する

参考

• メタデータによるレポートの移動全般
  • How do I mass-move reports into one | Salesforce Trailblazer Community
  • Updating reports with Eclipse and the Force.com IDE | Teach Me Salesforce (リンクを見失ったので後で更新)
• メタデータダウンロード
  • Bulk Move Reports or Dashboards with Metadata API
  • 3 Ways to Retrieve Metadata from Salesforce Org into VS Code | How to retrieve Apex /LWC in VS Code? – YouTube
• GUIでのメタデータバックアップ
  • Back Up Metadata to Protect and Restore Your Customizations