Résolution des problèmes¶
Cet article présente les causes courantes des échecs et avertissements de sauvegarde et de restauration Salesforce, et explique comment les analyser et les résoudre.
Afficher et vérifier les tâches dont l’état est Failed ou Warning¶
Dans le tableau de bord Overview, le widget 7-day status indique le nombre de tâches qui ont échoué ou se sont terminées avec des avertissements au cours des sept derniers jours. Le widget 24-hour status résume les résultats des tâches des dernières 24 heures.
Vous pouvez configurer des rapports du service dans l’onglet Configuration → Reports afin de recevoir périodiquement, par e-mail, Slack, Microsoft Teams ou Google Chat, des informations sur les licences, la protection et l’état des sauvegardes.
Pour trouver les tâches comportant des erreurs ou des avertissements, accédez à l’onglet Activity → Tasks et sélectionnez Failed ou Warning dans le filtre Status.
Cliquez sur une tâche pour en examiner les détails ainsi que les erreurs ou avertissements signalés. Chaque entrée de la section Warnings explique le problème et identifie le SObject concerné et, le cas échéant, l’identifiant de l’enregistrement.
Pour les tâches de restauration, consultez également le récapitulatif de la restauration, s’il est disponible.
Échecs des sauvegardes et des restaurations¶
L’état Failed signifie que l’opération n’a pas pu aboutir.
Échecs de sauvegarde les plus courants :
| Erreur | Points à vérifier |
|---|---|
| Afi user or storage quota exceeded | Vérifiez l’utilisation du service et le quota disponible du locataire dans l’onglet Licensing → Subscriptions. |
| Salesforce access unavailable | Vérifiez que l’organisation Salesforce est disponible, que le package géré Afi est toujours installé et que l’utilisateur qui a autorisé Afi est actif et dispose des accès requis à l’API, aux objets, aux champs et aux fichiers. Consultez Autorisations Salesforce. |
| Sandbox connection changed | Vérifiez la connexion de la sandbox dans l’onglet Service → Protection avant de relancer la sauvegarde. |
Une fois le problème résolu, cliquez sur Backup now pour relancer la sauvegarde.
Échecs de restauration les plus courants :
| Erreur | Points à vérifier |
|---|---|
| Recovery destination unavailable | Vérifiez que l’organisation ou la sandbox sélectionnée est connectée et accessible, et que son utilisateur d’intégration dispose des autorisations d’écriture requises. Pour une sandbox, vérifiez de nouveau sa connexion. |
| Salesforce storage limit reached | Vérifiez l’utilisation du stockage des données et des fichiers dans l’organisation Salesforce de destination et libérez la capacité nécessaire avant de relancer la restauration. |
Si vous avez sélectionné Disable Salesforce automation during recovery, vérifiez que les flux, règles de workflow et règles de validation précédemment actifs ont bien été réactivés. Une restauration interrompue peut les laisser désactivés. Pour plus d’informations, consultez Automatisation pendant la restauration.
Avertissements de sauvegarde et de restauration¶
L’état Warning signifie que l’opération s’est terminée, mais que certains SObjects ou enregistrements ont été ignorés. Ouvrez les détails de la tâche pour identifier les données concernées et la cause signalée.
Voici des avertissements courants susceptibles de se produire lors d’une restauration :
| Avertissement | Points à vérifier |
|---|---|
| Missing or read-only objects or fields | Vérifiez le schéma de la destination et les autorisations d’écriture de l’utilisateur d’intégration pour les objets et champs signalés. |
| Missing required parent record | Vérifiez que l’enregistrement parent associé existe dans la destination ou qu’il est disponible dans la sauvegarde pour être restauré. |
| Salesforce validation error | Examinez la condition de validation signalée ainsi que les champs obligatoires, les règles de doublons et l’automatisation de la destination. Les déclencheurs Apex restent actifs pendant la restauration et peuvent affecter les écritures. |
Afi restaure toutes les données sélectionnées, à l’exception des SObjects ou enregistrements ignorés. Une fois les problèmes signalés résolus, nous vous recommandons de ne sélectionner que les données ignorées pour la restauration. Vous pouvez également relancer la restauration pour l’ensemble de la sélection d’origine.
Rapport CSV des exceptions de restauration¶
Pour une restauration terminée comportant des enregistrements ignorés, ouvrez la tâche de restauration dans l’onglet Activity → Tasks et cliquez sur Download restore summary. Le fichier CSV répertorie chaque élément ignoré consigné dans trois colonnes : sobject (objet Salesforce), record_id (identifiant d’origine de l’enregistrement) et error. Le rapport répertorie les exceptions ; il ne répertorie pas chaque écriture réussie ni chaque correspondance entre identifiants source et de destination.
Sauvegardes ou restaurations suspendues¶
Une sauvegarde est souvent suspendue parce que les limites d’API Salesforce ont été atteintes pendant la synchronisation initiale d’une organisation de production ou d’une sandbox. Afi suspend la tâche concernée et la relance automatiquement ; elle reprend à partir de l’état enregistré dès que Salesforce autorise de nouveau les requêtes d’API. Les sauvegardes suspendues ne nécessitent généralement aucune intervention manuelle. Après la synchronisation initiale, les sauvegardes incrémentielles suivantes se terminent généralement plus rapidement.
Une tâche de sauvegarde ou de restauration peut également être suspendue en raison d’une erreur temporaire du service Salesforce. Afi relance automatiquement la tâche, qui se termine normalement une fois le problème résolu. L’équipe Afi surveille en permanence les tâches suspendues et analyse de manière proactive les problèmes récurrents.