IBM Rational Rose モデルのインポート機能 - リリース情報

エラーが含まれているインポート済みの Rose モデルを開こうとすると、「パーツを作成できません (Unable to Create Part)」というエラー・メッセージが表示されることがあります。 現在は、モデルのエラーが関連するクラスを見つけることができないといった不完全な関連によるものである場合は、詳細なメッセージが表示されるようになりました。例えば、「関連名は不完全です。関連クラス名は見つかりません。」のようなメッセージです。

インポート前の Rose モデルの確認

Rational Rose モデルのインポートを試みる前に、元のモデルが Rose でエラーなしで開くことを確認してください。

Rational Rose では、関連にある名前のラベルをロールのラベルとは異なるフォントにすることができます。デフォルトでは、Rose 関連名のラベルはイタリックで、ロールのラベルは Roman です。新規の UML モデリング製品では、関連にはすべてのラベルに適用される単一のフォント設定しかありません。

Swimlane (図形区画) はデフォルトでは透明で、それらに色を割り当てることはできません。ほとんどの場合、これらはそのコンテナーの色を継承します。

Rational Rose モデルにダイアグラム上に定義されたロールの制約を含む関連がある場合、制約はマイグレーションされますが、ダイアグラム上の表記は表示されません。現在のところ、関連コネクターに接続されたラベルとしての関連ロールの制約の表記はサポートされていません。

デフォルトのアイコンは基本的には図形イメージと同じであるため、状態または疑似状態要素ではステレオタイプのアイコンは現在のところサポートされていません。

Rose モデルに複数行のテキストを含むコネクター・ラベルがある場合、複数行のコネクター・ラベルは現時点ではサポートされていないため、そのテキストは単一行のテキストとしてインポートされます。 一部のラベルではダイアグラム・エディターで他の項目と重なり合い、ダイアグラムが読み取りにくくなることがあります。長い名前のラベルに合わせるには、図形とコネクターのビューを手動で整列させなければならない場合があります。

ステレオタイプ・クラスを持つライフラインを含む Rose シーケンス図、および関連するイメージ (装飾) を含む Rose シーケンス図は、インポート後に変更され、ライフラインがステレオタイプのイメージなしで表示されるようになります。ライフラインのクラスはステレオタイプ化されたままですが、これがそのケースであることを示すライフラインの装飾はなくなります。Rational Software Architect および Rational Software Modeler は、ライフラインのステレオタイプのイメージや装飾アイコンをサポートしていません。

Rose モデルをインポートすると、すべての管理ユニットの内容が自動的にインポートするモデル内にコピーされます。管理ユニットは別のファイルとしては常駐しなくなり、Software Architect または Software Modeler の標準のモノリシック・モデル内に組み込まれます。 これは選択できません。また、単一の大容量のファイルがあると、インポート・プロセス中にパフォーマンス上の問題が発生することがあります。

Rose モデルをインポートした後で、モデルを別の物理モデルに分割することができます。各サブシステムからモデルを作成すれば、そのサブシステムが Rose の管理ユニットであったときと同様に制御することができます。 詳しくは、オンライン・ヘルプ・トピック「複数モデルのアプローチと Rose 管理ユニット (Multiple model approach versus Rose controlled units)」を参照してください。

Rose では、シーケンス図、コラボレーション図、またはアクティビティー図のオブジェクトが、オブジェクトのタイプであるクラスに適用されるステレオタイプのアイコン (存在する場合) を示します。これは、Software Architect または Software Modeler では現在のところサポートされていません。

モデルのインポートの進行中にインポート・ウィザードを使用するとエラーが発生する

インポート操作が開始され、「進行情報 (Progress Information)」ウィンドウが開いた後で「Rational Rose Model Import」ウィザードのボタンをクリックすると、エラーが発生します。ウィザードを閉じてから再始動する必要があります。 「進行情報 (Progress Information)」ウィンドウが開いているときにインポート操作を停止するには、このウィンドウの「キャンセル」ボタンをクリックします。

回避方法: モデルのインポート中で「進行情報 (Progress Information)」ウィンドウが開いている間は、「Rational Rose Model Import」ウィザードのボタンを選択しないでください。

Rational Rose モデルにノート添付を使用してテキスト要素に接続されたノートがある場合、そのノート添付はインポートされません。サポートされているのは、ノートから UML 要素へのノート添付のみです。

Software Modeler または Software Architect で Rose Classic 外観スタイルを使用すると、ノード要素の右側に白い点が表示されます。外観の設定は「ウィンドウ」>「設定」をクリックし、「ワークベンチ」を展開して、「外観」をクリックすることによって設定されることに注意してください。

