跳转到主要内容

交互式可视化图表显示事件

项目描述

Production/Stable License: AGPL-3 OCA/web Translate me on Weblate Try me on Runbot

定义一个新的视图,以交互式可视化图表显示事件。

小部件基于外部库 https://visjs.github.io/vis-timeline/examples/timeline

目录

配置

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

属性

必需?

描述

date_start

定义包含事件开始日期的字段名称。

date_stop

定义包含事件结束日期的字段名称。date_stop 可以与 date_start 相等,以在时间轴上显示事件为“点”(瞬时事件)。

date_delay

定义包含事件持续时间(以小时为单位)的字段名称,默认 = 1。

default_group_by

定义在访问视图或未选择其他分组方式时用作默认分组的字段名称。

zoomKey

指定是否仅在按下其他键时缩放时间轴。可用的值是‘’(不适用)、‘altKey’、‘ctrlKey’或‘metaKey’。如果您想能够在事件很多的视图中使用滚动进行垂直导航,请设置此选项。

mode

指定初始可见窗口。可用的值有:‘day’以显示当前天,‘week’,‘month’和‘fit’。默认值是‘fit’,以调整可见窗口使其适合所有项目。

边距

指定项目周围的边距。它应遵循JSON格式。例如:‘{“item”:{“horizontal”:-10}}’。可用的值有:‘{“axis”:}’(项目与时间轴之间像素的最小边距)‘{“item”:}’(水平方向和垂直方向项目之间像素的最小边距),‘{“item”:{“horizontal”:}}’(项目之间像素的最小水平边距),‘{“item”:{“vertical”:}}’(项目之间像素的最小垂直边距),‘{“item”:{“horizontal”:,“vertical”:}}’(项目之间水平与垂直边距的像素组合)。

event_open_popup

当设置为true时,允许在弹出窗口中编辑事件。如果没有(默认值),则通过更改到表单视图来编辑记录。

堆叠

当设置为false时,项目将不会堆叠在一起,从而不会重叠。

颜色

允许在满足表达的条件(JS语法)时设置特定颜色。

dependency_arrow

将该属性设置为x2many字段,以便在x2many字段中引用的记录之间绘制箭头。

可选地,您可以声明一个自定义模板,该模板将用于渲染时间线项目。您必须命名模板为‘timeline-item’。以下是在模板渲染中可用的变量

  • record:用于访问在时间线定义中选择的字段值。

  • field_utils:用于格式化和解析值(请参阅web.field_utils中可用的函数)。

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

示例

<?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_assign"
                      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';"
                      dependency_arrow="task_dependency_ids">
                <field name="user_id"/>
                <templates>
                    <div t-name="timeline-item">
                        <div t-esc="record.display_name"/>
                        Assigned to:
                        <span t-esc="record.user_id[1]"/>
                    </div>
                </templates>
            </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键进行离散或范围选择。选定的记录以不同的颜色突出显示(但与背景颜色有关,差异会更明显)。一旦选择,您就可以拖动并移动所选记录穿过时间线。

当记录被选中时,在左上角会出现一个红色十字按钮,允许删除该记录。这对于多个记录不起作用,尽管它们已被选中。

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

双击记录进行编辑。在打开的区域双击以创建一个新记录,该记录与组以及您单击的区域关联的起始日期链接。通过按住Ctrl键并向左拖动,您可以创建一个新记录,其中拖动的起始和结束日期。

已知问题/路线图

  • 实现记录更新后刷新时间线的一种更有效的方法;

  • 使attrs属性工作;

  • 使操作属性(创建、编辑、删除)在表单和树视图中像工作一样。

错误跟踪器

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

请勿直接联系贡献者寻求支持或技术问题的帮助。

致谢

作者

  • ACSONE SA/NV

  • Tecnativa

  • Monk Software

  • Onestein

  • Trobz

贡献者

维护者

本模块由OCA维护。

Odoo Community Association

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

当前 维护者

tarteo

本模块是GitHub上OCA/web项目的组成部分。

欢迎您贡献。了解如何贡献,请访问https://odoo-community.org/page/Contribute

项目详情


下载文件

下载您平台上的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码分发

本版本没有提供源代码分发文件。请参阅生成分发归档的教程。

构建分发

odoo13_addon_web_timeline-13.0.1.1.2-py3-none-any.whl (358.7 kB 查看哈希值)

上传时间 Python 3

支持者