# 事井然甘特图

来源快照：`result_data_new_260518.json`

- 来源 ID：`1183983442647457973`
- 模块：低代码平台e-builder
- 目录：页面引擎 - 页面设计器 - 页面组件 - 模块组件 - 模块组件与项目管理
- space ID：`1157961794811633670`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 事井然甘特图

## 一、功能背景及价值用途

普加甘特图在现代项目管理及进度计划管理领域有着重要地位。其诞生背景源于对高效、便捷且功能强大的项目进度可视化管理工具的迫切需求。在复杂的项目环境中，传统的项目进度管理方式难以满足对大量数据的高效处理以及灵活多样的功能要求。普加甘特图应运而生，旨在突破这些局限，为项目管理者和开发者提供全面且易用的解决方案。

## 二、功能使用说明

### 2.1 属性-基础属性

标题、图标、启用标题，通用属性，不展开说明，都是统一的逻辑

### 2.2 属性-数据源

#### 2.2.1 数据源

数据源：ebuilder

（1）

ebuilder：为EB平台应用内关联表单

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328970800300074&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

#### 2.2.2 数据源设置

数据权限：所有数据、有权限数据

（1）

所有数据：为甘特图所选数据源表单所有数据

（2）

有权限数据：为甘特图所选数据源表单对操作者本人有权限的数据

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328975028158468&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

所属项目：为关联的项目表单

项目开始时间：时间字段，为项目的开始时间

项目结束时间：时间字段，为项目的结束时间

项目日期联动：默认不开启，任务起止日期改变时，是否联动改变项目日期

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328974981087266&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注：配置后，面板内不会显示数据，需在页面url上配置动态参数。例：？XXX=项目ID

### 2.3 属性-甘特图设置

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328974916182060&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

配置信息-字段设置

（1）

数据ID（必填）：系统字段

（2）

wbs（必填）：单行文本

（3）

wbs序号（必填）：数字字段

（4）

任务名称（必填）：单行文本

（5）

负责人（必填）：系统字段

（6）

进度（必填）：进度条

（7）

工期（必填）：数字字段

（8）

工时（必填）：数字字段

（9）

上级任务（必填）：关联ebuilder

（10）

前置任务（必填）：单行文本

（11）

里程碑（必填）：开关

（12）

任务模式（必填）：开关

（13）

计划开始日期（必填）：日期字段

（14）

计划结束日期（必填）：日期字段

（15）

实际开始日期（必填）：日期字段

（16）

实际结束日期（必填）：日期字段

（17）

约束类型（必填）：单行文本

（18）

约束日期：日期字段

显示模式：列表和甘特图（图一）、只显示列表（图二）

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328979267665929&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

图一

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328979237142546&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328979169206317&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

                        图二

### 2.4 属性-触发动作流

保存触发：选择动作流，执行动作流之前，会默认添加输入参数predecessorDataIds，参数内容为所有修改过前置任务的数据ID，多条数据以逗号分隔

参数配置：配置对应参数

异步执行：默认关闭，可手动开启

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328979169206325&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 2.5 属性\- License设置

授权数据源：选择对应授权数据源

授权密钥：选择对应授权密钥

授权文件：选择对应授权文件

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328983573225479&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 2.6 属性-显示字段

可选字段为对应数据源表单所有字段，可全选，可单独选择，选择后为显示字段。显示字段为甘特图每列展示字段。（注：显示字段展示字段则可选字段不显示对应字段）可在可选字段内进行筛选字段

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328983641161747&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 三、延伸用法

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328983467098163&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.1 数据增删改查

新建同级：新增数据同级

新建子级：新建数据子级

注：操作后需点击保存，如不保存，数据不会显示

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328987980169226&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

数据删除：勾选数据，点击删除

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328987980169241&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

操作返回：可对上一步操作还原，返回操作

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328987910135831&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

数据更改：双击可修改对应数据

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328987776745511&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.2 数据层级

升级：数据层级升级

降级：数据层级降级

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328992189153285&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

升级后：

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328992194510866&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

降级后

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328992189153307&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.2 数据复制粘贴

复制：选择对应数据复制

粘贴：选择对应数据粘贴

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328992266747921&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.3 导入excel

（1）选择文件导入

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328992189153319&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

（2）数据预览

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328992194510902&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

（3）导入数据成功

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328996500897798&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

（4）导入完成后，信息确认

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328996500897805&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.4 导入project

（1）选择文件导入

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328996558790672&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

（2）导入步骤

第一步，请先配置任务字段与WBS自定义字段对应关系

字段配置：任务字段、WBS字段，选择任务字段对应WBS字段即可

WBS导入字段配置可新增、删除

第二步，配置任务字段后，按照字段格式以及任务必填字段维护好WBS文档内容。

第三步，选择填写好的WBS文档，点击下一步按钮进行批量导入。

第四步，如果以上步骤和WBS文档正确的话，数据会被正确的导入，导入成功会有提示。如果有问题，则会提示WBS文档的错误之处。

（3）数据预览

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328996372037653&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

（4）导入完成数据确认

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163328996500897837&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.5 导出excel

点击导出excel，导出后提示导出成功

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329000661647361&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329000736317449&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.6  导出xml

点击导出xml，导出后提示导出成功

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329000661647382&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.7 自定义列

点击自定义列可更改列位置，可取消展示列，取消展示的列为不高亮

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329000661647392&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.8 导出图片

甘特图打印：当前视图、完整视图

当前视图：默认选择-甘特图完整视图

