例 2: ReplaceAction

レイアウト上の長方形オブジェクトの高さやその他のプロパティを変更するパッチファイルを作成するには:

  1. カスタム App の v1 (MyApp-v1.fmp12) で、長方形オブジェクトをレイアウトに追加します。

  2. 「MyApp-v1.fmp12」を閉じ、--generateGUIDs サブコマンドを使用して「MyApp-v1.fmp12」をソースファイルとして Upgrade Tool を実行します。

  3. 「MyApp-v1.fmp12」を XML として保存して「MyApp-v1.xml」という名前をつけます。

  4. 「MyApp-v1.fmp12」のコピーを作成して「MyApp-v2.fmp12」という名前をつけます。

  5. 「MyApp-v2.fmp12」で、これらの長方形のプロパティを変更します:

    • レイアウトオブジェクト名

    • 高さ

    • ポップアップヘルプ

  6. 「MyApp-v2.fmp12」を閉じ、--generateGUIDs サブコマンドを使用して「MyApp-v2.fmp12」をソースファイルとして Upgrade Tool を実行します。

  7. 「MyApp-v2.fmp12」を XML として保存して「MyApp-v2.xml」という名前をつけます。

  8. 「MyApp-v1.xml」(左側) と「MyApp-v2.xml」(右側) の対応するセクションを比較します。

    長方形オブジェクトを変更して FMSaveAsXML ファイルの v1 と v2 を比較

    「MyApp-v1.xml」と「MyApp-v2.xml」の主な変更点は次のとおりです:

    • LayoutObject 要素内で、レイアウトオブジェクト名が変更されています。

    • Bounds 要素内で、長方形の下端の位置が変更されています。

    • Tooltip 要素内で、ポップアップヘルプのテキストが変更されています。

    次の重要な UUID 要素に注意してください:

    • Layout 要素内の UUID 要素は D0CB40EA で始まっています (3108 行目)。

    • LayoutObject 内の UUID 要素は F4BE7291 で始まっています (3090 行目)。

  9. これらの変更を適用するプレーンテキストのパッチファイル (v1-v2-patch.xml) を作成します。「パッチファイルについて」に記載されている最上位の構造を使用します。Structure 要素内で:

    • 1 つの Replace 子要素を持つ ReplaceAction 要素を追加します。

    • Replace 要素内では、type 属性は変更する要素名と同じで、FMSaveAsXML ファイル内で確認できます (この場合、LayoutObject)。UUID 属性は FMSaveAsXML ファイル内の変更される LayoutObject 要素の UUID 子要素と同じ値です。

    • Replace 要素内で、*Reference 要素を追加して変更するオブジェクトの親を指定します。この例では、LayoutReference です。UUID 属性には、FMSaveAsXML ファイルの Layout 要素の UUID 子要素の値を指定します。LayoutReference 要素の他の属性には、FMSaveAsXML ファイル内の Layout 要素と同じ値を指定します。

    • また、Replace 要素内で置き換えるオブジェクトの要素を追加します。この例では、LayoutObject です。オブジェクトでは、FMSaveAsXML ファイルと同じ XML を使用して必要に応じてプロパティの値を変更します。

    コピー 
    <?xml version="1.0"?>
    <FMUpgradeToolPatch version="2.2.2.0">
      <Structure>
        <ReplaceAction> 
          <!-- レイアウトオブジェクトの UUID -->
          <Replace type="LayoutObject" UUID="F4BE7291-4796-4551-AF4F-5049CA1963B0">
            <! -- レイアウトの UUID -->
            <LayoutReference id="1" name="Table" width="1024" UUID="D0CB40EA-CDB6-4A36-9E94-085CACB2C583">
            </LayoutReference>
            <LayoutObject id="1" type="Rectangle" name="長方形の名前" kind="5">
              <! -- レイアウトオブジェクトの UUID -->
              <UUID>F4BE7291-4796-4551-AF4F-5049CA1963B0</UUID>
              <Bounds top="87" left="29" bottom="139" right="86"></Bounds>
              <Options>805322752</Options>
              <Rectangle></Rectangle>
              <Tooltip>
                <Text><! [CDATA["長方形のポップアップヘルプ"]]></Text>
              </Tooltip>
            </LayoutObject>
          </Replace>
        </ReplaceAction>
      </Structure>
    </FMUpgradeToolPatch>