Migration des applications de connexion de données vers l’utilisation de comptes de service gérés par les développeurs

All Traditional Service Accounts will sunset on March 18, 2025.

Traditional Service Accounts were deprecated on December 9, 2021. Beginning January 21, 2025, we will no longer allow the creation of new Traditional Service Accounts. Existing Traditional Service Accounts will continue to function until March 18, 2025.

In accordance with this timeline, developers of data connection applications that currently use Traditional Service Accounts are required to update their applications to use Developer Managed Service Accounts, and customers will be required to install these updated applications before the sunset date. All data connection applications not migrated by the sunset date will cease to function. Any application listed on the Procore App Marketplace that is not using a supported method for accessing the Procore API will be removed by the sunset date. See for additional information.

Avec l’obsolescence des comptes de service traditionnels et la sortie des comptes de service gérés par les développeurs (CSGD), les clients qui utilisent actuellement des applications de connexion de données qui reposent sur des comptes de service traditionnels doivent prévoir de passer à l’utilisation d’applications qui utilisent des DMSA avant la date d’expiration. Les développeurs et intégrateurs tiers mettront à jour leurs applications pour utiliser les DMSA et mettront de nouvelles versions à la disposition des clients Procore au fil du temps. Ce tutoriel fournit quelques suggestions pour la préparation d’un plan de migration et décrit les procédures à suivre lors d’une migration.

À propos du portail des développeurs Procore

Le portail des développeurs Procore est une ressource complète conçue pour les développeurs afin d’améliorer leur compréhension et leur utilisation des API de Procore et d’autres outils de développement. Le portail fournit une documentation détaillée, des guides et des ressources pour encourager les développeurs à créer des applications qui s’intègrent à la plateforme de Procore. Il facilite une interaction transparente avec le logiciel de gestion de la construction de Procore, permettant aux développeurs de créer des solutions personnalisées qui étendent les fonctionnalités de Procore.

Inscription, enregistrement et création d’une application sur le portail

Les clients Procore intéressés par la création de leurs propres applications qui s’intègrent à la plateforme Procore peuvent suivre ces étapes pour commencer leur parcours de développement :

• S’inscrire: créez un compte sur le portail des développeurs Procore.

• S’inscrire: Inscrivez-vous et créez une nouvelle application dans le portail.

• Créer: utilisez les API et la documentation de l’API de Procore pour développer et intégrer votre application à la plateforme de Procore.

Pour plus d’informations, reportez-vous à la section Création d’applications de connexion de données Procore avec DMSA .

• Autorisations utilisateur requises:

  • Administrateur de l’entreprise

Understanding your existing traditional service accounts can help you plan effectively for a successful application migration. Before migrating to a DMSA application you will need to review the settings for each of your existing service accounts to verify the information is accurate, and to update any service accounts where the settings may be missing or incorrect.

Service accounts are categorized into two application types - `Marketplace` and `Custom`.

• Marketplace - for service accounts that are mapped to applications installed from or listed on the Procore App Marketplace. Applications are selectable from a dropdown list.

• Custom - for custom applications that were developed internally or by third-party integrators specifically for your company.

Note that some service accounts in your company may not have a defined application type. You will need to update these service accounts with the correct application type before migrating to DMSAs. It is also a good opportunity to review and verify the existing application type settings to ensure your service accounts are mapped properly.

Step 1 - Set Application Type for Undefined Service Accounts

Use the following steps to update your existing service accounts where the application type is not defined.

1. Navigate to the company's Admin tool.

2. Under 'Company Settings', click Service Accounts. The Service Accounts page shows a list of the existing service accounts in your company.

   1. Upon examining your service accounts you may see one or more accounts with no value in the App Name column, as shown in the first account in the example above. This indicates that the application type for that service account is undefined. You will need to update those accounts before migrating to DMSA.

3. Locate a service account where the App Name column value is missing and click Edit.

   

4. For the App Type setting, choose one of the following options:

   1. Marketplace - choose this setting if the service account is mapped to an application on the Procore App Marketplace. Use the dropdown menu to select the application. Verify that the application you select matches the application you have in production.

      

   2. Custom - choose this setting if the service account is used by an application you have developed internally, or by an application built by a third-party integrator specifically for your company. Enter a description for the account as well as the developer name and email address.

      

