Migración de aplicaciones de conexión de datos para utilizar cuentas de servicio gestionadas por el desarrollador
Objetivo
Para migrar una aplicación de conexión de datos existente que utiliza una cuenta de servicio tradicional a una nueva versión que utiliza una cuenta de servicio gestionada por el desarrollador.
Contexto
Con la desaprobación de las cuentas de servicio tradicionales y el lanzamiento de las Cuentas de Servicio Administrado para Desarrolladores (DMSA), los clientes que actualmente utilizan aplicaciones de conexión de datos que dependen de las cuentas de servicio tradicionales deben planificar cambiar al uso de aplicaciones que utilizan DMSA antes de la fecha de vencimiento. Los desarrolladores e integradores de terceros actualizarán sus aplicaciones para usar DMSA y poner nuevas versiones a disposición de los clientes de Procore a lo largo del tiempo. Este tutorial proporciona algunas sugerencias para preparar un plan de migración y describe los procedimientos para trabajar a través de una migración.
Acerca del portal para desarrolladores de Procore
El Portal para desarrolladores de Procore es un recurso integral diseñado para que los desarrolladores mejoren su comprensión y uso de las API de Procore y otras herramientas de desarrollo. El portal proporciona documentación, guías y recursos detallados para animar a los desarrolladores a crear aplicaciones que se integren con la plataforma de Procore. Facilita la interacción fluida con el software de gestión de la construcción de Procore, lo que permite a los desarrolladores crear soluciones personalizadas que amplían las funcionalidades de Procore.
Registrarse, registrarse y crear una aplicación en el portal
Los clientes de Procore interesados en crear sus propias aplicaciones que se integren con la plataforma Procore pueden seguir estos pasos para comenzar su viaje de desarrollo:
- Registrarse: cree una cuenta en el portal para programadores de Procore.
- Registrarse: Registrarse y crear una nueva aplicación dentro del portal.
- Compilación: utilice las API y la documentación de API de Procore para desarrollar e integrar su aplicación con la plataforma de Procore.
Consulte Creación de aplicaciones de conexión de datos de Procore con DMSA para obtener más información.
Temas a considerar
- Permisos de usuario necesarios:
- Administrador de la empresa
Preparación de la migración
Conocer las cuentas de servicio tradicionales existentes puede ayudarle a planificar eficazmente la migración de la aplicación. Antes de migrar a una aplicación DMSA, tendrá que revisar los ajustes de cada una de sus cuentas de servicio existentes para verificar que la información es correcta, y actualizar cualquier cuenta de servicio en la que los ajustes pueda faltar o ser incorrecta.
Las cuentas de servicio se clasifican en dos tipos de aplicaciones: `Marketplace` y `Custom`.
- Marketplace - para las cuentas de servicio que se asignan a las aplicaciones instaladas o listadas en el Procore App Marketplace. Las aplicaciones se pueden seleccionar de una lista desplegable.
- Personalizado - para aplicaciones personalizadas desarrolladas internamente o por terceros integradores específicamente para su empresa.
Tenga en cuenta que algunas cuentas de servicio de su empresa pueden no tener un tipo de aplicación definido. Deberá actualizar estas cuentas de servicio con el tipo de aplicación correcto antes de migrar a los DMSA. También es una buena oportunidad para revisar y verificar los ajustes del tipo de aplicación existente para asegurarse de que sus cuentas de servicio están mapeadas correctamente.
Paso 1 - Establecer el tipo de aplicación para las cuentas de servicio no definidas
Siga los siguientes pasos para actualizar las cuentas de servicio existentes en las que el tipo de aplicación no está definido.
- Vaya a la herramienta Administrador de la empresa.
- En "Configuración de la empresa", haga clic en Cuentas de servicio . La página de cuentas de servicio muestra una lista de las cuentas de servicio existentes en su empresa.
Al examinar sus cuentas de servicio puede ver una o más cuentas sin valor en la columna Nombre de la aplicación, como se muestra en la primera cuenta del ejemplo anterior. Esto indica que el tipo de aplicación para esa cuenta de servicio no está definido. Deberá actualizar esas cuentas antes de migrar a DMSA.
- Localice una cuenta de servicio en la que falte el valor de la columna Nombre de la aplicación y haga clic en Editar.
- Para la ajustes del tipo de aplicación, elija una de las siguientes opciones:
- Marketplace - elija este ajuste si la cuenta de servicio está asignada a una aplicación en el Procore App Marketplace. Utilice el menú desplegable para seleccionar la aplicación. Compruebe que la aplicación que selecciona coincide con la aplicación que tiene en producción.
- Personalizado - elija esta opción si la cuenta de servicio es utilizada por una aplicación que ha desarrollado internamente, o por una aplicación construida por un integrador externo específicamente para su empresa. Introduzca una descripción de la cuenta, así como el nombre y la dirección de correo electrónico del desarrollador.
- Haga clic en Actualizar.
- Repita los pasos 3-5 anteriores para todas las cuentas de servicio existentes en su empresa en las que falte el valor de la columna Nombre de la aplicación.
Paso 2 - Revisar y verificar las asignaciones de cuentas de servicio existentes
Ahora que ha establecido el tipo de aplicación para todas sus cuentas de servicio existentes, tómese unos minutos para revisar cada cuenta y verificar que la asignación del tipo de aplicación es correcta, y que todos los campos requeridos y están rellenados como es necesario.
Revisar las cuentas de servicio personalizadas
- Asegúrese de que todas las cuentas de servicio marcadas como `Personalizadas` son realmente utilizadas por las integraciones personalizadas y no por las aplicaciones de Marketplace. Si encuentra una cuenta de servicio personalizada que debería cambiarse a una cuenta de Marketplace, actualice la ajustes del tipo de aplicación como se describe en la sección anterior.
- Compruebe que todas las cuentas de servicios personalizados de su empresa se utilizan activamente. Elimine las cuentas inactivas.
- Compruebe que todas las Cuentas de servicios personalizados de su empresa tienen los campos Descripción, Nombre de la empresa/desarrollador y Correo electrónico de la empresa/desarrollador rellenados con precisión. (ver arriba)
Revisar las cuentas de servicios del Marketplace
- Asegúrese de que todas las cuentas de servicio marcadas como 'Marketplace' son utilizadas realmente por las aplicaciones de Procore App Marketplace que tiene actualmente en producción. Si encuentra una cuenta de servicio de "Marketplace" que debería cambiarse a "Personalizada", actualice la ajustes del tipo de aplicación como se describe en la sección anterior.
- Compruebe que todas las cuentas de servicio de Marketplace tienen la aplicación correcta de Marketplace seleccionada en el menú desplegable. (ver arriba)
Migración de aplicaciones a DMSA
Los pasos para migrar una aplicación de la cuenta de servicio tradicional a la DMSA varían en función del tipo de aplicación.
Aplicaciones del Marketplace
- Póngase en contacto con los desarrolladores de sus aplicaciones de Marketplace basadas en cuentas de servicio existentes para saber cuándo esperan tener versiones habilitadas para DMSA disponibles para sus clientes. Localice la lista de aplicaciones en marketplace.procore.com y utilice el correo electrónico del desarrollador o la información de soporte para ponerse en contacto con él.
- Formule un plan de comunicación interna basado en las fechas de lanzamiento proporcionadas por el desarrollador, para que sus usuarios finales estén informados de cualquier migración de aplicaciones pendiente. Incluya plazos para pasar a todos los usuarios a las nuevas aplicaciones y para retirar las versiones antiguas.
- Una vez que la versión habilitada para DMSA de la aplicación esté disponible, siga los pasos descritos en Instalar una aplicación de conexión de datos desde el Marketplace. Si no tiene claro cómo instalar la nueva versión habilitada para DMSA de una aplicación concreta, póngase en contacto con el desarrollador para obtener información adicional.
- Después de instalar con éxito la nueva aplicación de Marketplace, indique a sus usuarios finales que empiecen a utilizar la nueva aplicación en lugar de la versión anterior.
- Una vez que todos los usuarios hayan pasado a utilizar la nueva aplicación, puede eliminar la antigua cuenta de servicio como se describe en Eliminar una cuenta de servicio y desinstalar la versión antigua de la aplicación.
Aplicaciones personalizadas
- Si una aplicación personalizada fue desarrollada y mantenida internamente por su empresa, tendrá que desarrollar una nueva versión de la aplicación habilitada para DMSA, tal como se describe en el anuncio de Obsolescencia de cuentas de servicios. Consulte Cuentas de servicios gestionadas por desarrolladores para obtener más detalles. Póngase en contacto con apisupport@procore.com si necesita orientación adicional.
- Si una aplicación personalizada fue creada por un desarrollador externo específicamente para su empresa, póngase en contacto con él para saber cuándo estará disponible una nueva versión de la aplicación habilitada para DMSA, y asegúrese de que rellena la información de la aplicación personalizada en la interfaz de usuario de la Cuenta de Servicio.
- Una vez que la versión habilitada para DMSA de la aplicación esté disponible, siga los pasos descritos en Instalar una aplicación personalizada. Si no tiene claro cómo instalar la nueva versión habilitada para DMSA de una aplicación concreta, póngase en contacto con el desarrollador para obtener información adicional.
- Después de instalar con éxito la nueva aplicación personalizada, indique a sus usuarios finales que empiecen a utilizar la nueva aplicación en lugar de la versión anterior.
- Una vez que todos los usuarios hayan pasado a utilizar la nueva aplicación, puede eliminar la antigua cuenta de servicio como se describe en Eliminar una cuenta de servicio y desinstalar la versión antigua de la aplicación.