286/293

Extending Technology Packs and Cartridges by Renaming

You can extend technology packs and cartridges by renaming the original technology pack or cartridge and refactoring all existing objects. Oracle recommends that you use this method only when you are not able to extend the technology pack or cartridge by adding new content to your own project.

Important:

When you intend to rename a technology pack or cartridge, do not deploy the original technology pack or cartridge into UIM.

To extend technology packs and cartridges by renaming:

1. Create a backup of the technology pack or cartridge.

2. Import all dependent projects into the workspace, then import the technology pack or cartridge.

   See "Importing Projects" for more information.

3. Build the technology pack or cartridge and all dependent projects and resolve all problem markers.

   See "Building and Packaging Projects" for more information.

4. From the Studio menu, select Show Design Perspective.

5. From the Studio Projects view, double-click the Project entity for the technology pack or cartridge.

   The entity opens in the Project editor.

6. On the Properties tab, click Unseal.

   The Unseal Project confirmation dialog box appears.

7. Click OK.

8. Build the unsealed technology pack or cartridge project.

9. From the Studio Projects view, right-click the technology pack or cartridge and select Rename.

   The Refactoring dialog box appears.

   Important:

   Always rename technology packs or cartridges from the Studio Projects view.

10. In the Name field, enter a new name for the technology pack or cartridge then click Next.

    Design Studio lists all of the changes to be performed. Ensure that all of the instances are selected.

11. Click Finish and when prompted click OK.

    Design Studio closes and restarts.

12. After Design Studio reopens, build all sample and dependent cartridges and fix all problem markers.

13. Change the package reference to remove "Oracle" from the class packaging.

    Removing this reference ensures that there are no collisions at run time.

    1. From the Window menu, select Open Perspective and then select Java.

       The Java perspective appears.

    2. In the Package Explorer view, navigate to and open the cartridge src folder.

    3. Remove the Oracle reference from the class packaging.

14. (Optional) If projects in the workspace have dependencies on the original cartridge, import the original cartridge back into the workspace.