自定义集成

自定义集成是指您为了扩展平台的功能而使用公开可用的 Autodesk API 开发的集成。在 Autodesk 平台服务中注册。您还可以在此处找到 API 文档。

自定义集成的权限可以由安全服务帐户 (SSA) 控制。若要详细了解 SSA，请参见安全服务帐户。

添加自定义集成

若要添加自定义集成，您必须先在 Autodesk Platform Services (APS) 门户中创建自定义集成。创建自定义集成后，您可以将其添加到 Autodesk Forma 平台。

1. 在“自定义集成”工具中单击“添加自定义集成”。
2. 提供您的 APS 客户端 ID。客户端 ID 是自定义集成的唯一标识符。您可以在 APS 门户中找到客户端 ID。
3. 提供您的集成名称。
4. 提供集成描述。
5. 单击“下一步”。

6. 系统会自动检索以前为您的客户端 ID 配置的安全服务帐户 (SSA)。
   • 如果未找到 SSA，将无法控制该集成的权限，它将以中心管理员身份运行，可即时访问您帐户中的所有数据。单击“仍然继续”以完成集成。
   • 如果检测到单个 SSA，集成将自动附着到该 SSA。在该 SSA 受邀加入项目之前，不会向集成授予数据访问权限。单击“知道了”以完成集成。
   • 如果检测到多个 SSA，请提供您希望附着到该集成的 SSA 的电子邮件地址。单击“添加”以完成集成。

集成状态

集成状态指示集成是处于“活动”状态还是“非活动”状态。您可以随时更改集成状态。若要排查集成的问题，建议将集成状态设置为“非活动”。

• 活动：集成可以使用 Autodesk API 读取数据并将数据写入 Autodesk Forma 平台。
• 非活动：集成未在使用 Autodesk API 读取数据或将数据写入 Autodesk Forma 平台。

若要更改集成的状态，请执行以下操作：

1. 从“自定义集成”工具的集成列表中选择集成。
2. 选择“状态”下拉列表，然后选择所需的状态。

集成访问权限

从“自定义集成”工具的列表中选择一个自定义集成时，将显示有关该集成的详细信息，包括其访问权限级别。此处显示的是集成在所有项目中达到的最高访问权限级别。例如，如果集成对您的某个项目拥有完全访问权限，但对另一个项目的访问受到限制，集成访问权限仍会显示为“完全项目访问权限”。

若要按项目查看有关集成的访问权限级别的详细信息，请执行以下操作：

1. 从“自定义集成”工具的集成列表中选择集成。
2. 在“集成访问权限”下，单击项目数链接。

有三个可能的访问权限级别，其含义分别如下：

• 完整的中心访问权限：
  • 没有关联的 SSA，所以集成可以访问帐户级数据（而不是仅限于项目级数据）。可用的帐户数据就是可通过公共 API 访问的数据。这适用于在支持 SSA 之前创建的集成。如果集成是在 BIM 360 UI 中创建的，且访问仅限于 Admin 或 Forma Data Management，将一直遵循该设置。集成无法访问受限制的服务。在这种情况下，集成可使用两方身份验证机制。集成电子邮件地址字段为空。
  • 向一个关联的 SSA 授予了您帐户中的“中心管理员”访问权限。填写了集成电子邮件地址字段。使用该 SSA 的集成以自动化用户身份运行，只在用户上下文中拥有相应权限，这可用作三方身份验证机制的一部分。
• 完全项目访问权限：附着到集成的 SSA 是至少一个项目的项目管理员。
• 项目访问权限：附着到集成的 SSA 是其受邀加入的所有项目的项目成员。

若要修改现有 SSA 的访问权限，请在各项目中转到 Project Admin 的“成员”工具。

删除集成

您可以删除不再有用的集成。“非活动”状态应该用来暂时阻止集成向 Autodesk Forma 传输数据以及从它传输数据。删除集成会将其从列表中移除，但可以再次添加。若要删除集成，请执行以下操作：

1. 从“自定义集成”工具的集成列表中选择集成。
2. 单击抽屉中的“更多”菜单 。
3. 选择“删除集成”。
4. 在确认对话框中单击“移除”。