Previous Topic: Defaults

Next Topic: Example Input

Ignore Incoming

There are several [..._IGNORE_INCOMING] sections in the text_api.cfg file, one for each interface that uses the Text API (for example [TNG_IGNORE_INCOMING] for the CA NSM interface and [EXT_IGNORE_INCOMING] for the external interface used by other CA products). These sections define fields and properties that are ignored in the input (the format is the same as described in Defaults, except no “=value” is specified). This feature lets you prevent users from setting certain values, which in turn, provides you with more security for such times as letting customers use the email interface.

The IGNORE sections work well when used in conjunction with the corresponding [..._DEFAULTS] sections because you can prevent the user from setting a particular value and supply a default value at the same time. For example, if you want to prevent email interface users from setting the priority of an issue, you could set the following values:

[EMAIL_DEFAULTS]
ISSUE.PRIORITY=2
[EMAIL_IGNORE_INCOMING]
ISSUE.PRIORITY

In this case, any priority that the user specifies in the email message body is ignored, and all issues created by the email interface are automatically assigned a priority of 2.