华为云用户手册

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 status String 开关状态。取值： Enabled：已开启， Disabled：已关闭， Switching：开关切换中。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 X-Language 否 String 请求语言类型。 枚举值： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 type 是 String 开关类型。取值DAS SQL Explorer和DAS Slow Query Log，分别表示DAS收集全量SQL开关和DAS收集慢SQL开关。 status 是 Integer 开关状态，取值0和1，分别代表要关闭和开启。 datastore_type 是 String 数据库类型。当前全量SQL支持的数据库类型包括MySQL和 GaussDB (for MySQL)，慢SQL支持的类型：MySQL、GaussDB(for MySQL)、PostgreSQL。 retention_days 否 Long SQL数据保存时长（天）。默认为7天，最长可保留30天，到期后数据自动删除。如果要保留30天以上，请到DAS页面进行操作。

功能介绍 打开或者关闭DAS收集全量SQL开关，开启后，实例的性能损耗在5%以内。开启全量SQL后，本服务会对SQL的文本内容进行存储，以便进行分析。用户可自行设置全量SQL的保存时间范围，到期后会自动删除；如果未设置，数据默认保留7天。 打开或者关闭DAS收集慢SQL开关。开启慢SQL后，本服务会对慢SQL的文本内容进行存储，以便进行分析。用户可自行设置慢SQL的保存时间范围，到期后会自动删除；如果未设置，数据默认保留7天。该功能仅支持付费实例。

请求示例 开启全量SQL开关。 POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/sql/switch { "type" : "DAS SQL Explorer", "status" : 1, "datastore_type" : "MySQL", "retention_days" : 8 }

请求示例 查询慢日志的开关状态。 GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/sql/switch?type=DAS Slow Query Log&datastore_type=MySQL

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 status String 开关状态。取值： Enabled：已开启， Disabled：已关闭， Switching：开关切换中。 retention_days Long SQL数据保存天数。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

URI GET /v3/{project_id}/instances/{instance_id}/sql/switch 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 type 是 String 开关类型。取值DAS SQL Explorer和DAS Slow Query Log，分别表示DAS收集全量SQL开关和DAS收集慢SQL开关。 datastore_type 是 String 数据库类型。当前全量SQL支持的数据库类型包括MySQL和GaussDB(for MySQL)，慢SQL支持的类型：MySQL、GaussDB(for MySQL)、PostgreSQL。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 interval_millis Long 返回列表两个时间点之间的时间间隔。总查询时长一小时之内间隔10s，一小时到六小时范围内间隔60s，六小时以上间隔300s。单位为毫秒。 top_sql_trend_items Array of TopSqlTrendItem objects SQL执行耗时区间数据。 total_count Integer 耗时区间数据总数。 表5 TopSqlTrendItem 参数 参数类型 描述 execute_at Long 执行时间点，毫秒时间戳。表示统计数据的时间范围为execute_at - interval_millis到execute_at。 query_time_in_100ms Long 执行耗时小于100ms。 query_time_in_500ms Long 执行耗时100ms-500ms。 query_time_in_1s Long 执行耗时500ms-1000ms query_time_over_1s Long 执行耗时大于1000ms。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

请求示例 导出SQL执行耗时区间数据。 GET https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/6243b3fcf2f948578d46ed4c52fb54eein01/top-sql-trend?start_at=1611975464337&end_at=1611979064337&datastore_type=MySQL&node_id=fec05693c76c4f389561051db430324cno01

响应示例 状态码： 200 Success. { "top_sql_trend_items" : [ { "execute_at" : 1666702330000, "query_time_over_1s" : 1, "query_time_in_100ms" : 3, "query_time_in_1s" : 0, "query_time_in_500ms" : 0 }, { "execute_at" : 1666702340000, "query_time_over_1s" : 2, "query_time_in_100ms" : 2, "query_time_in_1s" : 0, "query_time_in_500ms" : 0 } ], "interval_millis" : 10000, "total_count" : 2 }

URI GET /v3/{project_id}/instances/{instance_id}/top-sql-trend 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 start_at 是 Long 开始时间（Unix timestamp），单位：毫秒。 end_at 是 Long 结束时间（Unix timestamp），单位：毫秒。 datastore_type 是 String 数据库类型。支持MySQL和GaussDB(for MySQL)。 node_id 否 String 节点ID。

