Site-wide Custom Field Configuration¶
Custom fields can be configured through XML configuration files. This is useful if you wish to deploy a shared set of custom fields throughout your organization. Multiple configuration files can be deployed in this manner.
Configuration location for individual users¶
To deploy a custom field configuration for a single user, deploy an XML configuration file (documented below) in:
%appdata%\Algenta\Colectica\CustomFields\
Colectica will look for any XML files in the directory and will inspect them for custom field definitions.
Configuration location for all users¶
To deploy a custom field configuration for all users on a machine, deploy an XML configuration file (documented below) in:
%programdata%\Algenta\Colectica\CustomFields\
Colectica will look for any XML files in the directory and will inspect them for custom field definitions.
Configuration file format¶
The custom field configuration file is a simple XML format. The quickest way to create the configuration file is to use Colectica Express or Colectica Designer to create custom fields, and then copy the contents of the default custom field configuration file. The location of this file is:
%appdata%\Algenta\Colectica\CustomFields.xml
A sample file may look like this:
<?xml version="1.0" encoding="utf-8"?>
<CustomFieldDefinitionList>
<CustomFieldDefinition DefinedTypeId="f0b69d49-9596-40b6-a3fa-e99d6ad6065b"
ItemType="30ea0200-7121-4f01-8d21-a931a182b86d"
ValueType="String">
<Title lang="en-US">CustomFieldTitle</Title>
<Description lang="en-US">Description of the custom field.</Description>
</CustomFieldDefinition>
<CustomFieldDefinition DefinedTypeId="f964a067-5716-4cd4-a498-fd74c1c781f8"
ItemType="683889c6-f74b-4d5e-92ed-908c0a42bb2d"
ValueType="MultilingualString">
<Title lang="en-US">SecondCustomField</Title>
<Description lang="en-US">Another custom field.</Description>
</CustomFieldDefinition>
</CustomFieldDefinitionList>
Valid values for ValueType are String, MultilingualString, and Uri.