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

テキスト形式で差分を確認

概要​

プルリクエストの確認時など、Next Design外で差分をテキスト形式で確認する場合があります。
テキストはJSON形式で保存されます。ここではJSON形式の表記方法と、差分の表示について説明します。

add

備考

JSON形式での保存の注意事項はこちらを参照してください。

JSON形式でのモデル表記と読み方​

モデルと関連が記録されます。各要素は概ね下記の要素から構成されます。

モデルのJSON形式表記例​

// ユースケース「追従走行（ADAPTIVE）」の例
{
  "Id": "dfeab440-43ff-47d3-aec0-887e82b5e746",
  "EntityType": "Entity",
  "Name": "追従走行（ADAPTIVE）",
  "MetamodelId": "122fabe8-c00b-422d-be66-59e86fd79d1b",
  "Metamodel": "ユースケース",
  "Fields": {
    "Name": "追従走行（ADAPTIVE）",
    "Description": "先行車との車間距離を維持した走行。",
  }
},
  • Id
    • モデルのIDを示します。エラーのあった対象の検索や、関連の参照先などを検索する場合に利用できます。
  • EntityType
    • モデルの種別を示します。下記の値となります。
      • モデル - Entity
      • インタラクションモデルの要素 - Lifelineなど
  • Name
    • モデルの名前を示します。
  • MetamodelId
    • モデルのメタモデルのIDを示します。
  • Metamodel
    • モデルのメタモデル名を示します。
  • Fields
    • モデルのフィールド名とその値を示します。
    • 値が設定されているフィールドのみ記録されます。

関連のJSON形式表記例​

// ユースケース「追従走行（ADAPTIVE）」から任意のアクターへの関連の例
{
  "Id": "0299e2b0-2b44-47c0-b808-41ddcf643933",
  "RelationType": "Ref",
  "MetamodelId": "3a058d5b-880b-4d67-ab54-6e40f2c8a40d",
  "Metamodel": "主アクター関連",
  "SourceId": "dfeab440-43ff-47d3-aec0-887e82b5e746",
  "TargetId": "68f71941-4a9d-4ee0-afef-376c2b601f27"
},
  • Id
    • 関連のIDを示します。
  • RelationType
    • 関連の種別を示します。下記の値となります。
      • Embed - 所有関連
      • Ref - 参照関連
  • MetamodelId
    • 関連のメタモデルのIDを示します。
  • Metamodel
    • 関連のメタモデル名を示します。
  • SourceId
    • 関連元のモデルのIDを示します。
  • TargetId
    • 関連先のモデルのIDを示します。

差分の表示​

Gitクライアントによって差分の表示方法は変わりますが、基本的には変更前はオレンジ色や赤色、変更後は黄色や緑色などで差分表示されます。

備考
  • Next Designでは、フィールド名と値が並んで記録されます。
  • 値が未設定のフィールドは保存されません。

フィールド値の変更​

edit

  • 該当行で変更前後の値が差分表示されます。
  • 関連の参照先・参照元の付け替えの場合、SourceIdフィールド、TargetIdフィールドの値が更新され差分ありで表示されます。

要素の追加​

add

  • 新規に追加された要素のテキスト全体が差分ありでされます。

要素の削除​

delete

  • 要素の削除は変更前の画面でテキスト全体が差分ありで表示され、変更後の画面では空白で表示されます。
  • 別のモデルファイルの親要素へ付け替えた場合も同様に表示されます。

要素の順序変更​

reorder

  • 構造化して保存している場合、順序変更のあった要素が差分ありで表示されます(上図)。
    • この時同じテキストで差分がない部分は差分ありで表示されません。
  • 構造化して保存していない場合、SourceIndexフィールドのみが更新され差分ありで表示されます。
    • SourceIndexフィールドは、複数の要素を保持できるフィールドにおける要素の順序(何番目かを示すインデックス)を示すフィールドになります。構造化して保存していない場合に、ファイルに保存されます。
    • SourceIndexフィールドではなく、モデルの並び順で直感的に順序を把握したい場合は、構造化して保存するよう設定してください。
  • 構造化して保存に関しては、こちらを参照してください。
備考
  • テキスト形式の場合、プロファイルの差分も表示されます。前述の表示内容を踏まえて、目視で差分を確認することが可能です。

関連項目​

に最終更新