Help Center>Foundation Help

Applies to:

  • Winshuttle Foundation

Add Attachment plugin properties

«Back to Plugins Table

Related Topics

The Add Attachment Plugin gives you the ability to attach a document automatically at a given point in a Workflow.

The document that is to be attached can reside in a folder on a server or in a SharePoint Document Library.

When used in conjunction with the Attachment element, you can also attach documents from your local PC.

Properties

Property

Description

controlbinding

The XPath of the Attachment element. (For example, /my:myFields/my:AttachmentControl)

NOTE: The only supported Attachment element for this Plugin is the Attachment Control

file

The fully qualified path to the file.

Examples:

File on server: D:\Files\Public\Users\Daily Records.xlsx

SharePoint: http://servername/sites/MyDocumentLibrary/MyDocument.docx

Usage Example

If you are onboarding a new employee and you want to attach a resume to a form, you could use the Add Attachment plugin to do this. Another common use for this plugin is to attach PDF files or other supporting documents to a form, such as an invoice being routed through a series of approvals.

Attachment types

By default, Winshuttle supports attachment of the following document types:

  • PDF
  • TIFF
  • JPEG
  • PNG
  • DOC(X)
  • XLS(X)
  • TXT

Add other document types

You can customize which document types you can attach.

  1. On the SAP Integration Server, open the ShuttleRule.xml file (in C:\Program Files\Winshuttle\Server\Worker or in C:\Program Files\Winshuttle\Server\WorkerLaunchGui).
  2. Enter the MIME type for the document type that you want to add.

    For example, to add .mht files, enter the following:

    <TypeEntry MimeType="message/rfc822">

    <Extension>MHT</Extension>

    <Extension>MHTML</Extension>

    </TypeEntry>

Attachment size for AutoRun

The default maximum size for attachments during AutoRun is 30 MB.

You can change this setting in the ShuttleRule file of Worker and Launch GUI worker on SAP Integration Server.

  1. On the SAP Integration Server, open the ShuttleRule.xml file (in C:\Program Files\Winshuttle\Server\Worker or in C:\Program Files\Winshuttle\Server\WorkerLaunchGui).
  2. Change the DOCUMENTUPLOADSIZE value. For example,

    <DOCUMENTUPLOADSIZE SizeUnit="MB" Size="40"></DOCUMENTUPLOADSIZE>

This has been tested with a 50 MB attachment and a DOCUMENTUPLOADSIZE setting of 53 MB.