In the Template Definition field, enter HTML to define the template’s

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. 12-36 Oracle Fusion Middleware Users Guide for Oracle Portal You can perform additional management tasks on the data component on this screen.

10. Click Close to return to the Portal Navigator.

12.3.3.3 Editing an Unstructured User Interface Template

To edit an unstructured 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. Click the Shared Components link.

6. Click the User Interface Templates link.

7. Click the Edit link next to the UI template to be edited.

8. Make your changes to the template.

If you change the name of the UI template, keep in mind that the name must be unique among the object names within the Shared Components provider. Use up to 50 bytes. This equals 60 ASCII bytes, but fewer multibyte characters. Use any character except the following: , \ : ? |

9. Click OK to save your changes.

12.3.3.4 Deleting an Unstructured User Interface Template

When you delete an unstructured UI template, the default template is automatically applied to any components that used the deleted template. The default unstructured UI template is the one at the top of the pick list of unstructured UI templates. To delete an unstructured 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. Click the Shared Components link.

6. Click the User Interface Templates link.

7. Click the Delete link next to the UI template to be deleted.

8. On the resulting page, click Yes to confirm the deletion.

12.3.4 Copying HTML Templates

A quick way to create a new HTML template is to copy an existing one. The procedures for copying HTML templates differs between unstructured user interface templates and the other types of HTML templates. This section describes both procedures. It includes the following subsections: ■ Section 12.3.4.1, Copying an HTML Page Skin or Content Layout Template ■ Section 12.3.4.2, Copying an Unstructured User Interface Template