Notes on Upgrading from Next Design V1.0 to V1.1

Revision History

2020-09-04 : Added information regarding changes to system command IDs in extensions.

■ Project Files

Project files created in V1.0 are automatically converted to the latest data format when opened and can continue to be used. However, please note the following points.

Saving by overwriting will make the project unable to be opened in previous versions.
You may need to update the colors of your diagrams.

Due to revisions to the quick style color palette, opening projects created in V1.0 and displaying diagrams may result in certain shapes or connectors appearing colorless or gray. If necessary, please select the shapes or connectors and re-specify their colors. Note that connectors that have become colorless can still be selected on the diagram.

■ Extensions

If you use DLL-based extensions developed for V1.0 as-is in V1.1, the following message will be output and they cannot be used.

Failed to activate extension "xxx". (Could not load one or more of the requested types. For details, retrieve the LoaderExceptions property.)

When using V1.0 extensions in V1.1, please take the following actions.

Replacing referenced DLLs
Changing API namespaces
Handling API specification changes
Changing Key Names in Locale Files
Changing System Command IDs

Even when using the script-based extension format, "3. Addressing API Specification Changes" and "4. Changing Key Names in Locale Files" are required among the updates above, so please make the necessary adjustments.

1. Replacing Referenced DLLs

The file name of the DLL for extension development has been changed. Please replace the DLL reference in your extension project.

DLL File Name up to V1.0

DensoCreate.NextDesign.Extensibility.Api.dll

DLL File Name from V1.1
```
NextDesign.Core.dll  
NextDesign.Desktop.dll
```
The V1.1 extension development DLL file mentioned above is stored in the Next Design V1.1 installation folder.

2. Changing API Namespaces

The namespace for the extension API has been changed. Please update the namespaces in your extension source code.

API Namespace up to V1.0

DensoCreate.NextDesign.Extensibility.Extension  
DensoCreate.NextDesign.Extensibility.Api

API Namespace from V1.1

NextDesign.Extension  
NextDesign.Core  
NextDesign.Desktop

3. Addressing API Specification Changes

The APIs with changed specifications and those scheduled to be deprecated in the next update are listed below. For details on API migration methods, please refer to the corresponding API annotations in the Extension Development Manual.

Note that APIs scheduled for deprecation can still be used in V1.1, but building as a DLL-based extension will result in a warning message.

APIs with Specification Changes

ICommandParams.ToCollection Method
IModel.ModelPath Property
IModel.SetField Method
INavigator.Items Property
INavigator.SelectedItems Property
ModelBeforeNewRelationEventParams Class
ModelAfterNewRelationEventParams Class

APIs Scheduled for Integration

IApplication.CreateSearch
ICommonUI.MessageBox
IContext.Application
IEditorPage.IsInformationPaneVisible
IEditorPage.ActiveInfoWindow
IEditorPage.CurrentOutputCategory
IEditorPage.CurrnetInfoView
IWorkspace.CreateSearch

4. Changing the Key Name in Locale Files

The specified key name has been changed in the locale files defined for multi-language support. Key name: resouceStrings resourceStrings Please change it to . (This corrects a typo where the letter "r" was missing from "resource".)

locale.xx.json files up to v1.0

{
	"locale": "xx",
	"resouceStrings" : {
		･･･
	}
}

locale.xx.json files from v1.1 onwards

{
	"locale": "xx",
	"resourceStrings" : {
		･･･
	}
}

5. Changing System Command IDs

The IDs of system commands available for subscription in the manifest event definitions have been changed. Please update the IDs as follows.

Command	Previous ID	New ID
Delete Command	Delete	Home.Delete
Cut Command	Cut	Home.Cut
Copy Command	Copy	Home.Copy
Paste Command	Paste	Home.Paste
Undo Command	Undo	Home.Undo
Redo Command	Redo	Home.Redo

That is all.

Release