Moving an artifact

If you restructure an existing application, use refactoring to avoid breaking dependencies and relationships.

Moving an existing artifact to a new folder can break your application if you do not also update all the dependencies that use the former folder name. If you use a refactoring operation to move an artifact, the dependencies that refer to the former location will be updated automatically after you preview and accept the changes.

You can move an artifact to a new folder within the same module or to a different module, mediation module, or library. However, not all moves will result in an error-free workspace. For example, moving a BPEL process component from one module to another could result in errors. In such cases, the wizard provides a warning that you will need to make additional adjustments.

  1. In the Business Integration view, right-click the artifact that you want to move. Hold down the Ctrl key to select additional artifacts if you want to move more than one at a time to the same location.
  2. From the pop-up menu, select Refactor > Move.
  3. In the Move Artifact wizard, select a new location for the artifact. Click the plus sign to expand the menu to see levels below modules and libraries.
  4. To see a list of the refactoring changes that will be performed, click Preview. Click the plus signs to see details. 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.
  5. Accept all the refactoring actions. Click OK to start the refactoring operation. If you clear any check boxes, those artifacts will be excluded from the refactoring operation, which will then be incomplete. Do not clear any check boxes unless you have a clear understanding of the implications of overriding that change. Refactoring operations cannot be undone 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.