Advanced Functions: Change Management System Toolbar

Dropdown Library List

Libraries

A list of current libraries open. Select an alternate to list its classes. If you are viewing a datafile in the list, select a target library in this list to set the destination for the copy function.

List Lib.

List classes in the currently selected library. Operate File — Advanced — Custom Features Utility to open all libraries in your Custom directory.

Open Lib.

Opens an alternative library and lists its classes.

Copy CMS

Saves selected classes to the CMS data file. After selecting classes on the list for a library, this tool enables you to save them in binary coded form in the ProgCode.usa datafile in the Custom directory. If this file was not already present, it will be automatically created when you open this window.

WARNING: Always make sure that classes referencing custom file fields are saved with the custom file class. The field references are held as tokens and these are stored in the datafile. When loaded into a target library these tokens are reconnected to the file class in the target library. If the file class is not present, these token references will be lost and the class will be effectively corrupted. The Caliach Vision automatic update routine always loads file classes stored in ProgCode.usa before any other classes.

List CMS

List classes in the CMS data file.

Notes

Opens the Notes Maintenance window. This enables you to attach user notes to your CMS update.

Rename

Enables you to rename classes and change version and description. After changing values in the list, confirm with the save tool or revert.

NOTE: If you add the text “Rename to: ABCDEFGH” to the description of a class, Caliach’s class loader will automatically rename the class to ABCDEFGH. When you confirm changes that contain such text, you will get a confirmatory message. Note that you must use the exact characters shown above including spaces. The name must have no spaces and must start with a number or character. Try not to use $, #, /, , or punctuation characters.

WARNING: Take great care in naming classes. Caliach has a standard that is used. All reports are prefixed “r”, searches “s”, windows “w”, menus “m”, toolbars “tb”, tasks “ta”, objects “o” and code classes “c”. You should NOT apply this convention but use one of your own prefixing your classes with some short version of your business name. E.G “myco” for My Company Ltd, for example. NEVER name a task class “Startup_Task” or code class “cUpdate”.

Revert

Reverts and changes to that previously saved.

Save

Saves changes you have made.

Protect

Protects selected classes (only for those in the CMS data file). Having selected one or more class lines, this tool will set them to be protected when loaded in a subsequent library. Protected classes, once they are in a library, can not be viewed or modified, however using this class mover they can be overwritten. This tool does not explicitly protect the classes, only marks them for protection when they are loaded into a library using mover or the CMS auto-update.

WARNING: Caliach recommends that you steer well clear of protecting any classes. If you do protect classes make sure you have a backup of the un-protected classes.

Delete

Deletes selected classes in a CMS data file.

From CMS

Copy selected classes from the CMS data file into the library selected in the list on this toolbar. Having selected one or more class lines listed from the ProgCode.usa datafile, this tool will load the classes into the library selected in the toolbar list. Always make sure that classes using custom file fields are loaded after, or at the same time as, the custom file format.

WARNING: If the class already exists in the library, it will be overwritten automatically. You WILL NOT receive any message or opportunity to abort the overwrite.

To Lib.

Copy selected classes into another library without going via a CMS data file. This tool can operate on classes listed from the current library or those stored in the ProgCode.usa datafile. Having selected one or more of the class lines listed, click on this tool. A library file selection dialogue will be presented. The warning above applies.

WARNING: The “Rename to: ABCDEF” class name renaming process does not operate with the above two functions. This is because circular renaming may occur.

To Folder

To copy the data file into the current data directory so that other users will be updated with the modified classes stored within after they restart the program.

Print

Print class listing.

oCustom1

oCustom1 custom code transfer that copies code from the oCustom1 in the data file into the oCustom1 object in the library selected in the list on this toolbar. Also applies to other custom object classes, such as oLinkProgram and oSOCustom. This tool in only available if you have selected the oCustom1 object class when it is stored in the datafile ProgCode.usa. It operates a procedure for transferring special method code from the stored oCustom1 object class into a newly updated version of oCustom1 in the selected library. See the Upgrading Caliach Vision to a New Version topic.

Tool Text

Toggles the tool texts on this toolbar.

• Change Management System Class Mover
• Change Management System Notes Maintenance