Customizing › Web Interface Customization › HTML Templates (HTMPL Form) › HTMPL Directories

HTMPL Directories

The Administration Guide describes the web interfaces supplied with CA SDM. There are different sets of HTMPL files supplied to implement these interfaces, as shown in the following table:

In this table, interface is the name of the interface (analyst, customer, or employee).

Note: There is no separate directory for guest interface files; by default, this interface uses the employee interface files. You can change the guest user interface by changing the access type associated with user System_Anonymous. Both the customer and employee files dynamically modify themselves depending on whether the current user is a known user or a guest, using the <PDM_IF> template command described in this document.

There are three additional interface subdirectories under the htmpl directory:

default:

Contains HTMPL files common to all interfaces. When searching for a file, the web engine looks first in the directory corresponding to the current user's interface, and then in the default directory.

pda/analyst: (UNIX)

pda\analyst: (Windows)

Contains HTMPL files used by the mobile device interface. In Unicenter Service Desk r11.0, the mobile device interface is provided only for analysts.

web/interface/legacy: (UNIX)

web\interface\legacy: (Windows)

Contains HTMPL files from your previous release of CA SDM that are no longer used. This directory is automatically created if you upgrade from a previous release when you install CA SDM. You can delete the legacy directory when none of its files are referenced by your customized files.

We strongly recommend that you do not directly modify the supplied HTMPL files. Instead, either use WSP, or manually copy the file you want to modify to the site mods directory, and modify it there. The CA SDM web server looks for a new form in the appropriate site mods directory before checking the distribution directory. The standard site mods directories for each of the interfaces are as follows:

Note: If you change the form and save it into the install directory\site\mods\www\htmpl\interface directory, the form will be seen by everyone, regardless of the form group to which they belong. If you save it into the install directory\site\mods\www\htmpl\interface\interface directory, only those Contacts that are defined as belonging to that form group will see the changed forms.

In the previous table, interface is the name of the interface (analyst, customer, or employee). There is no separate directory for guest interface files; this interface uses the employee interface files. The advantage of storing your modified HTMPL files in the site mods directory is that this directory is preserved when you install CA SDM maintenance or a new release. In addition, keeping your modified files in site mods while preserving the originals ensures that you always have a correct copy of the originally distributed HTMPL file.

Each web interface page has a primary function, as indicated in the following table that lists the major HTML templates. However, you can add <PDM_FORM> blocks to any template to directly access any web interface supported operation. For example, you can modify the main menu to include fields for submitting an issue without using the intermediate page, or you can add search criteria fields and a search button to a list form:

Note: For a complete list of templates, view the contents of the directories in the table at the beginning of this section.