Skip to main content
Version: 8.2All Creatio products

Set up the app properties

App properties is details stored within the app itself regardless of an environment.

App properties includes the following data:

  • icon
  • icon color
  • name
  • description
  • code
  • app default page
  • version
  • developer

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.

Important

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

Fill out the app properties​

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

The app name can contain between 3 and 100 characters. You can use any alphanumeric and special characters.

The app code is used as the app ID. Also, the code is used in app schema names.

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

  • Use at least one Latin word in the title since the code can contain only digits and Latin characters.
  • 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 "UsrFinancialBenefits."
  • 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.

If the code and unique ID of the app to install matches the code and unique ID of an existing app, Creatio updates the existing app. If the code of the app to install matches the code of an existing app but the unique ID differs, the app installation ends with an error. For example, if you have the Test ("UsrTest" code) app created on your Creatio instance, the Test ("UsrTest" code) app created on another Creatio instance will not be installed to your instance.

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

Fig. 1 Properties of the Financial benefits app
Fig. 1 Properties of the Financial benefits app

Change the app properties​

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

  1. Open the Application Hub. To do this, click in the top right → Application Hub.

  2. Open the app. For example, Financial benefits app.

  3. Open the app properties. To do this, click .

  4. Edit the app properties. For example, name and icon color (Fig. 2).

    Fig. 2 Change the properties of the Financial benefits app
    Fig. 2 Change the properties of the Financial benefits app

  5. Specify the name of your company in the Developer parameter.

  6. 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 app properties (Fig. 3).

Fig. 3 Properties of the Payroll app
Fig. 3 Properties of the Payroll app

Change the app start page​

note

This functionality is available for Creatio 8.1.2 and later.

Creatio lets you change the start page to open in a self-developed app when you click the Run app button in the No-Code Designer. You can use a list page or homepage as the start page. You can use schemas only from the current app when configuring the start page.

If you configure the app start page, Creatio opens it when you click the Run app button. Otherwise, Creatio uses the following priority to open pages:

  • homepage
  • section list page
  • "ViewModule.aspx" page or desktop page.

To change the app start page:

  1. Open the Application Hub. To do this, Click in the top right → Application Hub.

  2. Open the app. For example, Financial benefits app that includes Financial benefits and Payroll sections.

  3. Open the app properties. To do this, click .

  4. Change the app start page in the App default page field. For example, "Payroll (Freedom UI)" (Fig. 4).

    Fig. 4 Properties of the Financial benefits app
    Fig. 4 Properties of the Financial benefits app

  5. Save the changes.

As a result, when you click the Run app button in the No-Code Designer for the Financial benefits app, Creatio will open the Payroll section list page (Fig. 5).

Fig. 5 Start page of the Financial benefits app
Fig. 5 Start page of the Financial benefits app

See also​

Manage apps

Environments (developer documentation)

Store app data