===============================
Scheduled Actions as Queue Jobs
===============================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:05503038ea739eba498d5a32ad2c7f487a1c6c1adf85ede63961f4111d755267
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fqueue-lightgray.png?logo=github
    :target: https://github.com/OCA/queue/tree/16.0/queue_job_cron
    :alt: OCA/queue
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/queue-16-0/queue-16-0-queue_job_cron
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/queue&target_branch=16.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module extends the functionality of queue_job and allows to run an Odoo
cron as a queue job.

**Table of contents**

.. contents::
   :local:

Installation
============

To install this module, you need to:

#. Just install it.

Usage
=====

To use this module, you need to:

#. Go to a scheduled action, a flag "Run as queue job" will allow you to run
the action as a queue job. You will also allowed to select a channel of its
execution.
To configure dedicated channels please refers to queue_job help: https://github.com/OCA/queue/blob/12.0/queue_job/README.rst

Channels can be used to manage sequential jobs and prevent concurrency accesses.
To do that you just have to define a channel per cron limited to 1 at time.

Changelog
=========

16.0.2.0.0 (2024-01-08)
~~~~~~~~~~~~~~~~~~~~~~~

**Features**

- By default prevent parallel run of the same cron job when run as queue job.

  When a cron job is run by odoo, the odoo runner will prevent parallel run
  of the same cron job. Before this change, this was not the case when the
  cron job was run as a queue job. A new option is added to the cron job when
  run as a queue job to prevent parallel run. This option is set to True by
  default. In this way, the behavior is now the same as when the cron job is run
  by odoo but you keep the possibility to disable this restriction when run as
  a queue job. (`#612 <https://github.com/OCA/queue/issues/612>`_)

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/queue/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/queue/issues/new?body=module:%20queue_job_cron%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* ACSONE SA/NV

Contributors
~~~~~~~~~~~~

* Cédric Pigeon <cedric.pigeon@acsone.eu>

Maintainers
~~~~~~~~~~~

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

This module is part of the `OCA/queue <https://github.com/OCA/queue/tree/16.0/queue_job_cron>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