Rational Rose では、ステートチャートおよびアクティビティー図は単一の状態/アクティビティー・モデルに実装されます。アクティビティー図で使用可能な要素は、ステートチャート図のスーパーセットです。状態/アクティビティー・モデルをインポートするとき、Software Architect または Software Modeler、Rose のアクティビティー図でのみ可視化できるアクティビティー図または要素が含まれているかどうかをチェックします。含まれている場合は、すべてのステートチャート図が新規 UML モデリング製品モデルの UML アクティビティー図に変換され、状態は構造化アクティビティー・ノードに変換され、遷移は制御フローに変換されます。

回避方法: ステートチャート図から UML アクティビティーのセマンティクスへの変換が問題である場合は、インポートする前に、ステートチャート図とアクティビティー図を Rose モデルの別の状態/アクティビティー・モデルに分離することができます。パッケージは単一の状態/アクティビティー・モデルしか所有できないため、これには追加のパッケージの作成が必要な場合があります。ステートチャート要素のみを含む状態/アクティビティー・モデルは、UML 状態マシンとしてインポートされます。

インポート時に UML 2.0 準拠が報告されない

UML 2.0 に準拠しないモデルをインポートするとき、「Rose モデルのインポート」ウィザードはエラー・メッセージを表示しません。

回避方法: UML 2.0 準拠エラーは、検証が行われるときに報告されます。

ステートチャートの開始状態とアクティビティーの開始ノードは、色として「線の色」属性を使用し、「塗りつぶしの色」属性値を無視します。ステートチャートの終了状態とアクティビティーのアクティビティー終了ノード (どちらも標的の形状のアイコン) は、外側の円の色を「塗りつぶしの色」属性に設定し、内側の円の色を「線の色」属性に設定します。

Rational Rose がインストールされていないコンピューター上に「Rational Rose Model Import」ウィザードをインストールして使用すると、インポートされたダイアグラムに、インポートされたモデルのステレオタイプのアイコンが予想通りに組み込まれません。また、ウィザードの「ステレオタイプのマップ」ページにあるステレオタイプ構成のリストが空になります。

注: 以下の回避方法は、Rose と新規 UML モデリング製品 (Software Modeler または Software Architect) 用に同じオペレーティング・システムを使用していることを前提としています。

回避方法: ダイアグラムにステレオタイプのアイコンを保存するには、Rose と Software Modeler または Software Architect 用に同じコンピューターを使用するか、以下の手順に従いステレオタイプ成果物をインポート中に使用できるようにします。

1. Rose がインストールされているマシンの Windows または MainWin レジストリーから Rose データをエクスポートし、結果のファイルを新規 UML モデリング製品がインストールされているコンピューターに転送します。以下のステップを使用して、Rose レジストリー・キーをエクスポートします。
   1. regedit または regedt32 ツールを使用して、以下のレジストリー・キーをエクスポートします。
      HKEY_CURRENT_USER\Software\Rational Software\Rose
   2. ファイルに rose_user.reg という名前を付けます。
   3. regedit または regedt32 を使用して、以下のレジストリー・キーをエクスポートします。HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Rose
   4. ファイルに rose_local.reg という名前を付けます。
   5. 以下の方法のいずれかを使用して、ファイル rose_user.reg と rose_local.reg を結合します。
      • Windows^® の場合、コマンド行から次のように入力します。
        C:\> copy rose_user.reg + rose_local.reg rose.reg
      • Windows の場合、メモ帳で両方のファイルを開き、一方のファイルの内容をもう一方のファイルの終わりにコピーし、結果を保存します。必ず、「名前を付けて保存」ウィンドウで Unicode エンコードを指定して保存してください。ファイルに rose.reg という名前を付けます。
      • Linux^® または UNIX^® プラットフォームの場合、コマンド行から次のように入力します。
        $ cat rose_user.reg rose_local.reg > rose.reg
2. 同じ Rose コンピューターで、基本 Rose インストールとすべてのインストール済みアドイン、および関連するすべてのイメージ・ファイルからのステレオタイプ構成 INI ファイルを、新規 UML モデリング製品を実行するコンピューターにコピーします。レジストリーおよびステレオタイプ INI ファイル情報は同じ構造によって決まるため、同一の Rose ディレクトリー構造を維持するよう注意してください。
3. 「Rational Rose Model Import」ウィザードで、ウィザードの最初のページの「レジストリー・ファイル (Registry file)」フィールドに、最初のステップで作成したレジストリー・エクスポート・ファイルを指定します。
4. ウィザードから「ステレオタイプのマップ」ページに進み、ステップ 2 で取得したステレオタイプ構成ファイルがすべて表示され、既存または新規の UML プロファイルにマップされていることを確認します。
5. ウィザードを終了してインポートを完了します。

