Migration des applications de connexion de données pour utiliser les comptes de service gérés par les développeurs
Objectif
Pour migrer une application de connexion de données existante qui utilise un compte de service traditionnel vers une nouvelle version qui utilise un compte de service géré par le développeur.
Contexte
Avec l'abandon des comptes de service traditionnels et la sortie des comptes de service gérés par le développeur (DMSA), les clients utilisant 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 utilisant 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 de Procore au fil du temps. Ce tutoriel fournit quelques suggestions pour préparer un plan de migration et décrit les procédures pour travailler à travers 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 et d'autres outils de développement de Procore. Le portail fournit une documentation approfondie, 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.
Signation, enregistrement et création d'une application sur le portail
Les clients Procore intéressés à créer leurs propres applications qui s'intègrent à la plateforme Procore peuvent suivre ces étapes pour commencer leur parcours de développement :
- Inscription: créez un compte sur le portail des développeurs Procore.
- S'inscrire: s'inscrire et créer une nouvelle application dans le portail.
- Créer: utilisez les API et la documentation des API de Procore pour développer et intégrer votre application à la plateforme Procore.
Voir Créer des applications de connexion de données Procore avec les CSGD pour plus d'informations.
Éléments à prendre en compte
- Autorisations utilisateur requises :
- Admin de l'entreprise
Préparation à la migration
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'application - « 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 correct avant de migrer vers les CSGD. C'est également une bonne occasion de revoir 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
Suivez les étapes suivantes pour mettre à jour vos comptes de service existants où le type d'application n'est pas défini.
- Accédez à l'outil Admin de l'entreprise.
- 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.
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. Cela 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.
- Localisez un compte de service où la valeur de la colonne Nom de l'application est manquante et cliquez sur Modifier.
- Pour le paramètre Type d'application, choisissez l'une des options suivantes :
- 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.
- 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 électronique du développeur.
- Cliquez sur Mettre à jour.
- 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 - Examen et vérification des mappages de comptes de service existants
Maintenant que vous avez défini le type de demande pour tous vos comptes de service existants, prenez quelques minutes pour examiner chaque compte et vérifier que le mappage du type de demande est correct, et que tous les champs obligatoires sont remplis comme il se doit.
Passer en revue les comptes de services 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 « 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)
Migrer les applications vers les CSGD
Les étapes de la migration d'une application du compte de service traditionnel vers les CSGD varient en fonction du type d'application.
Applications Marketplace
- 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. Localisez le listing 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 de toute migration d'application en cours. Prévoyez des délais pour la migration de tous les utilisateurs vers les 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 avec les CSGD 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 sont passés avec succès à 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 maintenue 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 Obsolescence du compte de service. Voir Comptes de services gérés par les développeurs pour plus de détails. Contactez apisupport@procore.com 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 avec les CSGD 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 sont passés avec succès à 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.