メインコンテンツまでスキップ

Next Design V5.0 の変更点

エクステンション機能の変更点

エクステンション開発環境

V5.0 以降で追加される API を利用する場合、.NET 10 対応の開発環境が必要となります。詳細は 作業を開始する を参照してください。

Pythonでのエクステンション開発

エクステンションの開発言語にPythonを利用できるようになりました。詳細は スクリプトとDLL を参照してください。

スクリプトウィンドウの強化

スクリプトウィンドウでPythonスクリプトの記述・実行ができるようになりました。詳細は スクリプトエディタでの実行 を参照してください。

スクリプト実行 API の拡張

スクリプト実行 API で Python 形式のスクリプトを利用できるようになりました。

  • IApplication.ExecuteScript メソッドで、Python 形式のスクリプトファイルを指定できるようになりました。合わせて例外が定義されました。
  • IApplication.ExecuteScriptCode メソッドで、スクリプト言語に Python を指定できるようになりました。合わせて例外が定義されました。

ドキュメント出力カスタマイズ API の追加

ドキュメント出力のカスタマイズに関するAPIが追加されました。詳細は ドキュメント出力内容のカスタマイズ を参照してください。

  • IEditorDef.ExportDocument プロパティで、対象のエディタをドキュメント出力するかどうかを取得・設定できるようになりました。
  • IWorkspace.GenerateDocument メソッドで使用する DocumentGenerationOptions に、以下のプロパティが追加されました。
    • ExportFiguresAsPng プロパティ - ダイアグラムの画像を外部出力するかどうかを指定できます。
    • ExportLargeTablesAsExcel プロパティ - ツリーグリッドをExcelファイルとして外部出力するかどうかを指定できます。
    • IncludeImageFileLinksInDocument プロパティ - 外部出力した画像ファイルへのリンクをドキュメントに含めるかどうかを指定できます。
    • IncludeTableFileLinksInDocument プロパティ - 外部出力したExcelファイルへのリンクをドキュメントに含めるかどうかを指定できます。
  • ツリーグリッド用のドキュメント出力カスタマイズのためのインタフェース ITreeTableCellContent、ITreeTableContent が追加されました。
  • IRichTextCellContent.PlainText プロパティで、ツリー形式のテーブルを外部の Excel ファイルに出力するときに使用するテキスト値を取得できるようになりました。
  • DocumentContentTypes 列挙体に、TreeTable と TreeTableCell の列挙メンバーが追加されました。
ドキュメント出力カスタマイズの制約事項
  • ITreeTableContent のコンテンツを編集する際、Html プロパティに値を設定した場合、Excel形式の出力でのみ FixColumnIndex の設定値を元に列が固定されます。
  • ITreeTableContent のコンテンツを編集する際、Excel形式の出力でのみ FixRowIndex の設定値を元に行が固定されます。
  • DocumentGenerationConfigs で設定できるエクスポート時のコールバック(RegisterAfterContentsGeneration、RegisterAfterContentWrite、RegisterBeforeContentWrite、RegisterDocumentWriteStart)によって出力するモデルを減らす場合、減った分のモデルが進捗率の計算外となり、100%未満の状態でエクスポートが完了する場合があります。

リッチテキスト操作 API の変更

リッチテキスト型フィールド値設定時に、表示用 HTML 値と検索用テキスト値の不整合が発生しないようになりました。

  • IModel.SetRichTextField メソッドでは、テキスト値を変更しようとしても無視されるようになりました。
  • IModel.SetRichTextFieldValues メソッドでは、第 3 引数のテキスト値を指定しても無視されるようになりました。

DB形式の廃止に伴うAPI引数不正条件の変更

DB形式のサポート廃止に伴い、以下のAPIではDB形式(.iproj)のパスを指定するとエラーとなるようになりました。

  • IProductLineModel.ExportAppliedProject メソッド
  • IProjectUnitManager.AddExternalUnits メソッド
  • IProjectUnitManager.ExportModelUnit メソッド
  • IProjectUnitManager.ImportModelUnits メソッド
  • IWorkspace.OpenProject メソッド
  • IWorkspace.SaveProjectAs メソッド

