Procore – Calidad Cloud

For the moment we can only show this documentation in spanish.

Para integrar las aplicaciones de Calidad Cloud con Procore, debes tener en Procore permisos de nivel "Administrador" en la herramienta Directorio a nivel compañía.

Video explicativo de la integración

Instalar/autorizar app en Procore
- Navegue hasta Procore Marketplace.
- Haga clic en Iniciar sesión. Ingrese sus credenciales de Procore y haga clic en Iniciar sesión nuevamente.
  Si es administrador de la compañía en más de una compañía, se le pedirá que seleccione la compañía en la que desea instalar la aplicación.
- Navegue y haga clic en el mosaico de la aplicación de Calidad Cloud que desea instalar.
- Haga clic en Instalar aplicación.
- Haga clic en Instalar para confirmar su selección. Está guiado a través de los pasos de instalación restantes.
Importar contenido desde Procore a Calidad Cloud (documentos, imágenes y planos)
Ingrese al módulo cBOX, seleccione el proyecto que desea sincronizar. Elija si desea importar documentos (Documentos), imágenes (photos) o planos (drawings) desde Procore, e ingrese a la carpeta correspondiente. Una vez dentro de la carpeta, haga clic con el botón derecho para desplegar el menú de opciones. También puede desplegar las alternativas al hacer clic sobre los tres puntos del menú . Luego vaya a "Importar desde..." y seleccione Procore.

Sino está previamente autenticado en Procore, se desplegará una ventana para para iniciar Sesión.

Luego de iniciada la sesión seleccione el proyecto y las carpetas/archivos en Procore que desea sincronizar. Finalmente haga clic en Importar para comenzar la sincronización de los datos. Los archivos comenzarán a descargarse inmediatamente y, dependiendo del tamaño total de datos a sincronizar, este proceso puede demorar varios minutos.

Finalizada la sincronización verá los archivos de Procore en Calidad Cloud. Todo archivo subido en Procore a la carpeta sincronizada en Calidad Cloud será agregado automáticamente. Los archivos ya cargados también serán actualizados de manera instantánea.
Exportar contenido desde Calidad Cloud hacia Procore (documentos, imágenes y planos)
Ingrese al módulo cBOX, seleccione el proyecto que desea sincronizar. Elija la carpeta donde se encuentre el contenido que desea exportar: documentos (Documentos) o imágenes (photos). Una vez dentro de la carpeta, haga clic con el botón derecho para desplegar el menú de opciones. También puede desplegar las alternativas al hacer clic sobre los tres puntos del menú . Luego vaya a "Importar desde..." y seleccione Procore. Seleccione las carpetas/archivos de Calidad Cloud que desea importar y luego el destino al que desee enviarlos en su sesión de Procore. Finalmente haga clic en Continuar para comenzar la sincronización de los datos. Los archivos comenzarán a copiarse inmediatamente y, dependiendo del tamaño total de datos a sincronizar, este proceso puede demorar varios minutos.
Problemas comunes
1) No tengo cuenta en Procore
Si no tiene una cuenta de Procore o su empresa aún no contrata el servicio por favor escribir a contacto@calidadcloud.com o solicite coordinar una llamada con un especialista.

2) Faltan carpetas o archivos
En algunos casos poco probables puede ocurrir que los datos en Calidad Cloud y Procore no sean los mismos. Este problema de sincronización puede ocurrir por problemas de conexión, autenticación u otros. Para actualizar el contenido y re sincronizar los datos, ingrese a la carpeta en Calidad Cloud, luego en el menú seleccione Procore y luego Actualizar. Se refrescará todo el contenido de la carpeta para que queden iguales.

Luego de la sincronización puede verificar el estado de los datos ingresando a Procore o desde Calidad Cloud comprobando el ícono de estado.

3) Webhook del proyecto mal configurado
Al intentar sincronizar los archivos aparece un mensaje de error de configuración del proyecto en Procore. Se debe verificar que el usuario en Procore tenga permisos de Administrador. Luego revisar que el webhook esté bien configurado ingresando al proyecto desde el menú de proyectos, luego desde el menú de acciones ir a Admin y luego a la izquierda Webhooks

Verifique que el endpoint sea https://app.calidadcloud.com/api/v2/public/api/cbox/procore/webhook . Si es uno diferente reemplázalo y haz clic en Save Endpoint.

4) Sin permisos de Administrador
Para utilizar la integración con Procore usted debe contar con una cuenta de Administrador. Para verificar sus permisos seleccione Admin del menú de acciones del proyecto (Project tools). Sino tiene esa opción comuníquese con el administrador de Procore de su empresa para activar el enlace.
Consideraciones

Importar contenido:

