Skip to main content

IMPORTANT - Product End of Life Statement - IMPORTANT

Request RE, Survey, and Calendar 1.5 Support Ending December 31, 2020
Contact Kinetic Data Support with Questions
Kinetic Community

Attachment Download Module

The Kinetic Request Attachment Download Module is a package that provides functionality necessary to download files stored in BMC® Remedy® attachment field values.  It is most often used by Kinetic Request bundles to allow technicians access to file attachments stored in related systems (such as ITSM Incident Work Log attachments, etc).


The Kinetic Request Attachment Download Module requires Kinetic Request v5.1.1, v5.1.2, or v5.1.3.

Additionally, the Attachment Download Module uses the built in Remedy permissions, and can only be accessed by users that have authenticated with Kinetic Request.


Installation of the Attachment Download Module requires that the kinetic-request-attachment-download.jar file is added to the Kinetic Request web application, the Kinetic Request web.xml file is modifed to expose the AttachmentDownloadServlet, and the web application is restarted.

Before beginning, download the attached kinetic-request-attachment-download.jar file.

  1. Copy the kinetic-request-attachment-download.jar file into the Kinetic Request web application WEB-INF/lib directory.
  2. Open the Kinetic Request web.xml file stored in WEB-INF and add the highlighted snippits.
            <display-name>Download Attachment Servlet</display-name>
            <description>Provides access to attachment files.</description>
  3. Reload the Kinetic Request web application.  This is most easily done by restarting the web server that is running Kinetic Request.


To use the Attachment Download Module, simply pass the form name, field id, and request id on a URL formatted similar to:


For example, the following URL is a link to the Kinetic Task handler attachment record (stored in attachment field 700001017 on the KS_TSK_Def form) associated to the entry with a request id of 000000000000006.



Any errors that occur, such as an unauthenticated user attempting to access the attachment download functionality or the specified form/field/record not existing will be included in the standard kslog.log file accessible in the Kinetic Request AdminConsole.

Advanced Usage

The Attachment Download Module supports an optional disposition parameter.  This parameter can be used to specify whether the attachment should be opened inline (IE in the browser window) or downloaded.

As an example, the following will display the "Power by Kinetic" logo in a browser tab:


while the following would force the file to be downloaded directly:


Special Instructions

Downloading Office/PDF documents over HTTPS

There is a known Internet Explorer bug that prevents Office and PDF documents from being downloaded over HTTPS when the Cache-Control header is set (for more information, see:

As a workaround for this issue, the Attachment Download Module provides an optional nocache parameter.  If the attachment download request includes this nocache parameter, the Attachment Download Module will not include the Cache-Control header.  The nocache parameter should be set to an automatically changing value to ensure that caching does not occur.

Hers is an example of the formatted request:


If you are using the Attachment Download Module with Kinetic Request bundles, you can generate a URL like this using code similar to:

*  @param Attachment
*  @return string
public static String buildAttachmentUrl(Attachment attachment) {
    return "DownloadAttachment/"+attachment.getFormName()+"/"+attachment.getFieldId()+"/"+attachment.getRequestId()+"?nocache="+System.currentTimeMillis();

Downloading attachments when using IIS 7.x & ISAPI Redirect

Microsoft IIS has URL filtering which will block attachments associated to certain forms. Any attachments that are on a form with a colon in the form name will be blocked if the URL filtering feature is turned on. Microsoft put this URL filtering in place to try and prevent breaking out of the web application directory and accessing unintended files on the operating system along with preventing accessing webpage source could through . You can turn off the URL filtering feature to prevent this issue from happening OR remove the colon as a filtered character. To remove the colon as a filtered character see the following link: Tweaking a few URL validation settings


v1.2.0 (2015-01-05)

  • Changes behavior to display a "No file found." message rather than raising an error if the attachment field is null.

v1.1.0 (2013-10-01)