Skip to content

Create Application Configuration Package

Packages are created in the Application Configuration Package page in Solution Manager. Click new and enter a package name, a description and an author.

The Package Name must be unique. Also consider choosing a name that will not conflict with packages in environments where this will be installed. Both the name and description can be changed later on if needed.
Author should describe the party that develops the package. If all packages are created locally without involvement from any vendor the user name can be set as Author. Note that Author may not be modified once the package is created.

There is also the ability in some cases to create a package when you are about to add an item to a package. Instead of selecting an existing package you select the option to create a new package and enter the name of the package. The description of the package can be entered later in the Application Configuration Packagepage.

Add items to the package

There are several ways to add items to a package. These different ways are describe below.

An item can only belong to one package. If there is a central configuration item that should really be used by two different packages the easiest solution is to have it in a third package that the other two packages are dependent of. In all cases when adding items to a package you will only be able to add items that are not already in a package. So the selection of items to choose from will not list items that already belongs to a package.

Some configuration items are dependent of other configuration items. For example a Custom Page is always dependent of a Custom Entity. See the reference page for configuration item dependencies. For some configuration item types, such dependencies are handled and also the related item is added unless it is already in another package.

Add item in Application Configuration Package

  • Click '+' on Items in the Application Configuration Package page.
  • Select the type of item to add.
  • Select the item from the list.
  • Select the item and click OK.

Note: Custom Attributes in a standard Entity are considered as individual objects. Therefore those Custom Attributes can be added to different Application Configuration Packages separately. But since a Custom Entity and its Attributes are considered as one single unit, the entire Custom Entity has to be added to the Application Configuration Package.

Add item from the Configuration Items page

  • Open the Configuration Items page
  • This shows all available configuration items. You may search for any specific Configuration Item using the Search. If a certain Configuration Item is already part of an ACP, then that ACP is shown for that specific Configuration Item in the column 'ACP'
  • Select the items you want to add to a package
  • Select Application Configuration Package -> Add To Package command
  • Now select what package these should be added. You may either select an existing ACP or create a new one

In the Configuration Items page, where you can see all configuration items, it is very easy to add several items of different types to the same package.

NB!There are configuration item types that are not supported by Application Configuration Packages. These cannot be added to a package. Only implemented types have the "Add to package" menu item.

Remove items from package

Items can be removed from a package in two ways, either from the Application Configuration Package page or from the Configuration Items page. After removing the item from the package the Configuration Item still exists but no longer belong to the package.

Remove in Application Configuration Administration page

In the Application Configuration Administration page simply select the items to remove from the package and delete.

Remove in Configuration Item administration pages

In the Configuration Item administration pages select the items and select Application Configuration Package / Remove from package command

Note: A Configuration Item cannot be removed if it is added to a package. To remove the Configuration Item it must always be removed from the package first.

Translate configuration items

In addition to the translation support provided in different configuration layer administration pages, it is also possible to add or update translations for configuration items in the Application Configuration Package page.

  • Select Manage Translations from the command list OR
  • Open the Application Configuration package and select the relevant configuration item from the Items list.
  • Then, select Manage Translations from the command list.

This will open up the Translatable Text page for that particular item.