Contexte

Il peut arriver d’avoir besoin d’exporter en masse des fichiers physiques d’une org Salesforce, notamment pour des raisons d’archivage légal.

Différentes solutions existent déjà:

  • Exporter un par un les fichiers : pas réaliste en cas de grand nombre de fichiers
  • Utiliser le Salesforce Export Wizard : tous les fichiers sont exportés, mais dans un format non lisible, le tri n’est pas possible, et vous ne pouvez pas le lancer à volonté.
  • Utiliser des outils payants, comme SFDC File Exporter : cela fonctionne à priori mais… il faut payer !

Avec sfdx-hardis

Hardis Group met à disposition en Open-Source une fonctionnalité permettant de:

  • Exporter tous les fichiers associés à des objets métiers (Comptes, Opportunités, Requêtes…)
  • Appliquer des filtrages: – sur les objets associés aux fichiers (Opportunités gagnées dans l’année, Requêtes gérée par un service en particulier…) – sur les types de fichiers retournés (PDF, Notes, Excel, PPT…)

Comment ça marche ?

Pré-requis

Suivez les instructions d’installation de sfdx-hardis, lancez Visual Studio Code dans un dossier vide (ou un projet DX si vous en avez un), et ouvrez l’extension sfdx-hardis

Configuration d’un export de fichiers

Cliquez sur le menu Create files export configuration

Définissez un nom de dossier, un libellé et une description

Définissez la requête à lancer pour lister les records dont vous voulez télécharger les fichiers associés.

Exemples :

  • SELECT Id,Name FROM Opportunity
  • SELECT Id,Name FROM Account WHERE CreatedDate > '2021-01-01'
  • SELECT Id,Name FROM Case WHERE Service > 'Reclamation'

Définissez le nom du champ qui sera le nom du dossier physique contenant les fichiers téléchargés.

Exemples :

  • Name
  • Identifier__c
  • Id

En cas de rejeu, sélectionnez si vous voulez télécharger à nouveaux les fichiers associés à un record déjà traité

En cas de rejeu, sélectionnez si vous voulez écraser les fichiers existants.

Vous avez maintenant un fichier de configuration, export.json que vous pourrez modifier ultérieurement si besoin.

Lancer l’export des fichiers

Lancez le menu Data & Files import/export -> Export files.

Connectez vous à l’org dont vous voulez exporter les fichiers.

Sélectionnez la configuration d’export que vous venez de créer, et utilisez celle par défaut

L’outil vous indique le nombre de records parents trouvés ainsi qu’une estimation du nombre d’ API Calls qui seront consommés.

Validez pour démarrer l’export.

Attendez le temps nécessaire pour télécharger tous les fichiers.

L’export est terminé !

Des métriques vous sont affichées, et vous pouvez accéder aux fichiers dans le dossier courant puis /scripts/files/MACONFIG/export

Si vous souhaitez planifier / automatiser ces exports (CRON, CI…), vous pouvez utiliser la commande sfdx hardis:org:files:export

Vous souhaitez en savoir plus ?

Besoin d’automatisations Salesforce avancées ? N’hésitez pas :

Nicolas Vuillamy

Directeur Technique Salesforce

SUR LE MÊME THÈME

Salesforce annonce Hyperforce

Salesforce annonce Hyperforce

Gestion du My Domain d’une org de production Salesforce

Gestion du My Domain d’une org de production Salesforce

Comment obtenir une donnée de qualité ?

Comment obtenir une donnée de qualité

LAISSER UN COMMENTAIRE

Leave a Reply