Skip to main content

Interactive visualization chart to show events in time

Project description

License: AGPL-3

Timeline view

Define a new view displaying events in an interactive visualization chart.

The widget is based on the external library http://visjs.org/timeline_examples.html

Configuration

You need to define a view with the tag <timeline> as base element. These are the possible attributes for the tag:

  • date_start (required): it defines the name of the field of type date that contains the start of the event.

  • date_end (optional): it defines the name of the field of type date that contains the end of the event.

  • date_delay (optional): it defines the name of the field of type date that contains the end of the event.

  • default_group_by (required): it defines the name of the field that will be taken as default group by when accessing the view or when no other group by is selected.

  • event_open_popup (optional): when set to true, it allows to edit the events in a popup. If not (default value), the record is edited changing to form view.

  • colors (optional): it allows to set certain specific colors if the expressed condition (JS syntax) is met.

You also need to declare the view in an action window of the involved model.

Example:

<?xml version="1.0" encoding="utf-8"?>
<odoo>
    <record id="view_task_timeline" model="ir.ui.view">
        <field name="model">project.task</field>
        <field name="type">timeline</field>
        <field name="arch" type="xml">
            <timeline date_start="date_start"
                      date_stop="date_end"
                      string="Tasks"
                      default_group_by="user_id"
                      event_open_popup="true"
                      colors="#ec7063:user_id == false;#2ecb71:kanban_state=='done';">
            </timeline>
        </field>
    </record>

    <record id="project.action_view_task" model="ir.actions.act_window">
        <field name="view_mode">kanban,tree,form,calendar,gantt,timeline,graph</field>
    </record>
</odoo>

Usage

For accessing the timeline view, you have to click on the button with the clock icon in the view switcher. The first time you access to it, the timeline window is zoomed to fit all the current elements, the same as when you perform a search, filter or group by operation.

You can use the mouse scroll to zoom in or out in the timeline, and click on any free area and drag for panning the view in that direction.

The records of your model will be shown as rectangles whose widths are the duration of the event according our definition. You can select them clicking on this rectangle. You can also use Ctrl or Shift keys for adding discrete or range selections. Selected records are hightlighted with a different color (but the difference will be more noticeable depending on the background color). Once selected, you can drag and move the selected records across the timeline.

When a record is selected, a red cross button appears on the upper left corner that allows to remove that record. This doesn’t work for multiple records although they were selected.

Records are grouped in different blocks depending on the group by criteria selected (if none is specified, then the default group by is applied). Dragging a record from one block to another change the corresponding field to the value that represents the block. You can also click on the group name to edit the involved record directly.

Double-click on the record to edit it. Double-click in open area to create a new record with the group and start date linked to the area you clicked in.

Try me on Runbot

Known issues / Roadmap

  • Implement support for vis.js timeline range item addition (with Ctrl key pressed).

  • Implement a more efficient way of refreshing timeline after a record update.

Bug Tracker

Bugs are tracked on GitHub Issues. 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.

Credits

Images

  • Odoo Community Association: Icon.

Contributors

Maintainer

Odoo Community Association

This module is maintained by the OCA.

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.

To contribute to this module, please visit https://odoo-community.org.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

File details

Details for the file odoo8_addon_web_timeline-8.0.1.0.0.99.dev2-py2-none-any.whl.

File metadata

File hashes

Hashes for odoo8_addon_web_timeline-8.0.1.0.0.99.dev2-py2-none-any.whl
Algorithm Hash digest
SHA256 c842f1aaafcea9fb3833629f18918c7ead95bacd26465e5c00beb15de414768d
MD5 5d095c7ccdac299a1cd2298de7ea160f
BLAKE2b-256 a4db193e435ccaf54e7eae0be4e1c23216af40b8e14151c7f1b2994230bcf721

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page