8-32 Desktop Integration Developers Guide for Oracle Application Development Framework
Figure 8–25 Runtime Dependent List of Values in an Excel Worksheet
8.8.3 How to Create a Dependent List of Values in an ADF Table Component’s Columns
Use instances of the TreeNodeList subcomponent to render both lists of values in a dependent list of values in ADF Table component columns at runtime.
Specify a tree binding attribute as a value for the parent TreeNodeList subcomponent’s List property. You also specify a tree binding attribute as a value for the child
TreeNodeList subcomponent’s List property and the same tree binding attribute referenced by the parent TreeNodeList subcomponent as a value for its
DependsOnList property.
Ensure that both tree binding attributes are associated with model-driven lists before you add the tree binding to your page definition file. For information about creating a
model-driven list, see the How to Create a Model-Driven List section of the Oracle Fusion Middleware Fusion Developers Guide for Oracle Application Development
Framework. For information about adding a tree binding to your page definition file, see
Section 4.3, Working with Page Definition Files for an Integrated Excel Workbook.
For information about the TreeNodeList subcomponent, see Section A.6,
TreeNodeList Subcomponent Properties.
To create a dependent list of values in an ADF Table component: 1.
Open the integrated Excel workbook.
2. If not present, insert an ADF Table component.
For more information, see Section 7.3, Inserting an ADF Table Component into an
Excel Worksheet.
3. Display the property inspector for the ADF Table component and invoke the
TableColumn Collection Editor by clicking the ellipsis button ... beside the input field for TableColumn[] Array.
4. If not created, click Add to add a new column to serve as the parent list of values.
For more information about creating a list of values, see Section 7.13, Creating a
List of Values in an ADF Table Component Column.
5. Add a new column to the ADF Table component to serve as the child list of values
in the runtime-dependent list of values. For more information about creating a list of values, see
Section 7.13, Creating a List of Values in an ADF Table Component Column.
6. Specify the tree binding attribute of the parent list of values as a value for the
DependsOnList property. Figure 8–26
shows the property inspector for a child ADF Desktop Integration Tree Node component, where the ParentCategoryId tree binding attribute is
specified as the parent list of values.
Adding Interactivity to Your Integrated Excel Workbook 8-33
Figure 8–26 Design Time Dependent List of Values in an ADF Table Components
Columns
7. Click OK.
8.8.4 What Happens at Runtime When a Dependent List of Values Renders in an ADF Table Component’s Columns
At runtime, the ADF Table component renders both instances of the TreeNodeList subcomponent in the columns that you configured to display these instances. When
the end user selects a value from the parent list of values, the selected value determines the list of values in the child list.
Figure 8–27 shows an example where the value that the end user selects in the
Category column list of values results in the corresponding values for sub-category
appearing in the Sub-Category column list of values. Figure 8–27
Runtime Dependent List of Values in an ADF Table Component’s Columns
8-34 Desktop Integration Developers Guide for Oracle Application Development Framework
8.8.5 Creating a Dependent List of Values in an Excel Worksheet and an ADF Table Component Column