- Todos los archivos importados en un proyecto Cbox se incluirán dentro de la carpeta Procore. Ésta se creará al interior de cada carpeta categorizada (Imágenes, Documentos, Planos) que tenga alguna integración en curso.
- No se podrán realizar importaciones si el proyecto de Procore ya tiene su webhook configurado por una aplicación externa a Calidadcloud.
- El proceso de importación podrá realizarse si la url corresponde a app.calidadcloud.com
- Si algún elemento importado quedó pendiente de eliminación por no contar con credenciales activas, se debe forzar su eliminación presionando sobre dicho ítem: Procore y luego Actualizar.
- Herramientas habilitadas para la integración: Documents, Photos, Drawings.

Drawings:

- Se importarán los planos en su última versión y solo los que estén publicados. Mismo comportamiento tendrá la sincronización automática.
- En Cbox se generará la estructura <Área> » <Disciplina> » <nro Plano> <nombre plano>
- Los proyectos de Procore que no tengan activa la opción "múltiples áreas" de todas formas cuentan con un área creada por defecto.

Photos:

- En Cbox se generará la estructura <Álbum> » <nombre imagen>
- Si una imagen cambia de álbum, en Cbox se seguirá mostrando solo si ese álbum también fue previamente sincronizado.
- Si una imagen sincronizada entre plataformas es enviada a la papelera de Procore porque se elimina el álbum que la contiene, y luego es recuperada, el elemento se seguirá viendo en cBox solo si el álbum Unclassified también está sincronizado.

Documents:

- En Cbox se generará la misma estructura que se visualiza en Procore.
- Si un elemento sincronizado entre plataforma se mueve a otra carpeta en Procore, se seguirá viendo en Cbox solo se la carpeta destino se encuentra sincronizada.
- Archivos recuperados desde la papelera de Procore serán visualizados en Cbox si la carpeta destino está sincronizada. Si se mueven a la carpeta raíz del proyecto de Procore, deben ser nuevamente sincronizadas por el proceso de Importar.

Exportar contenido:

- Todos los archivos exportados se reúnen en la carpeta/álbum CalidadCloud que se creará en el proyecto Procore respectivo donde se realice la integración.
- Si algún elemento exportado quedó pendiente de eliminación por no contar con credenciales activas, se debe forzar su eliminación desde Procore.
- Las modificaciones que se realicen en el contenido de la carpeta/álbum CalidadCloud, serán omitidas. La sincronización es unidireccional, solo los cambios desde Cbox se considerarán válidos.
- Herramientas habilitadas para la integración: Documents, Photos.

Documents

- Se sincroniza la misma estructura que se visualiza en Cbox.

Photos:

- Aunque se sincronicen carpetas con varios niveles, los archivos de extensión (.png, .jpg, .jpeg, .gif, .bmp) serán sincronizados al mismo nivel como subelementos del álbum CalidadCloud.
- Las imágenes sincronizadas tendrán en su descripción la ubicación del elemento en Cbox para identificarlos en caso de existir nombres repetidos.
- La edición de nombre o nueva versión del archivo generado desde Cbox eliminará y creará un nuevo archivo en Procore, por lo que comentarios y/o otros datos agregados desde las funcionalidades de Procore podrían perderse.

Consideraciones generales:

- Se podrá realizar una integración si se cuentan con los siguientes privilegios:
  - Permiso del perfil activo en Cbox > Integraciones > Procore
  - Permiso de edición en cbox en la carpeta categorizada sobre la que se hará la integración. (Documentos, Imágenes o Planos)
  - Permiso de administrador en sección Admin y administrador en la herramienta de Procore (Documents, Photos, Drawings)
- Una vez iniciada la sesión en procore y tras haber realizado alguna integración (importar/exportar) las credenciales del usuario son consideradas válidas para utilizarse en la sincronización automática de los elementos con el proyecto de Procore seleccionado.
- Para mantener los elementos sincronizados luego de una integración se revisa entre las credenciales válidas asociadas a Procore para implementar la actualización. Si el usuario original que hizo la integración ya no cuenta con los privilegios, se utilizarán las de otro usuario que haya completado una integración en el mismo proyecto.
- Los flujos de datos que transitan entre ambas plataformas por cada módulo se visualizan en la siguiente tabla:
  
  Procore
  
  Export Data
  
  Import Data
  
  Calidad Cloud
  
  Documents
  
  >>>
  
  <<<
  
  cBox/Documentos
  
  Photos
  
  >>>
  
  <<<
  
  cBox/Imágenes
  
  Drawings
  
  >>>
  
  cBox/Planos

Procore	Export Data	Import Data	Calidad Cloud
Documents	>>>	<<<	cBox/Documentos
Photos	>>>	<<<	cBox/Imágenes
Drawings	>>>		cBox/Planos

Artículos relacionados