odoo-addon-web-timeline 16.0.1.1.5

配置

您需要定义一个以 <timeline> 为基础元素的视图。以下是此标签的可能属性

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

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

• field_utils：用于格式化和解析值（请参阅web.field_utils中可用的函数）。

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

请参阅web_timeline/demo/ir_cron_view.xml，其中包含了一个非常基本的时间线视图示例，它被添加到cron任务中。

更进阶的示例，来自project_timeline

<?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="project_id"
                      event_open_popup="true"
                      colors="white: user_ids == []; #2ecb71: kanban_state == 'done'; #ec7063: kanban_state == 'blocked'"
                      dependency_arrow="depend_on_ids"
            >
                <field name="user_ids" />
                <field name="planned_hours" />
                <templates>
                    <t t-name="timeline-item">
                        <div class="o_project_timeline_item">
                            <t t-foreach="record.user_ids" t-as="user">
                                <img
                                    t-if="record.user_ids"
                                    t-attf-src="/web/image/res.users/#{user}/image_128/16x16"
                                    t-att-title="record.user"
                                    width="16"
                                    height="16"
                                    class="mr8"
                                    alt="User"
                                />
                            </t>
                            <span name="display_name">
                                <t t-esc="record.display_name" />
                            </span>
                            <small
                                name="planned_hours"
                                class="text-info ml4"
                                t-if="record.planned_hours"
                            >
                                <t
                                    t-esc="field_utils.format.float_time(record.planned_hours)"
                                />
                            </small>
                        </div>
                    </t>
                </templates>
            </timeline>
        </field>
    </record>

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

用法

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

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

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

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

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

双击记录进行编辑。在空白区域双击以创建一个新记录，并将组和起始日期链接到您单击的区域。通过按住Ctrl键并从左到右拖动，您可以使用拖动的起始和结束日期创建一个新的记录。

已知问题/路线图

• 实现一个更有效的刷新时间线的方法，在记录更新后；

• 使attrs属性工作；

• 当按m2m分组并且设置多个记录时，时间线项目只出现在一个组中。允许在两个组中显示。

• 当按m2m分组并拖动以更改时间或组时，不会设置对组的更改，因为这可能会使与我们想要进行的更改无关的记录消失。当项在所有组中显示时，根据拖动项的组更改值。

• 当项标签不适合其日期范围框时：✅ 标签正确溢出框；✅ 在标签上的任何位置单击可移动框；❌ 在框外双击标签不会打开该项。

错误跟踪器

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

请不要直接联系贡献者以获取支持或技术问题帮助。

鸣谢

维护者

此模块由OCA维护。

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

当前维护者

此模块是OCA/web项目的一部分，该项目位于GitHub上。

欢迎您做出贡献。有关如何贡献的信息，请访问https://odoo-community.org/page/Contribute。