User Guide Version: 2019.
User Guide Version 2019.1 Last Revision: 2020-01-16 Objectif Lune, Inc. 2030 Pie-IX, Suite 500 Montréal, QC, Canada, H1V 2C8 +1 (514) 875-5863 www.objectiflune.com All trademarks displayed are the property of their respective owners. © Objectif Lune, Inc. 1994-2020. All rights reserved. No part of this documentation may be reproduced, transmitted or distributed outside of Objectif Lune Inc. by any means whatsoever without the express written permission of Objectif Lune Inc. Objectif Lune Inc.
Table of Contents Table of Contents 4 Welcome to PrintShop Mail Connect 2019.
Manager installations Page break changes in 2019.1 Minor differences in AFP and IPDS output introduced in 2019.1 Issue with image placement in 2019.1 when using some customized AFP and IPDS Printer Definitions Issue after erroneous or incomplete update or re-installation Backend database might require periodic maintenance Windows 10 Search service impacting Connect Job Creation Presets: External Sorting change introduced in 2018.2 Business Graphics: Backward Compatibility Issues introduced in 2018.
Contexts Sections Print Copy Fit Creating a Print template with a Wizard Print context Print sections Pages Master Pages Media Email Designing an Email template Creating an Email template with a Wizard Email context Email templates Email header settings Email attachments Content elements Element types Editing HTML Attributes Inserting an element Selecting an element Deleting an element Styling and formatting an element Barcode Boxes Business graphics Date Hyperlink and mailto link Images Table Text and spec
Editing a snippet Renaming a snippet Translating a snippet Styling and formatting Local formatting versus style sheets Layout properties Styling templates with CSS files Styling text and paragraphs How to position elements Rotating elements Styling a table Styling an image Background color and/or image Border Colors Fonts Locale Spacing Using a Sass file Personalizing content Variable data Conditional content Dynamic images Snippets Scripts Loading data Variable Data Formatting variable data Showing content
Email Preferences Emmet Preferences Engine Setup Language Setting Preferences Log Setting Preferences Print Preferences Project Wizards Saving Preferences Scheduling Preferences Scripting Preferences Writing your own scripts Script types Creating a new Standard Script Writing a script Managing scripts Testing scripts Optimizing scripts Loading a snippet via a script Loading content using a server's API The script flow: when scripts run Selectors in Connect Control Scripts Post Pagination Scripts Translating
Output Creation Presets Page breakdown Australia Post 4 State Settings 645 667 674 Codabar Settings 676 Code 128 Settings 679 Code 39 Settings 682 Datamatrix Settings 685 EAN-128 Settings 687 EAN-13 Settings 690 EAN-8 Settings 693 Interleaved 2 of 5 Settings 696 KIX Code (Dutch Post) Settings 698 Japan Post Settings 700 PDF417 Settings 702 QR Code Settings 705 Royal Mail 4 State Settings 709 Royal Mail 2D Settings 711 UPC-A Settings 713 UPC-E Settings 716 US Postal Service
Examples Examples Example Example Example Example Example Examples Creating a table of contents Example Examples Examples Examples Examples Replace elements with a snippet Replace elements with a set of snippets Example Example Creating a Date object from a string Control Script API Examples Post Pagination Script API Setting the margins of a Print section Setting the header and footer of a Master Page Generating output Print output Email output Generating Print output Print settings in a template Aborting
Aborting content creation Using an ESP with PrintShop Mail Connect Optimizing a template Scripts Images Print Manager Print Manager Introduction Video Print Manager usage Print Manager Interface Menu options Printers pane Printer Queue pane Job Queue pane Messages pane Job History pane Printer Capabilities pane Printer Status pane Print Manager Preferences License Update Required for Upgrade to Connect 2019.1 Overview OL Connect 2019.
Improved Data Filtering Options General Print Wizard Improvements Known Issues Previous Releases Overview Connect 2018.2.1 Enhancements/Fixes Connect 2019.1 Enhancements Connect 2019.1 Designer Updates Connect 2019.1 Output updates Print Wizard and Preset Wizard Improvements Connect 2019.1 Print Manager updates Known Issues Overview Connect 2018.1.6 Enhancements/Fixes Connect 2018.1.5 Enhancements/Fixes Connect 2018.1.4 Enhancements/Fixes Connect 2018.1.3 Enhancements/Fixes Connect 2018.1.
Connect 1.6.1 General Enhancements and Fixes Connect 1.6.1 Designer Enhancements and Fixes Connect 1.6.1 Output Enhancements and Fixes Known Issues Overview Connect 1.5 Designer Enhancements and Fixes Connect 1.5 Output Enhancements and Fixes Connect 1.5 General Enhancements and Fixes Known Issues Overview Connect 1.4.2 Enhancements and Fixes Connect 1.4.1 New Features and Enhancements Connect 1.4.1 Designer Enhancements and Fixes Connect 1.4.
Welcome to PrintShop Mail Connect 2019.1 Note Since we are always looking for new ways to make your life easier, we welcome your questions and comments about our products and documentation. Use the feedback tool at the bottom of the page or shoot us an email at doc@ca.objectiflune.com. PrintShop Mail Connect is a tool designed to optimize customer communications. It is designed to improve the creation, distribution, interaction and maintenance of your communications.
Setup And Configuration This chapter describes the PrintShop Mail Connect installation and the different considerations that are important in regards to the installation and use of PrintShop Mail Connect. l "System and Hardware Considerations" below l "Installation and Activation" on page 34 l "Known Issues" on page 86 l "Engine configuration" on page 26 System and Hardware Considerations There are a variety of considerations to be aware of.
Antivirus Exclusions Article #: INFO-0002A Product: PrintShop Mail Connect Version: 1.5 and up Description The information on this page is designed to assist IT managers and IT professionals decide what anti-virus strategy to follow with consideration to OL Connect and their internal requirements and needs.
l l l %USERPROFILE%\Connect\logs: As the name implies, log files are created and updated here. These log files are plain text files. Virus protection may have an impact on the speed of the whole Connect suite. %USERPROFILE%\Connect\temp: Storage folder for temporary data, usually intermittent files in multiple folders. Virus protection on this folder and its subfolders may have a serious impact on the performance of Connect. %USERPROFILE%\Connect\workspace: Usually containing settings and helper files an
Using the MySQL Instance from the Installer The MySQL Instance provided in the Installation Wizard is already pre-configured with options to provide the most stable back-end setup. These are the specific options that have been changed in our version of "my.ini": l l l max_connections = 200 : PrintShop Mail Connect uses a lot of database connections. This number ensures that even in high volume environments, enough connections will be available.
existing (External) database then you yourself must ensure that the External database is accessible to Connect. Objectif Lune Inc. will take no responsibility for database connections to any but the supplied MySQL database. Options available within the installer: l l l The Configuration page for the local MySQL is displayed. MySQL settings are pre-filled with default values if no existing MySQL database configuration is found.
l l l When MS SQL is selected, the default values for root user are sa and 1433 for the port. If database settings from a previous OL Connect installation are found, the pre-exising settings will be displayed for the matching database type. For MS SQL settings, this will only work if they were created with Server Config Tool 1.5.0 or later, or the Installer for OL Connect 1.6.0 or later.
Note The Microsoft SQL selection capability will be available only with 1.6 version and upwards. To remove this dependency the user needs to do the following 1. Have a foreign Microsoft SQL running, ready for use with Connect Server. 2. Use the Server Configuration Tool "Database Connection preferences" on page 341 to switch the database to Microsoft SQL. 3. Re-start the Connect Server Service, so that the modifications become active. 4. Counter check that everything is working properly with Microsoft SQL.
Important If a Server Product and a MySQL Product were selected to be installed on Connect 1.5.0, and then the Server Configuration Tool is used to switch the database used by the Server to an external Microsoft SQL, then the Update to 1.6 requires an extra step. The procedure is as follows: 1. Run the Update to Connect 1.6.
l l l VMWare Environments. This includes VMWare Player, VMWare Workstation as well as VMWare ESX Server. VMWare VMotion. This means the virtual machine hosting PrintShop Mail Connect can be automatically moved from one ESX server to another in a clustered installation. Microsoft Hyper-V/Azure infrastructure environments. PrintShop Mail Connect is not officially supported on any other virtual machines such as Virtual PC, Parallels, Bochs, Xen, etc.
Exclusion for more information. l Antivirus software might interfere with installation scripts, notably a vbs script to install fonts. McAfee, in particular, should be disabled temporarily during installation in order for MICR fonts to install and the installation to complete successfully. Windows Search Indexing Service Tests have concluded that the Windows Search service, used to provide indexing for Windows Search, can interfere with Connect when installing on a virtual machine.
l Language: l PrintShop Mail Connect is currently offered in several languages. These languages can be switch between via the Preferences dialog. The current languages include: l English l French l German l Spanish l Italian l Korean l Portuguese l Chinese (Simplified) l Chinese (Traditional) l Japanese. The default language is English. The PrintShop Mail Connect help system (this document) is currently only available in English.
Engine configuration The Designer cooperates with different engines to handle specific tasks. A Merge engine merges the template and the data to create Email output, or to create an intermediary file for Printed output. The intermediary file is in turn used by a Weaver engine to prepare the Print output. (For more information see: "Connect: a peek under the hood" on page 96). Settings for these engines are made in the Scheduling Preferences (Window > Preferences > Scheduling).
Number of Merge engines When first installed, PrintShop Mail Connect is configured to use 1 Merge engine. A Merge engine will run mostly single-threaded. To benefit from modern multi-core systems it is recommended that several Merge engines run in parallel. As a rule of thumb, you will want to run as many Merge engines as the system has cores. The print statistics message dialog shows both the number of Merge engines and cores.
Job size limits Job size is a relative concept. In a small service company a job may be considered large when it counts 1,000 records, whereas in an insurance company the same job may be seen as small. PrintShop Mail Connectlets you define job sizes by setting the maximum number of records in a small job, and the minimum number of records in a large job. Jobs that are neither small nor large are medium sized. (Note that the term 'records' refers to top-level records only. Detail records are not considered.
l l For complex templates with a lot of pages per document, there is a chance that the Merge engines will run better with more memory. For jobs with heavy graphics, jobs that use Cut & Stack impositioning and jobs that use particular variables that entail page buffering (see "Content variables" on page 868), the maximum memory usage of the Weaver engine can be relevant.
Configuring these engines to match the hardware configuration is probably the fastest and most effective way to improve Connect's performance. See "Engine configuration" on page 26. l l l Number of Merge engines. When first installed, PrintShop Mail Connect is configured to use 1 Merge engine. A Merge engine will run mostly single-threaded. To benefit from modern multi-core systems it is recommended to run several Merge engines in parallel. See "Number of Merge engines" on page 27. Job size limits.
l l l l l Use a high-performance, low-latency hard drive. Connect benefits from fast I/O. Preferably use a Solid State Drive (SSD) or similar for storage. Use at least 8+ GB High-Quality RAM. Check memory usage while the Print command is being executed to see if you need more than the minimum of 8GB. Assuming that the Designer needs 1GB each, and that each engine needs 1GB as well, you can roughly estimate how much memory is needed. Consider using a physical machine instead of a virtual machine.
Virtual Environments l VMWare/VSphere l Hyper-V l Azure l Amazon Web Services (AWS) Minimum hardware requirements As with any software application, minimum hardware requirements represent the most basic hardware on which the software will run. Note however that settling for the minimum specification is unlikely to produce the performance you expect from the system. It can be used when configuring a trial or a development system, however.
l Storage Type: Solid State Drive (SSD) l Networking: 10Gb Ethernet *1: depends on the amount of data you process through OL Connect. For instance, a PostScript file containing several thousands of documents could easily take up several GBs. Requirements for individual Connect modules OL Connect Products comprises multiple modules that can be operated separately on multiple PCs. Each module has its own set of requirements that may differ from the other modules.
Installation and Activation This topic provides detailed information about the installation and activation of PrintShop Mail Connect 2019.1. Note A PDF version of this guide is available for use in offline installations. Click here to download it. Where to obtain the installers The installers for PrintShop Mail Connect 2019.
l Installation l Silent Installation l Installation on machines without Internet access Activation For information on licensing, please see Activating your license. Installation Prerequisites l l l l l Make sure your system meets the System requirements. PrintShop Mail Connect Version 2019.1 can be installed under a regular user account with Administrator privileges. PrintShop Mail Connect must be installed on an NTFS file system. PrintShop Mail Connect requires Microsoft .NET Framework 4.
If generating Print output, PrintShop Mail Connect Designer requires permission on the printer or printer queue to send files. Installing PrintShop Mail Connect on Machines without Internet Access Installing PrintShop Mail Connect2019.1 in offline mode requires some extra steps. These are listed below. Updating Connect Updating to Connect 2019.1 from earlier Connect version In order to update PrintShop Mail Connect to 2019.1 it is first necessary to update the Connect License.
3. Now copy the PrintShop Mail Connect installer to the offline machine and start the installation as normal Windows certificate validation - Certificate Revocation List retrieval should be switched off For your security Objectif Lune digitally signs all relevant files with our own name and certificate. The integrity of these files is checked at various times by different, context related, methods. One of these checks, done during the installation process, uses the Windows certificate validation check. .
Starting the PrintShop Mail Connect installer The PrintShop Mail Connect installer may be supplied as an ISO image or on a DVD. l If an ISO image, you can choose between the following, depending upon your Operating System and the choices available: 1. Burn the ISO image onto a DVD 2. Un-zip the contents to a folder (keeping the internal folder structure intact) 3.
This allows for any number of people to use the Designer for creating jobs, but without production capabilities such as automation and commingling. l MySQL: A supplied MySQL database used by PrintShop Mail Connect. The database is used for referencing temporary Connect files and for sorting temporarily extracted data, and similar. A pre-existing MySQL or Microsoft SQL server (referred to as an external database, in this documentation) could be used instead, for the same purposes.
l l l l Disk space required: Displays the amount of space required on the disk by the selected components. Disk space available on drive: Displays the amount of space available for installation on the drive currently in the Installation Path. Recalculate disk space: Click to re-check available disk space. This is useful if space has been made available for the installation while the installer was open. Source repository location: Displays the path where the installation files are located.
must be entered or the update will fail. If the password is subsequently forgotten, then MySQL must be uninstalled and its database deleted from disk before attempting to reinstall. l l Confirm MySQL user 'root' Password: Re-enter to confirm the password. Both passwords must match for installation to continue. TCP/IP Port Number: The port on which MySQL will expect, and respond to, requests. A check is run to confirm whether the specified TCP\IP Port Number is available on the local machine.
obtain details. This information can then be provided to Objectif Lune for troubleshooting. l When ready, click the Finish button to close the installation wizard, and initialize the Product Update Manager, if it was selected. The Product Update Manager If the Configure Update Check option has been selected, a message will be displayed after clicking “Finish” in the setup. The message details the information that needs to be sent back to Objectif Lune Inc.
License. For details on how to upgrade the Connect License see "Users of Connect prior to 2019.1" on page 83 Required and optional properties PrintShop Mail Connect can be installed in a so called "silent mode" to allow an automated setup during a company wide roll-out or comparable situations. The trigger for the Connect Installer to run in silent mode is a text file with the fixed name install.properties, which is located either in the same folder as the PrintShop Mail_Connect_Setup_x86_64.
# Verbose logging logging.verbose = true # Product selection install.product.0 = Connect Designer install.product.1 = Connect Server # Server settings server.runas.username = Localadmin server.runas.password = admin # Database configuration database.type = mysql database.host = 192.168.116.10 database.port = 3308 database.username = root database.password = admin database.schema = my_ol Verbose logging (optional) By default, the Silent Installer will log the same way as the GUI installer.
Note The values of install.product properties must contain the exact product names. Server configuration (required if Server is selected for install) For Server, the following properties need to be provided: server.runas.username = server.runas.password = Server Extension configuration (required if Server Extension is selected for install) For Server Extension, the following properties need to be provided: server.runas.username = server.runas.password = server.
access. If the Silent Installer runs with the default product selection, MySQL is included, and hence the database.unlocked = true property may be optionally set if MySQL on this machine is intended to serve as the central database also for remote machines. If the Silent Installer runs with the explicit installation of a stand-alone (install.product.0 = Connect Server), the database.unlocked property is irrelevant. Note The port will be defined automatically for the MySQL installation.
2b: Configuring an external Microsoft SQL Server database Note Since PrintShop Mail Connect version 1.6 the minimum required version of the MS SQL Server is SQL Server 2012. To configure an external Microsoft SQL Server database, the following properties should be defined: database.type = Microsoft SQL Server (required) database.host = (default value is localhost, otherwise required) database.port = (default value is 1433, otherwise required) database.
Examples product.repository = http://192.168.79.73/Connect/Version_ 01/repository product.repository = C:\\iso\\2.0.0.39695_unpacked\\repository Locale definition It is possible to define the Locale which affects the installation language and installed locale for Connect products by using the following properties in the install.properties file: user.language user.country Locales supported by Connect The Connect Setup supports a dedicated list of Locales, which is saved in the preinstall.ini file.
with an error. For example, user.language = fr and user.country = CA will cause an error since fr-CA is not in the list of supported Locales. Locale selection by defining only user.language If only user.language is defined in the install.properties file, the Installer will attempt to find a Locale in the list which starts with the given language code. The first match is selected for installation. If no match is found, the Installer will exit with an error. For example: user.
4. In the local folder, the repository subfolder should now be located next to the preinstall.exe, installer.exe and other Installer files. 5. Create the install.properties file for silent installation in the local folder. 6. With a batch file calling preinstall.exe and then querying the %errorlevel%, silent installation can be started and the exit code can be evaluated. See the sample batch file below. Exit codes 0 = Success 1 = General Error in preinstall (e.g. not supported settings for user.
Activating a License PrintShop Mail Connect comes with a30 day trial license period during which time it is not necessary to have a commercial license to run the application. This allows time for reviewing the applications and for organizing a commercial license. If a modification to the trail license is required, such as to allow an extension to the trial period, or for extra functionality, then a new activation code will need to be requested.
l End-User License Agreement - Appears only when loading a license file: l l l l l l License: This box displays the EULA. Please note that this agreement is legally binding. I agree: Select to accept the EULA. This option must be selected to install the license. I don't agree: Select if you do not accept the EULA. You cannot install the license if this option is selected. Load License File: Click to browse to the Connect license file (.olconnectlicense), once it has been received.
Activating the PrintShop Mail Connect license requires the user to have local Windows Administration rights. l Using a user profile that has local Windows Administration rights, open the Start Menu l Click on All Programs, then browse to the Objectif Lune folder. l Run the “Connect Software Activation” tool. l l l Click the Load License File button, and browse for the .olconnectlicense file you received from Objectif Lune Inc.. Read the EULA and click the I agree option to accept it.
l "Installation Prerequisites" on page 35 l "Antivirus Exclusions" on page 16 Downloading and installing the software In order to migrate to a new workstation, the software must already be installed on the new workstation. Follow the "Installation and Activation" on page 34 guide to download and install the newest version of PrintShop Mail Connect on the new workstation.
[UserName]\Connect\workspace\configurations\PrinterDefinitionCo nfig l OMR Marks Configuration Files (.hcf): C:\Users\[UserName]\Connect\workspace\configurations\HCFFiles Where [username] needs to be replaced with your own Windows user name. Other Resources l l l l OL Connect Designer Templates or Package files, copied from the folder where they reside. All PostScript, TrueType, Open Type and other host based fonts used in templates must be reinstalled on the new workstation.
4. Import the following files and folders from the old server into their equivalent location on the new server: C:\ProgramData\Objectif Lune\PlanetPress Workflow 8\PlanetPress Watch\capture\PPCaptureDefault.mdb C:\ProgramData\Objectif Lune\PlanetPress Workflow 8\PlanetPress Watch\DocumentManager C:\ProgramData\Objectif Lune\PlanetPress Workflow 8\PlanetPress Watch\PGC 5.
l l Configure the DataMapper, Merge and Weaver engines preferences under Scheduling (see Engine Setup preferences). As of version 2018.1 these preferences include the minimum (Xms) and maximum (Xmx) memory utilization for the Server, Merge and Weaver engines . Configure any other options for the Clean-up Service. 3. If the version used on the new machine is 1.8/8.
Transferring software licenses Once all the above resources have been transferred over to the new server, it is recommended to thoroughly test the new system - in demo mode - with sample files under normal production load to identify points of improvement and make sure the output matches the user’s expectation. Output generated at this point will normally bear a watermark which can be removed by transferring licenses from the old server to the new one.
To apply the PlanetPress Capture License: 1. Open the Workflow Configuration. 2. Click on Help on the Menu Bar and click on PlanetPress Capture License manager to import your license. Uninstalling PrintShop Mail Connect from the previous workstation It is recommended to keep the previous install for a few days until everything is completed. However, once your transition is successful and complete, the OL Connect software must be uninstalled from the original server. See "Uninstalling" on page 94.
l Name: Enter a unique name. l URL: Enter a valid URL (including the protocol, e.g. http://). l Restore Defaults: Removes all custom servers from the list and resets to the default Capture OnTheGo server. The COTG Servers Preferences also provides you with buttons to : l l Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences.
The values below define when the specified targets are to be set as being ready for deletion, not when they are actually deleted. The actual deletion occurs only as per the cron job scheduling; or when PrintShop Mail Connect is started (if Run at application start up is selected); or when the Run Now button is pressed. l l l Enable clean-up service: Check to enable the Clean-up services. When checked, either or both of the Database clean-up and File clean-up services can be set individually.
l Threads to use for database deletions: The number of Threads to be used in the clean-up. PrintShop Mail Connect is a multi-threaded application, and the clean-up is likewise. Tip The default number of threads is considered the best compromise for running both clean-up and production jobs simultaneously. If experience suggests that the clean-up is not running efficiently, then upping the number of threads here would be recommended.
For example, if your longest job takes 45 to 50 minutes to run, then set the retention time to 55 minutes (or 1 hour) to ensure that all the database objects created during job processing survive for the duration of the job. l l l l l Minimum time to retain Job Sets: The minimum time a Job Set (and all the jobs information it contains) is retained within the database before being set for deletion.
l l l Run Now: This will run the clean-up service immediately. Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog.
Tip If the Test Connection button shows that the database cannot be successfully connected to using the selected settings, then the contents of this field could be used to try to connect to the database outside of PrintShop Mail Connect. This should help in determining and refining the acceptable connection options. l l Hostname: Enter the IP Address or alias of the server where database resides. Database Instance Name: Enter an existing Microsoft SQL Server's instance name.
Connect is installed upon (CPU speed and the amount of cores being the major determinants). Tip Leaving this value set to the default maximum should be the best option in most circumstances. We recommended this entry be left at the default value. l Custom database parameters table: These are extra parameters which are appended to the database connection URL. The default values are those which have been determined to be useful in connecting to specific vendor databases.
l l l Test Connection: This will run a test on the current Database Connection settings. Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog.
l l Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog. -----------------------------------------------------------------------------------------Editing preferences These preferences define different editing options in the Designer module.
separate groups of rules have new lines between them. l l l l Compressed: This output style minifies the output. It has no whitespace except that necessary to separate selectors and a new line at the end of the file. It also includes some other minor compressions, such as choosing the smallest representation for colors. It's not meant to be human-readable. Expanded: This is the default output style. Each property and rule take up one line.
l l l Bleed box: This color delineates the printable area on a page; see "Page settings: size, margins and bleed" on page 138. Master pages: These edges are only visible on Master pages; see "Master Pages" on page 145. l l l Margins: This color delineates the content area on a page; see "Pages" on page 137. Header and Footer Margin: This color highlights the header and footer margin set for the Master page; see "Adding a header and footer" on page 146.
l l Email Address: Enter the email that is set by default in the "From Email" field in the Send Email and Send Test Email dialogs ("Send (Test) Email" on page 482). Litmus account Group: l Email Test address: If you have a Litmus account, enter the test address to use when sending a test email (see "Send (Test) Email" on page 482). For more information on Litmus, please see http://litmus.com/.
l Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog. -----------------------------------------------------------------------------------------Emmet Preferences Emmet is a framework that enables the lightning-fast creation of HTML code though the use of a simple and effective shortcut language resembling CSS Selectors (see "Emmet" on page 158).
If there is no need to transform the text while expanding it, create an Emmet snippet instead (see below). l New: Add a new abbreviation. l Name: The name of the abbreviation is also its trigger. l Context: The context in which the abbreviation is enabled (HTML, CSS, etc.). l Description: A short description of the abbreviation . l l Pattern: This defines what an abbreviation expands to.
without any transformation. l New: Click to create a new snippet. l Name: The name of the abbreviation is also its trigger. l Context: The context in which the snippet is enabled (HTML, CSS, etc.). l Description: A short description of the snippet. l Pattern: The pattern defines what a snippet expands to. l Automatically insert: This option doesn't affect how Emmet works in Connect Designer. l Edit: Modify the currently selected snippet.
l Edit: Click to modify the currently selected Variable. l Remove: Click to delete the currently selected Variable. The Emmet Preferences also provides you with buttons to : l l l Reload Engine. This allows you to reload the Emmet engine based upon the current settings. Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences.
l l Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog. -----------------------------------------------------------------------------------------Log Setting Preferences PrintShop Mail Connect logs the activities it undertakes whilst running.
l Rollover policy selection: Chose whether to retain Connect log files for a certain number of days (Daily logs) or based upon some predetermined hard disk usage limitations (Size-based logs). The selection are as follows: l Daily Logs: Use this setting to determine how many days Connect Logs are to be kept, before they are deleted. l l Size-based logs: Use this setting to restrict log file size, and to keep only a specified number of them.
Advanced Log Settings The Advanced settings over-ride the Overall logging settings, and provide a greater level of logging granularity. Warning Higher logging settings will have an impact upon Connect production speeds, as well as leading to substantially larger log files. The Advanced Log Settings should only be set in conjunction with advice from OL support, to ensure that only the most relevant settings are set to the higher logging levels.
l l Selected Printers: Lists the available Printer Definition Files in the system. Note that these are not installed Windows printers or printer queues, but PrintShop Mail Connect Printer Definition Files. Printer checkbox: This checkbox selects/deselects all printers in the list. Click to check all, click again to uncheck all.
Project Wizards Project Wizard deployment settings l Workflow Configurations l Encoding: By default, Project Wizards set the encoding of the Workflow configuration that they create to the encoding of the system on which the Designer runs (system default). If Workflow runs on another machine, and that system has a different active code page, Workflow may be unable to correctly interpret all the characters that are used in the configuration file (in path or file names, for example).
l Original: the directory in which the original file is stored. l Other directory: use the Browse button to select another directory. Backup files have the same name as the original file with two underscores and a progressive number (without leading zeros) at the end: originalname__1.OL-template, originalname__ 2.OL-template, etc. The Save Preferences also provides you with buttons to : l l Restore Defaults. This option restores the preferences to Defaults.
Engine Scheduling. The Scheduling Preferences also provides you with buttons to : l l Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog.
l l Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog. ------------------------------------------------------------------------------------------ Upgrading This page provides information about Upgrading to PrintShop Mail Connect version 2019.1.
Note that an erroneous or incomplete uninstall before a reinstall or upgrade to a newer version of OL Connect may cause issues (see Product or engine exits within a second of starting in Connect's Knowledge Base). Note If an error occurs during uninstallation or after/when re-installing Connect after uninstalling it, please see: Problems during a Connect installation or version upgrade in Connect's Knowledge Base. Connect: a peek under the hood Connect consists of visible and invisible parts.
The Connect database The Connect database is the database back-end used by Connect itself when processing jobs. It can be either the MySQL instance provided by the Connect installer, or a pre-existing (external) instance (see "Database Considerations" on page 17). All generated items (records, content items etc.) are stored in this database . Note Email content items are not stored in the Connect database.
Speed units The number of 'speed units' is the maximum number of Merge engines or Weaver engines that are allowed to work in parallel. The output speed of all engines together is limited to a certain number of output items (web pages, emails, or printed pages) per minute. How many speed units you have and what the maximum total output speed will be is determined by your licence and any additional Performance Packs you might have. PrintShopMail Connect always has just one speed unit.
The Update Client OL for Connect 2019.1 does not cater for standalone Connect Print Manager installations The Connect Print Manager is a standalone Connect tool that is used in production sites to manage print jobs. It can be installed and run on standalone machines without a Connect license. The Update Client for Connect 2019.1 looks for a Connect license as part of the update process, but it will not find one on standalone Connect Print Manager installations.
As "Scale to Fit" is now switched on by default in all standard Connect 2019.1 AFP and IPDS Printer Definitions, none of those should encounter the issue. This issue will be fixed in a subsequent patch release.
Backend database might require periodic maintenance Databases maintain a variety of statistics in order to optimize performance. When high levels of inserts and/or deletions occur, the statistical data keeping can struggle to keep up. Over a period of prolonged and intensive processing this can result in a degradation in performance, with the whole database slowing down as it struggles to clean itself up.
C:\Users\\Connect folder. This issue will be fixed in a later release. Job Creation Presets: External Sorting change introduced in 2018.2 Versions prior to 2018.2 did not correctly save the line end characters for external sort configurations in Job Creation Presets, which meant the job could not be externally sorted. This issue has been fixed in version 2018.2. However, Job Creation Presets created with an earlier version may still have the wrong line end character for external sorting.
l Benton Sans CFF font Minor differences in PCL, AFP and IPDS output introduced in 2018.1 The browser component (Mozilla Gecko) used in the WYSIWYG editor of the Designer was updated for Connect 2018.1. This allows use of new CSS properties, such as flexbox. However this update could lead to increased output file sizes for some PCL, AFP and IPDS jobs.
Print Output: Booklet Impositioning changes introduced in 2018.1 When Booklet Impositioning is enabled, all pages within a document need to be changed to duplex prior to Impositioning . The method for duplexing jobs has been changed to now always combine existing pages into the front and backsides of sheets, rather than adding empty backsides to any simplex pages. The result is that now every document in the job becomes a booklet without any empty pages between the first page and the last page.
Only one of the above language tags should be selected. Once saved, Connect will appear in the selected language at next start-up. GoDaddy Certificates When installing Connect offline, dialogs allow installing the GoDaddy certificates. Most users should use the default settings and click Next. In some cases, however, this may not work correctly.
also sometimes be the case that text and images can be slightly displaced. These are known issues and will be addressed in a later release of Connect. Magic Number changes when installing Docker Installing Docker on a system where Connect has already been installed may impact Connect's licensing mechanism and require reactivation. Note Installing Connect after Docker has already been installed will not cause issues.
Impacts upon other Applications and Services l l The Uninstall will terminate the installed Server / MySQL service(s). The following applications / services should be stopped in a controlled fashion, before running the PrintShop Mail Connect Uninstall: 1. PrintShop Mail Connect 2. Connect products on remote systems which refer to this MySQL database. Uninstallation Wizard The uninstallation is done by running the PrintShop Mail Connect Setup Wizard in uninstall mode.
Connect: a peek under the hood Connect consists of visible and invisible parts. The visible part is of course the Designer, that you use to create templates and Print Presets. The invisible parts process the Connect job to provide the actual output. This topic introduces you to those parts. Here's a simplified, graphical representation of the architecture of PrintShop Mail Connect. The Connect database The Connect database is the database back-end used by Connect itself when processing jobs.
Note Email content items are not stored in the Connect database. A clean-up of the database is performed at regular intervals in accordance with the settings (see "Clean-up Service preferences" on page 337). The File Store Connect has its own File Store which it uses for transient files. The Clean-up service takes care of removing obsolete files when those files are not marked as permanent (see "Clean-up Service preferences" on page 337). The engines DataMapper engine.
by the number of speed units, only applies to the Weaver engine; when creating Email , the limit applies to the Merge engines only (the Weaver engine is not involved). So, when generating Print output, multiple Merge engines can be used. The number of Merge engines is only limited to one when creating Email output. Each Merge engine and each Weaver engine needs at least one speed unit.
l l l .OL-package: A transfer file used to package one or many of the above files (the data model being part of both the template and the data mapping configuration). Created by using the File > Package dialog. (See "Package dialog" on page 460.) .OL-script: One or more Designer scripts. Scripts personalize the output of a template. They are either added via wizards (see "Personalizing content" on page 312) or selfwritten (see "Writing your own scripts" on page 360).
The Designer The Designer is a WYSIWYG (what you see is what you get) editor that lets you create templates for various output channels: Print, Email and Web. A template may contain designs for multiple output channels: a letter intended for print and an e-mail variant of the same message, for example. Content, like the body of the message or letter, can be shared across these contexts. Templates are personalized using scripts and variable data.
page 102. 2. Fill the template Add text, images and other elements to the template and style them. See "Content elements" on page 179 and "Styling and formatting" on page 270. 3. Personalize the content Personalize the content using variable data. See "Personalizing content" on page 312. 4. Generate output Adjust the settings, test the template and generate output: letters andemails. See "Generating output" on page 856. Note that steps 2 and 3 are not necessarily to be followed in this order.
"Personalizing content" on page 312. Personalize your customer communications using variable data. "Writing your own scripts" on page 360. Scripting can take personalization much further. Learn how to script via this topic. "Generating output" on page 856. Learn the ins and outs of generating output from each of the contexts. Templates The Designer is a WYSIWYG (what you see is what you get) tool to create templates. This topic gets you started.
After creating a template you can add the other contexts (see "Contexts" on page 109), as well as extra sections (see "Sections" on page 110), to the template. It is, however, not possible to use a Template Wizard when adding a context or section to an existing template. Tip If an Email context is going to be part of the template, it is recommended to start with an Email Template Wizard; see "Creating an Email template with a Wizard" on page 160.
Saving a template A Designer template file has the extension .OL-template. It is a zip file that includes up to 3 contexts, all the related resources and scripts, and (optionally) a link to a data mapping configuration. To save a template, select File > Save or press Ctrl+S. The first time you'll have to give the template a name. File > Save as allows you to save the template with a different name. Tip To quickly copy the name of any other file, set Save as type to Any file (*.*) in the Save dialog.
Auto Backup Connect Designer can automatically create a backup file when you manually save a template. To configure Auto Backup: 1. Select the menu option Window > Preferences > Save. 2. Under Auto backup, check the option Enable to activate the Auto Backup function. 3. Type the number of revisions to keep. 4. Select the directory in which the backups should be stored.
Exporting a template report A template report can be used for archiving purposes or to provide information about the template to people who do not have access to Connect. Such a report can be exported in PDF or XML format. By default it contains a summary of the template with an overview of all the settings and resources that are used in the template: media, master pages, contexts, sections, images, scripts etc. The file properties are included as well (see "File Properties dialog" on page 440).
documents and splitting the print jobs into smaller print jobs, as well as the more standard selection of printing options, such as binding, OMR markings and the like. See "Job Creation Presets" on page 632 and "Output Creation Presets" on page 645 for more details. Package files can be opened by other Connect users. To open the Package dialog, select File > Package.... For an explanation of the options in it, see "Package dialog" on page 460.
See also: "Loading a snippet via a script" on page 379 and "Writing your own scripts" on page 360. Note When referring to images or fonts from a CSS file, you need to remember that the current path is css/, meaning you can't just call images/image.jpg. Use a relative path, for example: #header { background-image: url('../images/image.jpg'); } External resources External resources are not stored in the template, but on the local hard drive or on a network drive. They are accessed using a path.
Contexts Contexts are parts of a template that are each used to generate a specific type of output: Email or Print. l l The Print context outputs documents to either a physical printer or a PDF file; see "Print context" on page 123. The Email context outputs HTML email, composed of HTML code with embedded CSS. See "Email context" on page 163. When a new template is made, the Context appropriate to that new template is automatically created, including one section.
Adding a context To add a context, right-click the Contexts folder on the Resources pane and click New print context, New email context or New web context. Or use Context > Add in the main menu. Only one context of each type can be present in a template. Each context, however, can hold more than one section; see "Sections" below. Deleting a context To delete a context, right-click the context on the Resources pane and click Delete.
Email Template Wizard; see "Creating an Email template with a Wizard" on page 160. After creating a template, contexts can be added to it, but that can not be done with a wizard. Importing a section To import a section from another template, click File > Import Resources... in the menu. See: Import Resources dialog. Remember to copy the related source files, such as images, to the other template as well.
3. Add a new section (see "Adding a section" on page 110, above). 4. Go to the Source tab and paste the contents of the other section here (press Ctrl+V). 5. When copying a section to another template, add the related source files, such as images, to the other template as well. Tip The easiest way to copy a section to another template, is to use the Import Resources dialog in the other template. See: Import Resources dialog.
1. On the Resources pane, expand the Contexts folder. 2. Expand the folder of the respective context. 3. Right-click the name of the section, and then click one of the options. Applying a style sheet to a section In order for a style sheet to be applied to a specific section, it needs to be included in that section. There are two ways to do this. Drag & drop a style sheet 1. Click and hold the mouse button on the style sheet on the Resources pane. 2.
Note Style sheets that are linked to (i.e. included in) a section show a chain icon in the Resources pane (see "Resources pane" on page 525). Arranging sections Changing the order of the sections in a context can have an effect on how they are outputted; see: "Print sections" on page 127, "Email templates" on page 166 and Web pages.
Print Connect supports a number of different types of print outputs. These include: l l AFP IPDS (spool file created by Connect, with printer control available through the "Print Manager" on page 884) l PCL l PDF l PostScript (including the PPML, VIPP and VPS variants) With the Designer you can create one or more Print templates and merge the template with a data set to generate personal letters, invoices, policies, or any other type of letter you can think of.
next page. This happens automatically, based on the section's page size and margins; see "Page settings: size, margins and bleed" on page 138. The minimum number of pages can be set via the Print section properties; see "Print section properties" on page 481. Although generally the same content elements can be used in all three contexts (see "Content elements" on page 179), the specific characteristics of pages make it possible to use special elements, such as page numbers; see "Page numbers " on page 139.
The Media will not be printed, unless this is specifically requested through the printer settings in the Print Wizard; see "Generating Print output" on page 857. See "Media" on page 148 for further explanation about how to add Media and how to apply them to different pages. Copy Fit Copy Fit is a feature to automatically adjust the font size of text to make it fit the available space. It could be used for the name of a person on a greeting card, for instance, or for the name of a product on a shelf talker.
See "Print context" on page 123 and "Print sections" on page 127 for more information about Print templates. Tip Use the Outline pane at the left to see which elements are present in the template and to select an element. Use the Attributes pane at the right to see the current element's ID, class and some other properties. Use the Styles pane next to the Attributes pane to see which styles are applied to the currently selected element.
The Wizard opens the Print section, so that you can fill it with text and other elements; see "Content elements" on page 179. It already has two Positoned Boxes on it: one on the front, for text, and one on the back, for the address. See "Print context" on page 123 and "Print sections" on page 127 for more information about Print templates. Formal letter The Formal Letter Wizard first lets you select the page settings, see "Page settings: size, margins and bleed" on page 138.
l l One Media. You can see this on the Resources pane: expand the Media folder. Media 1 is the Virtual Stationery that you have selected in the Wizard. It is applied to all pages in the Print section, as can be seen in the Sheet Configuration dialog. (To open this dialog, expand the Contexts folder on the Resources pane; expand the Print folder and rightclick "Section 1"; then select Sheet Configuration.) See "Media" on page 148. Selectors for variable data, for example: @Recipient@.
isn't saved with the template, the image remains external. Note that external images need to be available when the template is merged with a record set to generate output, and that their location should be accessible from the machine on which the template's output is produced. External images are updated (retrieved) at the time the output is generated. After clicking Next, you can change the settings for the page. The initial page size and bleed area are taken from the selected PDF.
On the next settings page (click Next to go there): l Choose the desired type of business document from the General drop-down. l Select a color for the colored parts of the document; see "Color Picker" on page 436. l Enter your contact details. l l Click the Browse button to select a logo, or select to use a placeholder logo or no logo at all. Select a PDF file with the letterhead stationery. Also see "Media" on page 148.
Print context The Print context is the folder in the Designer that can contain one or more Print templates. Print templates (also called Print sections), are part of the Print context. They are meant to be printed directly to a printer or a printer stream/spool file, or to a PDF file (see "Generating Print output" on page 857). The Print context can also be added to Email output as a PDF attachment; see "Generating Email output" on page 873.
l One Master Page is added to the template, as can be seen on the Resources pane, in the Master Page folder. In Print sections, there are often elements that need to be repeated across pages, like headers, footers and logos. In addition, some elements should appear on each first page, or only on pages in between the first and the last page, or only on the last page. Examples are a different header on the first page, and a tear-off slip that should show up on the last page.
It is also possible to exclude sections from the output, or to include a section only on a certain condition that depends on a value in the data; see "Conditional Print sections" on page 333. This can also be done using a Control Script; see "Control Scripts" on page 390. Printing on both sides To print a Print section on both sides of the paper, that Print section needs to have the Duplex printing option to be enabled; see "Enabling double-sided printing (Duplex, Mixplex)" on page 135.
1. Create a Job Creation Preset that overrides the settings of one or more sections: select File > Presets and see "Job Creation Presets" on page 632 for more details. 2. Select that Job Creation Preset in the Print wizard; see "Generating Print output" on page 857. Setting the bleed The bleed is the printable space around a page. It can be used on some printers to ensure that no unprinted edges occur in the final trimmed document. The bleed is one of the settings for a section.
Converting RGB black to CMYK black In Print output, black is by default output as a CMYK color. RGB black is converted into CMYK black. If that is not desirable for any reason, it is possible to prevent it: 1. Right-click the Print context in the Resources pane and select Color Output. 2. Enable the Keep RGB black in output option. In Connect versions prior to 2018.2, RGB black was not automatically converted to CMYK black.
Using headers, footers, tear-offs and repeated elements In Print sections, there are often elements that need to be repeated across pages, like headers, footers and logos. In addition, some elements should appear on each first page, or only on pages in between the first and the last page, or only on the last page. Examples are a different header on the first page, and a tear-off slip that should show up on the last page. This is what Master Pages are used for.
name of a product on a shelf talker. This feature is only available with Box and Div elements in Print sections. For more information about this feature see "Copy Fit" on page 285. Adding a Print section The Print context can contain multiple sections: a covering letter and a policy, for example, or one section that is meant to be attached to an email as a PDF file and another one that is meant to be printed out on paper.
background image" on page 132. Note Via a Control Script, sections can be added to a Print context dynamically; see "Dynamically adding sections (cloning)" on page 400. Tip If you need a whole Print section to be visible in the output only under certain conditions, consider using the Conditional Print Section script wizard; see "Conditional Print sections" on page 333.
output in the order in which they appear on the Resources pane, so changing the order of the sections in the Print context changes the order in which they are outputted to the final document. To rearrange sections in a context: l l On the Resources pane, expand the Print context and drag and drop sections to change the order they are in. Alternatively, on the Resources pane, right-click a section in the Print context and click Arrange.
gives it less weight. In case of conflicting rules, style sheets read later will override previous ones. Note Style sheets are applied in the order in which they are included in a section. The styles in each following style sheet add up to the styles found in previously read style sheets. When style sheets have a conflicting rule for the same element, class or ID, the last style sheet ‘wins’ and overrides the rule found in the previous style sheet. Note Style sheets that are linked to (i.e.
l l l Resources lists the images that are present in the Images folder on the Resources pane. Disk lists image files that reside in a folder on a hard drive that is accessible from your computer. Click the Browse button to select a folder (or an image in a folder). As an alternative it is possible to enter the path manually. You can give a local path (e.g. C:\Images\Test.jpg) or use the "file" protocol. The complete syntax of a fully qualified URL with the "file" protocol is: file:///.
5. Select the PDF's position: l Fit to page stretches the PDF to fit the page size. l Centered centers the PDF on the page, vertically and horizontally. l Absolute places the PDF at a specific location on the page. Use the Top field to specify the distance between the top side of the page and the top side of the PDF, and the Left field to specify the distance between the left side of the page and the left side of the PDF.
Workflow process. This is called 'stamping'. In the unusual case where extracting text from the PDF that is the output of a Print section with a PDF background doesn't work, it is recommended to use this method. For more information, see this how-to: Stamping one PDF file on another. Setting the binding style for a Print section In printing, Finishing is the binding style, or the way pages are bound together.
Note Your printer must support Duplex for this option to work. To enable Duplex or Mixplex printing: 1. On the Resources pane, expand the Print context, right-click the print section and click Sheet configuration. 2. Check Duplex to enable content to be printed on the back of each sheet. 3. When Duplex printing is enabled, further options become available. l Check Omit empty back side for Last or Single sheet to reset a page to Simplex if it has an empty back side.
Scripts" on page 390 and "Control Script API" on page 811). This is especially useful when you need identical sections with different settings. Pages Unlike emails, Print sections can contain multiple pages. Pages are naturally limited by their size and margins. If the content of a section doesn't fit on one page, the overflow goes to the next page. This happens automatically, based on the section's page size and margins; see "Page settings: size, margins and bleed" on the facing page.
l Detail tables can be used in all contexts, but transport lines are only useful in a Print context; see Detail Table. Positioning and aligning elements Sometimes, in a Print template, you don't want content to move up or down with the text flow. To prevent that, put that content in a Positioned Box. See "Content elements" on page 179. When it comes to positioning elements on a page, Guides can be useful, as well as Tables. See "How to position elements" on page 286.
Whitespace elements: using optional space at the end of the last page Print sections with conditional content and dynamic tables (see "Personalizing content" on page 312) can have a variable amount of space at the bottom of the last page. It is useful to fill the empty space at the bottom with transpromotional material, but of course you don’t want extra pages created just for promotional data. 'Whitespace elements' are elements that will only appear on the page if there is enough space for them.
page 145. To insert a page number, select Insert > Special character > Markers on the menu, and then click one of the options to decide with what kind of page number the marker will be replaced: l l l l l l Page number: The current page number in the document. If a page is empty or does not display a page number, it is still added to the page count. Page count: The total number of pages in the document, including pages with no contents or without a page number.
Creating a table of contents A table of contents can only be created in a script. If you are looking to create a short, simple table of contents in one section, you could add a Standard Script that uses the pageRef() function. For an example, see "Creating a table of contents" on page 778. For a multi-page, cross-section table of contents you must use a Post Pagination Script; see "Creating a Table Of Contents" on page 407.
Preventing widows and orphans Widows and orphans are lines at the beginning or at the end of a paragraph respectively, dangling at the bottom or at the top of a page, separated from the rest of the paragraph. By default, to prevent orphans and widows, lines are moved to the next page as soon as two lines get separated from the rest of the paragraph. The same applies to list items (in unordered, numbered and description lists).
1. Open the Formatting dialog. To do this, you can: l l Select the paragraph using the breadcrumbs or the Outline pane (next to the Resources pane) and then select Format > Paragraph in the menu. Right-click the paragraph and select Paragraph... from the contextual menu. 2. After Widows and Orphans, type the minimum number of lines that should be kept together.
Inserting a page break To insert a page break before or after a certain element, set the page-break-before property or the page-break-after property of that element (a paragraph for example; see also "Styling text and paragraphs" on page 281): 1. Select the element (see "Selecting an element" on page 183). 2. On the Format menu select the respective element to open the Formatting dialog. 3. In the Breaks group, set the before or after property.
Alternatively you could set this property on the Source tab in the HTML (for example:
), or add a rule to the style sheet; see "Styling your templates with CSS files" on page 275. Adding blank pages to a section How to add a blank page to a section is described in a how-to: Create blank page on field value. Master Pages In Print sections, there are often elements that need to be repeated across pages, like headers, footers and logos.
l On the Resources pane, right-click the Master pages folder and click New Master Page. l Type a name for the master page. l l Optionally, set the margin for the header and footer. See "Adding a header and footer" below. Click OK. Initially, the master page that has been created together with the Print context will be applied to all pages in the Print section.
1. First insert elements that form the header or footer, such as the company logo and address, on the Master Page; see "Editing a Master Page" on the previous page. 2. Next, define the margins for the header and footer. The margins for a header and footer are set in the Master Page properties. This does not change the content placement within the Master Page itself; in Master Pages, elements can go everywhere on the page.
4. Decide which Master Page should be linked to which sheet (position): click the downward pointing arrow after Master Page Front and select a Master Page. If Duplex is enabled, you can also select a Master Page for the back of the sheet and consequently, check Omit Master Page Back in case of an empty back page to omit the specified Master Page on the last backside of a section if that page is empty and to skip that page from the page count. 5. Optionally, decide which Media should be linked to each sheet.
Per Media, a front and back can be specified and you can specify on what kind of paper the output is meant to be printed on. This includes paper weight, quality, coating and finishing; see "Setting Media properties" below. Adding Media To add a Media, right-click the Media folder on the Resources pane and select New Media. The new Media is of course empty. You can specify two PDF files for the Media: one for the front, and, optionally, another for the back.
3. On the Virtual Stationery tab, you can click the Select Image button to select a PDF image file. Note Encrypted PDF files are not supported in PDF pass-through mode. l Click Resources, Disk or Url, depending on where the image is located. l l l Resources lists the images that are present in the Images folder on the Resources pane. Disk lists image files that reside in a folder on a hard drive that is accessible from your computer.
l With an external image, you can check the option Save with template. If this option is checked, the file will be inserted in the Images folder on the Resources pane at the top left. If it isn't saved with the template, the image remains external. Note that external images need to be available when the template is merged with a record set to generate output, and that their location should be accessible from the machine on which the template's output is produced.
2. Specify the paper's characteristics: l l l l l l l Media Type: The type of paper, such as Plain, Continuous, Envelope, Labels, Stationery, etc. Weight: The intended weight of the media in grammage (g/m2). Front Coating: The pre-process coating applied to the front surface of the media, such as Glossy, High Gloss, Matte, Satin, etc. Back Coating: The pre-process coating applied to the back surface of the media.
2. Optionally, check Duplex to enable content to be printed on the back of each sheet. Your printer must support duplex for this option to work. If Duplex is enabled, you can also check Tumble to duplex pages as in a calendar, and Facing pages to have the margins of the section switch alternately, so that pages are printed as if in a magazine or book. 3. If the option Same for all positions is checked, the same Media will be applied to every page in the print section. Uncheck this option. 4.
3. In the area for the respective sheet position, click the Edit script button next to Media. The Script Wizard appears with a standard script: results.attr("content","Media 1"); Media 1 will have been replaced with the name of the media selected for the chosen sheet position. The field Selector in the Script Wizard contains the name of the section and the sheet position that you have chosen. 4. Change the script so that on a certain condition, another media will be selected for the content.
displayed in each section (see "Setting Media properties" on page 149). l Section backgrounds are rotated separately (see "Using a PDF file as background image" on page 132). If in the Media properties, the Virtual Stationery position is set to Absolute, any offset given by the Top and Left values will be applied after rotation. A Virtual Stationery image located absolutely at the top left (Top: 0, Left: 0) will still appear at the top left of the page after rotating the Media.
standards (to a significant extent), email clients do not. Different email clients interpret the same HTML and CSS styles in totally different ways. When an Email template is created, either with a Wizard or by adding an Email context to an existing template (see "Adding a context" on page 110), the Email context folder is created along with other files that are specific to an Email context; see "Email context" on page 163.
This topic explains why designing HTML email design is as challenging as it is, which solutions are used in the Email Template Wizards and it lists good practices, for example regarding the use of images in HTML email. It will help you to create the best possible Email templates in the Designer. HTML email challenges Creating HTML email isn't like designing for the Web. That's because email clients aren't like web browsers.
Tip Click the Edges button on the toolbar to make borders of elements visible on the Design tab. The borders will not be visible on the Preview tab or in the output. Litmus There are several tools to preview how email will be rendered on a variety of clients. We recommend using Litmus. Support for Litmus is integrated into the Designer; the Send Test Email dialog has an option to "Send to Litmus".
Preferences To change the way Emmet works in the Designer, select Window > Preferences, and in the Preferences dialog, select Emmet; see "Emmet Preferences" on page 349. Using CSS files with HTML email Email clients do not read CSS files and some even remove a