Attachment Page Templates

Last Updated 21-Feb-2004

General Description

Attachment page templates are used within an application when a user can view and/or add one or many attachments to an object. An example may be an expense report that needs additional documents attached to the report to clarify the purchases.

Guideline Attributes

Spec Version # - 3.1
Spec Contributors - Betsy Beier, Raymond Wong, Lisa Serface, Mervyn Dennehy
UI Models - all
Example Products - All Products
Related Guidelines - Introduction to BLAF Page Templates, Attachments Flow, Object List Templates, Object Templates, Messaging Page Templates

Interaction and Usage Specifications

General Principles

Templates Used in Attachment Flow

There are multiple templates that make up an attachment flow. All of these templates may have relevance to adding or viewing an attachment.

All Object Template Options with Attachments
The following schematic shows all the types of Object Templates that can include Attachments Lists. See the Object Templates guideline for details on each of these templates.

Common Components Used in Attachment Templates

Launch Pages for Attachments

Attachments are initially surfaced in an application in an:

Object Pages with Label/Data Layout

Attachments to a single object can be surfaced on an object page in various ways, with key differences depending on whether the object can have one or more than one attachment, and whether the user can add an attachment.

Multiple Attachments Possible, or Privilege to Add

When the object can have more than one attachment, or the user has privileges to add an attachment:

Object Page with Both View Link and Add Button

Object Page with No Attachment and Add Button

Object Page with View Link Only

Single View-Only Attachment

When the object can only have one attachment, and the attachment is view-only:

Object Page with View Link for Single Attachment


Object Page with No Attachment


Object List Pages with Tabular Layout

Like object pages, objects lists can surface attachments in various ways, with key differences depending on whether the object can have one or more than one attachment, and whether the user can add an attachment. Each object in an object list may or may not have an associated attachments.

NOTE: Per usability test results, a row object without attachments should have an empty cell in the "View Attachment" column (that is, no "Empty Attachment" icon).

Multiple Attachments Possible, or Privilege to Add

When any object can have more than one attachment, or the user has privileges to add an attachment to any single object, individual rows vary as follows:

Object List Page with Mix of View, Add, and No Attachment Functionality

Note: In certain contexts, a user may only be able to view an attachment that is associated with an object, and not be able to update, delete or add another. An example of this usage is in a notifications template: Once the notification is created, a user who needs to approve the notification can only view the attachment, but not add/delete/or update it.

Single View-Only File Attachment

When all objects can have one or zero attachments, attachments are view-only, and the attachment type is "File":

Object List Page with Single View-Only File Attachments


Attachments List Pages

The Attachments List page is reached by clicking either a View link on an object page or a View Attachments icon on an object list page. The Attachments List table may be placed in different types of Object Templates. See Templates Used in Attachment Flow above for details.

View-Only Attachment List Page


Attachments List with Updateable Attachments

When the user has privileges to Add, Update, or Delete attachments to the object, these actions are implemented as follows:

Attachment List Page with Add, Update, and Delete Functionality


Attachments List with Search

Attachments Lists with either view-only or updateable attachments may contain Search. The Search section consists of a single "Name" text field and Go button, along with a "Show More Search Options" toggle. When the search options are shown, the user can search on any attribute of an attachment.

Attachment List Page with Search


Attachment List Page with Search Options Shown


Add Attachment Page

The Add Attachments page can be reached in several ways: by clicking an Add button on an object page, a View Attachments icon on an object list page, or an Add Attachment button on an Attachments List page.

Note: When the Type choice list is present, if the user makes changes to the page then selects a different option from the Type choice list without clicking Save Another, those changes will be lost.

Add Attachment Page with Type Choice List


Add Attachment Page with Confirmation Message

Note: The Open File dialog box can only add one attachment at a time. This is a restriction of HTML.

Update Attachment Pages

The Update Attachment template is reached by clicking an Update Attachment icon on an Attachments List page. The page layout depends on the type of attachment selected. For all attachment types, users can modify the attachment description and category. Other functions depend on attachment type:

Page level buttons are Cancel and Apply, which both return the user to the Attachments List page.

Update File Attachment


Update File Attachment with Previous File Cleared


Update URL Attachment


Update Text Attachment


View Text Attachment Page

When a user chooses to view a text attachment, it is displayed in the View Text Attachment page, as shown below. The View Text Attachment page includes breadcrumbs to show location in the application hierarchy and a Return to Attachments link to return to the previous page.

All fields on the page are view-only, and include data entered when the attachment was created or updated, along with system generated Last Updated and Updated By fields.

View Text Attachment


Note: Unlike text attachments, file attachments are displayed in a third party application, and the target pages of URL attachments are displayed in a browser secondary window.

Visual Specifications

Attachment Icons

The following icons indicate whether the user can view or add attachments in a table.


Open/Closed Issues