Documents on Action Items

Summary: This article describes how to configure Action Items with steps that automatically pull documents from the Association Document Library, or with steps that can automatically post documents to the Association Document Library.  This article will also describe how to use dynamic tags so that documents can be sourced or organized by report dates.

Objectives:

• Configure an Action Item
• Pull documents from the step to the Association Document library
• post documents from the step to the document library instead of pulling them from the Document Library
• Use dynamic tags in the File Path so that documents can be sourced or organized by report dates

When configuring the Action Item step, select the Document Setup:

1. Settings > Action Types/Steps
2. Find the Action Item and drill down to the Step where the documents need to be added.
3. Click on the hamburger menu to the right and select “Documents”
4. Add one or more file paths using the  “+ Add new record” button.

Pulling Documents from the Library

• The Order Number dictates the order of the documents if you have multiple file paths
• If you want just one document, you’ll specify the path, including the full name of the document which includes the extension, such as .doc or .pdf  For example, file name would be welcome letter.pdf
• If you want all documents in a specific folder to be included, the file path to the folder will end with a slash (“/”).
• When working with an action item, any documents included on the Step setup will be sourced and included with the communication sent on that step.

Posting Documents to the Library

• To post attachments from the step to the document library instead of pulling them from the Document Library, select the “Output” checkbox
• If the file path configured does not exist in the Document Library, that path will be created automatically
• If the file path ends with a slash ("/"), the document(s) will be posted with their existing file names.
• If you specify a file name, any attachments will be combined into a single file with that file name.
  • If there are any non-PDF documents, the output file will be a .ZIP
  • If all documents are PDF, the output file is a PDF
• If any reports or letters are generated on the same step that is posting to the Document Library, the system will wait until the generations are complete prior to posting. In this instance there may be a few minutes before you see the documents in the Document Library.
• When working with an action item, any attachments included (either through the Existing Attachments field or Uploaded at that time) on the step configured to post documents will be saved in the specified location in the file path

Using Dynamic Tags in the File Path

It is possible to use dynamic tags in the file name so that documents can be sourced or organized by report dates. For example, if you wish to pull Invoice Images via an action item, a dynamic tag can be used to indicate the month and year.

• The proper format for a dynamic tag is [~ReportDate:XXXX~] where XXXX includes the specific info for the date.
  For example, if the file path is:   Documents/Bank Statements/2018/09/
  the dynamic file path would be:  Documents/Bank Statements/[~ReportDate:yyyy/MM~]/
• Syntax for a Year:
  • yyyy = Full Year (example: 2018)
  • yy = Two Digit Year (example: 18)
• Syntax for a Month:
  • MMMM = Full Name of the Month (example: January)
  • MMM = Abbreviation of the Month (example: Jan)
  • MM = Two Digit Month (example: 01)
  • M = Single Digit Month (example: 1)

Real-Use Example #1:

A New Owner Setup Action Item needs to generate a Welcome Letter and include several forms and documents for the new owner.

• The Welcome Letter step on the Action Item will include the Welcome Letter Template under the Letter Setup
• The same step would include a Document Setup with the File Path of "Documents/Welcome Packet/". We are not selecting the "Output" checkbox and we will include a "/" at the end of the file name to make sure that we get ALL documents in the folder.
  
• When the attachment is generated on this step, it will first show the Welcome Letter and then include all documents from the Welcome Packet folder in the Document Library

Real-Use Example #2

A Financial Delivery Action Item needs to post an approved financial packet to the Financials folder in the Association Document Library.

• An approval step on the action item will have a Document Setup with a file path of "Documents/Financials/[~ReportDate:yyyy/MMMM~] Financials.pdf"
  
• We use the "Output" box to indicate that we want to post the documents to the Document Library
• We are naming the document in the Document Library with the Year and Month. In this example, if we are working with our August 2018 financials, the actual file path would be: Documents/Financials/2018/August Financials.pdf