OdooWiki OCA HUB

Asynchronous Import

base_import_async folder_open OCA/queue open_in_new
Generic Modules Licencia: AGPL-3

Este módulo amplía la funcionalidad estándar de importación CSV para importar archivos en segundo plano utilizando el framework OCA/queue.

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.0

Añade una casilla de verificación "Importar en segundo plano" a la pantalla de importación CSV estándar, de modo que los archivos grandes se dividen en fragmentos y se procesan mediante la cola en lugar de bloquear al usuario.

Cuando importas un archivo CSV en Odoo, este módulo añade una nueva casilla de verificación etiquetada "Import in the background" en el panel lateral de importación. Si la marcas e inicias la importación, Odoo ya no espera a que se procese todo el archivo: guarda los datos como un adjunto y crea trabajos en segundo plano en su lugar.

El archivo se divide automáticamente en fragmentos más pequeños (100 líneas por defecto) en los límites de los registros, y cada fragmento se convierte en un trabajo independiente en la cola. Cada trabajo importa su propia parte del archivo, y si un fragmento falla, el error se reporta en el trabajo. Las descripciones de los trabajos muestran el modelo, el nombre del archivo, el número de fragmento y el rango de líneas, para que puedas seguir el progreso. El adjunto está vinculado al trabajo, y un botón de acción relacionado lo abre directamente desde el formulario del trabajo.

Un mensaje de advertencia te indica que tu solicitud se está procesando y que puedes seguirla en el menú "Queue / Jobs". El módulo funciona sobre el modelo base_import.import y extiende queue.job. Si no marcas la casilla de verificación, o si ejecutas una importación de prueba, se utiliza la importación inmediata estándar.

Depende de

base_importqueue_job

Lo necesitan otros módulos

Modelos y campos (1)
  • base_import.import · amplía un modelo existente

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-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 6 confirmadas, 3 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Al usuario se le presenta una nueva casilla de verificación en la pantalla de importación. Cuando se selecciona, la importación se aplaza en un trabajo en segundo plano.

Este trabajo, a su vez, divide el archivo CSV en fragmentos de mínimo 100 líneas (o más para alinearse con los límites de los registros). Cada fragmento se importa entonces en un trabajo en segundo plano independiente.

Cuando una importación falla, el trabajo se marca como tal y el usuario puede leer el error en el estado del trabajo. El fragmento de CSV que se está importando se almacena como un adjunto del trabajo, lo que facilita su descarga, su corrección y la ejecución de una nueva importación, posiblemente en modo síncrono, ya que los fragmentos son pequeños.

Cualquier archivo que pueda importarse mediante el mecanismo de importación estándar también puede importarse en segundo plano.

El alcance de este módulo se limita a hacer asíncronas las importaciones estándar. No intenta transformar los datos ni automatizar flujos ETL.

Otros módulos pueden beneficiarse de esta infraestructura de la siguiente manera (como se ilustra en la suite de pruebas):

  • crear una instancia de base_import.import y rellenar sus campos (res_model, file, file_name),
  • invocar el método do con las opciones adecuadas (header, encoding, separator, quoting, use_queue, chunk_size).

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.

info

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.