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

À 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 plate-forme 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 de Procore intéressés par la création de leurs propres applications qui s'intègrent à la plate-forme Procore peuvent suivre ces étapes pour commencer leur parcours de développement :

• Inscription: Créez un compte sur le portail des développeurs Procore.
• Enregistrer: Enregistrez et créez 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 plate-forme de Procore.

Voir Création d'applications de connexion de données Procore avec DMSA pour plus d'informations.

É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.

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.

3. Localisez un service compte 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 :

• 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.

• 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.

5. Cliquez sur Mettre à jour.
6. 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)

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.