Set up the app metadata

All Creatio products

Creatio version 8.0.2 and later can store app metadata.

In this case, metadata is app details stored within the app itself regardless of an environment.

App metadata stores the following parameters:

  • icon
  • icon color
  • name
  • description
  • code

Set up the parameter values in the Application Hub. You can fill out the parameters only when you create an app, but you can change them at any moment.

Attention. The code is generated on app creation and cannot be changed later.

Fill out the app metadata 

Fill out the corresponding app parameters when you create an app. Learn more in a separate article: Create a custom app.

Since Creatio version 8.0.3, the app name can contain between 3 and 100 characters. You can use any alphanumeric and special characters.

Creatio generates the code based on the app name. Code generation has the following special features:

  • To generate the code, at least 3 characters from the app name suitable for code generation are required. If the app name contains multiple spaces, Creatio removes them from the code and formats the code in camelcase. For example, the code of the “Financial benefits” app is “UsrFinancialBenef.”
  • If the app name contains fewer than 3 characters suitable for code generation, Creatio generates the code in the format of “AppUsr_gfgvd08j.”
  • If you change the app name, Creatio updates the code accordingly. You can edit the code manually when you create an app. In this case, Creatio does not update the code on further name changes. After you create an app, it is not possible to change its code.

Creatio displays the specified parameter values both in the development environment and any other environment where you install the app (Fig. 1).

Fig. 1 Metadata of the Financial benefits app

Change the app metadata 

You can change the app metadata only in the development environment. To do this:

  1. Click btn_system_designer_1.png in the top right → “Application Hub.”
  2. Open the “Financial benefits” app.
  3. Click and edit the app parameters. For example, name and icon color (Fig. 2).

    Fig. 2 Change the metadata of the Financial benefits app
  4. Specify the name of your company in the Developer parameter.
  5. Save the changes.

As a result, the app will display the changed parameter values in the development environment. When you install the app into or update it in any environment, Creatio updates the metadata (Fig. 3).

Fig. 3 Metadata of the Payroll app