Avatar

What the Heck is “Case Structure” and How Do I Know Whether or Not to “Keep” It?

One of the most commonly asked questions of Tech Support Reps and CATalyst trainers is “When should I select the Keep Case Structure option?”

When you use the Backup function to back up one or more files, Case CATalyst stores the location information for that file. This information is also known as the “path” or the “case structure.” For example, if you back up your Personal Dictionary, the Personal Dictionary.ZIP file contains both the file named Personal Dictionary.sgdct, and the location information for that file – it knows that the file was stored in the System Files case.

When you use the Restore, Copy or Move functions, CATalyst has the option to restore, copy or move only the file, or to restore, copy or move both the file AND all of its location information.

The option that controls that choice is called Keep Case Structure.

If Keep Case Structure is selected, CATalyst will restore, copy or move both the file and the case structure. So, using the example of our backed up Personal Dictionary, selecting Keep Case Structure would restore a System Files case containing the Personal Dictionary.

If Keep Case Structure is not selected, CATalyst will restore, copy or move the file, only.

When you look at the To: section of the Restore, Copy or Move dialog boxes, you will see that by default, anything you select in the From: section will be restored, copied or moved to the main level of your user. You can see this by the path shown under the words Restore Job To:, Copy Job To: or Move Job To:.  It is shown boldfaced. For example, in my user, the default path is C:\CAT4\usr\Cindi. The Cindi user folder is also highlighted in the graphic representation of the path on the right side of the dialog.

So, let’s say I wanted to restore my backed up dictionary from the Personal Dictionary.ZIP file. If Keep Case Structure is selected, CATalyst will restore the Personal Dictionary.sgdct file inside the System Files case in my Cindi user.  If Keep Case Structure is not selected, it would restore just the Personal Dictionary.sgdct file, but it will not store it in the System Files case – it would restore the file to the main level of the Cindi user.  As the Personal Dictionary file is only automatically selected for translation if it’s located in the System Files case, it makes sense for me to select Keep Case Structure.

Now: here’s where some CATalyst users get confused: you also have the option to select the specific location where you want a file to be restored.  If you are going to take the time to browse to and select the same location from where the file was backed up, then you should not select Keep Case Structure, because you would be duplicating the structure. For example, if I selected the System Files case in my user, and I select Keep Case Structure, when I restore my Personal Dictionary and the System Files case in my backup, my Personal Dictionary will be restored to a System Files case inside the existing System Files case!

So here’s two simple rules that will help you know whether or not to select the Keep Case Structure option:

  1. If you want the file to remain in the structure shown in Restore/Copy/Move Jobs From:, select Keep Case Structure and do not select a specific location.
  2. If you want to restore the file to a new location; a different location than the location shown in Restore/Copy/Move Jobs From:, do not select Keep Case Structure and select a specific location under Restore/Copy/Move Jobs To:.

Follow those rules and you’ll find it much easier to find your files after they’ve been restored, moved or copied!

 

Share this post