大きい Rose モデルをロードするときにメモリー不足エラーが発生した場合は、ワークベンチ JVM のヒープ・サイズを大きくする必要があります。

回避方法: ワークベンチのコマンド行で "-vmargs -Xmx<size>" 引数を渡すことによって、メモリーを大きくします。例えば、標準的な製品インストールの場所を想定した場合、1 GB のヒープを指定するには次のようにします。

• Windows の場合:
  C:\Program Files\IBM\Rational\SDP\6.0\rationalsdp.exe -vmargs -Xmx1024M
• Linux の場合:
  /opt/IBM/Rational/SDP/6.0/rationalsdp.bin -vmargs -Xmx1024M

サイズが 50 MB までの Rose モデル (すべての CAT ファイルを含む) の場合、通常はデフォルトの JVM 設定で十分です。より大きいモデルの場合は、ヒープ・サイズを大きくすることを検討してください。

50 MB 以上の Rose モデルの場合は、インポート後にモデルをより小さい単位にリファクタリングすることを検討してください。ポップアップ・メニューで「パッケージからモデルを作成」コマンドを使用して、パッケージを別個のモデルに抽出することができます。これにより、メモリーに一度にロードされるモデル・データの量を削減しやすくなります。

Rational Rose モデルをインポートするとき、UML モデルとプロファイルを Rational ClearCase バージョン 6.13 の動的ビューの新規プロジェクトに作成すると、モデル・ファイルはインポートされますが、プロパティー・セットとステレオタイプは UML プロファイルに変換できない場合があります。プロファイルが生成される予定だったプロジェクトを作成できなかったことを示すエラーが表示されることがあります。例えば、「書き込み不可能な場所にはプロジェクトを作成できません (Cannot create project in non-writable location): test1project_profiles」です。

回避方法: インポートするモデルの ClearCase 動的ビューを使用するには、次のようにします。

1. 「Rose モデルのインポート」ウィザードを開き、ClearCase 動的ビュー以外の場所にモデルおよびプロファイル・プロジェクトを作成します。
2. ウィザードの次のページに進んで、Rose モデルとステレオタイプをインポートします。
3. ワークスペースからプロジェクトを削除します (プロジェクト内容は削除しないでください)。
4. Windows エクスプローラーで、プロジェクト・ディレクトリーを ClearCase 動的ビュー内に移動します。
5. 「既存のプロジェクトをワークスペース内にインポート (Import Existing Project into Workspace)」ウィザードを使用して、プロジェクトを Rational Software Architect または Rational Software Modeler のワークスペース内に戻します。

関連クラスおよび汎化のインポート時は、以下の問題に注意してください。

• Rational Rose では、関連に関連クラスを接続する時に使用する点線が付いたコネクターを、手動で自由に曲げられます。Software Architect および Software Modeler のダイアグラムでは、この接続コネクターはダイアグラム内に保持されず、常に直線としてレンダリングされます。ユーザーが操作することはできません。
• Rose では、汎化は名前付き要素です。UML 2.0 では汎化は名前付き要素ではないため、名前を持つ Rose モデルの汎化の名前は Software Modeler または Software Architect のダイアグラムには表示されません。汎化の元の名前は、UML 汎化の Rose ステレオタイプに保管されます。
• Rose では、関連と関連クラスは、互いにリンクされた別個の要素です。UML では、AssociationClass は単一要素として表されます。Rose の関連とクラスは両方とも名前が付いていることがあり、それらの名前は異なっていることがあります。それらをインポートすると、クラスの名前だけが UML 関連クラスに保存されます。Rose 関連の名前は、UML 関連クラスの Rose ステレオタイプに保管されます。

• メインのユースケース図を開こうとすると、「パーツを作成できません (Unable to create part)」というエラー・メッセージが表示される。
• ダイアグラム内のコンポーネントがゆがんで表示される。
• Rational Software Architect が停止する。

回避方法:  Rational モデリング製品を終了し、新規のワークスペースで再始動してください。

また、Rational Application Developer バージョン 6.0 の README に記載されている以下の情報が役に立つ可能性があります。

