Show TOC

Procedure documentationActivating and Deactivating Extensions Locate this document in the navigation structure

 

This procedure describes how to choose between several extensions that are available for one extension point, and how to review the properties of an extension.

An extension point can have several extensions in the design time, but only one extension can be active at an application runtime.

Each newly created extension becomes automatically activated by the design time of the extensibility configuration framework. Additionally you can manually deactivate or activate an extension in the design time. To make it actually active at the application runtime, you need to deploy the development component (or software component) that contains it.

Procedure

Activating and Deactivating an Extension

  1. Open the product containing the desired extension in the Composite Designer perspective.

  2. Select the extension.

  3. To activate it, from the context menu, choose Activate Extension.

    The extension is marked with a special symbol as shown in the example of the conceptual topic.

  4. To deactivate it, from the context menu, choose Deactivate Extension.

    The extension is marked with a special symbol as shown in the example of the conceptual topic.

Reviewing the Properties of an Extension

  1. Select the desired extension and from the context menu, select Properties.

  2. To review general information (name, type, package, development component, software component), choose General.

  3. To review information about the extension point and the corresponding extensions, choose Extensibility and then select from the Extension Points implemented by this component field the available extension points.

    Then you can activate or deactivate them by pointing to the extension and using the context menu.

    In the Extensibility details you have a Time Stamp column, which displays the exact time of the last design time activation for each extension.

    The Runtime Activation State column displays what the extensions' runtime state would be if the listed extensions are deployed to the AS Java.

    If you activate an extension in the design time, it receives a status active. But if you do not deploy it, it will not be the one that the application runtime will use.

    To review all available statuses for an extension, see the following descriptions:

    • active

      This extension will become active for the application runtime only if the containing component is deployed.

      Note Note

      In case of team development, with several developers providing extensions for a specific extension point, only the extension with the highest time stamp in general will become active for the application. So even if you have an active extension in your workspace, it may be not the active one for the application runtime, if another person deploys an extension for the same extension point but with a newer timestamp.

      End of the note.

    • inactive

      An active extension with newer timestamp exists in your workspace. This inactive extension can potentially become the active one for the application runtime only if the real active component is not deployed at all, or is undeployed later on.

    • deactivated

      This extension cannot become active for the application runtime when deployed, even if all available active extensions are undeployed.