5.7 マージ、リフレッシュまたは比較のための作業用コピーの作成

アプリケーションの作業用コピーを作成して、変更をマージ、リフレッシュまたは比較します。

• 作業用コピーについて
  作業用コピーについて説明します。
• アプリケーションの作業用コピーの作成
  アプリケーションのホームページで、アプリケーションの作業用コピーを作成します。
• 作業用コピーのメニューとタスクについて
  「作業用コピー」で使用可能なメニューおよびタスクについて説明します。
• 作業用コピーの表示と編集
  アプリケーションの作業用コピーを表示および編集します。
• 作業用コピーとメインの間の変更の比較
  作業用コピーとメイン・アプリケーションの間で変更を比較します。
• 作業用コピーからメインへの変更のマージ
  作業用コピーからメイン・アプリケーションに変更をマージします。
• メインからの変更による作業用コピーのリフレッシュ
  メイン・アプリケーションの変更内容によって作業用コピーをリフレッシュします。
• 作業用コピーの削除
  作業用コピーのコピーを削除します。
• 作業用コピーの詳細の表示または編集
  作業用コピーの名前または作業用コピーの詳細の説明を表示または編集します。

5.7.1 作業用コピーについて

作業用コピーについて説明します。

作業用コピーを使用すると、開発者はアプリケーションの特殊なコピーを作成し、そのコピーに変更を加え、その変更をメインの開発アプリケーション(メイン・アプリケーション)にマージできます。同様に、メイン・アプリケーションから作業用コピーに変更内容をマージすることもできます。エクスポート・プロセス中に、作業用コピーとメイン・アプリケーションの比較(または差分)を表示して、マージする変更を選択できます。

この機能の一般的なユース・ケースは、最初にページで変更をテストしてから、その変更をメイン・アプリケーションにマージして戻す場合です。

比較プロセスについて

作業用コピーをメイン・アプリケーションと比較すると、両方のアプリケーションの分割YAMLエクスポートが取得され、個別のファイルにチェックサムが生成されます。作業用コピーは元のIDでエクスポートされ、両方のアプリケーションでIDが同じことを保証します。その後、チェックサムが比較され、2つのアプリケーションの差異が識別されます。

マージ・プロセスについて

マージ・プロセスでは、作業用コピーからページと共有コンポーネントのサブセットを取得して、それらをメイン・アプリケーションにインポートします。ページまたは共有コンポーネントが存在する場合は、置き換えられます。そのため、作業用コピーに含まれていないメイン・アプリケーションの変更は、作業用コピーのマージによって上書きされます。

サポートされていないコンポーネント・タイプ

次のコンポーネント・タイプの自動マージは、作業用コピーではサポートされていません

• 翻訳
• テーマ
• テーマ・テンプレート
• サポートするオブジェクト
• アプリケーションのプロパティ
• ワークスペースレベルのコンポーネント(アプリケーション・グループ、資格証明、リモート・サーバーなど)

サポートされていないコンポーネント・タイプについて、Oracleの提案は、開発者が作業用コピーをマージし、その作業用コピーを削除してから、サポートされていないコンポーネント・タイプの追加または変更を手動で適用することです。

作業用コピーの制限

作業用コピーには、次のような制限があります:

• 作業用コピーの作業用コピーは作成できません。
• 削除した作業用コピーのページまたは共有コンポーネントは、メイン・アプリケーションで手動で削除する必要があります。
• 欠落としてリストされたコンポーネントは、作業用コピーで削除されているか、メイン・アプリケーションにのみ存在している可能性があります。

5.7.2 アプリケーションの作業用コピーの作成

アプリケーションのホームページで、アプリケーションの作業用コピーを作成します。

アプリケーションの作業用コピーを作成するには:

1. アプリケーションを表示します:
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
      アプリケーションのホームページが表示されます。
2. アプリケーションのホームページで、サイド・バーにある「作業用コピーのタスク」を見つけます。
   
   

   
   図creating_working_copy_app_home.pngの説明

   
   
