Changes in Next Design V5.0

Changes to Extension Functionality

Extension Development Environment

To use APIs added in V5.0 and later, a .NET 10 compatible development environment is required. See Getting Started for details.

Extension Development with Python

Python can now be used as the development language for extensions. See Scripts and DLLs for details.

• For APIs that cannot be used with Python, see Python Script Limitations.
• For information on the Python development extension for VS Code, please refer to Developing from Templates (Python).

Enhanced Script Window

You can now write and execute Python scripts in the script window. For details, please refer to Running with the Script Editor.

Enhanced Script Execution API

The Script Execution API now supports Python scripts.

• The IApplication.ExecuteScript method can now specify a Python script file. An exception has been defined accordingly.
• The IApplication.ExecuteScriptCode method can now specify Python as the scripting language. An exception has been defined accordingly.

Added Document Output Customization API

An API for customizing document output has been added. For details, please refer to Customizing Document Output Content.

• The IEditorDef.ExportDocument property now allows you to get and set whether to output the target editor as a document.
• The following properties have been added to DocumentGenerationOptions used with the IWorkspace.GenerateDocument method:
  • ExportFiguresAsPng property - Specifies whether to output diagram images externally.
  • ExportLargeTablesAsExcel property - Specifies whether to output the tree grid as an Excel file externally.
  • IncludeImageFileLinksInDocument property - Specifies whether to include links to externally output image files in the document.
  • IncludeTableFileLinksInDocument property - Specifies whether to include links to externally output Excel files in the document.
• Interfaces ITreeTableCellContent and ITreeTableContent have been added for customizing document output for tree grids.
• The IRichTextCellContent.PlainText property now allows you to get the text value used when outputting a tree-formatted table to an external Excel file.
• The DocumentContentTypes enumeration now includes TreeTable and TreeTableCell enumeration members.

Limitations on Document Output Customization

• When editing the content of ITreeTableContent, if you set a value for the Html property, the columns will only be fixed based on the FixColumnIndex setting in Excel output.
• When editing the content of ITreeTableContent, the rows will only be fixed based on the FixRowIndex setting in Excel output.
• When reducing the number of models to be output using the export callbacks (RegisterAfterContentsGeneration, RegisterAfterContentWrite, RegisterBeforeContentWrite, RegisterDocumentWriteStart) that can be set in DocumentGenerationConfigs, the reduced models will not be included in the progress calculation, and the export may complete with less than 100%. :::

Changes to the Rich Text Manipulation API

The inconsistency between the display HTML value and the search text value when setting rich text field values ​​has been resolved.

• The IModel.SetRichTextField method now ignores attempts to change the text value.
• The IModel.SetRichTextFieldValues ​​method now ignores the text value specified in the third argument.

Changes to API Argument Invalidation Conditions Due to the Deprecation of DB Format

Due to the deprecation of DB format support, specifying a DB format (.iproj) path in the following APIs will now result in an error.

• IProductLineModel.ExportAppliedProject Method
• IProjectUnitManager.AddExternalUnits Method
• IProjectUnitManager.ExportModelUnit Method
• IProjectUnitManager.ImportModelUnits Method
• IWorkspace.OpenProject Method
• IWorkspace.SaveProjectAs Method

Changes and Additions to Project File Operation APIs

The following APIs have been changed or added regarding project file operations:

• The IWorkspace.CleanUpProject method now targets only editable, reference-only, and loaded units among the managed units of the specified project for project cleanup.
• The IWorkspace.CloseCurrentProject method has been added. By explicitly specifying the argument, the project can be closed and changes discarded without prompting for saving, even if the current project is unsaved.

Changes per API

This section lists the API changes in Next Design V5.0. For details on each API, please refer to the API Specification.

Changed APIs

Lists the APIs changed in Next Design V5.0.

For details on how to migrate APIs, please refer to the annotations for the relevant APIs in the API Specification.

NextDesign.Core

API	Changes
IModel.SetRichTextField Method	Attempts to change the text value are now ignored. See the individual API specification for details.
IModel.SetRichTextFieldValues ​​Method	Specifying a text value for the third argument is now ignored.
IProductLineModel.ExportAppliedProject Method	Changed the conditions for invalid arguments. An error will occur if the extension of the specified project output path is unsupported.
IProjectUnitManager.AddExternalUnits Method	Changed the conditions for invalid arguments. An error will now occur if the extension of the specified unit file path is unsupported.
IProjectUnitManager.ExportModelUnit Method	Changed the conditions for invalid arguments. An error will now occur if the extension of the export destination file path is unsupported.
IProjectUnitManager.ImportModelUnits Method	Changed the conditions for invalid arguments. An error will now occur if the extension of the specified unit file path is unsupported.
IViewDefinitions.NewElementDef Method	Resolved an issue where a text box definition could not be created when the specified field type was Int or Double.

NextDesign.Desktop

API	Changes
DocumentContentTypes Enumeration	Added enumeration members for TreeTable and TreeTableCell.
IApplication.ExecuteScript Method	It is now possible to specify a Python format file for the script file, and an exception has been defined.
IApplication.ExecuteScriptCode Method	Python can now be specified as the scripting language, and an exception has been defined.
IWorkspace.CleanUpProject Method	The project cleanup process now targets only editable, non-referenced, and loaded units among the managed units of the specified project.
IWorkspace.OpenProject Method	Due to the end of support for DB format (.iproj), specifying a DB format project path will now result in an error.
IWorkspace.SaveProjectAs Method	Due to the end of support for DB format (.iproj), specifying a DB format project path will now result in an error.

Added APIs

Lists the APIs added in Next Design V5.0.

NextDesign.Core

• IEditor.IsAgentiqsPaneVisible property
• IEditorDef.ExportDocument property
• IRichTextCellContent.PlainText property
• ITreeTableCellContent interface
• ITreeTableContent interface

NextDesign.Desktop

• DocumentGenerationOptions.ExportFiguresAsPng property
• DocumentGenerationOptions.ExportLargeTablesAsExcel property
• DocumentGenerationOptions.IncludeImageFileLinksInDocument property
• DocumentGenerationOptions.IncludeTableFileLinksInDocument property
• IWorkspace.CloseCurrentProject method

There are no plans to remove or merge APIs in V5.0.