Vue d’ensemble¶

Afi Backup pour Salesforce protège les enregistrements et leurs valeurs de champ issus des SObjects standard et personnalisés, ainsi que Salesforce Files et les pièces jointes et les métadonnées des objets et des champs. Cet article explique comment parcourir les sauvegardes des organisations de production et des sandbox Salesforce, y effectuer des recherches, les exporter et les restaurer.

Avant de commencer, ajoutez la source de données Salesforce et protégez vos données dans l’organisation de production ou la sandbox.

Fonctionnement de la sauvegarde et de la restauration Salesforce¶

Lors de l’intégration, un administrateur Salesforce installe le package géré Afi et autorise Afi. Cet utilisateur devient l’utilisateur d’intégration, dont les autorisations Salesforce déterminent les objets et les valeurs de champ qu’Afi peut lire pour la sauvegarde, ainsi que les enregistrements et les champs qu’Afi peut écrire lors de la restauration.

Afi traite une organisation de production et chaque sandbox intégrée comme des ressources distinctes. Pour chaque ressource protégée, Afi sauvegarde les enregistrements et leurs valeurs de champ issus des SObjects standard et personnalisés interrogeables auxquels l’utilisateur d’intégration a accès via les API Salesforce prises en charge. Les objets des packages gérés installés suivent les mêmes règles de couverture que les autres objets personnalisés. Consultez Éléments pris en charge pour connaître la couverture des données et des métadonnées Salesforce.

Afi sauvegarde également le contenu des champs binaires ainsi que les métadonnées des objets et des champs. Ces métadonnées servent à afficher les enregistrements, à recréer les objets personnalisés absents de la destination de restauration et à fournir les définitions d’objets pour l’export XML.

Les sauvegardes Salesforce d’Afi sont incrémentielles permanentes : après la synchronisation complète initiale des données, le service ne synchronise que les enregistrements ajoutés ou modifiés depuis la sauvegarde précédente. Cela réduit à la fois la durée des sauvegardes et la quantité de données ajoutée à chaque sauvegarde. Afi resynchronise un objet lorsque les API Salesforce ne fournissent pas de suivi incrémentiel des modifications ou lorsque la protection a été interrompue pendant une période prolongée. Associée à l’utilisation d’opérations d’API en bloc, cette approche aide Afi à réduire la consommation du quota d’API Salesforce (en anglais).

Lors de la restauration, Afi utilise les API Salesforce pour écrire les données conformément au schéma d’objets et aux autorisations actuels de la destination. Afi met à jour les enregistrements correspondants ou recrée les enregistrements manquants, tout en préservant les relations entre les enregistrements restaurés.

Afficher les données sauvegardées et parcourir les instantanés¶

Pour ouvrir une sauvegarde Salesforce, accédez à l’onglet Service → Protection, recherchez l’organisation de production ou la sandbox, puis cliquez sur Recover. L’ouverture de la sauvegarde à l’aide de ce bouton ne lance pas de tâche de restauration.

Vous pouvez parcourir les objets standard et personnalisés sauvegardés dans l’onglet SObjects. Sélectionnez un objet pour parcourir ses enregistrements, puis cliquez sur un enregistrement pour afficher ses détails. Vous pouvez également choisir les champs sauvegardés qui s’affichent sous forme de colonnes du tableau.

Pour obtenir des instructions détaillées, consultez Parcourir.

Instantanés de sauvegarde¶

Par défaut, Afi ouvre l’instantané de sauvegarde réussi le plus récent. Utilisez le contrôle Backup version pour sélectionner une autre date et, si plusieurs sauvegardes ont été créées à cette date, l’heure de sauvegarde voulue. L’instantané sélectionné est utilisé lorsque vous parcourez les enregistrements et lancez un export ou une restauration.

Chaque instantané représente l’état de vos données Salesforce protégées au moment de la sauvegarde. Si un enregistrement est ensuite modifié, supprimé ou archivé dans Salesforce, vous pouvez toujours parcourir, rechercher, exporter et restaurer sa version antérieure à partir d’un instantané conservé. Les paramètres de rétention de la stratégie SLA attribuée déterminent la durée de conservation des instantanés de sauvegarde.

Afi ne capture pas actuellement les enregistrements qui se trouvent déjà dans la Corbeille Salesforce ni les activités archivées. Un enregistrement créé puis supprimé entre deux sauvegardes consécutives peut ne jamais être capturé.

Rechercher¶

Afi vous permet d’effectuer des recherches dans les champs d’enregistrement indexés de la sauvegarde de chaque ressource. Ouvrez la sauvegarde de l’organisation de production ou de la sandbox dans laquelle vous souhaitez effectuer une recherche, saisissez une requête, puis sélectionnez un SObject correspondant pour afficher ses enregistrements.

Par défaut, l’option Limit to current backup version limite les résultats à l’instantané sélectionné. Désactivez-la pour rechercher des versions d’enregistrements dans tous les instantanés conservés de cette ressource. Vous pouvez sélectionner les enregistrements correspondants pour les exporter et les restaurer. Les enregistrements sélectionnés pour une même tâche de restauration doivent provenir du même instantané.

Consultez Rechercher pour en savoir plus sur le contenu pouvant faire l’objet d’une recherche et sur la procédure.

