Create a custom package

Level: beginner

1. Create a package

1. Open the Configuration section. Instructions: Open the Configuration section.

2. Create a package. To do this, click in the package workspace. This opens the Package mini page.

3. Fill out the package properties.

   Property	Property description
   Name	The package name. Required. The package name cannot match the names of other packages.
   Compile into a separate assembly	The checkbox that identifies an assembly package whose source and automatically generated code is compiled into a separate assembly. Out of the box, the checkbox is selected. Learn more: Assembly package.
   Use smart activation	Available in Creatio 8.0.10 and later. The checkbox that identifies a smart activation package that combines functionality of multiple apps for compatibility between them in a single Creatio instance. Out of the box, the checkbox is cleared. Learn more: Smart activation package.
   Description	The package description. For example, package functionality details.
   Version control system repository	The name of the version control system repository that will store the package changes. Required. Only repositories from the configuration storage list that are marked as active will be available in the dropdown list. Important The Version control system repository property will become non-editable after you create the package.
   Version	The package version in the SVN repository. Required if the package is connected to an SVN repository. Fill out the property when creating a package. Otherwise, the property is non-editable. The property accepts digits, Latin characters, as well as “.” and “_” characters. The value must start with a digit or a letter. All package elements are of the same version as the package itself. The package version is not related to the version of the Creatio instance. To install the specific package version, use Application Hub.

4. Define the package dependencies if the package must inherit base Creatio functionality.

   1. Click Create and add dependencies. This opens the Package properties page.
   2. Click Add in the Depends on packages property block on the Dependencies tab. This opens the Select package modal window.
   3. Select the package/packages whose functionality must be inherited. If the package must inherit the entire Creatio functionality, set the package that follows the Custom package in the hierarchy as the parent package.
   4. Click Select.

5. Check the dependencies of the Custom package. To do this, make sure that the Custom package is listed in the Dependent Packages property block on the Dependencies tab. The Custom package must depend on all Creatio packages.

6. Apply the changes.

As a result, Creatio will save the package properties to the package metadata.

Package metadata

{
    "Descriptor": {
        "UId": "1c1443d7-87df-4b48-bfb8-cc647755c4c1",
        "PackageVersion": "8.0.10",
        "Name": "SomeCustomPackage",
        "ModifiedOnUtc": "\/Date(1522657977000)\/",
        "Maintainer": "SomeDeveloper",
        "DependsOn": []
    }
}

The Maintainer property contains information about the developer listed in the Publisher (Maintainer code) system setting.

---

See also

Creatio IDE overview

Assembly package

Smart activation package