完整视图：默认选择-甘特图完整视图、可选择表格完整视图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329000661647401&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

当前视图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329005056450562&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

完整视图：表格完整视图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329004990169097&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3.9 自动排程

自动排程：在项目管理过程中，自动排程功能能够依据一系列规则，高效且合理地规划项目进度，助力项目管理者对项目进行科学管控。

自动排程包含以下任务逻辑：完成-开始（FS）、开始-开始（SS）、完成-完成（FF）、开始-完成（SF）

(1)完成 - 开始（FS）：这是最常见的类型。像在建筑项目中，必须先完成地基的浇筑工作，后续的主体结构搭建任务才能启动。在这种关联下，自动排程会精准把控，确保后续任务在前置任务完成的那一刻即刻开始，时间上无缝衔接。

(2)开始 - 开始（SS）：两个任务需同步开启。以软件开发项目为例，前端开发与后端开发的部分任务，为了保证接口对接顺畅以及整体开发节奏一致，可能需要同时着手。一旦设置了 SS 关系的前置任务开始执行，后续任务也会立即跟进。

(3)完成 - 完成（FF）：后续任务的完成依赖于前置任务的结束。比如在广告宣传项目中，线上广告投放和线下活动宣传，为了便于统一评估宣传效果，往往需要在同一时间点收尾。Project 会依据前置任务的完成时间，灵活调整后续任务的工期，保障二者同时结束。

(4)开始 - 完成（SF）：此类型相对少见，意味着后续任务的完成取决于前置任务的启动。例如在一些持续监控的项目里，监控任务的结束时间，可能与某个关键操作的开始时间挂钩，当关键操作启动后，监控任务便进入倒计时，直至完成。

实例1：

父任务区间为2025年5月21日-2025年5月23日，子任务区间为2025年5月21日-2025年5月24日，任务区间此时超出项目区间，需点击自动排程让项目区间包含任务区间

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329004990169106&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329004983877651&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D) 实例2：

父任务区间为2025年5月21日-2025年5月26日，子任务区间为2025年5月21日-2025年5月24日，项目区间此时超出任务区间，需点击自动排程让项目区间包含任务区间

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329004983877664&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329005056450596&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

实例3：

父任务工期为1，子任务区间为1、1、1、4，项目区间此时超出任务区间，需点击自动排程让父任务同步子任务工期

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329009371119620&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329009458266121&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 四、使用注意点

1、

权限范围控制：甘特图组件应用-后台管理-表单-权限

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329009458266132&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329009371119639&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329009310302242&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

（1）

创建权限：普加甘特图表单数据新建权限，选择对象，选择对象后可编辑、删除、复制

（2）

共享权限：普加甘特图表单数据查看权限，共享对象默认创建者本人，权限默认查看，编辑、删除需手动添加。附件权限默认查看，下载、编辑需手动添加。关联PC布局：默认布局、编辑布局需可添加（1、默认布局生效范围是查看页面和编辑页面；编辑布局生效范围仅针对编辑页面2、如果当前用户所有权限中没有设置编辑布局，则默认布局生效，所有权限中默认布局也没有设置，则表单默认布局生效 ）

（3）

导入导出权限：新增对象、权限（导入、导出），设置后可编辑、删除、复制不同类型

2.

自动排程情况下-前后置任务回环引用

什么是前后置任务回环?

前后置任务回环指的是在任务依赖关系中形成了一个闭环，例如:

任务A依赖于任务B

任务B依赖于任务C

任务C又依赖于任务A

这样就形成了一个A→B→C→A的循环依赖，这在项目管理逻辑上是无法实现的。

实例1：

自动排程情况下，前后置任务指向成环会提示，此场景为汽车前置为轮船，轮船前置为汽车，回环引用成立。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329009371119654&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

实例解析：此场景应用前后置任务依赖关系，汽车的前置任务为轮船，轮船的前置任务想设置为汽车，此处任务的前置任务不能重叠相互依赖，造成回环。

实例2：

自动排程情况下，其子任务的父任务不能是子任务的前置，此场景为4-1的前置为4，任务2的前置为5，任务3的前置为1，拖拽4-1到任务1的子级，回环成立。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163329013764653059&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

实例解析：此场景应用父子任务前后置依赖关系，4-1的前置任务为任务2，任务2的前置任务任务3，任务3 的前置任务为任务任务1，其中4-1为任务4的子任务，任务2、3、4为同级父任务，拖拽4-1到任务1的子级内，形成作为其子任务，父任务不能是子任务的前置。

3.

为什么会出现回环引用？常见的原因包括：

（1）逻辑错误：任务依赖关系设置不符合实际业务流程（如 “设计” 依赖 “开发”，但 “开发” 又依赖 “设计”）。

（2）手动误操作：在甘特图中手动拖动任务或修改前置任务时，误将任务链闭合。

（3）复杂项目拆分不清晰：大型项目中任务拆分空间不足，导致依赖关系交叉混乱。

（4）跨阶段依赖遗漏：不同阶段的任务（如需求、开发、测试）之间错误设置双向依赖。

（5）前后置依赖、父子层级不明确：设置双向关联的前置依赖关系导致回环，拖拽父子层级任务造成回环。

## 五、更多参考资料

1、

事井然甘特图搭建指南：

[ _https://eteams.cn/community/help/1973261541039708720_](https://eteams.cn/community/help/1973261541039708720)

1、

普加甘特图二开口子汇总：

https://www.e-cology.com.cn/sp/ebddoc/weapp-ebdgantt/Gantt