プロジェクトファイル操作APIの変更と追加

プロジェクトファイルの操作に関して、以下のAPIが変更・追加されました。

  • IWorkspace.CleanUpProject メソッドで、プロジェクトのクリーンアップ処理の対象が、指定されたプロジェクトの管理対象ユニットのうち、編集可能かつ参照登録でなく、ロード済みであるユニットのみに変更されました。
  • IWorkspace.CloseCurrentProject メソッドが追加されました。引数を明示することでカレントプロジェクトが未保存の場合でも、保存するかの問い合わせなく変更を破棄してプロジェクトを閉じられます。

API ごとの変更点

ここでは、Next Design V5.0 のAPI変更点を列挙します。それぞれの API の詳細は API 仕様 を参照してください。

変更した API

Next Design V5.0 で変更したAPIを列挙します。

API 移行方法の詳細は API 仕様から該当 API の注釈を参照してください。


NextDesign.Core

API変更内容
IModel.SetRichTextField メソッドテキスト値を変更しようとしても無視されるようになりました。詳しくは個々の API 仕様を参照してください。
IModel.SetRichTextFieldValues メソッド第 3 引数のテキスト値を指定しても無視されます。
IProductLineModel.ExportAppliedProject メソッド引数不正の条件を変更しました。指定したプロジェクトの出力先のパスの拡張子がサポート外の場合にエラーとなります。
IProjectUnitManager.AddExternalUnits メソッド引数不正の条件を変更しました。指定したユニットファイルパスの拡張子がサポート外の場合にエラーとなります。
IProjectUnitManager.ExportModelUnit メソッド引数不正の条件を変更しました。エクスポート先のファイルパスの拡張子がサポート外の場合にエラーとなります。
IProjectUnitManager.ImportModelUnits メソッド引数不正の条件を変更しました。指定したユニットファイルパスの拡張子がサポート外の場合にエラーとなります。
IViewDefinitions.NewElementDef メソッド指定するフィールドの型がInt、Doubleの際にテキストボックス定義が作成できない問題を解消しました。

NextDesign.Desktop

API変更内容
DocumentContentTypes 列挙体TreeTable と TreeTableCell の列挙メンバーを追加しました。
IApplication.ExecuteScript メソッドスクリプトファイルに Python 形式のファイルを指定できるようになり、例外が定義されました。
IApplication.ExecuteScriptCode メソッドスクリプト言語に Python を指定できるようになり、例外が定義されました。
IWorkspace.CleanUpProject メソッドプロジェクトのクリーンアップ処理の対象が、指定されたプロジェクトの管理対象ユニットのうち、編集可能かつ参照登録でなく、ロード済みであるユニットのみに変更されました。
IWorkspace.GenerateDocument メソッド指定したフォルダパスで出力する場合に生成されるファイルのパスがWindowsの制限を超える場合には、ドキュメント出力前に ExtensionArgumentException にてエラーを通知するようになりました。
IWorkspace.OpenProject メソッドDB形式(.iproj)のサポート終了に伴い、DB形式のプロジェクトパスを指定した場合にエラーとなるようになりました。
IWorkspace.SaveProjectAs メソッドDB形式(.iproj)のサポート終了に伴い、DB形式のプロジェクトパスを指定した場合にエラーとなるようになりました。

追加した API

Next Design V5.0 で追加したAPIを列挙します。

NextDesign.Core

  • IEditor.IsAgentiqsPaneVisible プロパティ
  • IEditorDef.ExportDocument プロパティ
  • IRichTextCellContent.PlainText プロパティ
  • ITreeTableCellContent インタフェース
  • ITreeTableContent インタフェース

NextDesign.Desktop

  • DocumentGenerationOptions.ExportFiguresAsPng プロパティ
  • DocumentGenerationOptions.ExportLargeTablesAsExcel プロパティ
  • DocumentGenerationOptions.IncludeImageFileLinksInDocument プロパティ
  • DocumentGenerationOptions.IncludeTableFileLinksInDocument プロパティ
  • IWorkspace.CloseCurrentProject メソッド

V5.0 では、APIの削除および統廃合予定はありません。