Component Element (Data)

Context: HL Kit … Kit Reference … Structural File Reference 

The "component" Element

At the heart of every thing are the components that define their shared behaviors. All components define a collection of fields and re-usable behaviors that can be combined into component sets. Each component is specified through the use of a "component" element. The complete list of attributes for this element is below.

id	Id – Specifies the unique id of the component. This id is used in all references to the component.
name	Text – Public name associated with the component. Maximum length of 50 characters.
sequence	(Optional) Set – Designates the default sorting sequence to be used for picks based on this component. If no sort set is specified, or if the sort set does not yield a difference, picks will be sorted based on this criteria. Must be one of these value: ascii – Sort alphabetically based on pick name. nocase – Ignore case while sorting alphabetically. id – Sort on the unique id of each pick as if it were text. Default: "nocase".
nonusersort	(Optional) Set – Designates the special sorting behavior for picks that are not user-ordered when the same table mixes picks that are user-order with those that are non-user-ordered. Must be one of the following: first – Picks that are not user-ordered are sorted before picks that are user-sorted. last – Picks that are not user-ordered are sorted after picks that are user-sorted. none – No differentiation is made between user-ordered picks and those that are not user-ordered. Default: "none". NOTE!  Any attempt by the user to move non-orderable picks will fail, as will any attempt to move user-ordered picks above or below non-orderable picks.
usernamable	(Optional) Boolean – Indicates whether picks from this component should be user-namable. If a component allows naming, so does any derived component set, unless the component set explicitly says otherwise. Default: "no".
autocompset	(Optional) Boolean – Indicates whether the Kit should automatically create a new component set with the identical unique id as the component. This new compset will possess exactly one component - this one. Default: "yes".
orderfield	(Optional) Id – Unique id to be used when automatically defining a special field for the component that will track the details of user-ordering. If empty, then this component does not support user-ordered sequencing of its picks. Default: Empty.
unwind	(Optional) Id – Unique id of the tag group to utilize for controlling "unwind" logic of picks derived from this component. The unwind mechanism ensures picks are deleted in the reverse order they are added. If omitted, no unwind logic is enabled for the component. Default: Empty.
isgear	(Optional) Boolean – Indicates whether things derived from this component are considered to be "gear". The gear mechanism automatically provides additional logic to all things designated as gear. Default: "no".
denyboot	(Optional) Boolean – Indicates whether things derived from this component are denied the ability to be bootstrapped from any source. Default: "no".
panellink	(Optional) Id – Unique id of an edit panel that is associated with all things derived from this component as the default panel linkage. If a thing also specifies an explicit panel linkage, that will take precedence. If empty, no default panel linkage is established. Default: Empty.
hasshortname	(Optional) Boolean – Indicates whether all compsets derived from this component should automatically incorporate the "short name" behavior provided by the Kit. Default: "no".
ispublic	(Optional) Boolean – Indicates whether this component is displayed within the Editor when the user utilizes the "Find Things" mechanism. In general, internal "helper" components should be made non-public so that the user only interacts with components that will be familiar to them. Default: "yes".

The "component" element also possesses child elements that define various facets of the component. The list of these child elements is below and must appear in the order shown. Click on the link to access the details for each element.

field	Zero or more "field" elements may appear as defined by the given link. This element specifies the fields that exist for the component.
usage	Zero or more "usage" elements may appear as defined by the given link. This element specifies the pick-based usage pools associated with all things derived from the component.
linkage	Zero or more "linkage" elements may appear as defined by the given link. This element specifies the pick linkages that exist for all things derived from the component.
identity	Zero or more "identity" elements may appear as defined by the given link. This element specifies any identity tag groups that are defined for the component.
containerreq	Zero or more "containerreq" elements may appear as defined by the given link. This element specifies any container requirements for things derived from the component.

{ &l_displace, e_xml_optional }, { &l_shadow, e_xml_optional }, { &l_creation, e_xml_optional }, { &l_deletion, e_xml_optional }, { &l_xactsetup, e_xml_optional }, { &l_xactbuy, e_xml_optional }, { &l_xactsell, e_xml_optional }, { &l_tag, e_xml_zero_plus }, { &l_bootstrap, e_xml_zero_plus }, { &l_loadfixup, e_xml_optional }, { &l_eval, e_xml_zero_plus }, { &l_evalrule, e_xml_zero_plus }, { &l_prereq, e_xml_zero_plus }, { &l_merge, e_xml_optional }, { &l_split, e_xml_optional }

The "value" Element

The "value" element defines a tag for the containing tag group. The complete list of attributes for this element is below.

id	Id – Specifies the unique id of the tag within the group. This id is used in all references to the tag.
name	(Optional) Text – Name assigned to the tag. If empty, the unique id is used as the name. Maximum length is 100 characters. Default: Empty.
order	(Optional) Integer – Specifies the explicit order value to be used when sorting this tag against others within the tag group. This attribute only applies when the tag group is assigned the "explicit" sequence.

Example

The following example demonstrates what a "component" element might look like. All default values are assumed for optional attributes.