1. iModel 相关接口概述

1.1.1. 概述

iModel 接口提供了对 iModels 信息的访问和管理功能。iModel 是一个专用的信息容器，用于交换与基础设施资产生命周期相关的数据。iModel 的创建是为了促进信息的共享和分发，而不管信息的来源以及它们的格式如何。项目团队使用 iModel 来确保信息在设计、施工和运营环境之间及内部轻松、完整、准确地流动。iModel 是自我描述的、几何精确的、开放的、轻便的和安全的。iModel 以开放的格式封装组件信息、业务属性、几何图形、图像和关系，为多个供应商的应用程序提供标准接口。

1.1.2. iModelHub 服务

在 iModels API 服务下的是 iModelHub 服务，它支持数字孪生基础设施的一致性、可问责性和可访问性。它是 iModels 的控制中心，负责协调对 iModels 的并发访问，以及以变更集的形式对其进行的更改。它的主要作用是维护由变更集序列构成的 iModel 时间线。就像会计系统对金融交易所做的那样，iModelHub 拥有一个 iModel 所有变更的分类账。 在 iModelHub 的支持下，你不再需要质疑可能发生了什么变化，它有存储并管理操作人、操作内容以及操作时间的记录的能力。iModelHub 存储了变更本身，而不仅仅是存储了变更的结果。

变更（Changesets）

变更集合表示对 iModel 的一组变更。变更集合在每次修改 iModel 的本地副本时就会被创建，它反映了一段时间内所有添加、删除和修改的结合。将变更集上传到 iModelHub 时，系统会为其分配一个标识符，每个变更将会存储其父变更集的标识符，通过这种方式，iModelHub 中 iModel 的变更集链就形成了这个 iModel 的“变更时间线”。

命名版本（Named versions）

时间线上的每个变更都可以创建 iModel 的新版本。然而，时间线上的一些时间点可代表要保存的重要里程碑或重要事件（例如，用于Design Review）。一个命名版本可以在时间线上用名字标记一个时间点。命名版本会被缓存，以加快访问的速度。

1.1.3. 样例

有关如何使用 API 的更多信息，请查看 https://github.com/iTwin/imodels-api-management-workflow-sample-app