C# から UML への変換の構成

変換で予想どおりの出力を生成するために使用する情報を指定するには、構成のガイドをする新規変換構成ウィザード変換構成エディターを使用します。
このタスクについて

変換構成は、ファイル名拡張子 .tc を持ち、変換が予想通りの出力を生成するために使用する情報が含まれます。また、変換構成には、 特定のタイプの変換に固有の情報も含まれています。既存の変換構成を編集するには、ワークスペース・リソースを示すビューで変換構成ファイルをダブルクリックし、変換構成エディターを開きます。

変換構成ファイルに関する作業を簡略化するには、変換する要素を含むプロジェクトに構成ファイルを保管します。

C# から UML への変換を構成するには、以下のようにします。

  1. 「ファイル」 > 「新規」 > 「その他」 > 「変換」 > 「変換構成」の順にクリックします。
  2. 構成の詳細を指定します。新規変換構成ウィザードの「構成名および変換の指定」ページで、以下のステップを完了します。
    1. 名前フィールドに、構成の名前を指定します。
    2. 構成ファイル宛先フィールドで、変換構成ファイルの宛先を指定します。宛先は、現行ワークスペース内の相対パスです。完全修飾プロジェクト名またはフォルダー名を指定できます。プロジェクト内のフォルダーを指定する場合は、フォルダー名の前に接頭部としてスラッシュ (/) を付ける必要があります。
    3. 変換リストから変換を選択します。
      注: インストールされていても使用可能になっていない変換を表示するには、すべての変換の表示をクリックします。 変換は、このリストに表示するには、機能にバインドする必要があります。
  3. プロトコル」セクションでモデリング・プロトコルを指定します。これは、設計規約管理プロトコル (DCMP) とも呼ばれています。選択する値によって、変換のソースとターゲットを同期するかどうかが決定されます。
    • ソース・モデルが基本技術成果物の場合は、概念を選択します。 ソース・モデルへの変更はすべてターゲット・モデルに波及します。
    • ソース成果物が表すアーキテクチャーがターゲットとは独立して発展する場合は、「調整」を選択します。このオプションを選択すると、ソースとターゲットの比較や変更の調整に利用できる 後方変換を使用できるようになります。また、他のチームによって該当のアーキテクチャーが 実装、開発、または保守される場合にも、このオプションを選択することができます。
      注: このオプションを選択すると、「メイン」ページの「後方変換」セクションで、追加のプロパティーが使用可能になります。 一部の変換では、変換構成エディターで追加のページが使用可能になります。 後方変換の構成について詳しくは、下の関連リンクを参照してください。
  4. 「次へ」をクリックします。
  5. 変換のソース要素とターゲット要素を指定します。有効なソース要素とターゲット要素のリストについては、この変換に関する関連概念のトピックを参照してください。 「ソースとターゲット」ページで、以下のステップを実行します。
    1. 選択済みソース」ペインで、変換対象の変換用にソース要素を選択します。
    2. 選択済みターゲット」ペインで、変換出力の宛先を選択します。出力の新規の宛先を作成するには、ターゲット・コンテナーの作成をクリックします。
  6. 「終了」をクリックします。 変換構成エディターが開くと、構成の内容が表示されます。
  7. オプション: 変換構成に関する文書を指定します。このフィールドは、複数のユーザーが共有する構成に関する情報を伝達する場合に便利です。「メイン」ページの「文書」フィールドに、変換構成についての追加情報を指定します。
  8. オプション: ソースのプロジェクトのそれぞれの UML コレクション・タイプごとに、 変換により生成される C# コレクション・タイプを指定するには、「コレクション」タブをクリックします。 コレクションは、モデル要素のグループを表します。選択する C# コレクション・タイプにより、コレクション内に重複モデル要素が存在可能か、またはモデル要素が順序を持つかどうかが決定されます。UML コレクション・タイプは、 モデル要素の isOrdered および isUnique プロパティーにより決定されます。
  9. C# のソース・コードがモデルに変換される方法を構成するには、「C# から UML への変換の追加オプション」タブをクリックし、以下のオプションのいずれかを選択します。
    • コード内の各 getter または setter メソッドに対して、ターゲット・モデル内に UML 操作を生成するには、「各 C# getter/setter メソッドに対する UML 操作の生成」を選択します。
    • C# から UML への変換を実行した後に、ターゲット・モデルとマッピング・モデルを自動的に保管するには (UML から C# への変換の構成を通じて指定されている場合)、「C# から UML への変換の実行後にモデルを自動的に保管」を選択します。
    • C# クラスを表しているすべての UML クラスからアセンブリー・クラス System.Object への汎化関係を生成するには、「System.Object への汎化を作成」を選択します。
  10. オプション: 構成する変換がマッピングをサポートする場合は、マッピング・モデルを作成することで、変換で生成される成果物の代替名を指定できます。新規または既存のマッピング・モデルを使用するには、以下のステップを実行します。
    1. 変換構成エディターの 「マッピング」ページで、「この構成でマッピング機能を使用可能にする」チェック・ボックスを選択します。
    2. マッピング・モデルのファイル名」フィールドで、新規または既存のマッピング・モデルの名前を指定します。
  11. オプション: デバッグ情報を生成するには、「メイン」ページでデバッグ・ログの生成チェック・ボックスを選択します。 次回変換を実行したときに、ログ・ファイルが XML ファイルとして、変換の設定で指定したフォルダーに生成されます。 ログ・ファイルの場所を指定していない場合は、変換によりワークスペースの .metadata フォルダーにログ・ファイルが生成されます。
    ヒント: 変換の設定を行うには、「ウィンドウ」 > 「設定」とクリックし、「モデリング」を展開して、「変換」をクリックします。

    ログ・ファイルは、ソース要素、ターゲット要素、および変換によってソース要素が変換されるときに適用される規則に関する情報を提供します。変換が多数の要素を変換する場合、変換がログ・ファイルを生成している間はパフォーマンスが低下することがあります。そのため、ログ・ファイルを生成するのは、デバッグ目的の場合のみにしてください。

  12. オプション: 変換の実行中に新規ダイアログ・ボックスが開かないようにするには、「メイン」ページでサイレント・モードで前方変換を実行チェック・ボックスを選択します。

    サイレント・モードで変換を実行すると、変換によって生成されるすべてのダイアログ・ボックスが抑制されます。 変換ではデフォルトの規則と振る舞いが適用され、予期しない変換出力や不正確な変換出力が生成されることがあります。サイレント・モードでの変換の実行は、変換出力の検証ではなく、変換の実行を検証する場合のみ実行してください。例えば、自動化されたタスクや自動化されたテスト・スイートの一部として、変換をサイレント・モードで実行することがあります。

    変換がサイレント・モードで実行されるよう設定すると、指定したファイル上書きオプションがオーバーライドされ、必要に応じてファイルが上書きされます。

    UML から C# への変換が使用可能な場合、「サイレント・モードで後方変換を実行」チェック・ボックスを選択できます。サイレント・モードで UML から C# への変換、または後方変換を実行するよう指定すると、マージ・エディターが抑止されます。マージ中に競合が発生すると、変換が停止します。その場合には、サイレント・オプションをクリアして変換を再実行する必要があります。

  13. オプション: 変換のソースとターゲット間の追跡可能な関係を作成するには、「メイン」ページでトレース関係を作成チェック・ボックスを選択します。このチェック・ボックスは、混合モデリングまたは 調整されたモデリングのプロトコルを選択する場合のみ使用できます。

    トレース関係とビジュアル開発ツールを使用して、ソース・モデル要素と変換出力の関係を理解することができます。 この機能は、複数のモデルおよび変換構成を持つような大規模なプロジェクトの場合に便利です。 ソース・モデルは変換によって変更されません。

  14. オプション: 変換の実行時に発生したエラーを表示するには、「メイン」ページで変換の完了時に「レポート」ダイアログ・ボックスを開くチェック・ボックスを選択します。このチェック・ボックスを選択すると、生成されたエラーのみが表示されます。同じ情報はエラー・ログにも書き込まれます。このエラー・ログは「ウィンドウ」 > 「ビューの表示」 > 「エラー・ログ (Error Log)」の順にクリックすることで表示できます。

    変換の実行時に発生した警告を表示するには、「レポート」ダイアログ・ボックスに警告を表示チェック・ボックスを選択します。

  15. オプション: C# の要素とターゲット UML の要素の間の関連を定義するファイルを作成します。 この機能は、有効範囲が変換構成の外部であり、異なるプロジェクトに配置されている可能性のある C# 要素と UML 要素の間の関係を定義するのに役立ちます。 関連ファイルを作成するには、「C# から UML への関連」ページで、以下のステップのいずれかを実行します。
    • 「新規」をクリックしてから、ファイルの名前と場所を指定します。
    • 既存の関連ファイルを使用する場合は、参照により検索してからそれを選択します。
    • 「関連の追加」をクリックしてから、左側ペインで「すべて」を選択し、右側ペインでモデル要素を選択します。 2 つの項目が「ソースからモデルへの関連」表に表示されます。
  16. 「ファイル」 > 「保存」をクリックします。
タスクの結果
オプションは次回変換を実行したときに適用されます。

フィードバック