操作によって UML ダイアグラムが使用不可になる場合がある

Red Hat Enterprise Linux 3.0 では、ある一定の操作によって UML ダイアグラムが使用できなくなる可能性があります。 いずれの場合も、以下のエラー・メッセージが表示されます。

内部エラーの表示中に内部エラーが生じました (An internal error occurred while showing an internal error.)。ワークベンチを終了することをお勧めします (You are recommended to exit the workbench.)。 後続のエラーが起こる可能性があり、ワークベンチが警告なしに終了することがあります (Subsequent errors may happen and may terminate the workbench without warning.)。 詳細については .log ファイルを参照してください (See the .log file for more details.)。ワークベンチを終了しますか? (Do you want to exit the workbench?)

.log ファイルには、次の例と同じような例外が出力されます。

!MESSAGE Failed to execute runnable (java.lang.InternalError: Can't connect to X11window server using ':0.0' as the value of the DISPLAY variable.)

!STACK 0
org.eclipse.swt.SWTException: Failed to execute runnable (java.lang.InternalError:
Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.)
    at org.eclipse.swt.SWT.error(Unknown Source)
    at org.eclipse.swt.SWT.error(Unknown Source)
    at org.eclipse.swt.widgets.Synchronizer.runAsyncMessages(Unknown Source)
    at org.eclipse.swt.widgets.Display.runAsyncMessages(Unknown Source)
    at org.eclipse.swt.widgets.Display.readAndDispatch(Unknown Source)
    at org.eclipse.ui.internal.Workbench.runEventLoop(Workbench.java:1377)

!MESSAGE Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.
!STACK 0
java.lang.InternalError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.
    at sun.awt.X11GraphicsEnvironment.initDisplay(Native Method)
    at sun.awt.X11GraphicsEnvironment.<clinit>(X11GraphicsEnvironment.java:175)
    at java.lang.Class.initializeImpl(Native Method)
    at java.lang.Class.initialize(Class.java:350)
    at java.lang.Class.forNameImpl(Native Method)
    at java.lang.Class.forName(Class.java:116)
    at java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment(GraphicsEnvironment.java:91)
    at java.awt.image.BufferedImage.createGraphics(BufferedImage.java:1073)
    at org.apache.batik.ext.awt.image.GraphicsUtil.createGraphics(Unknown Source)
    at org.apache.batik.gvt.filter.GraphicsNodeRed8Bit.genRect(Unknown Source)
    at org.apache.batik.gvt.filter.GraphicsNodeRed8Bit.copyData(Unknown Source)
    at org.apache.batik.ext.awt.image.rendered.TileCacheRed.genRect(Unknown Source)

この問題を回避するには、製品を終了してから再始動してください。

ダイアグラム・リンクがインポートされない

ダイアグラム・リンクを含む Rational Rose ノートは、リンクとして正しくインポートされません。Rose では、ノートをダイアグラム上に作成してから、そのノート上に別のダイアグラムをドラッグして、そのダイアグラムへのリンクを作成することができます。 ノートをダブルクリックすると、該当のリンクされたダイアグラムが表示されます。このようなリンクはインポートで保持され、同じ機能が可能になるべきです。

回避方法: インポート後にこの機能を手動で実行するか、または特定のダイアグラム・リンクを作成してください。

「Rational Rose Model Import」ウィザードを使用するとき、「Rational Rose Model Import Preferences」ページの「Interpret UML 2.0 conventions in the Rose model」チェック・ボックスにチェックをすると以下のような影響があります。

• このチェック・ボックスが選択されている場合、「Rational Rose Model Import」ウィザードは、Rose モデルのアクターを UML 2.0 アクター要素にマップしようとします。ただし、以下の場合を除きます。
  
  • Rose アクターが何らかの属性、操作、または状態マシン (UML 2.0 アクターが所有できないものすべて) を所有する場合。
  • Rose アクターが、ユースケースまたはその他の分類子に誘導可能な関連を持つ場合 (UML 2.0 では、アクターは誘導可能性を維持するために関連の端を所有する必要がありますが、アクターがプロパティーを所有することはできません)。
    
    上記のような場合、「Rational Rose Model Import」ウィザードはアクターを UML 2.0 クラスとしてマップします。
    
• このチェック・ボックスが選択されていない場合、「Rational Rose Model Import」ウィザードは、ステレオタイプを持つ UML 2.0 クラスとしてアクターをマップします。

整合性を維持するため、このチェック・ボックスは選択しないでください。その場合、すべてのアクターはクラスとしてインポートされます。