User Guide


Help Programs Creating a Program Creating a Campaign Publishing Programs Saving Programs Building Workflows Users Adding New Users Roles and Permissions Sharing and Collaboration Contacts Importing Contacts Custom Fields Elements Target Audience Microsite Direct Mail Email SMS Facebook LinkedIn Twitter HP SmartStream Raw Data Extract Events Events Goals Scores FAQs Common Questions Developers APIs and MAML APIs More Resources Change Log Knowledge Base

HP SmartStream Outbound App

Configure the HP SmartStream OutboundApp Intermediate

This document provides help and step-by-step instructions for preparing an HP print template as well as configuring the HP SmartStream OutboundApp within MindFire Studio campaigns. This outbound app allows you to upload a new print template or manage templates you have already uploaded.


Prerequisites:

Before getting started, you will need the following:

  • Adobe InDesign CS6 or newer with HP SmartStream Designer plugin
  • A MindFire Studio account to create your campaigns
  • Access to the HP SmartStream OutboundApp element

Instructions:

1. Design your document with Adobe InDesign CS6 (or newer)

2. From within HP SmartStream Designer plugin, add the necessary variables and rules to your document and save it

3. Go to Tools menu and click on Pack Job menu

Pack Job - menu and window

HP SmartStream Designer Plugin's Pack Job menu and window: This menu will be used to pack a document for being used in the HP SmartStream OutboundApp.


4. In the Pack Job window, check Include Fast Template box and click on button

5. An .hpd file should be now created that can be used for print purposes through MindFire Studio campaigns

In order to add a print piece to your campaign, please follow these steps:

1. Either start a new campaign or open one of your saved/published ones

2. From Outbounds menu, drag and drop an HP SmartStream element to the canvas

3. Connect this element to either a TargetAudience or a Trigger element

4. Double click on the HP SmartStream element to open its properties window

5. If desired, you can modify the element's name in the same way you would for all other elements, then Navigate to the Configuration tab

6. If this is the first time using an HP SmartStream element, if you would like to upload more print templates to your account, or if you would like to view a sample PDF of print available print templates (if any), click on Template File Name field, then click on the link under the drop down

7. From Template File Name field, select the print template you would like to be used for print purposes through your campaign

8. From Is Template Imposed? field, select Yes, if you have set up impositioning through HP SmartStream Designer plugin in Adobe In-Design. Otherwise, select No. Please refer to Image_12 for a sample impositioned output.

9. Click on Delivery Method and select the method you would like to receive the output file (this can be either an email, a FTP or both)

10. Based on your selection in the previous step, provide values for the remaining fields (Email Address and/or FTP URL, FTP User Name and FTP Password)

11. Navigate to the Settings tab

12. Based on your print template selection under the Configuration tab, you need to add all the variables used in the template and map them to their equivalent fields from Studio. Repeat the following steps to add as many fields as required:

  • Click on button. You will see something similar to Image_2: HP SmartStream's Settings tab is where you map the print template variables with their equivalent standard/custom Studio field names.
  • Change "Column1" in Field Name box to one of the fields in your template. For instance: FirstName
  • Change "Column Content" in Field Value box to a Studio standard/custom field name. For instance: ##firstname##

13. Navigate to the Schedules tab, add a schedule and click on button

HP SmartStream Settings tab

HP SmartStream's Settings tab is where you map the print template variables with their equivalent standard/custom Studio field names.

The HP SmartStream Outbound App allows you to upload a new print template or update/delete/preview the ones that are already uploaded.

In order to bring up the Template Upload page to upload new template(s), or later on, to manage your uploaded templates, follow these steps:

1. Open a new campaign

2. From the toolbox, click on Outbounds and drag and drop an HP SmartStream element onto the canvas

3. Double-click on the element and navigate to the Configuration tab

4. Click on Template File Name (if it is not highlighted) field, and then on the link under the drop down

Upload a new print template or manage the existing ones

In order to Upload a new print template or manage the existing ones, go to the Configuration tab of the HP SmartStream element and click on Template File Name field in order to see the above link.

Select an action

When you land on the TemplateUpload page, you need to select an action; upload a new print template, or manage the one you have already uploaded.


4a. Depending on what you plan to do, read the related sub-section below

5. After you are done, close the window to return to the previous (Properties) window


I) Uploading a New Print Template:

  • From the drop down, select the 2nd option: Upload a new print template (When you select to upload a new print template, you are required to provide the print template file) Upload a New Print Template
  • Click on the Browse button for print template to select the desired print template (.hpd file)
  • If desired, click on the button for the preview and select a PDF file that represents the print template
  • Click on button and wait until you see a success (green) or error/failure (red) message Upload the File Green Success Message
  • Repeat steps 1 to 4 to upload more print templates (as necessary)

II) Updating Existing Print Templates:

  • From the drop down, select one of the available print templates
  • If you would like to update your print template, click on the first button and select a HPD file with the same name as current file (i.e. the name that is displayed in the drop down)
  • Click on Update button ONLY once and wait until you see a success/failure (green/red) message

III) Deleting Existing Print Templates and Their Preview Files:

  • From the drop down, select one of the available print templates. You should see a window similar to Image_6.
  • Click on button ONLY once and wait until you see a success/failure (green/red) message
  • Repeat steps 1 and 2 to delete more print templates and their related preview files, if desired

Notes

  • Print template files should always have "hpd" extension
  • After a print template is uploaded, you cannot modify the template name. The new file should always have the same name as the currently uploaded file.
  • Before deleting a print template, always make sure that it is not used in any campaigns that have a future schedule. Or else, that request will fail.
  • Delete feature doesn't ask for any confirmation and will delete the print template, if available, immediately

The output (rendered PDF) file will be delivered to you either by sending an email with a link to download the file to your computer or by copying it to your FTP server. This depends on the option you have selected from the Delivery Method drop down in the Configuration tab of the HP SmartStream element's properties window. The email goes to the address that is specified in the Email Address field in the same tab as Delivery Method. You can provide multiple email addresses (separated with a comma or semi-colon). The email output looks like this:

Confirmation Email

This email is sent out after the print template has been rendered successfully.


In here we just provide you with some screenshots of different menus in the HP SmartStream Designer plugin to give you a general idea of how this plugin can assist you to design your artwork and add variable pieces to it.

Sample artwork

Sample artwork: The graphics designer designs the background first, then adds the variable components. He/she can then, preview the expected result in InDesign.


Setting the Colors

Setting the Colors: A designer rule is defining the assignment between the color and a PDF that draws the color.


Define the QR Code

Define the QR Code.


Create an HP Document File

After your artwork is complete and saved, you need to pack it in order to create an HP Document (HPD) file for using in MindFire Studio.


Sample PDF

Sample impositioned PDF rendered by HP SmartStream Composer: Left side is the 1st page of the PDF and right side is the 2nd page.




  • At the moment, we cannot populate the Settings fields based on the selected print template in the Configurations tab. Therefore, you should know what variables exist in that template and what are their exact names.
  • See known limitations to rendering templates here: HP Smartstream Composer Engine
  • Diagonal variable text is not supported in the template