1. Application Developer's Guide
  2. Common Development Tasks
  3. Removing Objects

Removing Objects

If you have the necessary privileges, you can remove an object instance from a Work Area or an object definition from an Application Area or Domain. After you remove an object, the system prepends its name with a tilde (~). You can then use the original name again within the same container.

The following rules apply:

  • Object metadata is never completely removed. The system gives the definition or instance an end date but stores a record of it as it existed during the time it existed. However, when a Table instance is removed, all its data is deleted.
  • You cannot remove an object instance that has been installed and executed.
  • You cannot remove an object definition that is used as a source definition by one or more instances. You must remove the instance(s) first. If you try to remove an object definition with an instance, you receive an error message with the name of the instance object. To proactively check if a definition has instances, select Upgrade Instances from the Actions drop-down. The system displays all instances with their locations, validation statuses, and other information.
  • You cannot remove an object that contains objects that have not been deleted. This applies to Domains, Application Areas, Work Areas, Report Sets, and Workflows.

To remove objects:

  1. In the Applications tab, go to the location of the object you need to remove.

    Note:

    In the main Applications screen you can remove only one object at a time. However, if you go to the Properties screen for a Domain, Application Area, or Work Area, or the Manage Definitions screen of a Domain or Application Area, you can remove multiple objects at a time.

  2. Select one or more objects to remove.
  3. Click Remove. The system gives you a message asking you to confirm that you want to remove the selected object(s).
  4. Click Yes. The system removes the object or objects and returns you to the Application Development screen.

Parent topic: Common Development Tasks