3. 「作業用コピーのタスク」で、「作業用コピーの作成」をクリックします。

   作業用コピーの作成ウィザードが表示されます。

4. 「作業用コピーの作成」で、次のように操作します:
   1. 名前 - 作業用コピーの短縮名または識別子を入力します。
   2. 作業用コピーの説明 - 作業用コピーの説明または目的を入力します。
   3. 「作業用コピーの作成」をクリックします。

      アプリケーションのホームページが表示されます。アプリケーション名の横に、前の手順で定義した「作業用コピー名」が表示されます。

5.7.3 作業用コピーのメニューとタスクについて

「作業用コピー」で使用可能なメニューおよびタスクについて説明します。

アプリケーションのホームページの作業用コピー・メニュー

アプリケーションのホームページで作業用コピーを表示すると、作業用コピーの名前がアプリケーション名の横に表示され、「作業用コピー: 名前」メニューが「共有コンポーネント」と「ページの編集」の間のメニュー・バーに表示されます。

図working_copy_menus_app_home.pngの説明

「作業用コピー: 名前」メニューのオプションは次のとおりです:

• メインに切替え - メイン・アプリケーションへのリンクです。
• 作業用コピー - 既存の作業用コピーへのリンクを表示します。
• メインにマージ - 作業用コピーからメイン・アプリケーションに変更をマージします。
• 作業用コピーのリフレッシュ - メイン・アプリケーションから作業用コピーに変更をインポートします。
• 変更の比較 - 作業用コピーとメイン・アプリケーションの変更を比較します。
• 作業用コピーの詳細の表示 - 作業用コピーの名前または説明を表示または編集します。
• 作業用コピーの削除 - 現在の作業用コピーを削除します。

アプリケーションのホームページのサイドバーには、次の通常的に使用されるオプションへのリンクがあります:

• 作業用コピーのタスク:
  • メインとマージ
  • 作業用コピーのリフレッシュ
  • 変更の比較。
• メイン・アプリケーション - メイン・アプリケーションへのリンクを含めます。

ページ・デザイナでの作業用コピーの表示

「作業用コピー: 名前」メニューは、「ページ・デザイナ」ツールバーの「共有コンポーネント」と「保存」の間にも表示されます。このメニューには、アプリケーションのホーム・ページで利用可能なオプションと前述のオプションがあります。

図working_copy_menus_page_designer.pngの説明

ヒント:

「作業用コピー: 名前」メニュー・オプションのほとんどの使用方法の詳細は、このトピックの後半で説明します。

5.7.4 作業用コピーの表示と編集

アプリケーションの作業用コピーを表示および編集します。

作業用コピーを表示または編集するには:

1. メイン・アプリケーションを表示します:
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

      アプリケーション・ビルダーのホームページが表示されます。

      アプリケーションに作業用コピーがある場合は、アプリケーションのホームページに作業用コピーの数が表示されます。レポート・ビューには、「作業用コピー」列が表示され、作業用コピーの数が表示されます。アイコン・ビューでは、作業用コピーの数がアイコンの右側にあるアプリケーション名の下に表示されます。

   2. まだ選択していない場合は、「アイコン」ビューに変更します。ナビゲーション・バーで、「アイコンの表示」をクリックします。
   
   

   
   図working_copy_workspace_home.pngの説明

   
   
2. 表示する作業用コピーのあるアプリケーションを選択します。

   作業用コピー・アプリケーションのホームページが表示されます。

3. サイド・バーの「作業用コピー」で、表示するコピーを選択します。

   アプリケーションのホームページが表示されます。作業用コピーの名前がアプリケーション名の横に表示されます。

4. 作業用コピーに変更を加えます。

   ヒント:

   作業用コピーで使用可能なすべてのオプションの詳細は、「作業用コピーのメニューとタスクについて」を参照してください。

関連項目:

• 作業用コピーからメインへの変更のマージ
• メインからの変更による作業用コピーのリフレッシュ

5.7.5 作業用コピーとメインの間の変更の比較

作業用コピーとメイン・アプリケーションの間で変更を比較します。

