交互式可视化图表显示事件
项目描述
定义一个新的视图,以交互式可视化图表显示事件。
小部件基于外部库 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”: |
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问题上跟踪。如果遇到问题,请检查是否已报告您的问题。如果您是第一个发现的,请通过提供详细和受欢迎的反馈来帮助我们解决这个问题。
请勿直接联系贡献者寻求支持或技术问题的帮助。
致谢
贡献者
Laurent Mignon <laurent.mignon@acsone.eu>
Adrien Peiffer <adrien.peiffer@acsone.eu>
Pedro M. Baeza <pedro.baeza@tecnativa.com>
Leonardo Donelli <donelli@webmonks.it>
Adrien Didenot <adrien.didenot@horanet.com>
Dennis Sluijk <d.sluijk@onestein.nl>
Thong Nguyen Van <thongnv@trobz.com>
Alexandre Díaz <alexandre.diaz@tecnativa.com>
维护者
本模块由OCA维护。
OCA,即Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并推广其广泛使用。
当前 维护者
本模块是GitHub上OCA/web项目的组成部分。
欢迎您贡献。了解如何贡献,请访问https://odoo-community.org/page/Contribute。
项目详情
哈希值 for odoo13_addon_web_timeline-13.0.1.1.2-py3-none-any.whl
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 9dfb8a0de97e35a748a88e0e44abd82a62bf54b6375c0c3445e9aaa8ba244e3e |
|
MD5 | 00d860f1fa0229bd62a6a1edb4701bad |
|
BLAKE2b-256 | bab80dac91af922ebda3571080a55a9b8e99f9452e966fd7fa3c4deff3570cbc |