请求示例 导出慢SQL数据。 GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/slow-query-logs?start_at=1611975464337&end_at=1611979064337&limit=10&marker=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAQH8YWSEFfM3FyOXZRNzJQOTVLNHNBOTQ2UQ==&datastore_type=MySQL

响应示例 状态码： 200 导出慢SQL返回体。 { "slow_logs" : [ { "execute_at" : 1612343898000, "sql" : "SELECT sleep(10)\nLIMIT 0, 50;", "database" : "123", "client" : "[100.79.0.248]", "user" : "root[root]", "query_time" : 10.000158309936523, "lock_time" : 0, "rows_examined" : 0, "rows_sent" : 1 } ], "next_marker" : "DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAJr48WZERxYkx5Q2VRQS1LSXRrRWt0VEN1QQ==" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 slow_logs Array of SlowLog objects 慢SQL集合。当集合为空时，说明慢SQL已全部导出。 next_marker String 获取下一页所需的标识符。marker仅在3分钟内有效。 表5 SlowLog 参数 参数类型 描述 sql String SQL语句。 database String 数据库名。 client String 客户端。 user String 用户。 execute_at Long 执行开始时间（Unix timestamp），单位：毫秒。 query_time Double 执行耗时（秒）。 lock_time Double 锁等待耗时（秒）。 rows_examined Long 扫描行数。 rows_sent Long 返回行数。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

URI GET /v3/{project_id}/instances/{instance_id}/slow-query-logs 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 datastore_type 是 String 数据库类型。支持MySQL、GaussDB(for MySQL)、PostgreSQL。 start_at 是 Long 开始时间（Unix timestamp），单位：毫秒。 end_at 是 Long 结束时间（Unix timestamp），单位：毫秒。 limit 是 Integer 每页记录数。最大为2000。 marker 否 String 指定一个标识符。获取第一页时不用赋值，获取下一页时取上页查询结果的返回值。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户token。 X-Language 否 String 语言。 枚举值： zh-cn en-us 表3 请求Body参数 参数 是否必选 参数类型 描述 operate 是 String 操作类型。 枚举值： reanalysis datastore_type 是 String 引擎类型。 枚举值： MySQL GaussDB(for MySQL)

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 execution_time Long 执行时间，毫秒为单位的时间戳。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：8 最大长度：36 error_msg String 错误描述。 最小长度：2 最大长度：512

请求示例 创建空间分析任务。 POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/fa7d0b6e40704cd48facf9889d6e745bin01/space-analysis { "operate" : "reanalysis", "datastore_type" : "MySQL" }

请求示例 根据原始SQL生成SQL限流关键字。 https://das.cn-north-1.myhuaweicloud.com/v3/054c630ff780d4cc2f40c00d7f6fb21d/instances/da304cd5bbb944de828759bc7be3d3fein01/sql-limit/parse { "datastore_type" : "MySQL", "original_sql" : "select * from das_conn_info", "use_template" : true, "keep_operators" : true }

URI POST /v3/{project_id}/instances/{instance_id}/sql-limit/parse 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 X-Auth-Token 是 String 用户token。 X-Language 否 String 语言。 枚举值： zh-cn en-us

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 datastore_type 是 String 数据库类型，目前支持MySQL、MariaDB、GaussDB(for MySQL)三种引擎。 枚举值： MySQL MariaDB GaussDB(for MySQL) original_sql 是 String 原始SQL语句 最小长度：1 最大长度：1024 use_template 是 Boolean 是否校验SQL语句。 keep_operators 是 Boolean 是否保留操作符。

python模板 主调函数： # funcName: pythoncaller from functionsdk import Function def newStateRouter(event, context): func = Function(context, "pythonstateful", "test1") instanceID = func.get_instance_id() return instanceID def bindStateRouter(event, context): func = Function(context) # bind func.get_instance("pythonstateful", "test1") instanceID = func.get_instance_id() return instanceID def invoke(event, context): func = Function(context) # bind func.get_instance("pythonstateful", "test1") obj = func.invoke("{\"key\":\"value\"}") result = obj.get() return result def terminate(event, context): func = Function(context) # bind func.get_instance("pythonstateful", "test1") obj = func.terminate() result = obj.get() return result 父主题： Python

在缺陷详情页中管理缺陷 在编辑缺陷详情页面，您除了可以修改缺陷的描述、优先级、当前责任人等，还可以添加标签、添加附件、关联工作项、查看评审记录、添加工时和查看操作历史。 图2 缺陷详情页 表2 详情页相关管理操作 操作项 操作步骤 备注 编辑工作项 在缺陷详情页中单击需要修改的字段取值框，在输入框中输入目标值或在下拉框中选择目标值，可即时保存已修改内容。 操作成员需拥有缺陷的“编辑”权限。 修改工作项状态 进入工作项详情页面，单击工作项“状态”字段，可根据需要将工作项流转至目标状态，状态流转操作参考表1。 操作成员需拥有缺陷的“更新状态”权限。 上传附件 附件类型支持图片、工作簿、文稿、文本文件等类型。每个工作项可容纳的附件个数不超过100个，附件总容量不得超过50MB。 进入工作项详情，单击“附件”页签。 单击“点击或拖拽文件到此处上传”，选择本地文件，将文件上传至工作项中作为附件。 支持将本地文件直接拖拽到输入框中。当上传进度条达到100%，系统提示附件上传成功。 将鼠标放在上传成功的文件上，会显示可执行的操作。 单击，可以下载文件到本地存放。 单击，可以删除上传的文件。 操作成员需拥有缺陷的“上传附件”权限。 添加并查看关联项 工作项可以与项目内的其它类型工作项建立关联关系。 进入工作项详情页面，选择“关联项”页签。 图3 关联项 完成关联操作。 关联工作项：与本项目中其他类型的工作项，直接建立关联关系。 支持关联已有RR：先完成新建原始需求后，才可以在此处关联。 支持关联已有IR、SR和AR：先完成新建研发需求、分解研发需求后，才可以在此处关联。 关联已有Task：先完成新建任务后，才可以在此处关联。单击，可取消关联。 协同上游缺陷：从上游项目协同过来的缺陷。 仅其他项目的缺陷在新建“协同下游缺陷”中选择的“归属项目”为本项目时，才会在本项目中显示相应的信息。 协同下游缺陷：可将缺陷下发到其他项目。 支持批量协同下发，一次最多只能下发10条。默认一条，且不能删除。 1. 单击“协同下发”，弹出“协同下发”窗口。 2. 配置下发缺陷的信息。单击图标，可以展开及配置更多信息。 3. 单击“确定”，缺陷下发成功。该缺陷还需在协同下发的归属项目中进行查看和处理。 说明： 缺陷协同下发后，上游缺陷的附件不会带到下游缺陷中，需要缺陷当前责任人联系缺陷提出人获取附件。 文件：缺陷对应的文件。 选择与当前缺陷相关联的文件，支持上传本地文件。 Wiki：缺陷对应的Wiki。 选择与当前缺陷相关联的Wiki，支持新建Wiki。 测试计划：当前缺陷相关的测试计划。选择与本缺陷相关联的测试计划。 测试用例：当前缺陷相关的测试用例。可以在测试管理中选择与测试用例相关联的缺陷。 代码提交记录：当前缺陷相关的代码提交记录。 仅当代码提交时，关联了当前缺陷单号，才会显示相关信息。 代码分支：当前缺陷相关的代码分支。 仅当代码分支关联了当前缺陷单号，才会显示相关信息。 操作成员需拥有缺陷的“关联/取消关联工作项”、“分发”“关联/取消关联文件”、“关联/取消关联wiki”权限。 添加工时 进入工作项详情页面，选择“工时”页签。 单击“新增工时”，弹出“新增工时”窗口。 填写工时信息。 工时的结束日期不能早于开始日期。 是否勾选“包含周末”，如果不勾选，则工时记录中不会生成周末的记录。 “工时”可以选择“总数”或“每天”。 “工时类型”包括后端开发、前端开发、UI设计、调休请假、缺陷修复、公共事务等，还支持自定义取值，具体步骤参考添加IPD系统设备类项目工作项的工时类型 单击“确定”，工时新增成功。 系统会自动根据填写的工时日期和工时天数生成对应的记录。 工时支持编辑、删除操作。 添加工时操作，成员需拥有缺陷的“新增工时”权限。 编辑、删除工时操作默认是谁添加就谁可以操作，项目管理员默认可以编辑、删除所有工时数据。 查看历史记录 历史记录展示了用户的所有操作日志，包括：创建、状态流转、发起评审、关联工作项、新增工时等。 进入工作项详情页面。 选择“历史记录”页签，查看工作项所有的修改操作。 单击或，可以按操作时间的正序或倒序查看历史记录信息。 通过设置查询条件，可以查询到符合条件的历史记录。 操作成员需拥有缺陷的“查看”权限。 给工作项打标签 进入工作项详情页面，单击页面上方“标签”后面的，选择“新建标签”。 添加的标签显示在“标签”中。 在弹出的“新建标签”窗口中，输入“标签名称”和选择“标签颜色”。 单击“确定”，标签新建成功。 在缺陷列表中对应需求的编号后会显示新增的标签。 （可选）隐藏标签。 单击“标签”后面的，在弹出窗口中去掉标签的√，则会隐藏标签。 图4 隐藏标签01 将鼠标放在标签名称上，单击，则会隐藏标签。 图5 隐藏标签02 说明： 当有多个工作项需要添加标签时，您可以选择在工作项列表中勾选需要添加标签的需求，单击页面下方的“批量编辑”，选择“标签”字段进行添加。 操作成员需拥有缺陷的“编辑”权限。 添加评论 进入工作项详情页面。 在“详情”页签，单击“评论”输入框。 图6 添加评论 输入评论内容。 评论支持上传图片、输入链接、关联工作项、@项目成员等操作。 单击“发表”，评论成功。 发表后的评论支持回复、编辑、置顶、删除操作。 操作成员需拥有缺陷的“查看”权限。

导入特性树 访问CodeArts Req服务首页。 在项目主页，选择“特性树”。 单击“导入特性树”，弹出“导入”窗口。 图3 导入特性树 单击“下载导入模版”链接。导入模板文件显示在页面右上方，可保存到本地填写数据。模板文件命名规则：项目名称+“-”+模块名称（如特性）+导入模板。 填写“特性树-导入模板”页签中的字段。参数填写规则请参见模板文件中“导入说明”页签。 通过拖拽或单击图标，选择一个需要导入的文件。 单击“导入”，导入成功。 在特性树列表中可以查看到导入的特性集。

相关操作 对新创建的特性集，可以执行以下操作。 表1 特性集基本操作 操作项 说明 创建子特性集 单击特性集后单击图标，弹出“新建特性集”窗口。 输入“标题”。 单击“确定”，创建成功。 在对应特性集中可查看到新建的二级子特性集。 图4 子特性集 二级子特性集下可再创建三级子特性集，以此类推，最多可创建十级特性集。 系统支持对分层特性集的编辑和删除操作。 编辑特性集 鼠标悬浮特性集右侧按钮，单击“编辑”，可修改特性集名称。 删除特性集 鼠标悬浮在特性集右侧按钮，单击“删除”，弹出确定删除提示框 图5 删除特性集提示框 单击“删除”，删除成功。页面不再显示被删除的特性集及其子特性集。 说明： 特性集删除后，可在回收站中进行恢复和彻底删除。

使用项目模板创建CodeArts项目 在CodeArts中，预置了多种开箱即用的项目模板，包括Scrum、IPD和看板类型，您可以根据业务场景选择合适的项目模板。 单击服务首页的“新建项目”。 进入“选择模板”页面，根据自身业务需求选择合适的项目模板，各项目模板的特征和适用场景如表 项目模板特征和适用场景的区别所示。 表1 项目模板特征和适用场景的区别 项目模板 模板特征 适用场景 Scrum项目 Scrum是增量迭代式的软件开发方法，通过最重要的迭代计划会议、每日站会、迭代回顾、验收会议来进行简单高效的管理。 迭代式增量的软件开发。 IPD系统设备类项目 涉及到软硬件配套开发，产品需求相对固定，有相关的行业标准，开发周期长，一般为6～9个月，对产品质量及稳定性要求高，决策点多，多采用瀑布模式。 嵌入式软件场景，其特点为软件持续迭代，硬件平台也在持续演进，比如通信设备、汽车、家电、消费电子等涉及到软硬件复杂产品。 IPD独立软件类项目 软件可独立部署销售，多采用敏捷开发，客户需求变化频繁、快速规划、敏捷发布，交付周期一般为2～3个月甚至更短。 IT应用及平台类软件，硬件标准化或不依赖专有硬件，软件频繁迭代，比如ERP软件、CRM、数据库、网管软件等。 IPD自运营软件/云服务类项目 商业决策和需求决策分离，需求决策向下授权。以微服务为作战单元小步快跑，快速规划持续交付，发布频繁，交付周期2~3周左右甚至3~5天，多采用DevOps敏捷模式。 云服务开发，微服务架构，自运营软件场景居多，比如公有云、互联网应用软件。 看板项目 看板协作是一种业界流行的轻量、灵活和简单的团队协作办法，它将项目的需求、缺陷和任务可视。 任何行业、任何团队、任何角色高效协作。 选择合适的项目模板，单击“选用”，进入“新建项目”页面，配置相关参数。 表2 新建项目 参数名 参数说明 工作项设置模板 工作项设置模板包含Scrum项目工作项配置的所有配置项，“工作项设置-状态与流转-自动流转-为特定状态指定处理人”除外，可根据需求进行选择，选用之后可快速复用该项目的工作项配置数据。 除系统提供的默认Scrum模板外，您可以自定义工作项设置模板，操作方式为打开某项目后进入设置ㅡ工作项配置页面，再在该页面执行【保存为模板】操作。 说明： “工作项设置模板”仅Scrum项目支持。 项目名称 根据自己需求设置。 同一租户下的项目，名称不能重复。 支持大小写英文字母、数字、“_”，不超过128个字符。 项目代号 针对第三方业务。设置项目代号后，便于业务管理。 支持字母、数字、下划线和连字符，不超过200个字符。 关联企业项目(资源组) 指的是用户管理用户虚机、容器、数据库等底层资源，可根据需求选择。 说明： “关联企业项目(资源组)”仅Scrum项目和看板项目支持。 项目描述 对项目的简要说明。 支持大小写英文字母、数字、“_”，不超过1024个字符。 单击“确定”，项目创建成功，页面自动跳转至到项目内。

在工作项详情页中管理工作项 在编辑工作项详情页面，您除了可以修改工作项的描述、优先级、责任人等，还可以添加标签、添加附件、关联工作项、查看评审记录、添加工时和查看操作历史。 图2 工作项详情页 表2 详情页相关管理操作 操作项 操作步骤 备注 编辑工作项 在工作项详情页中单击需要修改的字段取值框，在输入框中输入目标值或在下拉框中选择目标值，可即时保存已修改内容。 操作成员需拥有工作项的“编辑”权限。 修改工作项状态 进入工作项详情页面，单击工作项“状态”字段，可根据需要将工作项流转至目标状态。 操作成员需拥有工作项的“状态设置”权限。 上传附件 附件类型支持图片、工作簿、文稿、文本文件等类型。每个工作项可容纳的附件个数不超过100个，附件总容量不得超过50MB。 进入工作项详情，单击“附件”页签。 单击“点击或拖拽文件到此处上传”，选择本地文件，将文件上传至工作项中作为附件。 支持将本地文件直接拖拽到输入框中。当上传进度条达到100%，系统提示附件上传成功。 将鼠标放在上传成功的文件上，会显示可执行的操作。 单击，可以下载文件到本地存放。 单击，可以删除上传的文件。 操作成员需拥有工作项的“上传附件”权限。 添加并查看关联项 工作项可以与项目内的其它类型工作项建立关联关系。 进入工作项详情页面，选择“关联项”页签。 完成关联操作。 父工作项：工作项所归属的父工作项。 说明： FE可以关联Epic。 US可以关联FE。 Task可以关联US。 Bug可以关联US。 子工作项：当前工作项分解的子工作项。 支持批量分解，一次最多只能分解10条。默认一条，且不能删除。 1. 单击“分解”，弹出“分解子工作项”窗口。 2. 输入子工作项的信息。单击图标，可以展开及配置更多信息。 3. 单击“确定”，子工作项分解成功。 该子工作项会自动显示在工作项列表中所属父工作项下。 4. （可选）单击，可取消关联。 说明： 仅Epic、FE、US类型工作项才支持分解子工作项操作。 关联工作项：与本项目中其他类型的工作项，直接建立关联关系。 Epic、US、Task工作项中支持新建和关联Epic、FE、US、Task、Bug，新建操作可参见新建工作项。 FE、Bug工作项中支持关联Epic、RR、FE、US、Task、Bug。 协同缺陷：当前项目的缺陷可以下发给其他项目。 支持批量下发，一次最多只能下发10条。默认一条，且不能删除。 1. 单击“协同下发”，弹出“协同下发”窗口。 2. 输入缺陷下发的基本信息。单击图标，可以展开及配置更多信息。 3. 单击“确定”，缺陷下发成功。 4. （可选）单击，可取消关联。 文件：当前工作项相关的文件。 选择与当前工作项相关联的文件，支持上传本地文件。 Wiki：当前工作项相关的Wiki。 选择与当前工作项相关联的Wiki，支持新建Wiki。 代码提交记录：当前工作项相关的代码提交记录。 仅当代码提交时，关联了当前工作项单号，才会显示相关信息。 代码分支：当前工作项相关的代码分支。 仅当代码分支关联了当前工作项单号，才会显示相关信息。 测试用例：当前工作项相关的测试用例。 说明： 仅Epic、FE、US、Task类型工作项支持关联测试用例。 在测试管理中选择与测试用例相关联的工作项。 测试计划：当前工作项相关的测试计划。 说明： 仅Task类型工作项支持关联测试用例。 选择与本缺陷相关联的测试计划。 操作成员需拥有工作项的“分解/关联/取消关联子工作项”、“关联/取消关联父工作项”、“新建/关联/取消关联工作项”、“关联/取消关联文件”、“关联/取消关联wiki”权限。 添加工时 进入工作项详情页面，选择“工时”页签。 单击“新增工时”，弹出“新增工时”窗口。 填写工时信息。 工时的结束日期不能早于开始日期。 是否勾选“包含周末”，如果不勾选，则工时记录中不会生成周末的记录。 “工时”可以选择“总数”或“每天”。 “工时类型”包括后端开发、前端开发、UI设计、调休请假、缺陷修复、公共事务等，还支持自定义取值，具体步骤参考添加IPD自运营/云服务类项目工作项的工时类型 单击“确定”，工时新增成功。 系统会自动根据填写的工时日期和工时天数生成对应的记录。 工时支持编辑、删除操作。 添加工时操作，成员需拥有工作项的“新增工时”权限。 编辑、删除工时操作默认是谁添加就谁可以操作，项目管理员默认可以编辑、删除所有工时数据。 查看历史记录 历史记录展示了用户的所有操作日志，包括：创建、状态流转、发起评审、关联工作项、新增工时等。 进入工作项详情页面。 选择“历史记录”页签，查看工作项所有的修改操作。 单击或，可以按操作时间的正序或倒序查看历史记录信息。 通过设置查询条件，可以查询到符合条件的历史记录。 操作成员需拥有工作项的“查看”权限。 给工作项打标签 进入工作项详情页面，单击页面上方“标签”后面的，选择“新建标签”。 添加的标签显示在“标签”中。 在弹出的“新建标签”窗口中，输入“标签名称”和选择“标签颜色”。 单击“确定”，标签新建成功。 在原始需求列表中对应需求的编号后会显示新增的标签。 （可选）隐藏标签。 单击“标签”后面的，在弹出窗口中去掉标签的√，则会隐藏标签。 图3 隐藏标签01 将鼠标放在标签名称上，单击，则会隐藏标签。 图4 隐藏标签02 说明： 当有多个工作项需要添加标签时，您可以选择在工作项列表中勾选需要添加标签的需求，单击页面下方的“批量编辑”，选择“标签”字段进行添加。 操作成员需拥工作项的“编辑”权限。 添加评论 进入工作项详情页面。 在“详情”页签，单击“评论”输入框。 图5 添加评论 输入评论内容。 评论支持上传图片、输入链接、关联工作项、@项目成员等操作。 单击“发表”，评论成功。 发表后的评论支持回复、编辑、置顶、删除操作。 操作成员需拥有工作项的“查看”权限。

使用示例项目创建CodeArts项目 单击服务首页的“新建项目”。 进入“选择模板”页面，可以选择下方示例项目来创建项目，目前支持的示例项目如表 示例项目所示。 表1 示例项目 项目模板类别 示例项目名称 使用场景 Scrum项目 DevOps全流程示例项目 针对敏捷开发全生命周期、DevOps持续交付的模板，模板内预置了思维导图、并实例化了Scrum工作项（如促销管理、会员管理，订单管理）、代码仓库、代码检查任务、编译构建任务、流水线任务等，实现全流程的研发交付自动化。 IPD项目 IPD-系统设备示例项目 针对嵌入式软件场景，其特点为软件持续迭代，硬件平台也在持续演进，比如通信设备、汽车、家电、消费电子等涉及到软硬件复杂产品。 IPD-独立软件示例项目 针对IT应用及平台类软件，硬件标准化或不依赖专有硬件，软件频繁迭代场景，比如ERP软件、CRM、数据库、网管软件等。 IPD-云服务全流程示例项目 针对云服务开发、微服务架构、自运营软件场景，比如公有云、互联网应用软件。 看板项目 客户联合敏捷交付(JAD)项目 针对研发类轻量级敏捷项目的管理，助力初创团队、小型组织任务协作，快速提升工作效率。 客户线索管理项目 针对市场营销类客户线索管理，搭建了科学的营销体系模板，推动客户转化。 招聘管理项目 针对HR类招聘进度管理，覆盖人力管理核心流程，实现科学规范化管理。 团建3+1项目 针对团建类项目的管理，助力团队活动建设。 选择相应的示例项目，进入“新建项目”页面，配置相关参数。 表2 新建项目 参数名 参数说明 工作项设置模板 工作项设置模板包含Scrum项目工作项配置的所有配置项，“工作项设置-状态与流转-自动流转-为特定状态指定处理人”除外，可根据需求进行选择，选用之后可快速复用该项目的工作项配置数据。 除系统提供的默认Scrum模板外，您可以自定义工作项设置模板，操作方式为打开某项目后进入设置ㅡ工作项配置页面，再在该页面执行【保存为模板】操作。 说明： “工作项设置模板”仅Scrum项目支持。 项目名称 根据自己需求设置。 同一租户下的项目，名称不能重复。 支持大小写英文字母、数字、“_”，不超过128个字符。 项目代号 针对第三方业务。设置项目代号后，便于业务管理。 支持字母、数字、下划线和连字符，不超过200个字符。 关联企业项目(资源组) 指的是用户管理用户虚机、容器、数据库等底层资源，可根据需求选择。 说明： “关联企业项目(资源组)”仅Scrum项目和看板项目支持。 项目描述 对项目的简要说明。 支持大小写英文字母、数字、“_”，不超过1024个字符。 单击“确定”，项目创建成功，页面自动跳转至到项目内。

后续操作 完成新建自定义报表或通过系统预置报表模板新建报表后，拥有报表的“编辑报表”、“删除报表”、“移动报表”“导出报表”权限的成员，可以执行以下操作： 对于新创建的报表，可以进行如下的操作。 表3 报表基本操作 操作项 说明 报表的图形和表格显示切换 单击报表卡片右上角的，可以切换报表的显示形式。 全屏查看报表 单击报表卡片右上角，可以全屏查看报表。 保存图表 单击报表卡片右上角下的“保存图表”，可以将当前报表保存为png图片。 导出表格 单击报表卡片右上角下的“导出表格”，可以将当前报表数据导出为Excel文件。 编辑报表 单击报表卡片右上角下的“编辑报表”，可以进入报表详情页进行编辑。 移动报表 单击报表卡片右上角下的“移动报表”，可以将当前报表移动至其他报表分类中。 删除报表 单击报表卡片右上角下的“删除报表”，可以将当前报表进行删除。 说明： 报表的删除为彻底删除，一旦删除后，不可恢复。

相关操作 对新创建的特性集，可以执行以下操作。 表1 特性集基本操作 操作项 说明 创建子特性集 单击特性集后单击图标，弹出“新建特性集”窗口。 输入“标题”。 单击“确定”，创建成功。 在对应特性集中可查看到新建的二级子特性集。 图4 子特性集 二级子特性集下可再创建三级子特性集，以此类推，最多可创建十级特性集。 系统支持对分层特性集的编辑和删除操作。 编辑特性集 鼠标悬浮特性集右侧按钮，单击“编辑”，可修改特性集名称。 删除特性集 鼠标悬浮在特性集右侧按钮，单击“删除”，弹出确定删除提示框 图5 删除特性集提示框 单击“删除”，删除成功。页面不再显示被删除的特性集及其子特性集。 说明： 特性集删除后，可在回收站中进行恢复和彻底删除。