proc_configuring-the-templatesync-plugin.adoc

Configuring the TemplateSync Plug-in

In the {ProjectWebUI}, navigate to Administer > Settings > TemplateSync to configure the plug-in. The following table explains the attributes behavior. Note that some attributes are used only for importing or exporting tasks.

Table 1. Synchronizing Templates Plug-in configuration

Parameter	API parameter name	Meaning on importing	Meaning on exporting
Associate	associate Accepted values: always, new, never	Associates templates with OS, Organization, and Location based on metadata.	N/A
Branch	branch	Specifies the default branch in Git repository to read from.	Specifies the default branch in Git repository to write to.
Dirname	dirname	Specifies the subdirectory under the repository to read from.	Specifies the subdirectory under the repository to write to.
Filter	filter	Imports only templates with names that match this regular expression.	Exports only templates with names that match this regular expression.
Force import	force	Imported templates overwrite locked templates with the same name.	N/A
Lock templates	lock	Do not overwrite existing templates when you import a new template with the same name, unless Force import is enabled.	N/A
Metadata export mode	metadata_export_mode Accepted values: refresh, keep, remove	N/A	Defines how metadata is handled when exporting: Refresh — remove existing metadata from the template content and generate new metadata based on current assignments and attributes. Keep — retain the existing metadata. Remove — export template without metadata. Useful if you want to add metadata manually.
Negate	negate Accepted values: true, false	Imports templates ignoring the filter attribute.	Exports templates ignoring the filter attribute.
Prefix	prefix	Adds specified string to the beginning of the template if the template name does not start with the prefix already.	N/A
Repo	repo	Defines the path to the repository to synchronize from.	Defines the path to a repository to export to.
Verbosity	verbose Accepted values: true, false	Enables writing verbose messages to the logs for this action.	N/A