To import incremental data 

1. Choose the Cloud storage category from the left pane and click Box. You can also search Box in the search box.

Note: If you had already added a Box connection earlier, click the Saved connections category from the left pane and proceed to import. To learn more about Saved connections, click here.

2. If you have already added a connection, click the existing connection and start importing data.

Note: Click the Add new link to add a new Box account. You can create as many Box connections as required.

3. Authenticate your Box account. You will need to authorize DataPrep to access your files when you do this for the first time.

Note: The connection configuration will be saved for importing data from Box in the future. Credentials are securely encrypted and stored.

4. To incrementally import your data, click the Advanced selection link.

Advanced selection helps you perform dynamic file selection based on regex. This can be used for getting new or incremental data from your Box account. The newly added or modified file that matches the file pattern after the previous sync will be taken from your Box account.

The details required are :

• Folder path : The folder path where you want to search for files. Eg. 2023/ 
  
  If the files are stored in the drive without any folder, you can leave this field empty.
  Info: Folder path is case-sensitive.
  Note: The recently created files in Box take upto 10 minutes to get reflected during import in DataPrep.

• Include subfolders : You can also select the Include subfolders checkbox if you want to include subfolders while searching for a file.
  

• File pattern : The pattern used to match the file names in the account. This supports regex type matching. You can also use the pattern, ".*" to match any file in the path specified.
  Info: File pattern is case-sensitive.

Note: The file pattern match is a simple regex type match. For example, to fetch files with file names such as Sales_2022.csv , Sales_2023.csv , Sales_2024.csv , you can input the pattern Sales_.* 

Similarly to fetch files such as PublicData1.csv , PublicData2.csv , PublicData3.csv , use Public.*

If you want to import a single file, then specify the pattern using the exact file name.
Eg: leads_jan_2022.*

• Parse file as : Choose the required extension to parse the file. If your file format is not a commonly used one, you can use this option to parse the file into one of the following formats before importing the data into a readable format. The available formats are CSV, TSV, JSON, XML, and TXT.
  

• Fetch new files based on modified time : You can fetch new files incrementally based on the modified time using this checkbox during each scheduled import or reload (reload data from source). DataPrep will fetch the file that matches the file pattern that was modified after the modified time of the previously imported file. 
  
  Note: When there are no new files in the source during incremental import:
  
  If the checkbox is unchecked: The last fetched files will be imported again.
  If the checkbox is checked: The reload or schedule will be skipped and no files will be imported.

• Merge files and import - This will merge all the files that match the pattern specified and import them as a single dataset.
  Info: This option can merge a maximum of only 5 files at a time.
  Note: If this checkbox is unchecked then, only 1 file will be fetched at a time.
  

  
  
  Eg. If your Box account has 10 files, the first 5 will be merged into one dataset and imported. During the next reload, the remaining 5 files will be merged and imported.
  
  
  
  Similarly, if your Box account has 8 files, the first 5 will be merged and fetched first, followed by the next 3.
  

Note: We support only CSV, TSV, JSON, XML, TXT file formats for incremental fetch from cloud storages.

5. Once you have completed importing data, your dataset will open and you can start preparing your data right away.

6. When your dataset is ready, export it to the required destination before next reload.

Note: You can choose to schedule the import using the Schedule import option available for datasets in your workspace or from the Import menu in the top bar of the DataPrep Studio page. Click here to know more.

Schedule your dataset based on your pipeline complexity. Give enough time to import, process data and export.

How incremental sync works         

7. When the dataset is scheduled for import, the imported time or the last scheduled time is recorded. Initially, only the oldest file will be fetched. During every successful sync, the last sync time is updated with the new value and the file created or modified after the sync time is imported. If there is no new or modified file in Box, no data will be imported. If no data were synced, the sync time will be updated since it was given a try. In the next cycle, the file created or modified after this sync time will be fetched.

Note: Please ensure that you schedule the export destination for your dataset; if not, data will be imported continuously, but you will lose data if you don't export it.

You can verify the number of records fetched from Box in the Operations history panel on the Sync Status page.

Click the Operations history icon near each sync status to view and track the changes made to the dataset, its previous states, the import and export schedules in a timeline. 

You can also verify the processed data for every sync in the Processing history panel. On clicking the Processing history option, the side pane will open up listing all the processed data IDs available for the dataset, along with the generated time.

 
You can also download and verify the processed data by clicking on the  icon that appears when you hover over a record.

 Manual reload 

8. To fetch the next file after the last sync time manually, you can use the Reload data from source option.

From the DataPrep studio page, select the Import menu in the top bar and click Reload data from source. Using this option, you can refresh your dataset with the latest file by reloading data from your data source.