作業用コピーの変更をメイン・アプリケーションと比較することで、変更、追加または欠落している内容を要約するダイアログが表示されます。

ノート:

実際に変更をマージまたはリフレッシュする場合は、「作業用コピーからメインへの変更のマージ」と「メインからの変更による作業用コピーのリフレッシュ」を参照してください。

作業用コピーとメイン・アプリケーションの間で変更内容を比較するには:

1. 作業用コピーを表示します:
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
      アプリケーション・ビルダーのホームページが表示されます。
   2. まだ選択していない場合は、「アイコン」ビューに変更します。ナビゲーション・バーで、「アイコンの表示」をクリックします。
   3. メイン・アプリケーションを選択します。
      アプリケーションのホームページが表示されます。
   4. サイド・バーの「作業用コピー」で、表示するコピーを選択します。
      作業用コピーが表示されます。作業用コピーの名前がアプリケーション名の横に表示されます。
2. 「作業用コピー: 名前」メニューをクリックして、「変更の比較」を選択します。

   ノート:

   サイド・バーから「変更の比較」を選択することもできます。また、ページ・デザイナでページを表示している場合は、「作業用コピー: 名前」メニューをクリックし、「変更の比較」を選択します。

   アプリケーション・ビルダーは、メイン・アプリケーションと作業用コピーをエクスポートし、この2つのバージョンを比較します。プロジェクト名 とメインの比較ダイアログが表示され、変更内容、追加内容、欠落しているものの概要が示されます。

   
   

   
   図compare_working_copy_and_main.pngの説明

   
   
3. 変更の差分を表示するには、「変更の比較」アイコンをクリックします。
   「差分の表示」ウィンドウが表示されます。このウィンドウを終了するには、「閉じる」をクリックします。

5.7.6 作業用コピーからメインへの変更のマージ

作業用コピーからメイン・アプリケーションに変更をマージします。

作業用コピーからメイン・アプリケーションに変更をマージするには:

1. 作業用コピーを表示します:
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
      アプリケーション・ビルダーのホームページが表示されます。
   2. メイン・アプリケーションを選択します。
      アプリケーションのホームページが表示されます。
   3. サイド・バーの「作業用コピー」で、表示するコピーを選択します。
      作業用コピーが表示されます。作業用コピーの名前がアプリケーション名の横に表示されます。
2. 作業用コピーに変更を加えます。
3. メイン・アプリケーションに変更をマージするには:
   1. 「作業用コピー: 名前」メニューをクリックして、「メインにマージ」を選択します。

      ヒント:

      また、サイド・バーから「メインにマージ」を選択することもできます。また、ページ・デザイナでページを表示している場合は、「作業用コピー:名前」メニューをクリックし、「メインにマージ」を選択します。

      アプリケーション・ビルダーは、メイン・アプリケーションと作業用コピーをエクスポートし、その2つのバージョンを比較します。プロジェクト名をメインにマージ・ダイアログが表示され、変更内容、追加内容、欠落しているものの概要が示されます。

      
      

      
      図merge_working_copy_into_main1.pngの説明

      
      
   2. 変更の差分を表示するには、「変更の比較」アイコンをクリックします。
      「差分の表示」ウィンドウが表示されます。このウィンドウを終了するには、「閉じる」をクリックします。
   3. 変更を除外する場合は、行の選択を解除します。
   4. 続行するには、「次へ」をクリックします。

      マージ プロジェクト名 メインにダイアログに、次の2つの新しいオプションが表示されます:

      • 最初にターゲット・アプリケーションをバックアップ
      • マージ後に作業用コピーを削除

      
      

      
      図merge_working_copy_into_main2.pngの説明

      
      
   5. 「最初にターゲット・アプリケーションをバックアップ」と「マージ後に作業用コピーを削除」を必要に応じて構成し、「マージの確認」をクリックします。

      アプリケーションのホームページが表示され、次のメッセージが示されます:

      変更は正常にマージされました。

5.7.7 メインからの変更による作業用コピーのリフレッシュ

