Show TOC

 SwitchLocate this document in the navigation structure


A switch is a repository object whose state determines:

  • If an enhancement object is active and can be used in the system
  • The visibility of maintenance views within a view cluster and view fields in maintenance views
  • The visibility of screen fields and the calling of modules in the flow logic of dynpros.

A switch is the technical level of switching objects on and off.


You use a switch to control the behavior of the objects assigned to it.


A switch can have one of the following possible states: ON, OFF, or STANDBY. This states determine the behavior of the switchable repository objects. For more information, see Switch States .

Note For all repository objects, when you create or change a switch, an inactive switch version is always created which you then have to activate. Activating a switch is different from switching it on.

You can assign switches to business functions as well as to objects that cannot be included in a package. You assign switches to these objects by assigning them directly in the respective tools. For example, in the Screen Painter, you assign switches to screen fields.

In the switch definition, you assign packages to a switch. By assigning a package to a switch, you also assign the development objects in that package. In that way, each object is assigned to a switch through the package assignment.


When a package is assigned to a switch, the behavior of the non-switchable repository objects of that package remains unaffected.

Switches and Nested Packages

You can assign several packages to one switch but cannot assign the same package to several switches.

If a package with subpackages is assigned to a switch, the switch applies to the subpackages as well as to the package. A subpackage cannot be assigned to a switch if a higher-level package is already assigned to a switch.

Assigning Nested Packages to Switches


To find out if a repository object is assigned to a switch, you need to check the package that contains the object. If no switch is assigned to the object through its own package or a higher-level package, the object is regarded as switched on.

See also:

Conflicts and Conflict Switches

Switchable Units

Business Function Set

Business Function