During a manual reload, only the newly added or modified file after the last sync time is imported to the dataset.

Note: All the newly added or modified files are incrementally fetched based on Greenwich MeanTime (GMT) / UTC.

 Case1: If you want to skip files in the middle: 

  For instance, a folder in Box has 10 files in total. The user wants to skip files from 3 to 5. Below are the steps to skip those particular files during incremental fetch.





Follow the steps below to skip files from the middle during the incremental fetch.

1) Import the file using a generic file pattern. Eg leads.*

2) Initially, only the oldest file will be fetched. i.e. leads1_2024-01-29_13-02-04.csv

During every successful sync, the last sync time is updated with the new value, and the file created/modified after the sync time is imported.

3) After importing data, click the Export now option from the Export menu on the DataPrep Studio page and export it to the required destination before reloading, or you'll lose your data.



4) From the DataPrep studio page, select the Import menu in the top bar and click Reload data from source. 

5) The next file i.e. leads2_2024-01-29_13-10-20.csv will be fetched incrementally. Again, export it to the required destination before reloading, or you'll lose your data.

6) Click the   ruleset icon in the top-right corner of the DataPrep Studio page to view the Ruleset pane.




7) In the Ruleset pane, click the data source configuration icon  and open the Data source details page.

8) In the data source details page, enter the specific file pattern from where you want to import next in the File patternfield. Click Update. Eg leads6_2024-02-21_12-32-51.csv.*

9) Go to the DataPrep studio page, select the Import menu in the top bar and click Reload data from source.

The files leads3, leads4, leads5 will be skipped, and the file leads6 will be fetched. The modified time will be tracked.

Export this file to the required destination.




10) Now again, navigate to the data source details page and change the file pattern to generic form. Eg. leads.* 





11) Schedule the data import and export to set a pipeline.

12) To schedule the import,

a. Click the Schedule import link.

b. In the Schedule config section, select a Repeat method (Every 'N' hours, Every day, Weekly once, Monthly once). Choose a time to repeat (i.e. set a frequency) using the Perform every option.

Select the Time zone to export data. By default, your local timezone will be selected.

c. Select the checkbox if you want to Import new columns found in the source data. 

d. Click Save to schedule import for your dataset.

13) After scheduling the import, schedule the export destination for your dataset; if not, the import will be done continuously, but without export, the data will be lost.

14) After scheduling, the new files with the same pattern will be fetched incrementally using the last synced time.  Eg. leads7, leads8 etc., will be imported incrementally and exported at regular intervals.

 Case2: If you want to import the file from the middle: 

For instance, a folder in Box has 10 files in total. The user wants to import files from 6. Below are the steps to start importing from a particular file during incremental fetch.

Follow the steps below to import files from the middle during incremental fetch.

1. Import the file using a specific file pattern. 
Eg leads6_2024-02-21_12-32-51.csv.*

2. Initially, only the specific file will be fetched. i.e. leads6_2024-02-21_12-32-51.csv





During every successful sync, the last sync time is updated with the new value, and the file created/modified after the sync time is imported.

3. After importing the data, click the Export now option from the Export menu on the DataPrep Studio page and export it to the required destination before reloading, or you'll lose your data.



4. Click the  ruleset icon in the top-right corner of the DataPrep Studio page to view the Ruleset pane.

5. In the Ruleset pane, click the data source configuration icon  and open the Data source details page.

6. In the data source details page, enter the generic file pattern from where you want to import next incrementally in the File pattern field. Click Update. Eg leads.*





7. Schedule the data import and export to set a pipeline.

To schedule the import,

a) Click the Schedule import link.

b) In the Schedule config section, select a Repeat method (Every 'N' hours, Every day, Weekly once, Monthly once). Choose a time to repeat (i.e. set a frequency) using the Perform every option.

Select the Time zone to export data. By default, your local timezone will be selected.

c) Select the checkbox if you want to import new columns found in the source data. 

d) Click Save to schedule import for your dataset.

8. After scheduling the import, schedule the export destination for your dataset; if not, the import will be done continuously, but without export, the data will be lost.

9. After scheduling, the new files with the same pattern will be fetched incrementally using the last synced time.  Eg. leads7, leads8 etc., and all the news files will be imported incrementally and exported at regular intervals.

NOTE: If you modify the data, there is a chance of duplicate records in your destination. So, we don't recommend modifying data.

SEE ALSO

How to add a new dataset?

What other cloud storage options are available in Zoho DataPrep?  

How to import data from cloud databases?

How to import data from saved data connections?

How to schedule import? 
How to import data from Box?

How to export data to Box?