The default CIM scripts ship with online help information. If you add your own custom scripts, you may want to provide assistance for users.

CIM help is provided in the form of a JS file, which contains a list of IDs that match CIM objects, and corresponding help text to be displayed when the user works with that object. The format is:

{"id":"CIMItemID","content":"Place your help text here"},

For example:

{"id":"AddOnSelectTask.addOns","content":"Select one or more of the listed
add-ons as part of your installation."},

You can place a product-specific online help file in the same directory as the product.xml file. Before the user has selected a product and add-ons, all of the help files present are combined, using no set order. After the user selects a product, the help is based on that product, using the extends attribute in the product.xml files to determine the hierarchy.

For example, CRS extends B2C, which extends DCS, which extends the platform. If the user selects CRS, the help file combines available help for those products. The “most child” product, in this case CRS, takes precedence; if any two of the files include the same help ID, the CRS help is used.

For sibling products that do not extend each other, common ancestors are used first, then the sibling products in no defined order.

Help IDs are automatically generated using standard formats for each item type. You can turn on debugging in the CIM GLOBAL.properties file to see help IDs displayed whenever you access the help.

For property file steps, the ID convention is to replace the dot in the filename with an underscore:

/Nucleus_path/filename_properties.propertyname

For example:

/atg/dynamo/Configuration_properties.httpPort

For a navigation step, the help ID format is:

For task, such as selecting from a list, the help ID format is:

taskID.propertyname.listItemID

For example:

DatasourcePropTask.databaseType.oracle

Some items you may want to add that would benefit from added online help are: