In the Layout Appearance section, click the Create button next to the HTML

Providing a Standard Look and Feel 12-35

10. In the Template Definition field, enter the HTML or other Web-standard code for

your template. Click the tags as substitution variables link for a list of substitution tags available for use in your template. See Appendix E, Substitution Tags for HTML and Unstructured UI Templates for a list and description of these database portlet substitution tags. You can use oracleoracle tags in your HTML to include SQL statements or PLSQL blocks in your template.

11. Click Preview to see how the template definition displays.

12. Click Create when you are finished to save your changes and exit the wizard.

12.3.3.2 Applying an Unstructured User Interface Template

Data components always display within the context of a UI template when viewed in full-page mode. They use either a default template provided by the portal or a template you select. You cannot detach a UI template from a data component, but you can select a template other than the default. Additionally, should you want a data component to display on a blank page when displayed in full-page mode, you can create a simple template that does not include any colors, objects, or formatting, then select that in lieu of a populated UI template. You can apply a UI template when you create a data component or when you edit one. This section describes how to apply a UI template when you edit a data component. To apply a UI template:

1. Log in to Oracle Portal.

2. Click the Navigator link at the top of the page.

3. Click the Providers tab to bring it forward.

4. Click the Locally Built Providers link.

5. Under the Name column, click the link to a database provider that contains the

data component to which to apply a template.

6. On the resulting page, click the Edit link next to the data component portlet to

which to apply a template.

7. Click the final tab in the series, Data Component and Personalization Form Text

Figure 12–10 . Figure 12–10 Data Component and Personalization Form Text Tab Icon

8. From the Template drop-down list, select the UI template to apply to the data

component.

9. Click OK to save your change and go to the Develop Data Component screen.

Note: If you want to include calls to APIs within Oracle tags, they must be granted to public. For example, you cannot use wwctx_api to obtain session context information such as current user within HTML templates. Instead use the appropriate substitution tags.