Technical Details - Regular Sync
Can I rename file names when they are in my Dropbox account or Procore?
Yes, you can rename the file within your Dropbox account. When you rename it, it will update in Procore in the next 5 minutes.
How often does the sync run?
The sync runs every five minutes searching for latest updates and is triggered to make a full update when any changes are made within any of the connected parent folders in Procore or DropBox respectively syncing to mirror.
What if I already have a Dropbox folder for the project?
In order to maintain the integrity of the sync, we have to start the integration from scratch in a new top level folder in Dropbox. Once the initial sync is complete and the data structure is created in Dropbox, you can move your existing data from the existing folders into the syncezy.procore.com folders created by SyncEzy.
What if I want only certain folders or files synced from Dropbox or Procore?
This sort of custom integration is currently not possible in the standard product. We may be able to do some limited customisations to meet your requirements. This will be at an additional cost as it deviates from our standard integration product.
Can I see who modified or added the files in Procore or Dropbox?
When you authenticate/connect your Procore and Dropbox accounts, this will determine what name/details are shown in files/folders in each application.
So for example, if you authenticate Procore and Dropbox with your own account it will work as follows:
1) whoever adds a file/folder to Procore, it will show their username/details on that file or folder in Procore, however when it is synced to Dropbox, it will show with the details/username of whoever authenticated Dropbox (in this example, your account) in the SyncEzy portal.
2) It works the same in the other direction, whoever adds a file/folder to Dropbox it will show in Dropbox with that user's name/details however when it is synced back to Procore it will show the user’s name/details of the account who authenticated Procore in the SyncEzy portal.
We recommend you setup a service email account with a generic name if you wish to avoid using your name when the integration makes changes. You could setup an email called procore@yourcompany.com or another alias and use this account to connect Procore and Dropbox to easily identify what changes our integration has made.
Why use a service account to connect the integration?
Service accounts are usually created specifically for a particular service or application and are granted only the permissions necessary for that service to function properly. They are often used to access other resources such as databases, APIs, file systems, or other services that the application or service needs to interact with. Basically, we use a service account to differentiate the user activity.
We highly recommend you setup a service email account with a generic name if you wish to avoid using your name on folders/files when the integration syncs folder/file changes to the opposite application. You could setup an account in Procore with an email called
procore@yourcompany.com for example and use this account to connect Procore and Dropbox to easily identify what synced changes our integration has made. Please ensure any new service accounts you setup have full admin permissions on the Documents and Photos tools for all projects you want to sync in Procore.
There are several reasons why you might want to use service accounts in your computing environment:
Security: By using service accounts, you can limit the permissions granted to individual applications or services, which helps to reduce the risk of security breaches. Because service accounts are typically used for automated processes, they do not require interactive login sessions or access to sensitive information that humans would normally need, such as passwords or other confidential data.
Accountability: When you use service accounts, you can track the actions of individual services or applications, making it easier to identify which system or service is responsible for particular actions or changes within your environment.
Centralization: By using service accounts, you can centralize the management of access and permissions across multiple applications or services, making it easier to ensure that each application has the appropriate level of access and reducing the complexity of managing permissions across your computing environment.
Are there any limits to how much data can be synced?
There are no technical limits to the amount of data that can be synced. We have synced individual projects with over 50,000 files each and over 50 GB of data per project. Our standard plan comes with some fair use limits detailed in your proposal which can be extended upon request and special pricing.
The only hard limit we have is for individual files to be less than 955 MB. Typically this would be data like large laser scans (point cloud) of buildings, large drone video captures and special purpose files. We do not have any file type restrictions. We can sync and support all file types and data types.
We do not stop syncing the files just because the limit has been reached, this will only ever be done after consultation with you. You do not have to worry about the sync stopping once the limits are reached.
What if I need to change the Dropbox Account?
We currently do not support that for a live sync. You will need to reset or delete the configuration and start from scratch again.
How quickly does the data sync? What is your sync speed?
We sync data every 30 minutes after edits or changes in Dropbox. The time to move the files can depend on the size of the file and number of files edited. In 98% of cases, this happens within a few minutes.
We do not throttle data transfer speeds from our end, we are only limited by Dropbox or Procore limits. In most cases this is done every 5 minutes for hundreds of files at once. Initially, once the projects are connected, the first download can take from 4 to 48 hours depending on the amount of data in Procore. Once the initial sync is complete every future sync happens automatically, every five minutes, whenever a file change is detected in either system.
Can I rename my files in Dropbox?
Yes, you can rename the files or folders within Documents or Photos folders that are automatically populated from the sync. Any renaming of the parent folders connected in the Configuration section of our integration portal will break your sync.
Service account - Introduction and benefits
Service accounts are usually created specifically for a particular service or application and are granted only the permissions necessary for that service to function properly. They are often used to access other resources such as databases, APIs, file systems, or other services that the application or service needs to interact with. Basically, we use a service account to differentiate the user activity in a particular application.
Why use a service account to connect the integration applications?
We highly recommend you setup a service email account with a generic name if you wish to avoid using your name on folders/files when the integration syncs folder/file changes to the opposite application. You could setup an account in Procore with an email called
procore@yourcompany.com for example and use this account to connect Procore and Dropbox in your integration. This will ensure you can easily identify what synced changes our integration has made. Please ensure any new service accounts you setup have full admin permissions on the Document and Photos tools for all projects you want to sync in Procore and also full read/write permissions on the applicable Dropbox account.
There are several reasons why you might want to use service accounts in your computing environment:
Security: By using service accounts, you can limit the permissions granted to individual applications or services, which helps to reduce the risk of security breaches. Because service accounts are typically used for automated processes, they do not require interactive login sessions or access to sensitive information that humans would normally need, such as passwords or other confidential data.
Accountability: When you use service accounts, you can track the actions of individual services or applications, making it easier to identify which system or service is responsible for particular actions or changes within your environment.
Centralization: By using service accounts, you can centralize the management of access and permissions across multiple applications or services, making it easier to ensure that each application has the appropriate level of access and reducing the complexity of managing permissions across your computing environment.
Version control and updates:
Both Dropbox and Procore platforms offer full version history available in the file history, ensuring comprehensive tracking and management of file revisions.
Adding a new project in Dropbox:
The initial sync time for a new project to Procore can vary from 10 minutes to a few hours, depending on the data volume.
Adding a new project in Procore:
When adding a new project in Procore, syncing to Dropbox typically takes 10-30 minutes for initial connection. Subsequent syncs for new projects in Procore usually complete within 1-2 minutes.
Best practices around the integration
Do not have any trailing spaces at the end of folders or project names
Dropbox (Windows) does not handle Document library names well with spaces at the end of the name. Procore allows trailing spaces at the end of Album names in their Photos tool. We also have a setting to turn on automatic rename of certain special characters.
Make sure your team does not change the first three levels of folders in the Dropbox Folders.
Level 1: The parent folder in Procore and SharePoint/Teams/OneDrive
Level 2: The project folder
Level 3: The name of the tool, for example, Documents, Photos etc.
This will break the sync as the storage of these exact folder names is an integral part of how we create and maintain your integration for each project.
Note: if you need to delete a large number of files
If you need to delete a large number of files from both systems, do it manually from both systems. This is because as a safety mechanism, SyncEzy has a delete limit for the maximum number of files that can be deleted through the sync in any 24-hour period.
Once the limit is hit, the sync will not delete any more files and the sync will email the administrator with the path of the files not deleted. The Sync deletes limit will reset after 24 hours. (Please note that the 24-hour deletion limit reset is based on the file deletion time, which means the 24-hour starts from the time you have deleted the file).
Can I buy additional space? I’m getting an out of space error?
Yes this will be based on your Dropbox account. Please contact your organization's Dropbox account admin for details. We do not have space restrictions for the integration.
Some of my folders look different or have not been synced?
This can occasionally happen when the delete limit has been reached, due to somebody manually deleting a large number of files or a top level folder from one of the systems, and the corresponding data isn’t deleted from the second system. In these cases, reach out to support and we will assist you.
How does your pricing work?
Please contact us for pricing. Pricing is based on theAnnual Construction Volume.
Does SyncEzy keep a copy of my data stored?
Your data is only stored on your Procore account and in your Dropbox account. SyncEzy is only the conduit and does not store any of your organisation's project data files. We only store relevant metadata (file names, folder names and folder paths, sync time, modified time etc) as required for us to manage the integration and syncing the files.
Your files are transferred through our servers for only as long as it takes to pass them from one system to the other. Once the transfer is complete the actual files are automatically deleted. We only store the metadata and the file paths.
This is why if you have any technical issues our support team may ask you to add support@syncezy.com to the project documents folder so we can review the data. We do not have access to any of your tools or login to your Procore.
Where is SyncEzy hosted?
Our application and the metadata that we store is hosted securely with Amazon Web Services (AWS). This is the same back end infrastructure system that Procore uses.
Do the files transferred into cloud storage count towards my cloud storage account storage limits?
Yes, all files & folders synced across will count towards your file storage limits.
How long does it take to transfer my files across?
The integration syncs every 30 minutes as long as the Dropbox file or folder has been edited and saved.
What triggers the files being transferred?
Any changes made to the files or folders will trigger a sync. For example, renaming the file, opening the Word document and saving it, revising it in Procore, editing a document in Dropbox, deleting the document in either system. All of these changes will trigger the sync, and the older file in either system will be replaced with the current / latest version of the file.
Where do I go to check the settings and billing details on my cloud storage integration?
You can view your settings configurations and any billing details by going to the SyncEzy Portal here. In the Portal, navigate to Plan Details to see billing details. Contact support to make changes or cancel your service.
Is there a limit on how many files can be synced in an hour?
There are no limits from our side. On the Procore end, there is a hard limit of 3600 API calls per hour. On average, every single file takes about 4 API calls. Based on this, and depending on the speed of the data connection, we have a hard limit of 900 files that can be synced in one hour.
Most of the time we are only running an incremental sync of what has been changed in the last five minutes, which is far fewer files than 900. So on a day-to-day basis you should see all of your interactions sync automatically every five minutes.
Currently we can sync Procore Project Documents, Photos & Daily Log / Site Diary. We also plan to add additional modules to the sync like Drawings, Models, RFI and more. If you have any specific requirements regarding data extraction or having to sync specific tools from Procore, please reach out to our support team and we will do our best to help.
Other questions
Have a support question?
We offer three support channels:
Phone - # 1 for Support
AUS: +61 2 9136 9448
NZ: +64 9 303 2999
UK: +44 203 670 1109
US: +1 720 500 9302
Have you done this before and what about security of data?
Yes we have, we have been building integrations for the last eight years with over 50 integrations built across various systems. All our communication between systems is fully-encrypted. We do not store your actual data and files on our servers, we only store the IDs / names / and meta data of the records and some minimum information for logging and troubleshooting.
This integration is also certified and validated by Procore and Dropbox and officially listed on both of their marketplaces.
and
How secure is the sync?
Short answer: Very secure.
The longer answer, The API keys are encrypted at rest and all our communication with Procore and SharePoint is through 256 Bit SSL connections.
To know more about our SSL certification details see this link.
In addition to this, we store the minimum amount of data in our servers relying on the metadata of the files to manage the integration. Your data files are on SyncEzy servers only once during transfer and are automatically erased permanently from our servers once the data is moved to the second application. For servers and back end infrastructure we use the same secure AWS infrastructure that is used by all the world’s leading organizations including Procore.
We also offer two-factor authentication for the admin users using the SyncEzy integration
What if I need to use a different cloud storage system other than Dropbox?
Reach out to us at
support@syncezy.com. We are always looking to build more integrations. Chances are that we already have something in our plans.
What if I use a different project management system?
We have worked with a variety of job and project management systems in the past, including Aconnex, simPRO, ServiceM8, Aroflo and more. If you would like the data to go into a different job management system reach out to us and we’ll do the best to help.
What if I use a different cloud storage system?
We have worked with a variety of cloud storage systems in building integrations including Sharepoint, OneDrive, Google Drive, Dropbox, Dropbox Business and more. If you would like a different system integrated with Procore, reach out to us and we’ll do the best to help.