How to Configure a Dynamic Column What Happens at Runtime When Data Is Downloaded or Uploaded

Working with ADF Desktop Integration Table-Type Components 7-27

7.15.1 How to Configure a Dynamic Column

You configure a dynamic column by specifying an EL expression with the following format for the Value property of the component specified by the ADF Table component column’s InsertComponent property as a subcomponent: {bindings.TreeID.[TreeNodeID].AttributeNamePrefix.inputValue} or: {bindings.TreeID.AttributeNamePrefix.inputValue} where: ■ TreeID is the ID of the tree binding used by the ADF Table component ■ TreeNodeID is an optional value that specifies the tree node binding ID. If you omit this value, all matching attributes from the tree binding display regardless of which tree node binding the attribute belongs to. ■ AttributeNamePrefix identifies a subset of attributes that exist within the tree binding’s underlying iterator. If you do not specify a value for AttributeNamePrefix, all attributes for the tree binding or tree binding node are returned. Always use the character. The following example returns all attributes that begin with the name period in the model.EmpView node of the EmpTree binding: {bindings.EmpTree.[model.EmpView].period.inputValue}

7.15.2 What Happens at Runtime When Data Is Downloaded or Uploaded

When the ADF Table components Download or DownloadForInsert action is invoked, the ADF Table component automatically updates the dynamic columns so that they contain an up-to-date set of matching attributes. For each invocation of Download, ADF Desktop Integration requires that all rows must have the same set of attributes for the dynamic column. It may generate errors if the set of attributes changes from row to row during Download. If a dynamic column supports both Insert and Update operations, you should specify the same EL expression for the Value properties of the dynamic column’s InsertComponent and UpdateComponent subcomponents. At runtime, the ADF Table component expands to include a dynamic column that displays the value of the attribute binding returned by the EL expression. When the ADF Table component’s Upload action is invoked, the workbook prompts the end user to determine if the end user wants to continue to upload data when the previously downloaded attributes no longer exist in the tree binding. Note: While adding a dynamic column, ensure that tree node attribute names are not specified in the page definition file. At runtime, the tree node object returns all attribute names from the underlying iterator. If there are attribute names specified in the page definition file, the tree node object limits the list of available attribute names based on that list. 7-28 Desktop Integration Developers Guide for Oracle Application Development Framework Support for View Objects with Declarative SQL Mode To support view objects that are configured with declarative SQL mode and customized at runtime, ADF Desktop Integration ignores all attributes with the selected property set to False. On the server side, the JUCtrlHierNodeBinding object determines the attribute list and passes it to the integrated Excel workbook on request.

7.15.3 How to Specify Header Labels for Dynamic Columns