Customizing the add organization wizard
You can add custom fields to the add organization wizard in the service provider and reseller control panels. This makes it possible to capture billing or other special information when you add organizations.
To add custom fields, you need to modify the file that displays wizard information. This file contains the text strings used in Ensim Unify control panel. These strings are stored as key-value sets. The key represents the unique ID of the message (msgid) and the value (msgstr) contains the actual message displayed in control panels. The file is stored on the control panel server in the following directory: C:\Program Files\Ensim\Ensim Unify\cp\resources\en-US\.
After you modify the file, custom fields are displayed on the first page of the add organization wizard in the service provider and reseller control panels. Users can type up to 250 characters in custom fields.
To add or change custom fields:
Log in to the control panel (CP) server as domain administrator.
Go to the C:\Program Files\Ensim\Ensim Unify\cp\resources\en-US\ directory and copy the file named platform.strings.po into another directory for editing. You might want to save an additional copy of the file for future reference.
Open the file platform.strings.po with any text editor.
Do not change the message identifiers, such as MSGID_22B6AE14, in the .po file. These identifiers determine where text strings are displayed in control panels. Changing them prevents the system from displaying them correctly.
Search for the following message identifiers, then add text between the quotation marks in the msgstr lines below them. This text becomes the label of the field. Any combination of characters and spaces is allowed in the label.
msgid "MSGID_22B6AE14". This ID adds a title.
msgid "MSGID_13E31329". This ID adds a field.
msgid "MSGID_252ADB69". This ID adds a second field.
All fields are optional. If you do not want a title field, for example, do not add any text between the two quotation marks following msgstr below msgid "MSGID_22B6AE14". By default, custom fields are empty ("") and are not displayed.
Save the modified file as platform.strings.po and copy it to the C:\Program Files\Ensim\Ensim Unify\cp\resources\en-US\ directory to replace the existing version of the file.
Load the new .po file into the control panel server:
On the control panel server, open a command window: click Start, then click Run. In the Open text box type cmd, then click OK.
In the command window, type the following three commands. Press Enter after each command:
net stop w3svc
reglangpack
net start w3svc
To see the changes, log in to the service provider control panel, then start the add organization wizard. Custom fields appear on the first page of the wizard.
When using custom fields, keep these points in mind:
By default, custom fields are not displayed.
When you add custom fields, they appear on the first page of the add organization wizard in both the service provider and reseller control panels.
Users can type up to 250 characters in custom fields.
Input from custom fields is displayed on the organization overview page and when you edit organization information in the service provider and reseller control panels.
Input from custom fields is not displayed in the organization or user control panels.
Custom fields are always optional in the add organization wizard; you cannot make them required fields.
You can change information added through custom fields by changing the organization's information at any time.
You can change the custom fields at any time by repeating the steps above.
If you add custom fields after you have added an organization, you can update the organization's information to include the new fields.
Information collected through custom fields is stored in the Ensim Unify database in the following format:
Table Name |
Field Name |
Unit |
Ensim_WVH_Configuration.OU |
CustomField1 |
VARCHAR(250) |
Ensim_WVH_Configuration.OU |
CustomField2 |
VARCHAR(250) |