Déplacement en masse de rapports ou tableaux de bord avec l'API de métadonnées

Vous pouvez migrer des rapports ou tableaux de bord entre des dossiers et des sous-dossiers dans Lightning Experience. Si vous souhaitez déplacer des rapports ou des tableaux de bord en masse, utilisez l'API de métadonnées.

Par exemple, le dossier Anciens dossiers dépréciés contient deux rapports : Rapport sur mes comptes et Rapport sur mes opportunités. Vous souhaitez déplacer le Rapport sur mes comptes vers un nouveau dossier intitulé Comptes et le Rapport sur mes opportunités vers un nouveau dossier Opportunités.

Cet exemple utilise l'API REST Rapports et tableaux de bord pour récupérer les détails des rapports que vous souhaitez déplacer, et l'API de métadonnées pour déplacer les rapports (le même processus fonctionne pour les tableaux de bord). Vous pouvez utiliser Postman ou cURL pour appeler l'API REST Rapports et tableaux de bord. Vous pouvez utiliser Salesforce Extensions pour Visual Studio Code ou Salesforce CLI afin d'exécuter l'API de métadonnées. Vous pouvez suivre un processus similaire en utilisant l'outil de migration ANT force.com.

1. Récupérez la liste de vos rapports en utilisant la méthode PATCH report resource de l'API REST Rapports et tableaux de bord.
2. Recherchez dans la liste les noms de développeur des rapports que vous souhaitez déplacer, et l'ID du dossier qui les contient.
3. Utilisez l'ID de dossier pour récupérer le nom du développeur du dossier avec l'méthode GET folder operation.
4. Créez un fichier Manifest package.xml en utilisant les noms de développeur du dossier et du fichier en tant que membres.

   <?xml version="1.0" encoding="UTF-8"?> 
   <Package xmlns="http://soap.sforce.com/2006/04/metadata"> 
       <types> 
           <name>Report</name> 
           <members>Some_Old_Deprecated_Folder/My_Accounts_Report_eQ</members> 
           <members>Some_Old_Deprecated_Folder/My_Opty_Report_CO</members> 
       </types> <version>43.0</version> 
   </Package>

5. Récupérez un package qui contient les rapports en utilisant l'appel retrieve() de l'API de métadonnées.
6. Décompressez le package.
   
7. Dans le package décompressé, créez le dossier et la structure de fichiers.
   
8. Dans le fichier Manifest package.xml, changez la structure du dossier pour tenir compte des modifications que vous avez effectuées dans le package décompressé.

   <?xml version="1.0" encoding="UTF-8"?>
   <Package xmlns="http://soap.sforce.com/2006/04/metadata">
      <types>
          <members>Accounts/My_Accounts_Report_eQ</members>
          <members>Opportunities/My_Opty_Report_CO</members>
          <name>Report</name>
      </types>
      <version>43.0</version>
   </Package>

9. Créez les dossiers dans Lightning Experience.
   
10. Créez le package pour le déploiement.
    Cette commande crée un fichier ZIP à partir du contenu du répertoire du package décompressé intitulé unpackaged.

    zip -r move_reports.zip unpackaged/

11. Déployez le package qui contient les rapports déplacés en utilisant l'appel de deploy() de l'API de métadonnées.