提单配置
提单配置可以将 TCA 代码分析发现的问题（代码检查问题、圈复杂度问题）自动同步到第三方项目管理平台，实现问题的自动化流转与跟踪管理。
什么是提单？
"提单"是指将代码分析发现的问题自动或手动创建为第三方项目管理平台（如 TAPD 等）上的缺陷单，方便团队在统一的项目管理平台上跟踪和处理代码质量问题。
请按照以下步骤完成配置：
- 第三方项目管理平台授权：进入团队管理-第三方应用页面，完成第三方项目管理平台的 OAuth 授权。
- 项目提单配置：进入项目管理-提单配置页面，完成项目与第三方项目管理平台项目空间的绑定，并配置提单规则。
- 代码库提单配置：进入代码库-分析配置-提单配置页面，在代码库中配置是否启用提单配置，以及更细粒度的提单规则，或直接复用项目提单配置。
- 执行代码分析：分析完成后，系统将根据配置自动提单，也支持手动提单。
平台授权
您需要先在团队管理中完成第三方项目管理平台的 OAuth 授权，才能进行后续的提单配置。
操作步骤
- 进入 团队管理 → 第三方应用 页面。
- 查看当前支持的平台列表，选择需要授权的平台。
- 点击 授权 按钮，系统将跳转到对应平台的 OAuth 授权页面。
- 在第三方平台完成授权确认后，系统会自动回调并保存授权信息。
授权管理
完成授权后，您可以在授权列表中进行以下管理操作：
- 查看授权详情：查看单个授权的详细信息。
- 刷新授权：当授权过期时，可以重新刷新授权。
- 删除授权：删除不再使用的授权，支持强制删除。
- 查看关联配置：查看该授权已关联的提单配置项列表。
注意
删除授权时，如果该授权已关联提单配置，建议先解除关联再删除，或使用强制删除。
项目提单配置
项目提单配置用于将项目与第三方项目管理平台的 项目空间 进行绑定，并配置项目层级的提单规则。配置完成后，该项目下的代码库即可使用提单功能。
重要
还需要在代码库层级配置启用提单，参见代码库提单配置。
绑定项目空间
步骤1： 进入 项目 → 提单配置 页面，点击 项目空间绑定 按钮。
步骤2： 在弹框中按 平台 → 授权站点 → 项目空间 三级树形结构选择目标项目空间，并填写提单规则。
步骤3： 配置问题级别映射（将 TCA 问题级别映射到第三方平台的严重级别和优先级），点击确认完成绑定。
提单规则说明
| 配置项 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
| 项目空间 | ✅ | - | 第三方项目管理平台项目空间，绑定后不可修改 |
| 提单人 | ✅ | 腾讯云代码分析TCA | 提单时显示的报告人名称 |
| 抄送人 | ❌ | - | 提单时的抄送人，多个用英文分号（;）分隔 |
| 缺省负责人 | ✅ | - | 当无法自动获取问题代码责任人时，默认指派给该负责人 |
| 拒单负责人 | ❌ | - | 拒单后将问题单处理人流转为拒单处理人 |
| 自动提单量 | ✅ | 20 | 每次分析的自动提单数量上限（代码检查、圈复杂度分开计算） |
| 自动提单范围 | ✅ | 严重 + 错误 | 仅对指定严重级别的问题自动提单 |
| 自动提单配置 | ❌ | 代码检查自动提单 | 可勾选：代码检查自动提单、圈复杂度自动提单 |
| 自动关单配置 | ❌ | 开启 | 问题解决后自动关闭对应的缺陷单 |
自动提单范围 支持以下级别：
| 选项 | 提单范围 |
|---|---|
| 严重 | 仅提单严重级别的问题 |
| 严重 + 错误 | 提单严重和错误级别的问题 |
| 严重 + 错误 + 警告 | 提单严重、错误和警告级别的问题 |
| 严重 + 错误 + 警告 + 提示 | 提单所有级别的问题 |
问题级别映射
问题级别映射用于将 TCA 的问题级别对应到第三方平台的严重级别和优先级，确保问题在不同平台间的严重程度一致。
| TCA 问题级别 | 可映射的严重级别 | 可映射的优先级 |
|---|---|---|
| 严重 | 致命 / 严重 / 一般 / 提示 / 建议 | 紧急 / 高 / 中 / 低 / 无关紧要 |
| 错误 | 致命 / 严重 / 一般 / 提示 / 建议 | 紧急 / 高 / 中 / 低 / 无关紧要 |
| 警告 | 致命 / 严重 / 一般 / 提示 / 建议 | 紧急 / 高 / 中 / 低 / 无关紧要 |
| 提示 | 致命 / 严重 / 一般 / 提示 / 建议 | 紧急 / 高 / 中 / 低 / 无关紧要 |
管理已绑定的项目空间
在提单配置列表页，可以对已绑定的项目空间进行以下操作：
- 提单配置：修改已绑定项目空间的提单规则和级别映射。
- 查看关联代码库：查看该项目空间已关联的代码库提单配置列表。
- 删除授权：解除项目空间绑定，支持强制删除。
注意
删除项目空间绑定会将已关联的代码库提单配置清空，请谨慎操作！建议先查看已绑定的代码库配置，确认影响范围后再执行删除。
代码库提单配置
代码库提单配置位于 代码库 → 分析配置 → 提单配置 中，用于在代码库中配置是否启用提单配置，以及更细粒度的提单规则，或直接复用项目提单配置。
前置条件
只有当项目已绑定至少一个项目空间时，代码库的仓库配置中才会出现「提单配置」选项。
配置模式
代码库提单配置支持三种模式：
| 模式 | 说明 |
|---|---|
| 关闭提单配置 | 不启用代码库级别的提单功能 |
| 复用项目提单配置 | 直接使用项目级别的提单规则，无需额外配置 |
| 自定义提单配置 | 在代码库级别自定义提单规则，覆盖项目配置 |
操作步骤
步骤1： 进入代码库的 分析配置 → 提单配置 页面，选择提单配置控制模式。
步骤2： 配置目标分支和目标方案，选择要关联的项目空间。
- 目标分支：支持填入分支名或正则表达式，匹配需要提单的分支。
- 目标方案：选择至少一个分析方案（必填）。
- 项目空间：选择项目已绑定的第三方平台项目空间（必填）。
步骤3： 如果选择了 自定义提单配置 模式，还需要配置具体的提单规则：
自定义模式下的配置项与项目提单配置一致，包括：提单人、抄送人、缺省负责人、拒单负责人、自动提单量、自动提单范围、自动提单配置、自动关单配置。
提示
首次配置自定义提单时，切换项目空间会自动获取该项目空间在项目级别的提单配置作为默认值，方便快速配置。
步骤4： 点击 保存 完成配置。
手动提单
除了自动提单外，您还可以在分析项目中对具体的问题手动发起提单。
使用方式
- 进入分析项目的 代码检查 或 圈复杂度 页面。
- 选择需要提单的问题或文件。
- 点击提单按钮，系统会将选中的问题同步到已配置的缺陷平台。
提示
手动提单前，系统会自动校验当前分析项目是否已配置提单规则。如果未配置，请先完成项目和代码库的提单配置。
常见问题
为什么在代码库的分析配置中看不到「提单配置」选项？
请确认项目已绑定至少一个项目空间。代码库提单配置依赖项目提单配置，只有项目完成配置后，代码库才会显示该选项。
自动提单量是如何计算的？
自动提单量是指每次代码分析后自动创建的缺陷单数量上限。代码检查和圈复杂度的提单量是分开计算的，例如设置为 20，则代码检查最多自动提 20 单，圈复杂度也最多自动提 20 单。
复用项目提单配置和自定义提单配置有什么区别？
- 复用项目提单配置：直接使用项目级别的提单规则，适合大多数场景。
- 自定义提单配置：可以在代码库级别覆盖项目的提单规则，适合需要差异化配置的场景，例如不同代码库需要不同的提单人或提单范围。