Passer au contenu principal
Procore

Migrer les applications de connexion de données pour utiliser les comptes de service gérés par les développeurs

 

dépréciation des comptes de service traditionnels
Les comptes de service traditionnels seront abandonnés le 9 décembre 2021. La création de nouveaux comptes de services traditionnels ne sera plus autorisée après le 31 juillet 2022. Tous les services traditionnels comptes seront au coucher du soleil le 31 janvier 2023. En conséquence de cette obsolète, les développeurs des applications de connexion de données qui utilisent actuellement les services traditionnels comptes doivent migrer l’application pour utiliser les DMSA et les clients doivent installer ces applications migrées avant la date du coucher du soleil du 31 janvier 2023. Voir Déprecation des comptes de service traditionnels pour plus de détails.

Objectif

Migrer une application de connexion de données existante qui utilise un service traditionnel compte à une nouvelle version qui utilise un compte de service géré par les développeurs.

Contexte

Avec l’abandon des comptes de services traditionnels et la sortie des comptes de service gérés (DMSA), les clients utilisant actuellement des applications de connexion de données s’appuyant sur les applications de service traditionnelles comptes doivent planifier de passer à l’aide d’applications qui utilisent des applications qui utilisent des DMSA avant la date du coucher du soleil du 31 janvier 2023. Les développeurs et intégrateurs tiers devront mettre à jour leurs applications pour utiliser des DMSA et rendre de nouvelles versions disponibles pour les clients Procore au fil du temps. Ce tutoriel fournit un certain suggestions pour préparer un plan de migration et décrit les procédures de travail via une migration.

Éléments à considérer

  • Permissions d'utilisateur requises :
    • Admin de l’entreprise

Préparation de la migration

Comprendre votre comptes de service traditionnel existant peut vous aider à planifier efficacement une migration d’application réussie. Avant de migrer vers une application DMSA, vous devrez examiner les paramètres de chacun de vos services existants comptes pour vérifier que les informations sont exactes et pour mettre à jour tout service comptes où les paramètres peuvent être 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 mappées aux applications installées à partir ou répertoriées sur le marché des applications Procore. Les applications sont sélectionnables dans une liste déroulante.
  • Personnalisé - pour les applications personnalisées développées en interne ou par des intégrateurs tiers spécifiquement pour votre compagnie.

Notez que certains comptes de service de votre compagnie peuvent ne pas avoir de type d’application défini. Vous devrez mettre à jour ces comptes de service avec le type d’application correct avant de migrer vers des DMSA. Il est également une bonne occasion de réviser et de vérifier les paramètres de type d’application existants pour vous assurer que vos comptes de service sont correctement mappées.

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

Suivez les étapes suivantes pour mettre à jour votre service existant comptes où le type d’application n’est pas défini.

  1. Accédez à l'outil Admin de la compagnie.
  2. Sous « Paramètres de la compagnie », cliquez sur Comptes de service. La page Comptes de service affiche une liste des comptes de service existantes dans votre compagnie.

existing-service accounts.png

Lors de l’examen de votre comptes de service, vous pouvez voir un ou plusieurs comptes sans valeur dans la colonne Nom de l’application, comme indiqué dans le premier compte dans l’exemple ci-dessus. Cela indique que le type d’application de ce service compte n’est pas défini. Vous devrez mettre à jour ces comptes avant de migrer vers DMSA.

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

service-account-app-type.png

  1. Pour le paramètre Type d’application, choisissez l’une des options suivantes :
  • Marketplace - choisissez ce paramètre si le service compte est mappé à une application sur le marché des 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 dans production.

edit-account-marketplace.png

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

edit-account-custom.png

  1. Cliquez sur Mettre à jour.
  2. Répétez les étapes 3 à 5 ci-dessus pour tous les comptes de service existants dans votre compagnie où la valeur de la colonne Nom de l’application est manquante.

Étape 2 - Vérifiez et vérifiez les mappages existants de compte de service

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 de type d’application est correct, et que tous les champs obligatoires et sont remplis si nécessaire.

Examiner les comptes de service personnalisés

  • Assurez-vous que tous les services comptes marqués comme « Personnalisés » sont réellement utilisés par des intégrations personnalisées plutôt que par des applications Marketplace. Si vous trouvez un service personnalisé compte qui doit être modifié 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 service personnalisés de votre compagnie sont activement utilisés. Supprimez tout comptes inactif.
  • Vérifiez que tous les comptes de service personnalisé de votre compagnie ont les champs Description, Nom de la compagnie/Développeur et Courriel de compagnie/développeur remplis avec précision. (voir ci-dessus)

Examiner les comptes de service du marché

  • Assurez-vous que tous les comptes de service marqués comme « Marketplace » sont réellement utilisés par les applications du marché des applications Procore que vous utilisez actuellement dans production. Si vous trouvez un service « Marketplace » compte qui doit être modifié en « Personnalisé », mettez à jour le paramètre Type d’application comme décrit dans la section précédente.
  • Vérifiez que tous les services du marché des comptes ont la bonne application Marketplace sélectionnée dans le menu déroulant. (voir ci-dessus)

Migrer les applications vers DMSA

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

Applications du marché

  • Contactez les développeurs de vos applications de service compte basées sur le marché des données pour comprendre quand elles s’attendent à ce que les versions activées par DMSA soient disponibles pour leurs clients. Localisez la liste des applications sur marketplace.procore.com et utilisez le courriel de développeur ou les informations de support pour contacter le développeur.
  • Formulez un plan de communication interne en fonction des dates de sortie fournies par le développeur, afin que vos utilisateurs finaux soient informés de toute migration d’application en attente. Incluez les délais pour déplacer tous les utilisateurs sur de nouvelles applications et pour effacer les anciennes versions.
  • Une fois la version activée par DMSA de l’application disponible, suivez les étapes décrites dans Installer une application de connexion de données à partir du marché des données. Si vous n’êtes pas clair sur la façon d’installer la nouvelle version activée par DMSA d’une application particulière, contactez le développeur pour plus d’informations.
  • Après avoir installé avec succès la nouvelle application Marketplace, demandez à vos utilisateurs finaux de commencer à utiliser la nouvelle application au lieu de la plus ancienne version.
  • Une fois que tous les utilisateurs ont été déplacés vers l’utilisation de la nouvelle application, vous pouvez supprimer l’ancienne 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 entretenue en interne par votre compagnie, vous devrez développer une nouvelle version activée par DMSA de l’application comme décrit dans l’annonce d’abandon du compte de service. Voir Comptes de service 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 compagnie, contactez-les pour comprendre lorsqu’une nouvelle version activée par DMSA de l’application sera disponible et assurez-vous qu’elle remplira les informations de l’application personnalisées sur l’utilisateur du compte de service interface.
  • Une fois la version activée par DMSA de l’application personnalisée est disponible, suivez les étapes décrites dans Installer une application personnalisée. Si vous n’êtes pas clair sur la façon d’installer la nouvelle version activée par DMSA d’une application particulière, contactez le développeur pour plus d’informations.
  • 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 la plus ancienne version.
  • Une fois que tous les utilisateurs ont été déplacés vers l’utilisation de la nouvelle application, vous pouvez supprimer l’ancienne compte de service comme décrit dans Supprimer un compte de service et désinstaller l’ancienne version de l’application.