5.8.1 About Working Copies
Learn about Working Copies.
A Working Copy enables developers to create a special copy of an application, make changes in the copy, and then merge those changes back into the main development application (or Main application). Similarly, you can also merge changes from the Main application back into the Working Copy. During the export process, you can view a comparison (or diff) of the Working Copy and the Main application and then select which changes to merge.
A common use case for this feature is when you want to test some changes on a page first and then merge them back into the Main application later.
About the Comparison Process
When you compare a Working Copy to the Main application, a split YAML export is taken of both applications and a checksum is generated on the individual files. The working copy is exported with original IDs to ensure that the IDs are the same between both applications. The checksums are then compared to identify the differences between the two applications.
About the Merge Process
The merge process takes a subset of pages and shared components from a Working Copy and imports them back into the Main application. If the page or shared component exists, it is replaced. Therefore, changes in your Main application that are not in your Working Copy will be overwritten by the Working Copy merge.
Unsupported Component Types
Working Copies do not support the automatic merging of the following component types:
- Translations
- Themes
- Theme Templates
- Supporting Objects
- Application Properties
- Workspace-level components (such as App Groups, Credentials, and Remote Servers)
For unsupported component types, Oracle suggests developers merge the working Working Copy, delete it, and then manually apply the additions or changes for the unsupported component types.
Limitations of Working Copies
Limitations of Working Copies include:
- You cannot create a Working Copy of a Working Copy.
- Deleted working copy pages or Shared Components must be manually deleted in the Main application.
- Components listed as Missing may have been removed in the Working Copy or may only exist in the Main application.
Parent topic: Creating a Working Copy to Merge, Refresh, or Compare