Acrolinx stores the configuration of the custom user and document fields in XML template files. When you update the custom fields on the Custom Fields page in the Dashboard, Acrolinx automatically updates the XML templates. Also, when you update the XML templates, Acrolinx automatically updates the information on the Custom Fields page. Instead of configuring the custom fields in the Dashboard, you can also edit these XML template files directly. This method is helpful if you generate the XML template files automatically from data in your databases. You might configure your system to generate an updated XML template file every time your system is updated with new information.
For example, suppose that your custom information forms require your users to enter their departments and the project of the checked document. The available department and project names are stored in two different databases. You now configure your system to query these databases regularly and to check if either the departments or the projects have changed. If either of these values did change, you can have your system generate a new XML template file with the updated values. This way, the custom information forms always reflect the latest updates in your organization.
Configuring the XML Template
Instead of configuring the custom fields in the Dashboard, you can also edit the relevant XML template files directly. You use the user form template to define the custom fields that you want your users to complete before they start using Acrolinx. A sample template is provided to help you get started.
To configure the custom user fields in the XML template, follow these steps:
- Open your overlay of the following file: user_meta_data_configuration.xml
Restriction: Users can’t enter more than 255 characters into text fields.
If you have installed linguistic resources with the version 2.1 or later, a sample file is installed in the common directory. You can copy the sample file, rename it to user_meta_data_configuration.xml , and update the fields based on the requirements for your organization.
If your installation doesn’t contain a sample file, create a new file called user_meta_data_configuration.xml , and add the following code excerpt to get started.
<?xml version="1.0" encoding="UTF-8"?> <metadataconfiguration> <fields> <field name="Department" default="No Department" inputType="REQUIRED" dataType="LIST"> <range> <value>No Department</value> <value>It</value> <value>Marketing</value> </range> </field> <field name="external" default="" inputType="PROVIDED_EXTERNALLY" dataType="STRING"> <range/> </field> <field name="optional" default="" inputType="OPTIONAL" dataType="STRING"> <range/> </field> </fields> </metadataconfiguration>
This sample code creates a form with dropdown fields for Department and Strategic Business Unit as well as text fields for E-mail address and Room number .
- Save your changes.
- (Optional) Clear the custom user information so that users must enter their user information again .
You might clear the custom user information if you have edited the values of a field and want users to update the new fields.