# 通过CSV更新工作项

URL: https://docs.ones.cn/data-migration/update-issues-with-csv

## 功能介绍

你可以通过.csv（或.xlsx.xls）格式的文件，将你在第三方数据源维护的工作项数据，迁移至ONES系统中，实现对系统内工作项数据的创建与更新。

## 功能入口

在工作项视图的「更多」-「通过CSV更新工作项」中。

## 操作流程

### 3.1获取所需的权限

在进行导入操作时，请确保你俱备通过CSV更新工作项权限。管理员可前往配置中心-项目管理配置-权限配置中管理该权限。

![通过CSV更新工作项 配图 1](https://docs.ones.cn/assets/images/12406b54db1501b2-fbbe4f3550b0580bb35c8580a987428d.png)

### 3.2准备导入文件

前往你准备放置数据的视图中，点击更多-通过CSV更新工作项按钮，在「设置与下载模板」中，获取你所需的导入文件。在这个操作中，你可以按需选择你所需新建或更新的属性字段，从而完成文件表头的设置。完成设置后，点击「下载模板」按钮，系统会生成导入模板，以及各个属性的填写说明，于此同时，文件还会包含当前视图筛选结果的数据，以便于你快速获取你所需更新的数据，无需手动额外维护。

![通过CSV更新工作项 配图 2](https://docs.ones.cn/assets/images/49d6b10e13e8b976-36c777565cb1ab3a77719d87e8e545dc.png)

### 3.3导入文件

准备好文件后，根据页面指引开始导入操作。

#### 3.3.1上传你的文件

在操作界面中，点击「上传文件」按钮，上传你的文件。请确保你的文件符合格式要求（.csv.xlsx或.xls），且未对文件进行加密处理。

确保文件上传完成后，即可点击「下一步」，进入下一步操作。

#### 3.3.2设置匹配字段

系统将以文件的第一个页签进行处理，根据属性名称，自动匹配文件内表头与系统内属性的映射关系。若自动生成的映射关系不能满足你的需求，你可进行手动调整。请确保调整后的映射关系，至少包含 **ID、标题、负责人、工作项类型和所属项目** ，这是导入所需的必要数据。

确保属性的映射关系设置完成后，即可点击「下一步」，进入下一步操作。

![通过CSV更新工作项 配图 3](https://docs.ones.cn/assets/images/0d417134bcbcd3a7-986b53e4715786a25be21b1f8b46b7c1.png)

#### 3.3.3校验导入信息

系统将根据属性填写约束，检查导入文档的有效性。如果文档内容存在不符合要求的数据，系统会在对应单元格中批注错误原因，并生成校验结果。你可点击「下载校验的结果」，获取这份文件，以便于你根据要求调整你的导入文件。如果你的导入文件无任何问题，则可忽略这个步骤。

确保导入信息检验无误后，即可点击「下一步」，进入下一步操作。

![通过CSV更新工作项 配图 4](https://docs.ones.cn/assets/images/48a1e8e90324de2c-75dabff41eaaa92330153331a61cebb8.png)

以下是校验和导入过程中，会遇到的一些关键规则

| 属性 | 规则 |
| --- | --- |
| ID | 这是必填属性，系统根据此字段判断执行创建或者编辑操作。当此属性填写为空时，执行创建操作；否则，执行编辑操作。 |
| 标题 | 这是必填属性，不可设置为空。 |
| 负责人 | 这是必填属性，不可设置为空。 |
| 工作项类型 | 这是必填属性，不可设置为空。执行编辑操作时，不可修改此属性。 |
| 所属项目 | 这是必填属性，不可设置为空。执行编辑操作时，不可修改此属性。 |
| 优先级 | 该属性不允许存在空值。在创建时，如果不填写，则会以默认优先级填入；在编辑时，如果不填写，则不做修改。 |
| 状态 | 该属性不允许存在空值。在创建时，如果不填写，则会以默认状态填入；在编辑时，如果不填写，则不做修改。 |
| 父工作项 | 该属性只在创建时起作用。若文档同时包含「父工作项ID」和「父工作项」，系统将优先以「父工作项ID」进行处理，若「父工作项ID」为空，才会以「父工作项」进行处理。 |

### 3.4获知导入结果

系统将会在云端对这些工作项进行处理，不会影响你的其他操作。处理结果将以邮件方式发送至你的邮箱帐号。

## 常见问题

- 该操作为数据迁移操作，过程中只会以通过CSV更新工作项权限进行校验，不考虑工作项权限（包括创建工作项权限、编辑工作项权限、属性创建权限和属性编辑权限等），请谨慎管理该权限。
- 该操作为数据迁移操作，允许用户忽略步骤验证与步骤属性，将工作项状态直接设置为任意状态。而且，该操作也不会触发修改状态的后置动作。
- 若单元格填入为空，系统将执行置空操作，必填属性和部分属性（优先级、状态）除外。