Customize code with the Configuration Explorer

The Configuration Explorer is a visual interface for the Configuration service, which is a part of the Persistence package. Using the Configuration Explorer, you can change the behavior of your extensions more easily by adjusting the properties of the code, instead of modifying the code itself. Using the Configuration Explorer means less code, fewer bugs, and more control.

Because properties are scoped to the current project to which an enricher is subscribed, only members of that project can customize the enricher's behavior. Another benefit is that you can reuse some common parts of the code, routines, or even whole services, and run them parametrized. Create your own set of variables or configure the pre-defined variables to include them in your source code, and use them with other extensions, such as the Builder modules.

The Configuration Explorer allows you to define tenant-level configurations only.
The Configuration Explorer is not intended for storing passwords or sensitive data.
To find information about consuming defined properties, refer to the Configuration service documentation.

Access the Configuration Explorer

The Configuration Explorer is a part of the SAP Hybris Profile Core Services package. When you subscribe to the SAP Hybris Profile Core Services package, the system automatically enables the Configuration Explorer for Builder projects of one tenant. Follow the instructions in the Builder documentation to subscribe to this package.

Follow these steps to access the Configuration Explorer.

  1. Open the Builder.
  2. Click your project.
  3. In the left navigation menu, click Hybris Profile Developer Tools.
  4. In the left navigation menu, click Configuration Explorer.

Use the Configuration Explorer

Use the Configuration Explorer to define, edit, or remove variables for use in other extensions.

To define a new variable, follow these steps:

  1. In the Configuration Explorer, click + variable. A pop-up window titled Add a new variable appears.
  2. Enter the name of your variable in the Variable Name field.
    The name of a property must must start with a letter or a number, be between one and 36 characters long, and can contain uppercase or lowercase letters, numbers, and the following characters: -, _, ., |, @.
  3. Provide the value of your variable in the field Value.
  4. Click Add to save your changes and add the newly-defined variable. The window closes automatically and a list of your variables appears.

Edit or remove variables

You can edit or remove entries at any time. To do so, use the pencil and bin icons on the right. Click the pencil icon to edit the details of your variable, or the bin icon to remove the whole entry.