Author: |
Savoir-faire Linux,Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
8.0 |
Repository: |
apetbiz/connector-redmine |
Dependencies: |
connector,
connector_redmine,
hr_timesheet_sheet,
and
web |
Languages: |
JavaScript (53, 5.4%),
PO File (183, 18.8%),
Python (573, 58.8%),
SVG (34, 3.5%),
XML (73, 7.5%),
and
reStructuredText (59, 6.1%) |
Other branches: |
7.0 |
Other repositories: |
ClearCorp/oca-connector-redmine,
Endika/connector-redmine,
Ingeos/connector-redmine,
NeatNerdPrime/connector-redmine,
OCA/connector-redmine,
SeuMarco/connector-redmine,
Thipas/connector-redmine,
VisiionSolucionesTecnologicas/connector-redmine,
ashcharles/connector-redmine,
daltinn/connector-redmine,
dvitme/connector-redmine,
eLBati/connector-redmine,
elego/connector-redmine,
haroldtamo/connector-redmine,
initOS/connector-redmine,
isoscl/connector-redmine,
jacob1264/connector-redmine,
lideritjnma/connector-redmine,
pscloud/connector-redmine,
rokealva83/connector-redmine,
rossasa/connector-redmine,
savoirfairelinux/connector-redmine,
syci/connector-redmine,
tafaRU/connector-redmine,
and
x0rzkov/odoo-connector-redmine |
<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg">
</a>
<a name="redmine-import-time-entry"></a>
<h2>Redmine Import Time Entry</h2>
<p>Connector used to import Redmine time entries as Odoo analytic timesheets in batch.</p>
<p>To use this module, you must add a custom field on your Redmine projects. You can give the name you want
to this field, but every project must have a different value for this field.</p>
<p>In Odoo, you must create an analytic account for each Redmine project.
The value of the custom field must be written in the field ref ('Reference') of the analytic account.</p>
<a name="installation"></a>
<h3>Installation</h3>
<p>Nothing to do.</p>
<a name="configuration"></a>
<h3>Configuration</h3>
<p># Go to Connectors -> Redmine -> Backends and select your Redmine backend</p>
<p># Enter the name of the custom field used to identify projects in Redmine</p>
<p># Click on the button to test the custom field</p>
<dl class="docutils">
<dt># The field "Time Entries - Number of days" is by default set to 14. This means that the connector will</dt>
<dd>only fetch time entries that have a date between 2 weeks ago and now. Of course, the connector will only
create single jobs for Redmine records that have been updated since the last update.</dd>
</dl>
<p>You must set one Redmine service as the default one. For this, you may check the box <cite>Default Redmine Service</cite>.
By default, the timesheets of every user will be imported from that redmine service. If a user needs to
import his timesheets from a different redmine service, he may change it in his preference settings,
the same way you switch companies.</p>
<a name="usage"></a>
<h3>Usage</h3>
<p>To use this module, you need to:</p>
<ol class="arabic simple">
<li>Go to ...</li>
</ol>
<a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/169/8.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a>
<a name="known-issues-roadmap"></a>
<h3>Known issues / Roadmap</h3>
<p>The Redmine API does not allow to fetch time entry records based on the last update field.
For this reason, the connector fetches every records for a period of time (e.g. 2 weeks) as explained in Configuration.</p>
<a name="timesheet-entries-update"></a>
<h4>Timesheet Entries Update</h4>
<p>In vanilla Odoo, there is a flaw of design with the timesheet widget. When you modify a time entry using
the widget, instead of updating the existing records, Odoo deletes all records and creates all of them from
the begginning. Not only it has a performance impact, but it also conflicts with the Redmine Connector. This is
why the widget is fixed in this module so that entries are updated intead of recreated.</p>
<p>This issue has another impact. The field partner_id on analytic.timesheet.line is related and it is not readonly.
This is a flaw of design but in vanilla Odoo, it does not cause issues because of the entries are not updated.
Therefore, the field partner_id is set to readonly to prevent access errors.</p>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/connector-redmine/issues">GitHub Issues</a>. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
help us smashing it by providing a detailed and welcomed feedback.</p>
<a name="credits"></a>
<h3>Credits</h3>
<a name="contributors"></a>
<h4>Contributors</h4>
<ul class="simple">
<li>Maxime Chambreuil <<a class="reference external" href="mailto:maxime.chambreuil@savoirfairelinux.com">maxime.chambreuil@savoirfairelinux.com</a>></li>
<li>David Dufresne <<a class="reference external" href="mailto:david.dufresne@savoirfairelinux.com">david.dufresne@savoirfairelinux.com</a>></li>
</ul>
<a name="maintainer"></a>
<h4>Maintainer</h4>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>This module is maintained by the OCA.</p>
<p>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.</p>
<p>To contribute to this module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>.</p>