Megger Baker AWA-IV User Manual page 160

The "MotorDisplaySpecs" parameter identifies how many groupings of other entries there will be. Each grouping
consists of other parameters where the name is built with a prefix of "MotorDisplaySpec", an ordinal group number
(starting with 1 for the first grouping), and another item sub-name (the name specific to that sub-item in the group)
using period delimiters.
Notice the difference in plurality between "MotorDisplaySpecs" and "MotorDisplaySpec". When this item is missing
(or its value is 0), this feature is turned off, and every motor will be displayed using the "motorid" value. If the
item is present and its value is greater than 0, the custom identifier for each motor will initially be set to an empty
string, and the various "MotorDisplaySpec" groups will determine which strings are appended to it to form the final
customized identifier for display purposes.
If no strings are appended because the groups do not specify any "Format" strings to append, the custom identifier
will always be the empty string (the same situation used internally to indicate exclusions) essentially forcing the Motor
ID and Route lists to always be empty.
The "MotorDisplaySpecs.AllowedContexts" parameter is optional and defaults to "RouteList". This identifies which
AWA user interface contexts the specifications will apply to. It should be the union of all contexts used across all
"AppliedTo" parameters in all "MotorDisplaySpec" groupings (described below). It may also specify "MotorIdList"
and these separate contexts may be combined with a space, comma, or vertical bar delimiter. The value "All" applies
the specifications to all possible contexts, but at present only two have any effect: "RouteList" and "MotorIdList".
This does not set a default value for which contexts any grouping will apply to; it specifies which groupings will be
allowed in the specifications.
The special value of "None" means that the specifications are not to be allowed in any context, which is essentially
the same as setting "MotorDisplaySpecs" to 0. It allows you to keep the individual "MotorDisplaySpec" groupings in
the AWA.INI file, but causes them to have no effect.
Each "MotorDisplaySpec" sub-item group (sharing the same ordinal group number) specifies a database field whose
value will be checked and/or appended to a custom ID string for display purposes in only those three areas of the
AWA software interface. Each type of sub-item should only occur once per grouping.
The possible sub-item names (after "MotorDisplaySpec.groupnumber.") include:
„ Field (required)—Identifies the database column in the MotorId table whose value is to be used. If the column
value is NULL (missing) on a particular motor's row, the string value used in its place will usually be "NULL." All
columns of the MotorId table are allowed. Invalid names will trigger an error message display and the grouping
being ignored. The same error occurs if the "MotorDisplaySpecs" number exceeds the groupings of sub-items
specified.
Format (required if the field is to be appended to the custom identifier)— Provides the format string to be used
„
(along with the value of the field, when building the substring to be appended. It minimally needs "%s" (or an
alternative format item) in its value. You will likely need a delimiter of some sort on all but one of the groupings'
"Format" parameters. If the "Format" parameter is missing for a group, that field value will not be appended to
the identifier. This can be used to allow certain fields to be checked for excluding a motor, but not to compose
the custom identifier.
Refer to https://msdn.microsoft.com/en-us/library/56e442dc.aspx# for more explanation of what
format specifications are possible. Keep in mind that the column's value, converted to a string, will be the only
argument.
Exclusions (optional)—Provides a comma-separated list of exact values that the field value is compared to. Any
exact match (full-value, case-sensitive) will exclude the identified motor from being displayed where the custom
identifiers are used. This does not affect the motor tree in the Explore tab. If a pattern you want to exclude contains
a comma, it will have to be specified via "ExclusionsRegex".
ExclusionsRegex (optional)—Provides a valid ECMAScript-style regular expression, against which the entire field
value is matched. A successful full-value match excludes the identified motor from being displayed where the custom
identifiers are used. This does not affect the motor tree in the Explore tab.
148 Baker AWA-IV 71-015 EN V16 User Guide www.megger.com