第3章 XML ルールの作成
3.1. XML ルール構造 リンクのコピーリンクがクリップボードにコピーされました!
このセクションでは、XML ルールの基本構造を説明します。すべての XML ルールは、rulesets 内の要素として定義されます。詳細は、MTR XML ルールスキーマ を参照してください。
3.1.1. Rulesets リンクのコピーリンクがクリップボードにコピーされました!
ルールセットとは、特定の移行領域をターゲットとする 1 つ以上のルールのグループです。これは <ruleset>
要素の基本構造です。
<ruleset id="<UNIQUE_RULESET_ID>">: これを MTR ルールセットとして定義し、一意のルールセット ID を指定します。
<metadata>: ルールセットに関するメタデータ。
- <description>: ルールセットの説明。
- <dependencies/>: このルールセットで必要なルールアドオン。
- <sourceTechnology/>: ソーステクノロジー。
- <targetTechnology/>: ターゲットテクノロジー。
<overrideRules/>:
true
に設定した場合は、MTR で配布されるコアルールセットと同じ ID で、このルールセットのルールを上書きします。ルールセット ID とルール ID の両方がコアルールセット内のルールと一致する必要があり、ルールは無視されます。さらに、このルールセットのターゲットテクノロジーは、分析を実行するために指定したターゲットの 1 つと一致させる必要があります。デフォルトは
false
です。
<rules>: 個々のルールのセット。
<rule id="<UNIQUE_RULE_ID>"> ルールを定義して、一意の ID を指定します。ルール ID の一部としてルールセット ID を含めることが推奨されます (例:
<UNIQUE_RULESET_ID_UNIQUE_RULE_ID>
)。ルールセットには 1 つ以上のルールを定義できます。- <when>: 照合する条件。
- <perform>: ルール条件が一致したときに実行されるアクション。
-
<otherwise>: ルール条件が一致しない場合に実行されるアクション。この要素は、
<perform>
要素と同じ子要素を取ります。 - <where>: パラメーターとして定義される文字列パターン。このパターンは、ルール定義の他の場所で使用できます。
- <file-mapping/>: エクステンションをグラフタイプにマップします。
- <package-mapping/>: パッケージパターン (正規表現) から組織名にマッピングします。
3.1.2. 事前定義されたルール リンクのコピーリンクがクリップボードにコピーされました!
MTR は、一般的な移行要件に事前定義されたルールを提供します。これらのコア MTR ルールは、MTR インストールの <MTR_HOME>/rules/migration-core/
にあります。
以下は、プロプライエタリーユーティリティークラスで一致するコア MTR ルールの例になります。