# Data Model URIs

> 依据一个模式，为项目的每个工件类型、属性、数据类型、枚举值和链接类型赋予一致的 URI，并在任何更改之前提供完整预览。

Source: https://widgets.doorsnext.com/zh/widgets/data-model-uris/

- 学科: 配置与治理
- 适用于: IBM DOORS Next 模块
- 支持的产品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- 更改数据
- Keywords: 分配的 URI, 类型系统 URI, 数据模型 URI, RDF URI, 工件类型 URI, 属性 URI, 枚举 URI, OSLC, 全局配置, 报告, 命名约定, camelCase
- 版本: 1.14 (发布日期 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 工作流程: 1. 在变更集中打开项目 → 2. 输入域、前缀和名称格式 → 3. 预览每个 URI 和冲突 (如有需要: 有冲突：更改前缀或格式) → 4. Set URIs：保存到数据模型 → 5. Excel 变更报告

## 它是什么，为何存在
DOORS Next 项目中的每个工件类型、属性、数据类型和枚举值都可以带有一个 URI。报告、发布模板、OSLC 集成和全局配置正是依靠这些 URI，在不同的项目和流中识别出"同一个"属性或类型。没有 URI，每个项目都只有自己的内部标识符，跨项目工作就无法顺利进行。

在项目属性中手动设置 URI，意味着要逐一打开每个定义、输入 URI，并保持命名一致。对于一个真实的数据模型来说，这涉及数百个条目，需要花费数小时，其间很容易打错字。Data Model URIs 用一个步骤完成这项工作，整个模型使用一套命名方案。

## 解决的问题
- 数据模型没有 URI，导致报告、集成和全局配置无法在项目之间匹配类型。
- 手动输入的 URI 在拼写、前缀和大小写上不一致。
- 重复的 URI 阻碍数据模型的使用或造成报告混乱。
- 在项目属性中花费数小时，完成一项本来只需遵循简单规则的任务。

## 优势
- **整个模型使用一个模式：** 您的域或服务器、每组一个前缀，以及一种名称格式（camelCase、PascalCase、snake_case 或 kebab-case）。
- **先查看，再更改：** 设置模式时实时显示示例，并预览每个 URI 及其状态。
- **安全的设计：** 除非您选择替换，否则现有 URI 会被保留；存在冲突的 URI 绝不会被写入。
- **包含枚举值和链接类型**，每个枚举值都位于其数据类型的 URI 之下。
- **Excel 导出**：可导出预览以及每次运行所做的更改，便于审核和审计。

## 使用方法
1. 在变更集（推荐）或流中打开项目。小部件会读取其数据模型。
2. 在 **URI pattern** 处单击 **Change**，输入您的域或服务器，例如 `https://example.com/ns`，然后为每组选择前缀和名称格式。示例会随您的选择而更新。
3. 查看预览：新的 URI、已设置的 URI、保留的 URI 以及任何冲突。如果需要更改现有 URI，请勾选 **Replace URIs that are already set**。如需他人检查，可将预览导出到 Excel。
4. 单击 **Set URIs**（设置 URI）并确认。系统会显示进度，您可以随时停止。
5. 使用结果区块中的 **Log** 下载变更报告，确认满意后再交付变更集。

## 须知
- 我们建议在变更集中工作，这样新的 URI 可以在交付之前进行审核或废弃。基线无法更改。
- 名称会被转换为规范的 URI 单词：去除重音符号，并以空格、连字符和大写字母作为单词分隔。
- 典型用途：准备项目模板、在设置全局配置之前统一各个项目，以及支持报告和 OSLC 集成。
- 属于 DOORS Next 自身的定义（例如系统属性）显示为只读，绝不会被更改。工作流的状态不会列出，因为 DOORS Next 不允许以这种方式保存它们的 URI。
