Fehlerbehebung¶
Dieser Artikel erläutert häufige Ursachen für Fehler und Warnungen bei Salesforce-Sicherungen und -Wiederherstellungen und beschreibt, wie Sie diese untersuchen und beheben.
Aufgaben mit dem Status Failed oder Warning anzeigen und prüfen¶
Im Dashboard Overview zeigt das Widget 7-day status an, wie viele Aufgaben in den letzten sieben Tagen fehlgeschlagen oder mit Warnungen abgeschlossen worden sind. Das Widget 24-hour status fasst die Aufgabenergebnisse der letzten 24 Stunden zusammen.
Sie können auf der Registerkarte Configuration → Reports Dienstberichte konfigurieren, um regelmäßig per E-Mail, Slack, Microsoft Teams oder Google Chat über Lizenzierung, Schutz und Sicherungsstatus informiert zu werden.
Um Aufgaben mit Fehlern oder Warnungen zu finden, wechseln Sie zur Registerkarte Activity → Tasks und wählen Sie im Filter Status den Wert Failed oder Warning aus.
Klicken Sie auf eine Aufgabe, um ihre Details und gemeldete Fehler oder Warnungen zu prüfen. Jeder Eintrag im Abschnitt Warnings erläutert das Problem und nennt das betroffene SObject sowie, sofern verfügbar, die Datensatz-ID.
Prüfen Sie bei Wiederherstellungsaufgaben außerdem die Wiederherstellungszusammenfassung, sofern verfügbar.
Fehler bei Sicherung und Wiederherstellung¶
Der Status Failed bedeutet, dass der Vorgang nicht abgeschlossen werden konnte.
Häufigste Sicherungsfehler:
| Fehler | Zu prüfen |
|---|---|
| Afi user or storage quota exceeded | Prüfen Sie auf der Registerkarte Licensing → Subscriptions die Dienstnutzung und das verfügbare Kontingent des Mandanten. |
| Salesforce access unavailable | Vergewissern Sie sich, dass die Salesforce-Organisation verfügbar ist, das verwaltete Afi-Paket weiterhin installiert ist und der Benutzer, der Afi autorisiert hat, aktiv ist und über die erforderlichen Zugriffsrechte für API, Objekte, Felder und Dateien verfügt. Siehe Salesforce-Berechtigungen. |
| Sandbox connection changed | Prüfen Sie die Verbindung der Sandbox auf der Registerkarte Service → Protection, bevor Sie die Sicherung wiederholen. |
Klicken Sie nach Behebung des Problems auf Backup now, um die Sicherung zu wiederholen.
Häufigste Wiederherstellungsfehler:
| Fehler | Zu prüfen |
|---|---|
| Recovery destination unavailable | Vergewissern Sie sich, dass die ausgewählte Salesforce-Organisation oder Sandbox verbunden und erreichbar ist und dass ihr Integrationsbenutzer über die erforderlichen Schreibberechtigungen verfügt. Prüfen Sie bei einer Sandbox erneut deren Verbindung. |
| Salesforce storage limit reached | Prüfen Sie die Nutzung des Daten- und Dateispeichers in der Salesforce-Zielorganisation und geben Sie die erforderliche Kapazität frei, bevor Sie die Wiederherstellung wiederholen. |
Wenn Sie Disable Salesforce automation during recovery ausgewählt haben, prüfen Sie, ob die zuvor aktiven Flows, Workflow-Regeln und Validierungsregeln wieder aktiviert sind. Eine unterbrochene Wiederherstellung kann sie deaktiviert zurücklassen. Weitere Informationen finden Sie unter Automatisierung während der Wiederherstellung.
Warnungen bei Sicherung und Wiederherstellung¶
Der Status Warning bedeutet, dass der Vorgang abgeschlossen wurde, einige SObjects oder Datensätze jedoch übersprungen wurden. Öffnen Sie die Aufgabendetails, um die betroffenen Daten und den gemeldeten Grund zu ermitteln.
Zu den häufigen Warnungen, die bei einer Wiederherstellung auftreten können, gehören:
| Warnung | Zu prüfen |
|---|---|
| Missing or read-only objects or fields | Prüfen Sie das Schema des Ziels und die Schreibberechtigungen des Integrationsbenutzers für die gemeldeten Objekte und Felder. |
| Missing required parent record | Prüfen Sie, ob der zugehörige übergeordnete Datensatz im Ziel vorhanden oder in der Sicherung zur Wiederherstellung verfügbar ist. |
| Salesforce validation error | Prüfen Sie die gemeldete Validierungsbedingung sowie die Pflichtfelder, Duplikatsregeln und Automatisierungen des Ziels. Apex-Trigger bleiben während der Wiederherstellung aktiv und können Schreibvorgänge beeinflussen. |
Afi stellt alle ausgewählten Daten mit Ausnahme der übersprungenen SObjects oder Datensätze wieder her. Nachdem Sie die gemeldeten Probleme behoben haben, empfehlen wir, nur die übersprungenen Daten für die Wiederherstellung auszuwählen. Sie können die Wiederherstellung auch für die gesamte ursprüngliche Auswahl wiederholen.
CSV-Ausnahmebericht der Wiederherstellung¶
Öffnen Sie bei einer abgeschlossenen Wiederherstellung mit übersprungenen Datensätzen die Wiederherstellungsaufgabe auf der Registerkarte Activity → Tasks und klicken Sie auf Download restore summary. Die CSV-Datei führt jeden erfassten übersprungenen Eintrag in drei Spalten auf: sobject (Salesforce-Objekt), record_id (ursprüngliche Datensatz-ID) und error. Der Bericht listet Ausnahmen auf; er enthält weder jeden erfolgreichen Schreibvorgang noch jede Zuordnung von Quell- zu Ziel-IDs.
Angehaltene Sicherungen oder Wiederherstellungen¶
Ein häufiger Grund für eine angehaltene Sicherung ist das Erreichen von Salesforce-API-Limits bei der ersten Synchronisierung einer Produktionsorganisation oder Sandbox. Afi hält die betroffene Aufgabe an und wiederholt sie automatisch. Dabei wird sie aus dem gespeicherten Zustand fortgesetzt, sobald Salesforce wieder API-Anforderungen zulässt. Angehaltene Sicherungen erfordern normalerweise keine manuelle Fehlerbehebung. Nach der ersten Synchronisierung werden nachfolgende inkrementelle Sicherungen in der Regel schneller abgeschlossen.
Eine Sicherungs- oder Wiederherstellungsaufgabe kann auch aufgrund eines vorübergehenden Salesforce-Dienstfehlers angehalten werden. Afi wiederholt die Aufgabe automatisch, und sie wird normalerweise abgeschlossen, sobald das Problem behoben ist. Das Afi-Team überwacht angehaltene Aufgaben fortlaufend und untersucht wiederkehrende Probleme proaktiv.