odoo10-addon-web-timeline 10.0.1.2.1

配置

您需要定义一个带有标签 <timeline> 的视图作为基本元素。以下是该标签的可能属性

• date_start (必需)：它定义了包含事件开始日期的字段名称。

• date_end (可选)：它定义了包含事件结束日期的字段名称。date_end 可以等于 date_start 属性，以在时间轴上显示“点”事件（瞬间事件）

• date_delay (可选)：它定义了包含事件持续时间的浮点数/整数字段名称，单位为小时，默认值 = 1

• default_group_by (必需)：它定义了在访问视图或未选择其他分组时用作默认分组的字段名称。

• zoomKey (可选)：指定是否只有在按下一个附加键时才对时间轴进行缩放。可用值是：''（不适用）、'altKey'、'ctrlKey' 或 'metaKey'。如果您想能够在具有大量事件的视图中使用滚动来垂直导航，请设置此选项。

• mode (可选)：指定初始可见窗口。可用值是：'day'（显示当前日）、'week'（周）、'month' 和 'fit'。默认值是 'fit' 以调整可见窗口，使其适合所有项目

• event_open_popup (可选)：当设置为 true 时，允许在弹出窗口中编辑事件。如果不（默认值），则通过切换到表单视图来编辑记录。

• 颜色（可选）：如果满足所表达的条件（JS语法），则允许设置某些特定的颜色。

您还需要在涉及模型的操作窗口中声明视图。

示例

<?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"
                      zoomKey="ctrlKey"
                      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>

用法

要访问时间轴视图，您必须单击视图切换器中的带有时钟图标的按钮。第一次访问时，时间轴窗口会缩放到适合所有当前元素，这与您执行搜索、筛选或按组操作时相同。

您可以使用鼠标滚轮在时间轴上放大或缩小，并单击任何空白区域并拖动以在该方向上平移视图。

您的模型记录将显示为矩形，其宽度根据我们的定义表示事件的持续时间。您可以通过单击此矩形来选择它们。您还可以使用Ctrl或Shift键进行离散或范围选择。所选记录以不同的颜色突出显示（但与背景颜色有关，差异会更明显）。一旦选择，您就可以拖动并沿时间轴移动所选记录。

当记录被选中时，在左上角出现一个红色十字按钮，允许删除该记录。尽管选择了多个记录，但这不起作用。

根据所选的按组标准，记录被分组在不同的块中（如果没有指定，则应用默认的按组）。将记录从一块拖动到另一块会更改相应的字段，以表示该块。您还可以单击组名称直接编辑涉及的记录。

双击记录进行编辑。双击空白区域以创建一个新记录，并将组以及开始日期链接到您单击的区域。

已知问题/路线图

• 实现支持vis.js时间轴范围项添加（按住Ctrl键）。

• 实现记录更新后刷新时间轴的更高效方法。

错误跟踪器

错误在GitHub Issues上跟踪。如果遇到问题，请检查是否已经报告了您的问题。如果您是第一个发现它的人，请通过提供详细且受欢迎的反馈来帮助我们解决问题。

鸣谢

维护者

此模块由OCA维护。

OCA，即Odoo社区协会，是一个非营利组织，其使命是支持Odoo功能的协作开发并促进其广泛应用。

要为此模块做出贡献，请访问https://odoo-community.org。