File Lists

Overview

A File List is assigned to a Project to define the files that should be included and excluded from a Project backup.

When you define a File List for a given Project type, you can exclude certain files from the compare. This is helpful when determining if a Project has changed, as it allows you to ignore binary file that may change every time.

Creating a New File List

You can create new File Lists by clicking the Add File List button. This will launch you into the editing sequence.

Alternatively, you can click on any of the Copy icons next to an existing File List. This will create an editable instance of the chosen File List.

Your new File List will appear in the Custom File Lists section.

Editing an Existing File List

Click on the name of a File List to edit its contents.

You cannot edit the default File Lists provided by Copia. You can only edit File Lists that appear in the Custom File Lists section.

This will launch you into the editing sequence. Label your new File List with the Name field and assign a project type with the Project Type dropdown.

Next, you will need to declare which files should be included in the backup and which should be excluded from the compare.

The format for entering this information is based on the .gitignore format. While a more comprehensive summary of syntax options can be found through the gitignore reference site, a simplified table of common patterns is provided below:

Pattern	Description
**	All files in current dir and subdir
*.*	All files in current dir and subdir
/*.*	All files in current dir
*.log	All *.log in current dir and subdir
/*.log	All *.log in current dir
test.*	All files named test with any extension in the current dir and subdir
/test.*	All files named test with any extension in the current dir
abc/*.*	All files in the abc dir
!abc/*.log	Exclude log files in the abc dir

Include in Backup

The Include in Backup section defines what is to be included (and excluded, by using the ! symbol) in the backup. Using the format above, you can add multiple lines to the filelist to define what you would like to be included in the backup.

A blank line will not affect the format of the File List. A line starting with a "#" symbol will be considered a comment and therefore not impact the File List. The lines process from top to bottom, so using a "!" symbol to exclude would typically occur after an include statement.

Exclude from Compare

After the backup operation has completed, Copia will determine if a change has been made by comparing the data from the device versus the existing data within Copia. Using the Exclude from Compare list, you can choose to "ignore" certain files/folders during the comparison. This lets you focus on changes that are important, versus changes that may be unimportant (like the current value of a timer, or a date/time).

NOTE: The files listed in the Exclude from Compare are only used to determine if a modification has occurred, and will not affect the actual files that will be committed to Copia.

Once satisfied with the File List declarations, click the Create File List button.