项目

Composer 中的 ThingWorx 模型定义 > 建模 > 项目

项目

项目用于组织 ThingWorx 内的实体。在项目中收集的实体可以一起导出或导入。实体只能属于一个项目。必须将所有实体分配至项目。在 Composer 中创建实体时，“项目”字段为必填项，且在设置项目前无法保存实体。

默认项目：PTCDefaultProject

尽管建议创建自定义项目，但仍会将 PTCDefaultProject 纳入出厂项目。PTCDefaultProject 具有以下行为：

• 如果通过 API 创建实体且未定义项目，则会将该实体添加至 PTCDefaultProject。

• PTCDefaultProject 是无法作为项目实体依存项添加的系统对象。

• 如果实体通过服务创建、导入或迁移至 9.1 及更高版本，且未提供项目名称，则会将 PTCDefaultProject 分配为项目。

• 如果实体被复制且随后移除了实体所包含的项目，则在保存实体后，会默认分配 PTCDefaultProject。

• SetProjectName 服务可用于为可编辑扩展实体设置项目。用户界面仍为只读状态，必须调用此服务来设置项目。用户创建的项目和属于相同扩展一部分的项目均可设置为这些实体。

• 如果项目属于组件或构建基块类型，可通过编辑项目将名称空间分配给 PTCDefaultProject。

创建项目

1. 在 Composer 中，浏览至“项目”，然后单击

图标以创建新项目。

2. 输入项目的名称和说明。

3. 选择一个“项目类型”。以下选项供您选择：

◦ “组件”类型项目表示可重用解决方案/应用程序的一部分，例如模板、形态或服务。它们可以是用户体验、模型和/或逻辑的组合，但在被应用程序使用前，这种组合不能解决任何问题，也不会产生任何结果。“组件”为默认类型。

◦ “构建基块”类型项目是包含多个实体的 ThingWorx 项目实体，这些实体紧密耦合、内容详实的细分为若干可重复使用、标准化、自包含的组件，并提供精心设计的外部接口，使内部实施对外隐匿。

项目类型“构建基块”在 ThingWorx 9.5.0 及更高版本中可用。

◦ “解决方案”类型项目表示完整的解决方案/应用程序。解决方案/应用程序由组件类型项目组成，通常可用于解决问题或提供结果。

通过 EntityServices 中的 CreateProject 服务创建项目时，用户无法在执行服务期间分配名称空间和访问权限修饰符，也无法弃用对象。一旦通过 EntityServices 中的 CreateProject 服务创建项目，即可从 Composer 或通过 REST 调用分配该项目。

4. 对于“组件”和“构建基块”项目类型，可从现有列表中添加“名称空间” 或创建新的名称空间。

在 ThingWorx 中，名称空间用于将项目组织成逻辑组并防止名称冲突。有关名称空间的详细信息，请参阅名称空间主题。

“名称空间”对于“构建基块”项目类型为必填项，对于“组件”项目类型为选填项。“解决方案”项目类型不支持“名称空间”。

5. 对于“构建基块”项目类型，需为项目指定“默认范围”。“默认范围”可为“无”(公共)、“受限”或“专用”。如果选择“无”，则项目为公共项目。有关范围的详细信息，请参阅访问修饰符主题。

6. 或者，添加适当的“标记”并选择“主混搭”。

7. 使用“项目依存项”字段来指定该项目所依存的其他项目的列表。

不建议使用“项目依存项”字段将空项目 (不包含任何实体的项目) 分配给其他项目。如果将空项目分配给其他项目后便将此空项目删除，则在导入或导出现有项目时可能会发生错误。

8. 通过使用“扩展依存项”字段，指定项目所依存的全部扩展，以便按预期部署和运行。可将扩展发布至 Solution Central 或从中进行部署。

9. 要在项目中添加实体，请从“实体”区域的“可用实体”列表中选择或搜索实体，然后将这些实体拖放到“项目实体”区域中。

对于新项目，在“可用实体”列表中将显示已分配给其他项目的实体的列表。如果将这些实体添加到新项目中，则会对其进行重新分配并从先前的项目中移除。

使用筛选器 (

) 图标，还可基于类型、项目、标记、事物模板、事物形态、说明或范围来筛选实体。