During the lifecycle of a custom Java application, based on SAP Netweaver, it happens that archive name(s) change with the new version of the software. As SAP Software logistics logic rely on archive name (to find the application components successors), there is special treatment build in the update and upgrade Java tools called refactoring
Example - existing application has version 1.x.x and the new release 2.x.x comes with different number SCAs. Some of the SCAs have changed name and, in addition, some SDAs inside were removed.
The mapping between old source (SCA/SDA) components and the new target components is done with the help of specific configuration file (.sap-refactoring) which should be packed in new target(2.x.x) SCA. You need one SCA which haven't change its name between 1.x.x and 2.x.x release which contains .sap-refactoring file. This .sap-refactoring file will describe structural changes of all you components and upgrade tool will use it to map the detected source component to the new target components.
How to delete a development component:
1. Create a file .sap-refactoring in the correct folder of your project or DC. (to create a file starting with a '.' on Windows you can use Command prompt: echo > .sap-refactoring)
2. Use following examples for .sap-refactoring and .sap-refactoring_1_0.xsd and adjust by:
3. Calculate/copy new guid, from Guid Generator (128-bit Globally unique identifier)
4. Set the textID/name to match the name of your DC
5. Set the textID/when/date to the date on which you have created this .sap-refactoring file
textID/when/date must be <= TODAY
6. Set the deleted/when/date to the date per which the delete mus become effective
deleted/when/date must be <= TODAY
deleted/when/date must be >= textID/when/date
Note: Refactoring of SCAs and SDAs is supported from SAP Netweaver 7.10 and higher releases. Which is to say - one can use .sap-refactoring when upgrading SAP Netweaver to 7.10/7.11/7.20CE/7.30, or performing update of custom components on the already mentioned releases of SAP Netweaver.