5. Click Update.

6. Repeat Steps 3-5 above for all existing service accounts in your company where the App Name column value is missing.

Step 2 - Review and Verify Existing Service Account Mappings

Now that you have set the application type for all your existing service accounts, take a few minutes to review each account and verify that the application type mapping is correct, and that all required fields and are filled in as needed.

Review Custom Service Accounts

• Be sure that all service accounts marked as `Custom` are actually used by custom integrations rather than by Marketplace applications. If you find a Custom service account that should be changed to a Marketplace account, update the App Type setting as described in the previous section.

• Verify that all Custom service accounts in your company are actively being used. Remove any inactive accounts.

• Verify that all Custom service accounts in your company have the Description, Company/Developer Name and Company/Developer Email fields filled in accurately. (see above)

Review Marketplace Service Accounts

• Be sure that all service accounts marked as ‘Marketplace’ are actually used by applications from the Procore App Marketplace that you have currently running in production. If you find a ‘Marketplace’ service account that should be changed to ‘Custom’, update the App Type setting as described in the previous section.

• Verify that all Marketplace service accounts have the correct Marketplace App selected in the dropdown. (see above)

Les étapes de la migration d’une application du compte de service traditionnel vers les CSGD varient en fonction du type d’application.

Applications de la place de marché

• Contactez les développeurs de vos applications Marketplace existantes basées sur le compte de service pour savoir quand ils prévoient de mettre à disposition de leurs clients des versions compatibles avec les CSGD. Recherchez la liste de l’application sur marketplace.procore.com et utilisez l’e-mail du développeur ou les informations de support pour contacter le développeur.

• Élaborez un plan de communication interne basé sur les dates de sortie fournies par le développeur, afin que vos utilisateurs finaux soient informés des migrations d’applications en cours. Incluez des échéanciers pour le transfert de tous les utilisateurs vers de nouvelles applications et pour le retrait des anciennes versions.

• Une fois que la version prenant en charge les CSGD de l’application est disponible, suivez les étapes décrites dans Installer une application de connexion de données à partir de la Marketplace. Si vous ne savez pas comment installer la nouvelle version compatible DMSA d’une application particulière, contactez le développeur pour obtenir des informations supplémentaires.

• Après avoir installé avec succès la nouvelle application Marketplace, demandez à vos utilisateurs finaux de commencer à utiliser la nouvelle application au lieu de l’ancienne version.

• Une fois que tous les utilisateurs ont été transférés vers l’utilisation de la nouvelle application, vous pouvez supprimer l’ancien compte de service comme décrit dans Supprimer un compte de service et désinstaller l’ancienne version de l’application.

Applications personnalisées

• Si une application personnalisée a été développée et gérée en interne par votre entreprise, vous devrez développer une nouvelle version de l’application compatible avec les CSGD, comme décrit dans l’annonce d’obsolescence du compte de service . Pour plus d’informations, consultez la section Comptes de service gérés pour les développeurs . N’hésitez pas à apisupport@procore.com contacter si vous avez besoin de conseils supplémentaires.

• Si une application personnalisée a été créée par un développeur tiers spécifiquement pour votre entreprise, contactez-le pour savoir quand une nouvelle version de l’application compatible avec les CSGD sera disponible et assurez-vous qu’il complète les informations relatives à l’application personnalisée dans l’interface utilisateur du compte de service.

• Une fois que la version compatible avec les CSGD de l’application personnalisée est disponible, suivez les étapes décrites dans Installer une application personnalisée. Si vous ne savez pas comment installer la nouvelle version compatible DMSA d’une application particulière, contactez le développeur pour obtenir des informations supplémentaires.

• Après avoir installé avec succès la nouvelle application personnalisée, demandez à vos utilisateurs finaux de commencer à utiliser la nouvelle application au lieu de l’ancienne version.

• Une fois que tous les utilisateurs ont été transférés vers l’utilisation de la nouvelle application, vous pouvez supprimer l’ancien compte de service comme décrit dans Supprimer un compte de service et désinstaller l’ancienne version de l’application.