Exporter¶

Vous pouvez exporter l’ensemble des données d’enregistrement sauvegardées de la ressource, tous les enregistrements sauvegardés d’un ou de plusieurs types SObject sélectionnés, ou des enregistrements individuels sélectionnés dans la vue de navigation ou dans les résultats de recherche.

Afi prend en charge les formats d’export suivants :

CSV pour les données d’enregistrement SObject ;
JSON pour les données d’enregistrement SObject, au format JSON Lines (.jsonl) avec un enregistrement par ligne ;
XML pour les métadonnées d’objet sauvegardées disponibles.

Les exports de données d’enregistrement incluent le contenu des champs binaires pris en charge. Lorsque vous exportez des enregistrements sélectionnés, vous pouvez également inclure leurs fichiers sauvegardés et leurs enregistrements enfants directs.

Consultez Exporter pour en savoir plus sur les formats et la sélection.

Restaurer¶

À partir d’un instantané de sauvegarde sélectionné, vous pouvez restaurer :

La ressource Salesforce complète ;
Tous les enregistrements sauvegardés d’un ou de plusieurs types SObject sélectionnés, par exemple tous les comptes ou tous les contacts ;
Des enregistrements individuels sélectionnés, y compris des enregistrements sélectionnés dans les résultats de recherche.

Les SObjects en lecture seule peuvent être parcourus, faire l’objet de recherches et être exportés, mais ne peuvent pas être sélectionnés pour une restauration.

Vous pouvez restaurer des enregistrements avec ou sans leurs enregistrements enfants sauvegardés. Pour inclure les enregistrements enfants directs pris en charge, les fichiers liés et les pièces jointes, sélectionnez Direct children sous Child records.

Afi met à jour les enregistrements correspondants et recrée les enregistrements manquants ou supprimés. Afi ne supprime pas les enregistrements de la destination créés après l’instantané sélectionné. Si un objet personnalisé pris en charge est absent de la destination, Afi le recrée automatiquement à partir de ses métadonnées sauvegardées avant de restaurer ses enregistrements. Afi préserve les relations prises en charge en restaurant les enregistrements requis dans l’ordre de leurs dépendances et en mettant à jour les références des relations de référence et principal-détails avec les ID d’enregistrement correspondants de la destination.

Vous pouvez restaurer les données dans la ressource Salesforce d’origine ou dans une autre ressource connectée. Vous pouvez ainsi restaurer une partie des données d’une organisation de production dans une sandbox.

Par défaut, la boîte de dialogue de restauration laisse l’automatisation Salesforce activée. Sélectionnez Disable Salesforce automation during recovery pour désactiver temporairement les flux, les règles de workflow et les règles de validation actifs dans toute l’organisation de destination. Lorsque cette option est sélectionnée, Afi réactive l’automatisation précédemment active après une restauration réussie.

Consultez Restaurer pour obtenir des instructions détaillées et connaître les options de restauration.

Choisir une approche de restauration¶

Votre situation	Approche suggérée
Quelques enregistrements ont été supprimés ou écrasés par une importation	Parcourez un instantané antérieur à l’incident ou effectuez-y une recherche, examinez les valeurs enregistrées et restaurez les enregistrements concernés. La restauration écrit les champs sauvegardés éligibles de chaque enregistrement sélectionné.
Un compte et ses données associées ont été perdus	Sélectionnez le compte et choisissez Direct children pour restaurer ses contacts sauvegardés et les autres enregistrements enfants directs éligibles.
Un fichier ou une pièce jointe a disparu	Téléchargez le contenu enregistré ou restaurez le fichier en sélectionnant son enregistrement ContentDocument et Direct children sous Child records. Afi restaure ensuite automatiquement ses liens sauvegardés vers les enregistrements de destination. Pour une pièce jointe classique, sélectionnez son enregistrement Attachment ; Afi restaure automatiquement la relation avec l’enregistrement parent.
Des données historiques sont nécessaires pour des tests ou une enquête	Restaurez les données sélectionnées dans une sandbox connectée.
Un objet personnalisé a été supprimé	Restaurez ses enregistrements à partir d’un instantané qui inclut ses métadonnées d’objet. Afi utilise ces métadonnées pour recréer automatiquement l’objet avant de restaurer ses enregistrements.
Des champs personnalisés ont été supprimés, mais le type SObject existe toujours	Afi ne recrée pas ces champs lors de la restauration des enregistrements, même si vous restaurez tous les enregistrements de ce type. Restaurez ou recréez les champs dans Salesforce avec leurs noms d’API d’origine avant de restaurer leurs valeurs.

Sécurité de l’accès aux données¶

Afi utilise des rôles d’accès explicites pour contrôler qui peut répertorier, prévisualiser, télécharger et restaurer les données de sauvegarde, et qui peut restaurer des données vers une autre ressource. Consultez Gestion des accès pour Salesforce pour obtenir des conseils de configuration.

Afi journalise les activités de navigation, de recherche, d’export et de restauration des données. Les administrateurs peuvent consulter ces événements dans l’onglet Activity → Audit. Les événements de restauration identifient l’utilisateur à l’origine de l’opération ainsi que la source et la destination concernées.