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:

  1. Log in to the control panel (CP) server as domain administrator.

  2. 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.

  3. Open the file platform.strings.po with any text editor.

  4. 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.

  1. 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.

  1. 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.

  2. Load the new .po file into the control panel server:

  1. On the control panel server, open a command window: click Start, then click Run. In the Open text box type cmd, then click OK.

  2. In the command window, type the following three commands. Press Enter after each command:

net stop w3svc

reglangpack

net start w3svc

  1. 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.

Using custom fields

When using custom fields, keep these points in mind:

Table Name

Field Name

Unit

Ensim_WVH_Configuration.OU

CustomField1

VARCHAR(250)

Ensim_WVH_Configuration.OU

CustomField2

VARCHAR(250)