Converting a solution to a template by using the command line

Edit online

Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15

You can convert a solution to a template by using the command line. You use templates to quickly create new solutions that are based on the same design as the template. The template contains all the solution design information, but you cannot edit a template directly or create running cases from a template.

About this task

Restriction: You cannot convert a solution that contains any locked items.

Procedure

To convert a solution to a template:

Change the current directory to the install_root/CaseManagement/configure directory, where install_root is the location where Business Automation Workflow is installed.
Generate the text input file by running the following command. Do not enter any line breaks when you enter the command:
```
configmgr_cl generate_input_sa -operation convertToTemplate 
 -file input_file_name
  [-help]
```
-file input_file_name

Specifies the full path to the text input file to create. The directory structure in the path must exist. You can use any valid file name, but the .txt extension is recommended. For example, use -file C:\solutions\to_template_input.txt.

-help

Optional: Shows a brief message on the command syntax instead of running the command.
For example, the following command creates the C:\solutions\to_template_input.txt input file:
```
configmgr_cl generate_input_sa -operation createFromTemplate 
 -file C:\solutions\to_template_input.txt 
```
Edit the property values in the input_file_name file.
1. Open the input_file_name file in a text editor.
2. Provide a value for each property in the file.
  For example, enter the Content Platform Engine server WSI URL value:
```
CEWS_URI=http://myserver:9080/wsi/FNCEWS40MTOM
```
  You can specify whether unique identifiers are preserved by providing a value for the preserveIdentifier property. The default setting is preserveIdentifier=false.
  Important: For most solutions, do not change the default setting. However, if this solution contains assets that are not managed by Case Builder, such as forms or search templates whose unique identifiers are referenced by non-IBM® Business Automation Workflow programs, you might want the identifiers to be preserved. If you enter preserveIdentifier=true, do not deploy more than one solution that is made from this template to the same target object store.
3. Save and close the input file.
Apply the values in the text input file by running the following command. Do not type any line breaks when you enter the command:
```
configmgr_cl execute_sa -operation convertToTemplate 
 -file input_file_name
```