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

Tous les comptes de service traditionnels ont pris fin le 18 mars 2025.

Les comptes de service traditionnels ont été abandonnés le 9 décembre 2021. À compter du 21 janvier 2025, nous n’autoriserons plus la création de nouveaux comptes de service traditionnels. Les comptes de service traditionnels existants continueront de fonctionner jusqu’au 18 mars 2025.

Conformément à ce calendrier, les développeurs d’applications de connexion de données qui utilisent actuellement des comptes de service traditionnels sont tenus de mettre à jour leurs applications pour utiliser des comptes de service gérés par les développeurs, et les clients devront installer ces applications mises à jour avant la date d’extinction. Toutes les applications de connexion de données qui n’ont pas été migrées à la date d’expiration cesseront de fonctionner. Toute application répertoriée sur Procore App Marketplace qui n’utilise pas une méthode prise en charge pour accéder à l’Procore API sera supprimée à la date d’expiration. Pour plus d’informations, reportez-vous à la section Migration des applications de connexion de données vers l’utilisation des DMSA.

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

Comprendre vos comptes de service traditionnels existants peut vous aider à planifier efficacement une migration réussie de l’application. Avant de migrer vers une application CSGD, vous devrez revoir les paramètres de chacun de vos comptes de service existants pour vérifier que les informations sont exactes et pour mettre à jour les comptes de service dont les paramètres sont manquants ou incorrects.

Les comptes de service sont classés en deux types d’applications : Marketplace et Personnalisé.

• Marketplace - pour les comptes de service qui sont associés à des applications installées ou répertoriées sur la Marketplace des applications Procore. Les applications peuvent être sélectionnées dans une liste déroulante.

• Personnalisé - pour les applications personnalisées qui ont été développées en interne ou par des intégrateurs tiers spécifiquement pour votre entreprise.

Notez que certains comptes de service dans votre entreprise peuvent ne pas avoir un type d’application défini. Vous devrez mettre à jour ces comptes de service avec le type d’application approprié avant de migrer vers les CSGD. C’est également une bonne occasion d’examiner et de vérifier les paramètres de type d’application existants pour s’assurer que vos comptes de service sont correctement mappés.

Étape 1 - Définir le type d’application pour les comptes de service non définis

Procédez comme suit pour mettre à jour vos comptes de service existants où le type d’application n’est pas défini.

1. Accédez à l’outil Admin de l’entreprise.

2. Sous Paramètres de l’entreprise, cliquez sur Comptes de service. La page Comptes de service présente une liste des comptes de service existants dans votre entreprise.

   1. En examinant vos comptes de service, vous pouvez voir un ou plusieurs comptes sans valeur dans la colonne Nom de l’application, comme le montre le premier compte dans l’exemple ci-dessus. Ceci indique que le type d’application pour ce compte de service est indéfini. Vous devrez mettre à jour ces comptes avant de migrer vers les CSGD.

3. Localisez un compte de service où la valeur de la colonne Nom de l’application est manquante et cliquez sur Modifier.

   

4. Pour le paramètre Type d’application, choisissez l’une des options suivantes :

   1. Marketplace - choisissez ce paramètre si le compte de service est associé à une application sur la Marketplace d’applications Procore. Utilisez le menu déroulant pour sélectionner l’application. Vérifiez que l’application que vous sélectionnez correspond à l’application que vous avez en production.

      

   2. Personnalisé - choisissez ce paramètre si le compte de service est utilisé par une application que vous avez développée en interne, ou par une application construite par un intégrateur tiers spécifiquement pour votre entreprise. Saisissez une description du compte ainsi que le nom et l’adresse e-mail du développeur.

      

5. Cliquez sur Mettre à jour.

6. Répétez les étapes 3 à 5 ci-dessus pour tous les comptes de service existants dans votre entreprise pour lesquels la valeur de la colonne Nom de l’application est manquante.

Étape 2 - Examiner et vérifier les mappages de comptes de service existants

Maintenant que vous avez défini le type d’application pour tous vos comptes de service existants, prenez quelques minutes pour examiner chaque compte et vérifier que le mappage des types d’application est correct et que tous les champs obligatoires et sont remplis au besoin.

Passer en revue les comptes de service personnalisés

• Assurez-vous que tous les comptes de service marqués comme « personnalisés » sont en fait utilisés par des intégrations personnalisées plutôt que par des applications Marketplace. Si vous trouvez un compte de service personnalisé qui doit être changé en compte Marketplace, mettez à jour le paramètre Type d’application comme décrit dans la section précédente.

• Vérifiez que tous les comptes de services personnalisés de votre entreprise sont activement utilisés. Supprimez tous les comptes inactifs.

• Vérifiez que les champs Description, Nom de la société/du développeur et E-mail de la société/du développeur sont correctement remplis pour tous les comptes de services personnalisés de votre entreprise. (voir ci-dessus)

Passer en revue les comptes de service de la Marketplace

• Assurez-vous que tous les comptes de service marqués comme Marketplace sont effectivement utilisés par les applications de Procore App Marketplace que vous avez actuellement en production. Si vous trouvez un compte de service Marketplace qui doit être changé en Personnalisé, mettez à jour le paramètre Type d’application comme décrit dans la section précédente.

• Vérifiez que tous les comptes de service Marketplace ont la bonne Application Marketplace sélectionnée dans la liste déroulante. (voir ci-dessus)

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.