Adding a Form to an Integrated Excel Workbook

Adding Interactivity to Your Integrated Excel Workbook 8-27 Figure 8–21 ADF Button Component for an Advanced Search Form

8.7 Adding a Form to an Integrated Excel Workbook

You can use the ADF Desktop Integration components described in Chapter 6, Working with ADF Desktop Integration Form-Type Components, to create forms in your integrated Excel workbook. These components can be useful when you want to provide end users with functionality that allows them to view and edit individual fields rather than use the functionality provided by the table-type components to download rows of data from the Fusion web application. Use one or more of the following components to create a form: ■ ADF Button Use this component to provide end users with a button that can invoke a ClickActionSet. Figure 8–22 shows an ADF Button labeled Search that invokes a search operation using the search term entered by the end user in the ADF Input Text component. ■ ADF Input Text Use this component to provide end users with a readwrite field where the current value of a binding appears. This component can also be used to input a value, as in the example illustrated in Figure 8–22 , where users enter a search term in the ADF Input Text component. ■ ADF Output Text Use this component to provide end users with a read-only field where the current value of a binding appears. ■ ADF List of Values Use this component to provide end users with a dropdown menu from which a user can select a value from a list binding. ■ ADF Label Use this component to provide end users with instructions or other information on how to use the form you create. For example, the Master Price List modules EditPriceList-DT.xlsx workbook uses ADF Label components to display an instruction to end users and the number of matches for a search term. Figure 8–22 8-28 Desktop Integration Developers Guide for Oracle Application Development Framework shows the runtime values of these components. The text Search For: is a label instructing end uses to enter the search string, and 8 records found label displays the number of records found matching the search string. Figure 8–22 Runtime View of a Form in an Integrated Excel Workbook You use the ADF Desktop Integration task pane to insert the components you require into a worksheet. To create a form in an integrated Excel workbook: 1. Decide which ADF form components you require for the finalized form and insert them in the Excel worksheet. For more information about these components, see Chapter 6, Working with ADF Desktop Integration Form-Type Components. 2. Configure the layout and appearance of the components you insert. For more information about configuring the appearance of components, see Chapter 9, Configuring the Appearance of an Integrated Excel Workbook. 3. Test your form. For more information about testing an integrated Excel workbook, see Chapter 13, Testing Your Integrated Excel Workbook.

8.8 Creating Dependent Lists of Values in an Integrated Excel Workbook