3.1. General information on template directories
Infobases are created from the templates. The templates are installed using a dedicated installer created during distribution package generation in Designer. A template is a collection of distribution files, manifest file and accompanying files used to create the infobase. For more details on distribution package generation, please refer to {HL:dev:TI000001138:the book}.
To use configurations and/or infobases as templates, they must be installed on the user computer in a particular way. All templates must be stored in subdirectories of a predefined directory, together with manifest files that describe the installed templates.
The system supports multiple template directories that can be located on local disks or on network drives. This allows you to create a unified list of template directories the users can access to install or update configurations.
By default, the template directory is called tmplts. The template directory location depends on the operating system used:
- Windows: %APPDATA%\1C\1cv8\tmplts.
- Linux: ~/.1cv8/1C/1cv8/tmplts.
- macOS: ~/.1cv8/1C/1cv8/tmplts.
Users can change location of the template directory and specify links to other directories (with arbitrary names). For a more detailed description on selecting template directories, see page . The documents describe operations with the default template directory; however, the descriptions are also fully applicable to any other template directories.
A template directory is divided into provider subdirectories each solution provider chooses a subdirectory based on their company name (for example, solutions by 1C are stored in 1C directory). Names of solution subdirectories within a provider subdirectory are not regulated. However, it is recommended to choose subdirectory names based on the corresponding solution names.
Each solution directory contains subdirectories according to versions of the solution. For example, tmplts\1C\Accounting\1.5.7.5.
It is recommended to maintain the naming arrangement to avoid confusion between providers.
The examples of configuration template installation are based provided for Windows-based computers.
3.2. Installing configuration templates
To install a configuration, you need to install its template. Download (or otherwise obtain) an archive with the installation files. Then, uncompress the archive on the computer where you plan to install the template. Then, start the executable file located in a directory with the uncompressed files:
- Windоws: setup.exe file
- Linux: setup file
- macOS: setup.app distribution package
After starting the template installer, the installation wizard will be displayed.
Fig. . Installing configurations
Select a directory to install the configuration template. The default path to the template directory is specified as follows:
- ConfigurationTemplatesLocation parameters in file 1cestart.cfg (see page ) are searched for the local template directory that the user has a permission to write. If 1cestart.cfg contains more than one parameter with such directories, the first directory will be chosen.
- If no local directories are found, a directory will be created at the default location. This directory will be used as the default template directory. Besides, the record about this directory will be specified as the first ConfigurationTemplatesLocation parameter in 1cestart.cfg.
The user can change the proposed default path and choose another directory. Then, installation of the configuration template into the specified directory is attempted. If successful, the directory is specified as the first ConfigurationTemplatesLocation parameter in 1cestart.cfg.
Fig. . Choosing the template directory
Then, the installer copies the configuration template file into the specified directory.
To skip some steps of configuration template installation, run setup.exe with /s parameter. In this case, only the startup dialog box and configuration template copying progress bar will be displayed. The configuration template directory from 1cestart.cfg file will be used (see page ). If the file does not contain information on template directory location, the default directory will be created. The path to the created directory will be set as default. Besides, the record about this directory will be specified as the first ConfigurationTemplatesLocation parameter in 1cestart.cfg.
3.3. Creating an infobase from template
To create a specific infobase using the template installed, run 1C:Enterprise and click Add….
Fig. . Adding an infobase
Then, choose an installed template (see page ) and click Next > to proceed with the installation. Creating a template tree might take a significant time.
If you choose to create the infobase from the launcher (see page ), you can use any template version (that is, 1C:Enterprise 8.0, 8.1, 8.2, or 8.3). If you choose to create the infobase from the thick client, you can only use templates of the same 1C:Enterprise version as the executable client file.
Fig. . Choosing a template
Then, select the infobase name and parameters (see page ). After this, the infobase will be created.
If you are planning to restore an infobase from dump file (*.dt) or develop a new configuration, choose Create an infobase without a configuration… in Add infobase or folder window (see ).