Attachments widget

Draft comment:
This topic is shared by BAW, CP4BA. Last updated on 2025-01-20 10:38
You use the Attachments widget to display a list of the documents that are attached to a work item. The documents are stored on the Content Platform Engine server. In addition, you can configure a case type so that the Attachments widget can display documents from external repositories.

For FileNet® P8 documents, the Attachments widget lists attachments by the document title that is assigned when the attachment was added to the widget. This title is automatically updated when the document title is updated in the repository.

In addition to viewing attachments, users use the Attachments widget to:
  • Upload local files to a repository
  • Attach documents by browsing and selecting them from a repository
  • Attach documents by dragging them from your file system to the Attachment widget
  • Check out, check in, cancel checkout, and view properties of documents; download attachments; remove attachments
  • Add documents from external repositories as work item attachments
  • Share documents and folders with external users by using the external Share feature in IBM® Content Navigator.
    Note: The external Share feature must be configured in IBM Content Navigator before you can share documents and folders externally. The external Share feature is supported in IBM Business Automation Workflow with an external IBM Content Navigator deployed on WebSphere® Application Server V9.0 and above. The external Share feature is also supported in Content Platform Engine and IBM Content Navigator container deployment environments where the external Share container must be additionally deployed.
Restriction: Users can select any item to add to the Attachments widget, including system files such as workflows and entry templates. However, the check out, check in, cancel checkout, and view properties actions are supported only for document classes. Using these operations for other file types can produce unexpected results.
The fields that are displayed on the Attachments widget and the actions that you can take are determined by the following permissions, which are assigned to the fields when the workflow is created or modified in the FileNet IBM FileNet Process Designer:
Read
The Attachments widget displays the attachment name and the name of the assigned target document. You can view the target document, but you cannot change it.
Write
The Attachments widget displays the attachment name, but not the name of the assigned target document. Optionally, you can change to a different target document for the attachment.
Read/Write
The Attachments widget displays the attachment name and the name of the assigned target document. You can view the target document and, optionally, you can change to a different target document for the attachment.
You can edit the settings for the Attachments widget to:
  • Specify whether attachment content will be displayed in the Viewer widget or in a separate browser window
  • Specify whether to display a list of all document classes or only the list of document classes that are defined for the current solution when a user adds a document from the local computer as an attachment.
  • Open a specified document when the page containing the Attachments widget is opened.

IBM Business Automation Workflow pages that include this widget by default

The Attachments widget is included on the following pages:
  • Add Activity page
  • Add Activity Form page
  • Work Details page
  • Work Details Form page