迁移开发人员管理服务账户使用的数据连接应用程序
目标
将使用传统服务账户的现有数据连接应用程序迁移到使用开发人员管理服务账户新版本中。
背景
随着传统服务账户的弃用和开发人员管理服务账户（DMSA）的发布，当前使用依赖传统服务账户的数据连接应用程序的客户必须在停用日期之前计划切换到使用使用 DMSA 的应用程序。 第三方开发商和集成商将更新他们的应用程序以使用 DMSA，并随着时间的推移向 Procore 客户提供新版本。 本教程提供了一些关于准备迁移计划的建议，并概述了完成迁移的过程。
关于 Procore 开发人员门户
Procore 开发人员门户是为开发人员设计的综合资源，可增强他们对 Procore API 和其他开发工具的了解和使用。 该门户提供深入的文档、指南和资源，以鼓励开发人员构建与 Procore 平台集成的应用程序。 它促进了与 Procore 的建设工程管理软件的无缝交互，使开发人员能够创建可扩展 Procore 功能的自定义解决方案。
在门户上注册、注册和构建应用程序
对构建自己的与 Procore 平台集成的应用程序感兴趣的 Procore 客户可以按照以下步骤开始他们的开发征程:
有关详细信息，请参阅使用DMSA构建 Procore 数据连接应用程序。
需要考虑的事项
- 所需用户权限：
- 公司管理员
迁移准备
了解你现有的传统服务账户可以帮助你有效地计划成功的应用程序迁移。在迁移到 DMSA 应用程序之前，你需要审核每个现有服务账户的设置，以验证信息是否准确，以及更新设置可能缺失或错误的任何服务账户。
服务账户分为两种应用程序类型 - “应用商店”和 “自定义”。
- 应用商店 - 适用于映射到从 Procore 应用程序安装或列出的应用程序的服务账户。从下拉列表中选择应用程序。
- 自定义 - 适用于内部开发或第三方集成商专门为你的公司开发的自定义应用程序。
请注意，你公司中的某些服务账户可能没有定义的应用程序类型。在迁移到 DMSA 之前，你需要使用正确的应用程序类型更新这些服务账户。这也是审核和验证现有应用程序类型设置以确保服务账户正确映射的好机会。
第 1 步 - 设置未定义的应用程序类型
使用以下步骤更新未定义应用程序类型的现有服务账户。
- 导航到公司管理员工具。
- 在“公司设置”下，点击服务服务账户。“服务账户”页面显示了你公司现有服务账户的列表。
在检查你的服务账户时，你可能会在应用程序名称列中看到一个或多个没有值的账户，如上例中的第一个账户所示。这表示该服务账户的应用程序类型未定义。在迁移到 DMSA 之前，你需要更新这些账户。
- 找到应用程序名称列值缺失的服务账户，然后点击编辑。
- 对于应用程序类型设置，选择以下选项之一：
- 应用商店 - 如果服务账户映射到 Procore 应用商店中的应用程序，请选择此设置。使用下拉菜单选择应用程序。验证你选择的应用程序是否与生产中拥有的应用程序相匹配。
- 自定义- 如果服务账户由内部开发的应用程序使用，或者由第三方集成商专门为公司构建的应用程序使用，请选择此设置。输入账户描述以及开发人员姓名和电子邮件地址。
- 点击更新。
- 对你公司内缺少应用程序名称列值的所有现有服务账户，重复上述步骤 3 至步骤 5。
第 2 步 - 审核并验证现有服务账户映射
既然你已经设置了所有现有服务账户的应用程序类型，请花几分钟时间来审核每个账户并验证应用程序类型映射是否正确，以及是否根据需要填写所有必填字段。
审核自定义服务账户
- 确保所有标记为“自定义”的服务账户实际上由自定义集成使用，而非由应用商店的应用程序使用。如果你发现应更改为应用商店账户的自定义服务账户，请按照先前部分的说明更新应用程序类型设置。
- 验证公司中的所有自定义服务账户都在使用中。移除所有不活动的账户。
- 验证公司中的所有自定义服务账户都准确填写了描述、公司/开发人员名称和公司/开发人员电子邮件字段。（参考以上内容）
审核应用商店服务账户
- 请确保所有标记为“应用商店”的服务账户实际上都由 Procore 应用商店中的应用程序使用，且应用商店正在生产中运行。如果你发现应更改为“自定义”的“应用商店”服务账户，请按照先前部分的说明更新应用程序类型设置。
- 验证所有应用商店服务账户都在下拉列表中选择了正确的应用商店中的应用程序。（参考以上内容）
将应用程序迁移到 DMSA
此操作步骤将应用程序从传统服务账户迁移到 DMSA 中，根据应用程序类型而有所不同。
应用商店中的应用程序
- 联系你基于应用商店中应用程序的现有服务账户的开发人员，了解他们打算为客户提供支持 DMSA 的版本的时间。在 marketplace.procore.com 上找到应用程序列表，并通过开发人员电子邮件或支持信息联系开发人员。
- 根据开发人员提供的发布日期制定内部沟通计划，以便你的最终用户了解任何一个待处理的应用程序迁移。包括将所有用户移动到新应用程序和淘汰旧版本的时间表。
- 支持 DMSA 的应用程序版本可用后，请按照安装应用商店中的数据连接应用程序中概述的步骤操作。如果不清楚如何安装特定应用程序的启用 DMSA 的新版本，请联系开发人员以了解更多信息。
- 安装新的应用商店中应用程序成功后，请指导你的最终用户开始使用新应用程序，而不是旧版本。
- 所有用户成功转移到新应用程序并开始使用后，可以按照删除服务账户中的描述删除旧服务账户并卸载旧版本的应用程序。
自定义应用程序
- 如果自定义应用程序由公司内部开发和维护，你将需要开发一个新的启用 DMSA 的应用程序版本，如服务账户弃用公告中的描述所示。有关详细信息，请参阅开发人员托管服务账户。如果需要更多指导，请联系 apisupport@procore.com。
- 如果自定义应用程序由第三方开发人员专门为公司构建，请联系他们以了解可以使用新的已启用 DMSA 的应用程序版本的时间，并确保他们在服务账户用户页面填写自定义应用程序信息。
- 支持 DMSA 的应用程序版本可用后，请按照安装自定义应用程序中概述的步骤操作。如果不清楚如何安装特定应用程序的启用 DMSA 的新版本，请联系开发人员以了解更多信息。
- 安装新的应用程序应用程序成功后，请指导你的最终用户开始使用新应用程序，而不是旧版本。
- 所有用户成功转移到新应用程序并开始使用后，可以按照删除服务账户中的描述删除旧服务账户并卸载旧版本的应用程序。