Este módulo añade la función de sincronización con Jira. Funciona con Jira Cloud comportándose como una Atlassian Connect App.
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 17.0Conecta Odoo con Jira Cloud para sincronizar proyectos, tareas y partes de horas (worklogs). Vincula proyectos de Odoo con proyectos de Jira, importa incidencias de Jira como tareas e importa worklogs de Jira como entradas de partes de horas.
Este módulo añade una configuración de backend de Jira bajo el menú Connector. Los usuarios pueden configurar una conexión a Jira Cloud registrando Odoo como una Atlassian Connect App y, a continuación, vincular proyectos de Odoo a proyectos de Jira.
Una vez vinculados, las incidencias de Jira se importan como tareas de Odoo, y los worklogs de Jira se importan como partes de horas en el proyecto y la tarea correspondientes. El módulo añade campos relacionados con JIRA en proyectos, tareas y partes de horas, como la clave de JIRA, la URL de la incidencia, el enlace de épica y el tipo de incidencia.
Las reglas de negocio incluyen: las partes de horas vinculadas a un worklog de Jira no se pueden modificar ni eliminar; los proyectos vinculados a Jira no pueden tener nuevas partes de horas creadas manualmente; solo una vinculación por proyecto puede establecerse en 'Export' a Jira; las claves de Jira deben seguir un formato específico; y los proyectos exportados no se pueden eliminar.
Los trabajos programados (cron) importan automáticamente tareas de proyecto, worklogs y usuarios desde Jira, y eliminan worklogs adicionales. Un asistente permite actualizar los worklogs desde Jira para las líneas de partes de horas seleccionadas. El módulo también proporciona un botón para comprobar la conexión e importar los tipos de incidencia.
Depende de
Lo necesitan otros módulos
Menús que añade
Modelos y campos (30)
- jira.base · modelo nuevo
- queue.job · amplía un modelo existente
- res.users · amplía un modelo existentejira_bind_ids (User Bindings)
- jira.binder · modelo nuevo
- jira.backend · modelo nuevouri (Jira URI), name, state, company_id (Company), public_key, verify_ssl (Verify SSL?), display_url, private_key, issue_type_ids (Issue Types), application_key, project_template (Default Project Template), report_user_sync, epic_link_on_epic, app_descriptor_url (App Descriptor URL), epic_link_field_name (Epic Link Field), epic_name_field_name (Epic Name Field), worklog_date_timezone, project_template_shared (Default Shared Template Key), import_project_task_force, import_analytic_line_force, worklog_date_timezone_mode, worklog_fallback_project_id (Fallback for Worklogs), import_project_task_from_date (Import Project Tasks from date), delete_analytic_line_from_date (Delete Extra Worklogs from date), import_analytic_line_from_date (Import Worklogs from date)
- jira.binding · modelo nuevobackend_id (Jira Backend), external_id (ID on Jira)
- jira.deleter · modelo nuevo
- project.task · amplía un modelo existentejira_bind_ids (Task Bindings), jira_issue_url (JIRA issue), jira_issue_type (JIRA Issue Type), jira_compound_key (JIRA Key), jira_parent_task_id (JIRA Parent), jira_epic_link_task_id (JIRA Epic)
- jira.exporter · modelo nuevo
- jira.importer · modelo nuevo
- jira.res.users · modelo nuevoodoo_id (User)
- task.link.jira · modelo nuevotask_id, jira_key (JIRA Key), backend_id (Jira Backend), jira_task_id, linked_backend_ids
- jira.issue.type · modelo nuevoname, backend_id, description
- project.project · amplía un modelo existentejira_key (JIRA Key), jira_bind_ids (Project Bindings)
- jira.model.binder · modelo nuevo
- jira.project.task · modelo nuevoodoo_id (Task), jira_key (Key), jira_issue_url (JIRA issue), jira_parent_id (Parent Issue), jira_epic_link_id (Epic), jira_issue_type_id (Issue Type), jira_project_bind_id
- project.link.jira · modelo nuevojira_key, backend_id (Jira Backend), project_id, jira_project_id
- jira.base.exporter · modelo nuevo
- jira.import.mapper · modelo nuevo
- jira.batch.importer · modelo nuevo
- jira.project.binder · modelo nuevo
- jira.backend.adapter · modelo nuevo
- jira.project.adapter · modelo nuevo
- jira.project.project · modelo nuevoodoo_id (Project), project_type
- jira.worklog.adapter · modelo nuevo
- account.analytic.line · amplía un modelo existentejira_bind_ids (Worklog Bindings), jira_issue_key (Original JIRA Issue Key), jira_issue_url (Original JIRA issue Link), jira_issue_type_id (Original JIRA Issue Type), jira_epic_issue_key (Original JIRA Epic Key), jira_epic_issue_url (Original JIRA Epic Link)
- jira.backend.timestamp · modelo nuevobackend_id (Jira Backend), component_usage, from_date_field
- jira.issue.type.mapper · modelo nuevo
- jira.mapper.from.attrs · modelo nuevo
- jira.res.users.adapter · modelo nuevo
Texto generado por IA (DeepSeek) al leer el código de la versión 17.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. 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 15.0
Confirmado el 2026-11-03 en la rama 15.0 de OCA/connector-jira.
terminal Instalación y uso
Documentación de OCA · Odoo 17.0Instalación
Fuente · Odoo 17.0Necesitas los siguientes paquetes de Python:
- requests
- jira
- oauthlib
- requests-oauthlib
- requests-toolbelt
- PyJWT
- cryptography
- atlassian-jwt
Una vez instalado el addon, sigue estos pasos:
Job Queue
En odoo.conf, configura de forma similar:
[queue_job]
channels = root:1,root.connector_jira.import:2Backend
- Abre el menú Connectors \> Jira \> Backends
- Crea un nuevo Jira Backend
- Pon el nombre que quieras
- También puedes seleccionar la compañía donde se crearán los registros y la plantilla de proyecto predeterminada usada cuando Odoo cree los proyectos en Jira
- Guarda
- Anota el valor de la App Descriptor URL (importante: asegúrate de que el parámetro del sistema web.base.url esté configurado correctamente. Para desarrollo local querrás usar ngrok para que tu ordenador sea accesible por https desde Jira Cloud).
Instalar el backend como una Jira App
En caso de que esto quede desactualizado, consulta
- Inicia sesión en marketplace.atlassian.com (posiblemente crea una cuenta)
- En la esquina superior derecha, el icono con tu avatar lleva a un menú -\> selecciona la entrada Publish an App
- En la pantalla Publish a new app:
- selecciona un Vendor (normalmente tu compañía)
- sube tu app: selecciona Provide a URL to your artifact
- haz clic en el botón Enter URL
- pega la App Descriptor URL en la ventana emergente y haz clic en el botón Done
- el campo Name debería rellenarse con el nombre de tu backend
- Compatible application: selecciona Jira
- build number: puede dejarse como está
- Haz clic en el botón Save as private (!) Importante: no hagas clic en el botón "Next: Make public". Ese flujo permitiría a cualquiera en Jira Cloud instalar tu backend.
- En la siguiente pantalla, puedes ir a la página "Private Listings" y hacer clic en el botón "Create a token": este token puede usarse para instalar la app en tu instancia de Jira.
Instalar la Jira App en tu instancia de Jira Cloud
- Conéctate a tu instancia de Jira con una cuenta con acceso de Admin
- En el menú Apps, selecciona Manage your apps
- En la pantalla Apps, haz clic en el enlace Settings que está bajo la lista User-installed apps
- En la pantalla de settings, marca la casilla Enable private listings y haz clic en Apply
- Actualiza la página Apps: deberías ver un enlace Upload app: haz clic en él
- En el diálogo Upload app, pega la token URL que recibiste en el procedimiento anterior y haz clic en Upload
Configuración del Backend
Volviendo a Odoo, el backend debería estar ahora en el estado Running, con algo de información rellenada, como la Jira URI.
Configurar el Epic Link
Si usas Epics, necesitas hacer clic en "Configure Epic Link", Odoo buscará el nombre del campo personalizado usado para el Epic Link.
¡Enhorabuena, has terminado!
Las tareas y los worklogs siempre se importan de JIRA a Odoo, no hay sincronización en la otra dirección.
Sincronizaciones iniciales
Ya puedes seleccionar la pestaña "Imports" en el Backend y hacer clic en "Link users" e "Import issue types". Los usuarios se emparejarán ya sea por login o por email.
Crear y exportar un proyecto
Los proyectos se pueden crear en Odoo y exportar a Jira. Puedes entonces crear un proyecto y usar la acción "Link with JIRA" y usar la acción "Export to JIRA".
Cuando eliges exportar un proyecto a JIRA, si cambias el nombre o la clave del proyecto, los nuevos valores se enviarán a JIRA.
Vincular un proyecto con JIRA
Si ya tienes un proyecto en JIRA o prefieres crearlo primero en JIRA, puedes vincular un proyecto de Odoo. Usa la acción "Link with JIRA" en el proyecto y selecciona la acción "Link with JIRA".
Esta acción establece el vínculo, entonces los cambios del nombre o de la clave en cualquiera de los dos lados no se envían.
Issue Types en los proyectos
Cuando vinculas un proyecto, tienes que seleccionar qué issue types se sincronizan. Solo se crearán en Odoo las tareas de los tipos seleccionados.
Si se añade un worklog de JIRA a un tipo de issue que no está sincronizado, se adjuntará a la tarea más cercana siguiendo estas reglas:
- si es una subtask, buscar la tarea padre
- si no hay tarea padre, buscar la tarea epic (solo si está en el mismo proyecto)
- si no hay epic, adjuntar al proyecto sin vincularse a una tarea
Cambiar la configuración de sincronización en un proyecto
Si quieres cambiar la configuración de un proyecto, como qué issue types se sincronizan, puedes abrir la pestaña "Connector" en los ajustes del proyecto y editar el "binding" con el backend.
Sincronizar tareas y worklogs
Si los webhooks están activos, en cuanto se creen en Jira deberían aparecer en Odoo. Si no están activos, puedes abrir el Jira Backend y ejecutar las sincronizaciones manualmente, o activar las Scheduled Actions para ejecutar las importaciones por lotes. Es importante seleccionar los issue types, así que no te saltes este paso (necesita mejoras).
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: 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.