Renaming an artifact

As you develop an application, you might want to change the names of some artifacts. Use refactoring to avoid breaking dependencies.

Renaming an existing business object, interface, or other artifact can break your application if you do not also update all the dependencies that use the former name. If you rename using refactoring, the dependencies will be updated automatically after you preview and accept the changes.

To rename an artifact using refactoring:

  1. In the Business Integration view, right-click the artifact that you want to rename.
  2. From the pop-up menu, select Refactor > Rename.
  3. In the Rename Artifact wizard, type the new name. The Preview button becomes available.
    This screen capture shows the Rename Artifact wizard with the Preview button enabled.
  4. Leave the check boxes selected. To see the refactoring actions that will be performed to complete the name change across the application, click Preview. If you try to refactor while you have unsaved changes in an editor, you will be prompted to save the changes in the editor. Save the changes if you are sure you want to do so, or click Cancel to reconsider the changes before saving the editors and refactoring. Once you click Preview, a new page opens that shows the refactoring actions that will be performed to complete the renaming and update the dependencies across the application. Click the plus signs to see details.
  5. Accept all the refactoring actions. Click OK to initiate the refactoring operation or Cancel to close the wizard without making the change. Be aware that you cannot undo a refactoring operation once it is performed except by refactoring again. The status bar shows that the workspace is being updated. It clears when the refactoring operation finishes.

Feedback
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.