When you install a new release of Corticon Studio, your Corticon development assets (Vocabularies, Rulesheets, Ruleflows, and Ruletests) might need to be upgraded for use in the Corticon Studio. These could be projects you were working on or samples you imported from another location. When you open an asset, Corticon Studio checks the version of the asset and alerts you if it needs to be upgraded. As you open each asset that needs to be upgraded, you are alerted as to the required action, and encouraged to proceed to upgrade it. The asset upgrade process will force the upgrade of dependent assets that also require a similar upgrade. This task can be tedious if you have a lot of assets and a lot of projects.

Note: Comprehensive upgrade steps - The procedure described here is only a part of an enterprise upgrade of all installations and assets. See Procedures for upgrading Corticon installations

The project upgrade utility lets you choose projects or folders of projects that will be upgraded all in one pass. Typically, you would update projects in your workspace but, you can also choose to update assets in folders outside your workspace.

Performing this procedure just after upgrading your Corticon Studio will relieve you of having to do this task as you work.

Note: Once you upgrade your assets, you cannot open them with earlier versions of Corticon Studio.

To upgrade a selected project:

  1. Choose the Upgrade Rule Assets command, , on the dropdown menu that opens when you right-click on any project name in the Projects Explorer view. The Upgrade Corticon Assets dialog box opens, as shown:

    In this example, the MedicalClaim project was selected so all the assets in that project are selected for upgrade.

  2. Click Finish to start upgrade processing. You are alerted that this process cannot be undone, so consider whether you should cancel, backup the files as-is, and then run the same upgrade process again to completion.
  3. After processing, the Update Results window opens, listing the assets that required upgrade and were upgraded, as well as those that did not require an upgrade, as shown:
    You can choose to click Copy, and then paste the text into your preferred text editor.
  4. Click OK to close the results window and the dialog box.

To upgrade multiple projects not in your workspace:

  1. Choose the Upgrade command, , from the Project menu. The Upgrade Corticon Assets dialog box opens.
  2. Click Browse to navigate to the root folder containing Rule Projects are rule assets, and click OK. The rule assets are listed in the Upgrade Corticon Assets dialog box, as in this example:
  3. Click Finish to start upgrade processing. You are alerted that this process cannot be undone, so consider whether you should cancel, backup the files as-is, and then run the same upgrade process again to completion.
  4. After processing, the Update Results window opens, listing the assets that required an upgrade and were upgraded, as well as those that did not require an upgrade. To record this information, simply copy the text from this window and save it elsewhere.
  5. Click OK to close the results window and the dialog box.