Solución de problemas¶
Este artículo explica los motivos habituales de los errores y las advertencias de las copias de seguridad y restauraciones de Salesforce, y cómo investigarlos y resolverlos.
Cómo ver y comprobar las tareas con estado Failed o Warning¶
En el panel Overview, el widget 7-day status muestra cuántas tareas han fallado o se han completado con advertencias en los últimos siete días. El widget 24-hour status resume los resultados de las tareas de las últimas 24 horas.
Puede configurar informes del servicio en la pestaña Configuration → Reports para recibir periódicamente información actualizada sobre las licencias, la protección y el estado de las copias de seguridad por correo electrónico, Slack, Microsoft Teams o Google Chat.
Para encontrar las tareas con errores o advertencias, vaya a la pestaña Activity → Tasks y seleccione Failed o Warning en el filtro Status.
Haga clic en una tarea para revisar sus detalles y los errores o advertencias notificados. Cada entrada de la sección Warnings explica el problema e identifica el SObject afectado y, cuando está disponible, el ID del registro.
En el caso de las tareas de restauración, revise también el resumen de la restauración, si está disponible.
Errores de copia de seguridad y restauración¶
El estado Failed significa que no se pudo completar la operación.
Errores de copia de seguridad más habituales:
| Error | Qué comprobar |
|---|---|
| Afi user or storage quota exceeded | Revise el uso del servicio y la cuota disponible del inquilino en la pestaña Licensing → Subscriptions. |
| Salesforce access unavailable | Confirme que la organización de Salesforce está disponible, que el paquete gestionado de Afi sigue instalado y que el usuario que autorizó a Afi está activo y tiene el acceso necesario a la API, los objetos, los campos y los archivos. Consulte Permisos de Salesforce. |
| Sandbox connection changed | Compruebe la conexión del sandbox en la pestaña Service → Protection antes de volver a intentar la copia de seguridad. |
Una vez resuelto el problema, haga clic en Backup now para volver a intentar la copia de seguridad.
Errores de restauración más habituales:
| Error | Qué comprobar |
|---|---|
| Recovery destination unavailable | Confirme que la organización o el sandbox seleccionados están conectados y accesibles, y que su usuario de integración tiene los permisos de escritura necesarios. Si se trata de un sandbox, vuelva a comprobar su conexión. |
| Salesforce storage limit reached | Revise el uso del almacenamiento de datos y de archivos en la organización de Salesforce de destino y libere la capacidad necesaria antes de volver a intentar la restauración. |
Si seleccionó Disable Salesforce automation during recovery, compruebe que los flujos, las reglas de flujo de trabajo y las reglas de validación que estaban activos se han vuelto a habilitar. Una restauración interrumpida puede dejarlos deshabilitados. Consulte Automatización durante la restauración para obtener más información.
Advertencias de copia de seguridad y restauración¶
El estado Warning significa que la operación se completó, pero se omitieron algunos SObjects o registros. Abra los detalles de la tarea para identificar los datos afectados y el motivo notificado.
Entre las advertencias habituales que pueden producirse durante una restauración se incluyen:
| Advertencia | Qué comprobar |
|---|---|
| Missing or read-only objects or fields | Compruebe el esquema del destino y los permisos de escritura del usuario de integración para los objetos y campos notificados. |
| Missing required parent record | Compruebe que el registro principal relacionado existe en el destino o está disponible en la copia de seguridad para restaurarlo. |
| Salesforce validation error | Revise la condición de validación notificada y los campos obligatorios, las reglas de duplicados y la automatización del destino. Los desencadenadores de Apex permanecen activos durante la restauración y pueden afectar a las escrituras. |
Afi restaura todos los datos seleccionados, excepto los SObjects o registros omitidos. Una vez resueltos los problemas notificados, le recomendamos seleccionar solo los datos omitidos para restaurarlos. También puede repetir la restauración de toda la selección original.
Informe CSV de excepciones de la restauración¶
Para una restauración completada con registros omitidos, abra la tarea de restauración en la pestaña Activity → Tasks y haga clic en Download restore summary. El archivo CSV enumera cada omisión registrada en tres columnas: sobject (objeto de Salesforce), record_id (ID original del registro) y error. El informe enumera las excepciones; no enumera cada escritura correcta ni cada correspondencia entre los ID de origen y de destino.
Copias de seguridad o restauraciones en pausa¶
Un motivo habitual por el que una copia de seguridad se pone en pausa es que se alcanzan los límites de API de Salesforce durante la sincronización inicial de una organización de producción o un sandbox. Afi pone en pausa la tarea afectada y la reintenta automáticamente, y la reanuda desde el estado guardado en cuanto Salesforce vuelve a permitir solicitudes de API. Las copias de seguridad en pausa no suelen requerir una solución manual de problemas. Tras la sincronización inicial, las copias de seguridad incrementales posteriores suelen completarse más rápido.
Una tarea de copia de seguridad o restauración también puede ponerse en pausa debido a un error temporal del servicio de Salesforce. Afi reintenta la tarea automáticamente y esta suele completarse una vez resuelto el problema. El equipo de Afi supervisa continuamente las tareas en pausa e investiga de forma proactiva los problemas recurrentes.