Skip Headers
Oracle® Application Express Application Builder User's Guide
Release 4.2

E35125-05
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to current chapter
Up
Go to next page
Next
PDF · Mobi · ePub

5.13 Managing Annotations

You can add commentary and additional details to a web page by adding annotations. Annotations can be in the form of uploaded files, notes, links, and tags. Annotations can be added to both pages and data grid records.

Topics:

5.13.1 Managing Uploaded Files and Images

You can upload files and images to a Websheet page using the Files region. Once uploaded, you can display uploaded images within a page section or embed download links to files.

Topics:

5.13.1.1 Uploading Files and Images

To upload files and images to a Websheet:

  1. Log in to and run the Websheet. See "Running a Websheet".

  2. Under Files on the right side of the page, click the Add File icon.

    Description of websheet_files.gif follows
    Description of the illustration websheet_files.gif

  3. On the Add File page:

    1. File - Browse to locate the file to upload. Once uploaded, the file is associated with the current page. You can reference an uploaded file in any page using the image or file syntax. See "Displaying an Uploaded Image Inline" or online Help, Markup Syntax.

    2. Alias - A file alias enables you to embed download links or image links within page sections. A file alias must be unique within an application.

    3. Description - Enter descriptive text to describe the file.

  4. Click Add File.

5.13.1.2 Including a Download Link in a Page Section

You can embed a download link within a page section to uploaded files using the following syntax.

Syntax:

[[ file: < file name > | < link name > ]]
[[ file: < file alias > | < link name > ]]

Syntax Examples:

[[file: myfile ]]
[[file: myfile.xls ]]
[[file: myfile | My File ]]

File Markup Example:

This [[file: parts01.xls | spreadsheet ]] documents our part numbers.

5.13.1.3 Displaying an Uploaded Image Inline

After you upload an image, you can display it within any page section of an application by embedding a download link using the following syntax. You can reference an uploaded image using the image name or image alias.

Images defined for the current page are used before images associated with other pages. If image names are ambiguous, the most recently created image displays.

Syntax:

[[ image: < file name > | < properties > ]]
[[ image: < file alias > | < properties > ]]

Syntax Examples:

[[image: myimage ]]
[[image: theimagename.jpg ]]
[[image: myimage | width="600" alt="my image" ]]

Example:

This diagram [[image: diagram1]] illustrates the work flow.

5.13.1.4 Editing or Deleting Uploaded Files

To edit details or delete uploaded files:

  1. Log in to and run the Websheet. See "Running a Websheet".

  2. In the Files region, click the Edit File icon.

    The Details page appears.

  3. To edit file details:

    1. Edit the fields provided. See item Help for more details.

    2. To accept your changes, click Apply Changes.

  4. To delete a file:

    1. Click Delete.

    2. To accept your changes, click OK.

5.13.2 Adding Tags

Tags facilitate keyword searching within a Websheet.

Topics:

5.13.2.1 Adding Tags

To add tags to a Websheet page:

  1. Log in to and run the Websheet. See "Running a Websheet".

  2. Under Tags on the right side of the page, click the Add Tag icon.

    Description of websheet_tags.gif follows
    Description of the illustration websheet_tags.gif

  3. Enter tags in the field provided. Separate multiple tags with a comma.

  4. Click Apply Changes.

5.13.2.2 Editing Existing Tags

To edit existing tags:

  1. Log in to and run the Websheet. See "Running a Websheet".

  2. In the Tags region, click the Edit Tag icon.

    The Details page appears.

  3. Edit the tags and click Apply Changes.

5.13.3 Adding Notes

Use notes to record user comments.

Topics:

5.13.3.1 Adding Notes

To add notes to a Websheet page:

  1. Log in to and run the Websheet. See "Running a Websheet".

  2. Under Notes on the right side of the page, click the Add Note icon.

    Description of websheet_notes.gif follows
    Description of the illustration websheet_notes.gif

  3. Enter text in the field provided.

  4. Click Add Note.

5.13.3.2 Editing and Deleting Existing Notes

To edit or delete existing notes:

  1. Log in to and run the Websheet. See "Running a Websheet".

  2. In the Notes region, click the Edit Note icon.

  3. To edit file details:

    1. Edit the fields provided. See item Help for more details.

    2. To accept your changes, click Apply Changes.

  4. To delete a note, click Delete.

5.13.4 Viewing and Deleting Annotations

You can view and delete all Websheet annotations on the Annotations page. Annotations include uploaded files, notes, links, and tags that were either added to a Websheet page or to a specific row in a data grid.

Topics:

5.13.4.1 Accessing the Annotations Page

To access the Annotations page:

  1. Log in to and run the Websheet. See "Running a Websheet".

  2. From the View menu, select Annotations.

    The Annotations page appears.

    Description of websheet_annot.gif follows
    Description of the illustration websheet_annot.gif

  3. To view specific type of annotation, click the Files, Notes, Links, Tags, or Tag Cloud tabs.

5.13.4.2 Deleting Annotations

To delete uploaded files, notes, link, or tags:

  1. Log in to and run the Websheet. See "Running a Websheet".

  2. From the View menu, select Annotations.

    The Annotations page appears.

  3. Select an annotation type by clicking the appropriate tab at the top of the page.

  4. Click the appropriate tab: Files, Notes, Links, Tags, or Tag Cloud.

  5. Select the annotations to be deleted.

  6. If not selected, click the View Report icon.

    Description of websheet_annot_del.gif follows
    Description of the illustration websheet_annot_del.gif

  7. Click Delete Checked.