メイン・アプリケーションの変更内容によって作業用コピーをリフレッシュします。

作業用コピーのリフレッシュにより、メイン・アプリケーションからの変更が作業用コピーにエクスポートされます。

作業用コピーをリフレッシュするには:

1. 作業用コピーを表示します:
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
      アプリケーション・ビルダーのホームページが表示されます。
   2. まだ選択していない場合は、「アイコン」ビューに変更します。ナビゲーション・バーで、「アイコンの表示」をクリックします。
   3. メイン・アプリケーションを選択します。
      アプリケーションのホームページが表示されます。
   4. サイド・バーの「作業用コピー」で、表示するコピーを選択します。
      作業用コピーが表示されます。作業用コピーの名前がアプリケーション名の横に表示されます。
2. メイン・アプリケーションの変更内容によって作業用コピーをリフレッシュするには:
   1. メニュー・バーの「作業用コピー: 名前」メニューをクリックして、「作業用コピーのリフレッシュ」を選択します。

      ヒント:

      また、サイド・バーから「作業用コピーのリフレッシュ」を選択することもできます。また、ページ・デザイナでページを表示している場合は、「作業用コピー:名前」メニューをクリックし、「作業用コピーのリフレッシュ」を選択します。

      アプリケーション・ビルダーは、メイン・アプリケーションから作業用コピーに変更内容をエクスポートし、その2つのバージョンを比較します。名前をメインからリフレッシュ・ダイアログが表示され、変更内容、追加内容、欠落しているものの概要が示されます。

   2. 変更の差分を表示するには、「変更の比較」アイコンをクリックします。
      「差分の表示」ウィンドウが表示されます。このウィンドウを終了するには、「閉じる」をクリックします。
   3. 変更を除外する場合は、行の選択を解除します。
   4. 続行するには、「次へ」をクリックします。

      次の新しいオプションが表示されます:

      • 最初にターゲット・アプリケーションをバックアップ
   5. 「最初にターゲット・アプリケーションをバックアップ」を必要に応じて構成し、「リフレッシュの確認」をクリックします。

      アプリケーションのホームページが表示され、次のメッセージが示されます:

      変更は正常にリフレッシュされました。

5.7.8 作業用コピーの削除

作業用コピーのコピーを削除します。

作業用コピーを削除するには:

1. 作業用コピーを表示します:
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
      アプリケーション・ビルダーのホームページが表示されます。
   2. まだ選択していない場合は、「アイコン」ビューに変更します。ナビゲーション・バーで、「アイコンの表示」をクリックします。
   3. メイン・アプリケーションを選択します。
      アプリケーションのホームページが表示されます。
   4. サイド・バーの「作業用コピー」で、表示するコピーを選択します。
      作業用コピーが表示されます。作業用コピーの名前がアプリケーション名の横に表示されます。
2. メニュー・バーの「作業用コピー: 名前」メニューをクリックして、「作業用コピーの削除」を選択します。
3. 「作業用コピーの削除」ダイアログで、「作業用コピーの削除」をクリックします。

5.7.9 作業用コピーの詳細の表示または編集

作業用コピーの名前または作業用コピーの詳細の説明を表示または編集します。

作業用コピーの詳細を表示または編集するには:

1. 作業用コピーを表示します:
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
      アプリケーション・ビルダーのホームページが表示されます。
   2. まだ選択していない場合は、「アイコン」ビューに変更します。ナビゲーション・バーで、「アイコンの表示」をクリックします。
   3. メイン・アプリケーションを選択します。
      アプリケーションのホームページが表示されます。
   4. サイド・バーの「作業用コピー」で、表示するコピーを選択します。
      「作業用コピーの詳細」ダイアログが表示されます。
2. 「作業用コピーの詳細」で、次のようにします:
   1. 名前 - 作業用コピー・アプリケーションの短縮名または識別子を入力します。
   2. 作業用コピーの説明 - 作業用コピー・アプリケーションの説明または目的を入力します。
   3. 「変更の適用」をクリックして、変更を保存します。