<part> Element

This element adds a parts list entry for a component type.

Parent Elements

Attributes

Name	Type	Description	Required
componentAlternate	boolean	If `true`, this component model number is considered an alternate part. If `false`, this component model number is considered the primary part.	No (defaults to `false`)
componentModelNum	string	The component model number that the scanned component model number must match for the component to be deemed acceptable. Wildcards are supported. Variable placeholders are supported (see the remarks below). If this is not specified, then all component model numbers are considered valid. Note that multiple acceptable component model numbers can be specified via multiple parts list entries.	No
componentSerialNum	string	The component serial number that the scanned component serial number must match for the component to be deemed acceptable. Wildcards are supported. Variable placeholders are supported (see the remarks below). If this is not specified, then all component serial numbers are considered valid. To ensure that a non-blank serial number is scanned, specify `?*`.	No
description	string	An optional part description, which, when it exists, will appear in the component scan prompt at the workstation.	No
unitModelNum	string	The unit model number(s) to which this parts list entry applies. Wildcards are supported. If this is not specified, the parts list entry will apply to all unit model numbers.	No
unitSerialNum	string	The unit serial number(s) to which this parts list entry applies. Wildcards are supported. If this is not specified, the parts list entry will apply to all unit serial numbers.	No

Child Elements

None.

Remarks

componentModelNum or componentSerialNum can contain variable placeholders. The following variable placeholders are supported:

Placeholder	Gets Replaced By
`@unitSerialNumber@`	the unit serial number
`@unitModelNumber@`	the unit model number
`@unitModelNumberAlias@`	the unit model number alias
`@componentSerialNumber:componentTypeName@`	the serial number of the installed (i.e., scanned) component of the specified type, or blank if the component is not installed
`@componentModelNumber:componentTypeName@`	the model number of the installed (i.e., scanned) component of the specified type, or blank if the component is not installed

Warning

Because variable placeholders are indicated via surrounding '@' characters, component type names used in the placeholders above cannot contain any '@' characters.

For example, the following will configure a component type for scanning a unit's box label to make sure it matches the unit's serial number:

<componentType name="Box Label" scanComponentModel="false" scanComponentSerial="true">
  <partsList>
    <part unitModelNum="*" componentSerialNum="@unitSerialNumber@" />
  </partsList>
</componentType>

The following will configure a component type for verifying that the serial number of a special customer serial number bar code on the box matches the customer serial number scanned on a unit bar code earlier in the process: