Creating a package in the file system development mode

Introduction

If you do not intend to use SVN in the development process, then the process of creating a package is the file system development mode is the same as that in the normal mode. For more information on creating packages please refer to the “Creating and installing a package for development” article.

When the file system development mode is enabled, the SVN integration mechanism is turned off. The packages from the SVN repository can be only installed and updated with built-in tools. It is recommended to create a package with built-in tools and bind it to the repository with the external utilities like TortoiseSVN.

Package creation process

1. Create a package in the application

Select the [Add] action in the context menu of the [Packages] tab in the [Configuration] section (Fig. 1).

Fig. 1 Adding a package in the [Configuration] section

Fill out the main package properties fields in the package edit page (Fig. 2). Please see the "Creating and installing a package for development” article for details. Specify the repository name to which the package will be bound.

Fig. 2 Package summary

2. Download created package to file system

Click [Download packages to file system] (Fig. 3).

Fig. 3 [Download packages to file system] action

As a result, the empty package will be downloaded to the [Path to the installed application]\Terrasoft.WebApp\Terrasoft.Configuration\Pkg\sdkPackageInFileSystem folder (Fig. 4).

Fig. 4 Package in the file system

3. Create necessary folders for the packages in the SVN repository

Go to the repository specified in the package edit page to create folders for the package via SVN client (such as TortoiseSvn). Create a folder in the repository with the name that matches the name of the package created in the application.

Fig. 5 Creating a folder in the SVN repository

Create branches and tags sub-folders in the created folder to replicate the bpm’online flat package structure. Finally, create a folder with the name that matches the package version number (7.10.0) in the branches folder (Fig.6).

Fig. 6 Flat package structure in the repository

4. Create a working copy of the package version branch

To create a working copy of the package version branch, execute SVN checkout from the repository folder with the name that matches the package version number, to the package folder in the file system (Fig. 7) and confirm the download to the existing folder (Fig. 8).

Fig. 7 Obtaining the working copy of the package version branch from the repository

Fig. 8 Confirmation of the SVN checkout operation to the existing folder.

As a result the [Path to the installed application]\Terrasoft.WebApp\Terrasoft.Configuration\Pkg\sdkPackageInFileSystem package folder will be bound to the branch of the 7.10.0 version of the package in the repository (Fig. 9).

Fig. 9 Visual mapping of the bound of the folder with the SVN repository

5. Commit the package folder in the repository

To commit the package folder, add all the contents of the following folder to the repository: [Path to the installed application]\Terrasoft.WebApp\Terrasoft.Configuration\Pkg\sdkPackageInFileSystem. After adding the folder to the repository, execute the “Commit” command (Fig. 11).

Fig. 10 Adding a folder to the repository

Fig. 11 Committing changes to the repository

See also

• Working with SVN in the file system
• How to install an SVN package in the file system development mode
• How to bind existing package to SVN
• Updating and committing changes to the SVN from the file system
• Creation of the package and switching to the file system development mode