What Happens at Runtime to the Branding Items in an Integrated Excel Workbook

9-12 Desktop Integration Developers Guide for Oracle Application Development Framework

4. In the the NameValuePair Collection Editor, click Add and specify values for the

new element as follows: ■ Name Specify the name, or the EL expression, of the branding item to define. ■ Value Specify a literal string or click the ellipsis button ... to invoke the expression builder and write an EL expression that retrieves a value at runtime. BrandingItems must use literal strings or resource expressions, and must not contain any binding expression. Figure 9–10 shows the design time view of branding items in the Master Price List module. Figure 9–10 Design Time View of Branding Items in the Master Price List Module

5. Click OK.

9.6.2 What Happens at Runtime to the Branding Items in an Integrated Excel Workbook

At runtime, the name-value pairs that you define for the BrandingItems group of properties appear in a dialog that the end user invokes from the About button of the Oracle ADF tab, which you configured to appear, as described in Section 8.3, Configuring the Runtime Ribbon Tab. Figure 9–11 shows the runtime view of branding items in the Master Price List module’s EditPriceList.xlsx workbook. Configuring the Appearance of an Integrated Excel Workbook 9-13 Figure 9–11 Runtime View of Branding Items in the Master Price List Module

9.7 Using Worksheet Protection

By default, the end user can edit the values of read-only cells and ADF Desktop Integration read-only components, such as ADF Label and ADF Output Text, at runtime. While uploading data, ADF Desktop Integration ignores these changes and overwrites them when it downloads data from the Fusion web application. To prevent editing of read-only cells at runtime, you must enable the worksheet protection. Optionally, you can also provide a password to prevent the end user from turning off worksheet protection.

9.7.1 How to Enable Worksheet Protection

Worksheet protection enables true read-only mode for read-only cells and prevents any editing at runtime. To enable Worksheet Protection 1. Open the integrated Excel workbook.

2. In the Oracle ADF tab, click Worksheet Properties.

3. In the Edit Worksheet Properties dialog, expand the Protection property and

configure values as follows: ■ To enable the worksheet protection at runtime, set the Mode to Automatic. ■ If desired, provide a value in the Password field. The end-user cannot turn off sheet protection at runtime without knowing this value. Note that the password is not encrypted and the maximum password length allowed by Excel is 255 characters. If you specify a longer password, it will be truncated silently at runtime when sheet protection is toggled. Figure 9–12 shows the design time view of worksheet protection in Master Price List module.