La obtención de aplicaciones de conexión de datos para usar cuentas de servicio administradas por programadores
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 administrada para programadores.
Fondo
Con la desactualización de los cuentas de servicio tradicional y la versión de cuentas de servicio administradas para programadores (DMSA),los clientes que utilizan actualmente aplicaciones de conexión de datos que dependen de los cuentas de servicio tradicionales deben planificar cambiarse a usar aplicaciones que utilizan DMSAs antes de la fecha de puesta de sol. Los desarrolladores e integradores de terceros actualizarán sus aplicaciones para usar DMSAs y harán que nuevas versiones estén disponibles para 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 programadores de Procore
El Portal para programadores de Procore es un recurso completo diseñado para que los desarrolladores mejoren su comprensión y uso de las APIs de Procore y otras herramientas de desarrollo. La portal proporciona documentación, guías y recursos en profundidad para fomentar a los desarrolladores para crear aplicaciones que se integren con la plataforma de Procore. Facilita la interacción sin problemas con el software de administración de la construcción de Procore, lo que permite a los desarrolladores crear soluciones personalizadas que extiendan 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:
- Regístrese: cree un cuenta en el portal para programadores de Procore.
- Registro: registre y cree una nueva aplicación dentro de la portal.
- Crear: utilice la documentación de apIs y API de Procore para desarrollar e integrar su aplicación con la plataforma de Procore.
Consulte Crear aplicaciones de conexión de datos de Procore con DMSA para obtener más información.
Aspectos a tener en cuenta
- Permisos de usuario requeridos:
- Administrador de la compañía
Preparación de la migración
Entender sus cuentas de servicio tradicional existentes pueden ayudarlo a planificar de manera efectiva para una migración exitosa de aplicaciones. Antes de vencer a una aplicación DMSA, deberá revisar la configuración de cada uno de sus servicios existentes cuentas para verificar que la información sea precisa y actualizar cualquier servicio cuentas donde la configuración pueda faltar o ser incorrecta.
Los cuentas de servicio se clasifican en dos tipos de aplicaciones: "Marketplace" y "Personalizado".
- Marketplace : para cuentas de servicio que se asignan a las aplicaciones instaladas desde o aparecen en Procore App Marketplace. Las aplicaciones se pueden seleccionar de una lista desplegable.
- Personalizado : para aplicaciones personalizadas que fueron desarrolladas internamente o por integradores de terceros específicamente para su compañía.
Tenga en cuenta que es posible que algunos cuentas de servicio de su compañía no tengan un tipo de aplicación definido. Deberá actualizar este servicio cuentas con el tipo de aplicación correcto antes de administrarlo a las DMSAs. También es una buena oportunidad de revisar y verificar la configuración de tipo de aplicación existente para asegurarse de que sus cuentas de servicio se asignen correctamente.
Paso 1: establecer el tipo de aplicación para cuentas de servicio no definidas
Siga los siguientes pasos para actualizar su servicio existente cuentas donde no se define el tipo de aplicación.
- Navegue hasta la herramienta Administrador de la compañía.
- En "Configuración de la compañía", haga clic en Cuentas de servicio.La página Cuentas de servicio muestra una lista de los cuentas de servicio existentes en su compañía.
Al examinar su cuentas de servicio, es posible que vea una o más cuentas sin valor en la columna Nombre de la aplicación, como se muestra en el primer cuenta en el ejemplo anterior. Esto indica que el tipo de aplicación para esa cuenta de servicio no está definido. Deberá actualizar esos cuentas antes de abrirse a DMSA.
- Busque un servicio cuenta donde falta el valor de la columna Nombre de la aplicación y haga clic en Editar.
- Para la configuración Tipo de aplicación, elija una de las siguientes opciones:
- Marketplace : elija esta configuración si el servicio cuenta está asignado a una aplicación en Procore App Marketplace. Utilice el menú desplegable para seleccionar la aplicación. Verifique que la aplicación que seleccione coincida con la aplicación que tiene en producción.
- Personalizado : elija esta configuración si el servicio cuenta es utilizado por una aplicación que ha desarrollado internamente o por una aplicación creada por un integrador de terceros específicamente para su compañía. Ingrese una descripción para la cuenta, así como el nombre del desarrollador y la dirección de correo electrónico.
- Haga clic en Actualizar.
- Repita los pasos 3 a 5 anteriores para todos los servicios existentes cuentas en su compañía donde falta el valor de la columna Nombre de la aplicación.
Paso 2: revise y verifique las asignaciones de cuentas de servicio existentes
Ahora que ha configurado el tipo de aplicación para toda su cuentas de servicio existente, tome unos minutos para revisar cada cuenta y verificar que la asignación del tipo de aplicación sea correcta y que todos los campos obligatorios y se completen según sea necesario.
Revisar cuentas de servicio personalizadas
- Asegúrese de que todas las cuentas de servicio marcadas como "Personalizadas" son utilizadas en realidad por integraciones personalizadas en lugar de por aplicaciones de Marketplace. Si encuentra un servicio personalizado cuenta que se debe cambiar a una cuenta Marketplace, actualice la configuración Tipo de aplicación como se describe en la sección anterior.
- Verifique que se utilicen activamente todos los cuentas de servicio personalizados de su compañía. Elimine cualquier cuentas inactiva.
- Verifique que todos los cuentas de servicio personalizados de su compañía tengan los campos Descripción, Nombre de la compañía/Desarrollador y Correo electrónico de la compañía/Desarrollador que se completaron con precisión.(ver arriba)
Revisar cuentas de servicio de Marketplace
- Asegúrese de que todos los cuentas de servicio marcados como "Marketplace" son utilizados en realidad por aplicaciones del App Marketplace de Procore que actualmente está ejecutando en producción. Si encuentra un servicio "Marketplace" cuenta que debe cambiarse a "Personalizado", actualice la configuración del tipo de aplicación como se describe en la sección anterior.
- Verifique que todos los cuentas de servicio marketplace tengan la aplicación de Marketplace correcta seleccionada en el menú desplegable. (ver arriba)
Migrar aplicaciones a DMSA
Los pasos para exportar una aplicación de servicio tradicional cuenta a DMSA varían según el tipo de aplicación.
Aplicaciones de Marketplace
- Comuníquese con los desarrolladores de sus aplicaciones de Marketplace basadas en Marketplace cuenta existentes para comprender cuándo esperan que las versiones DMSA estén disponibles para sus clientes. Busque la lista de aplicaciones en marketplace.procore.com y use el correo electrónico para programadores o la información de soporte para contactar al desarrollador.
- Inicie un plan de comunicación interno en función de las fechas de lanzamiento proporcionadas por el desarrollador, para que sus usuarios finales se informen sobre las migración de aplicaciones pendientes. Incluya líneas de tiempo para mover a todos los usuarios a nuevas aplicaciones y para retirar las versiones anteriores.
- Una vez que esté disponible la versión habilitada de DMSA de la aplicación, siga los pasos descritos en Instalar una aplicación de conexión de datos desde Marketplace. Si usted está extensualmente acerca de cómo instalar la nueva versión DMSA habilitada de una aplicación en particular, comuníquese con el desarrollador para obtener información adicional.
- Después de instalar correctamente la nueva aplicación Marketplace, indique a sus usuarios finales que comiencen a usar la nueva aplicación en lugar de la versión anterior.
- Una vez que todos los usuarios se hayan movido correctamente al usar la nueva aplicación, puede eliminar el antiguo servicio cuenta como se describe en Eliminar una cuenta de servicio y desinstalar la versión anterior de la aplicación.
Aplicaciones personalizadas
- Si su compañía desarrolló y mantuvo una aplicación personalizada internamente, deberá desarrollar una nueva versión habilitada de DMSA de la aplicación como se describe en el anuncio de deprección de la cuenta de servicio. Consulte Cuentas de servicio administradas para programadores para obtener más detalles. Comuníquese con apisupport@procore.com si necesita orientación adicional.
- Si un desarrollador de terceros creó una aplicación personalizada específicamente para su compañía, comuníquese con ellos para comprender cuándo estará disponible una nueva versión de DMSA habilitada para la aplicación y asegúrese de que completen 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 de la aplicación personalizada esté disponible, siga los pasos descritos en Instalar una aplicación personalizada. Si usted está extensualmente acerca de cómo instalar la nueva versión DMSA habilitada de una aplicación en particular, comuníquese con el desarrollador para obtener información adicional.
- Después de instalar correctamente la nueva aplicación personalizada, indique a sus usuarios finales que comiencen a usar la nueva aplicación en lugar de la versión anterior.
- Una vez que todos los usuarios se hayan movido correctamente al usar la nueva aplicación, puede eliminar el antiguo servicio cuenta como se describe en Eliminar una cuenta de servicio y desinstalar la versión anterior de la aplicación.