Este módulo permite importar/exportar archivos desde/hacia servidores backend.
Un servidor backend se define mediante el módulo básico fs_storage de OCA, aunque puede configurarse (amazon S3, sftp,...) con módulos adicionales de librerías python fs
Los archivos importados (y los archivos a exportar) se almacenan en Odoo como objetos attachment.queue, definidos por el módulo attachment_queue, mientras que la importación en sí (resp. exportación) se realiza mediante "Attachments Import Tasks" (resp. "Attachments Export Tasks") definidos por este módulo actual.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 18.0Crea tareas programadas que importen automáticamente archivos desde un backend de almacenamiento externo a los adjuntos de Odoo, o exporten los adjuntos de Odoo de vuelta a ese backend, con opciones para renombrar, mover, eliminar u omitir duplicados.
Este módulo añade una nueva pantalla llamada 'Attachment synchronize task' donde se define un trabajo que importa archivos desde un backend de almacenamiento externo o exporta adjuntos de Odoo a él. Cada tarea está vinculada a un backend de almacenamiento y a una ruta de archivo, y se elige si es una Import Task o una Export Task.
Para las tareas de importación se puede: - Seleccionar archivos usando un patrón (por ejemplo *.txt) o tomar todo lo que hay en la carpeta. - Evitar importar archivos que ya existen como adjuntos. - Después de la importación, renombrar, mover, mover y renombrar, o eliminar automáticamente el archivo de origen. El renombrado puede usar una plantilla basada en el nombre del archivo original. - Asignar un tipo de archivo a los adjuntos creados y establecer correos de notificación de fallos.
Para las tareas de exportación, los adjuntos pendientes vinculados a la tarea se envían al backend, y la carpeta se crea si es necesario. Si la transferencia agota el tiempo de espera, se reintenta más tarde.
Las tareas se pueden ejecutar manualmente con un botón Run, o automáticamente mediante un trabajo programado (deshabilitado por defecto, se ejecuta cada 30 minutos cuando está habilitado). El formulario de la tarea muestra contadores de adjuntos fallidos, pendientes y realizados, y el formulario del backend de almacenamiento muestra cuántas tareas de importación y exportación lo utilizan. Los menús aparecen bajo el menú de almacenamiento como 'Attachments Import Tasks' y 'Attachments Export Tasks'.
Depende de
Menús que añade
Modelos y campos (3)
- fs.storage · amplía un modelo existenteexport_task_count (Export Tasks), import_task_count (Import Tasks), synchronize_task_ids (Tasks)
- attachment.queue · amplía un modelo existentetask_id (Task), file_type, method_type, fs_storage_id (Filestore Storage)
- attachment.synchronize.task · modelo nuevoname, active (Enabled), pattern (Selection Pattern), filepath (File Path), new_name, file_type, move_path, backend_id (Backend), method_type, after_import, attachment_ids (Attachment), failure_emails, count_attachment_done, avoid_duplicated_files (Avoid importing duplicated files), count_attachment_failed, count_attachment_pending
Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 4 confirmadas, 5 sin información de 9 versiones.
Fuentes · Odoo 14.0
Confirmado el 2026-11-03 en la rama 14.0 de OCA/server-tools.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Como la importación y la exportación son procesos diferentes, se activan de formas distintas:
Para importar archivos, debe crear una "Attachment Import Task" (menú Settings \> Technical \> Attachments Import Tasks) que define:
- dónde encontrar los archivos a importar desde el servidor backend (ruta a los archivos, patrón de selección)
- qué hacer con los archivos de origen en el servidor backend (evitar duplicados, eliminar/renombrar después de la importación...)
- cómo se procesarán los archivos una vez importados (a través del campo File Type).
> 🔎 Las opciones de File Type están definidas por otros módulos construidos para > procesar las Attachments Queues con el mismo "File Type".
Para exportar archivos, primero debe registrarlos como objetos "Attachments Queues" vinculados a una "Attachment Export Task" (que establece automáticamente su File Type a "Export File (External Location)").
Después, puede exportar un archivo a la vez desde la vista de formulario de la Attachment Queue, o exportar todas las Attachments Queues en estado pendiente relacionadas con la misma Export Task desde la vista de formulario de la Export Task dada (menú Settings \> Technical \> Attachments Export Tasks):
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.