设置和使用 Procore 项目设置代理

概述

Procore 项目设置代理可为使用 Procore 的组织自动完成 OpenSpace 项目设置。您只需在组织级别设置一次路由规则和权限映射。之后，当创建的 Procore 项目符合您的规则时，OpenSpace 会自动：

• 在规则指定的项目组中创建 OpenSpace 项目。
• 从 Procore 填充项目详细信息，包括项目名称、地址、开始日期、结束日期和合同金额。
• 根据您的权限映射将用户添加到项目中。
• 在新项目上设置 Procore 集成。

设置完成后，代理会持续监控 Procore。如果项目或其用户之后在 Procore 中发生变化，例如项目进入新阶段或增加了更多人员，代理会自动获取这些变化。

权限

前提条件

• Procore 项目设置代理适用于订阅 Enterprise 方案的组织。如果您在管理工具栏中看不到集成，则您的组织没有订阅 Enterprise 方案。如果您认为这不正确，或想要了解更多信息，请联系您的 OpenSpace 团队。
• 必须从 Procore 应用市场将 OpenSpace 应用和双向同步应用安装到您的 Procore 公司中。请在本文中查看相关说明。
• 您必须拥有在 Procore 公司级别创建 Webhook 的权限
• 您必须通过 Procore 登录 OpenSpace。

设置 Procore 项目设置代理

• 在 OpenSpace 主页中，从左侧边栏的管理下选择集成，然后在 Procore 卡片上选择设置。

• 在连接步骤中，从公司下拉菜单中选择您的 Procore 公司，然后选择连接。公司连接完成后，选择下一步。

• 在安装应用步骤中，确认OpenSpace应用和双向同步应用均显示为已安装，然后选择下一步。
  • 提示：如果任一应用尚未安装，请选择查看说明获取分步指导，或选择相应应用以打开其 Procore 应用市场页面。

• 在规则步骤中，设置用于决定 OpenSpace 项目创建方式的规则。
  • 请注意：其他所有情况规则适用于不符合其上方规则的任何 Procore 项目。该规则默认为不同步，即不会创建 OpenSpace 项目。您可以将其更改为同步到 OpenSpace，以便为每个 Procore 项目创建 OpenSpace 项目。

• 选择添加您的第一个路由以定义第一条规则。为路由命名，然后设置条件：Procore 项目阶段、位置（按州、城市或邮政编码）以及合同金额（高于、低于或介于某些数值之间）。如果您的组织使用项目组，请选择新项目创建到的组。然后选择保存。
  • 请注意：如果您未为某项条件选择任何内容，则规则会匹配任意值：任意阶段、任意位置或任意合同金额。

• 根据需要添加任意数量的规则，然后选择下一步。
  • 请注意：规则会按照从上到下的顺序进行评估，并以第一个匹配的规则为准。拖动规则即可重新排序。

• 在权限步骤中，将您的 Procore 权限模板映射到 OpenSpace 权限。对于每个 Procore 权限模板，选择相应用户添加到新项目时应分配的 OpenSpace 权限（查看者、编辑者、编辑者增强版或站点管理员）。
  • 请注意：您的所有 Procore 权限模板（包括自定义模板）都会自动显示在此处。
  • 请注意：其他所有人员备用选项适用于 Procore 角色没有映射的用户。该选项默认为不添加，即不会将这些用户添加到 OpenSpace。

• 完成映射后，选择完成。

Procore 项目设置代理现已激活。每当创建的 Procore 项目符合您的规则条件时，OpenSpace 都会自动创建项目，并根据您的权限映射添加用户。

管理 Procore 项目设置代理

• 前往集成并选择 Procore 集成，以查看已同步的项目。Procore 项目创建并路由到 OpenSpace 后，此表会显示相关内容。

• 选择管理设置，即可在设置完成后的任何时间编辑、添加、移除、启用或停用规则，或编辑权限映射。

• 选择活动，即可查看项目设置代理事件的完整审计日志，例如规则变更和项目创建。

Procore 项目设置代理创建的内容

当 Procore 项目符合您的规则条件时：

• OpenSpace 项目会自动在规则指定的项目组中创建。

• 项目详细信息会自动从 Procore 填充，包括项目名称、地址、开始日期、结束日期和合同金额。

• 系统会根据您的权限映射自动将用户添加到项目中。

• Procore 集成会自动在项目上设置并配置，无需进行项目级别设置。

常见问题 

创建 Procore 项目时，如果它不符合任何规则，会发生什么？

该项目会归入其他所有情况规则，该规则默认为不同步。代理会持续监控 Procore，因此如果项目之后符合某条规则的条件，例如其阶段发生变化或添加了地址，系统会在该时点将其路由到 OpenSpace。

之后有人加入 Procore 项目时会发生什么？

代理会持续同步用户。在 Procore 项目创建后加入的任何人员，都会根据您的权限映射自动添加到 OpenSpace 项目。

设置完成后，我可以更改规则或权限映射吗？

可以。前往组织管理员工具栏下的集成，选择 Procore 集成，然后选择管理设置。

后续步骤 

管理 Procore 集成的现场记录

如果您还有其他问题，请联系 OpenSpace 支持团队：support@openspace.ai。