Training
Module
Feature management in finance and operations apps - Training
Learn how to enable features, disable them, and reschedule them in the Feature management workspace.
This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
The Feature Table defines the logical tree structure of features and contains the columns shown in the following table.
Column | Type | Key | Nullable |
---|---|---|---|
Feature | Identifier | Y | N |
Feature_Parent | Identifier | N | Y |
Title | Text | N | Y |
Description | Text | N | Y |
Display | Integer | N | Y |
Level | Integer | N | N |
Directory_ | Identifier | N | Y |
Attributes | Integer | N | N |
Feature
The primary key that is used to identify a specific feature record. The value in this field must not exceed a maximum length of 38 characters.
Feature_Parent
An optional key of a parent record in the same table.
The key points to the Feature column. If the parent feature is not selected, then this feature is not installed. A null value in this field indicates that this feature does not have a parent and is a root item. The Feature_Parent column must not equal the Feature column of the same record.
Note
The maximum depth of any feature is 16. An error 2701 results if a feature that exceeds this maximum depth exists.
Title
A short string of text that identifies a feature.
This string is listed as an item by the SelectionTree Control of the Selection Dialog.
Description
A longer string of text that describes a feature.
This localizable string is displayed by the Text Control of the Selection Dialog.
Display
The number in this field specifies the order in which the feature is to be displayed in the user interface.
The value also determines whether or not the feature is initially displayed expanded or collapsed. If the value is null or 0 (zero), the record is not displayed.
Level
The initial installation level of this feature. Processing the Condition Table can modify the level value.
An install level of 0 (zero) disables the item and prevents it from being displayed. A feature with an installation level of 0 (zero) is not installed during any installation, including administrative installations. For more information, see the "Install Level" information in the Remarks section of this topic.
Directory_
The Directory_ column specifies the name of a directory that can be configured by a Selection Dialog.
Because this field is a key into the Directory Table, the specified directory must be listed in the first column of the Directory Table. You must enter a Public Property in this column to make the directory configurable, and to display a Browse button on the Selection Dialog.
Attributes
The remote execution option for features that are not installed and for which no feature state request is made by using any of the following properties.
Add the indicated bits to the total value of this column to include a remote execution option.
Name | Decimal | Hexadecimal | Description |
---|---|---|---|
msidbFeatureAttributesFavorLocal | 0 | 0x0000 | Components of this feature that are not marked for installation from source are installed locally. A component shared by two or more features, some of which are set to msidbFeatureAttributesFavorLocal and some to msidbFeatureAttributesFavorSource, is installed locally. Components marked msidbComponentAttributesSourceOnly in the Component Table are always run from the source CD/server. The bits msidbFeatureAttributesFavorLocal and msidbFeatureAttributesFavorSource work with features not listed by the ADVERTISE Property. |
msidbFeatureAttributesFavorSource | 1 | 0x0001 | Components of this feature not marked for local installation are installed to run from the source CD-ROM or server. A component shared by two or more features, some of which are set to msidbFeatureAttributesFavorLocal and some to msidbFeatureAttributesFavorSource, is installed to run locally. Components marked msidbComponentAttributesLocalOnly in the Component Table are always installed locally. The bits msidbFeatureAttributesFavorLocal and msidbFeatureAttributesFavorSource work with features not listed by the ADVERTISE Property. |
msidbFeatureAttributesFollowParent | 2 | 0x0002 | Set this attribute and the state of the feature is the same as the state of the feature's parent. You cannot use this option if the feature is located at the root of a feature tree. Omit this attribute and the feature state is determined according to msidbFeatureAttributesDisallowAdvertise and msidbFeatureAttributesFavorLocal and msidbFeatureAttributesFavorSource. To guarantee that the child feature's state always follows the state of its parent, even when the child and parent are initially set to absent in the SelectionTree Control, you must include both msidbFeatureAttributesFollowParent and msidbFeatureAttributesUIDisallowAbsent in the attributes of the child feature. Note that if you set msidbFeatureAttributesFollowParent without setting msidbFeatureAttributesUIDisallowAbsent, the installer cannot force the child feature out of the absent state. In this case, the child feature matches the parent's installation state only if the child is set to something other than absent. Set msidbFeatureAttributesFollowParent and msidbFeatureAttributesUIDisallowAbsent to ensure a child feature follows the state of the parent feature. |
msidbFeatureAttributesFavorAdvertise | 4 | 0x0004 | Set this attribute and the feature state is Advertise. If the feature is listed by the ADDDEFAULT Property this bit is ignored and the feature state is determined according to msidbFeatureAttributesFavorLocal and msidbFeatureAttributesFavorSource. Omit this attribute and the feature state is determined according to msidbFeatureAttributesDisallowAdvertise and msidbFeatureAttributesFavorLocal and msidbFeatureAttributesFavorSource. |
msidbFeatureAttributesDisallowAdvertise | 8 | 0x0008 | Note that this bit works only with features that are listed by the ADVERTISE Property. Set this attribute to prevent the feature from being advertised. Set this attribute and if the listed feature is not a parent or child, the feature is installed according to msidbFeatureAttributesFavorLocal and msidbFeatureAttributesFavorSource. Set this attribute for the parent of a listed feature and the parent is installed. Set this attribute for the child of a listed feature and the state of the child is Absent. Omit this attribute and if the listed feature is not a parent or child, the feature state is Advertise. Omit this attribute and if the listed feature is a parent or child, the state of both features is Advertise. |
msidbFeatureAttributesUIDisallowAbsent | 16 | 0x0010 | Set this attribute and the user interface does not display an option to change the feature state to Absent. Setting this attribute forces the feature to the installation state, whether or not the feature is visible in the UI. Omit this attribute and the user interface displays an option to change the feature state to Absent. Set msidbFeatureAttributesFollowParent and msidbFeatureAttributesUIDisallowAbsent to ensure a child feature follows the state of the parent feature. Setting this attribute not only affects the UI, but also forces the feature to the install state whether the feature is visible in the UI or not. |
msidbFeatureAttributesNoUnsupportedAdvertise | 32 | 0x0020 | Set this attribute and advertising is disabled for the feature if the operating system shell does not support Windows Installer descriptors. Omit this attribute and advertising is not disabled. |
Some attributes are exclusive of each other. Attempting to set these attributes together on the same feature causes the installation package to fail Package Validation.
Note that if a child feature is installed, its parent feature is also installed. If a parent feature is installed, its child feature is not necessarily installed unless its msidbFeatureAttributesFollowParent and msidbFeatureAttributesUIDisallowAbsent attributes are set. This hierarchical relationship of the installation of parent and child features is also used for the GUI installations and installations that use command-line properties.
Several additional temporary columns are added to this table when it is loaded into memory for computations used by costing and user interface (UI) selection.
A component can be shared between two or more features or applications. If two or more features refer to the same component, then that component is selected for installation if any of the associated features are selected. This can also be the reason child features are not uninstalled when a parent feature is removed. If the child feature consists of components needed by other features or applications, the Windows Installer does not remove the child feature.
For more information, see Controlling Feature Selection States.
Install Level:
ICE03
ICE06
ICE10
ICE14
ICE21
ICE32
ICE41
ICE45
ICE47
ICE50
ICE57
ICE59
ICE62
ICE67
ICE79
ICE86
ICE94
Training
Module
Feature management in finance and operations apps - Training
Learn how to enable features, disable them, and reschedule them in the Feature management workspace.