Professional Documents
Culture Documents
2008 XMPie Inc. All rights reserved. U.S. Patents 6,948,115, 7,406,194 and pending patents.
uCreate
TM
Version 4.0.4 User Guide, Document Revision: 1.143, October 2008
For information, contact XMPie Ltd., 12 Hamelacha Street, POB 8687, Poleg Technology Park, Netanya 42504, Israel
Tel: +972 9 885 6750 Fax: +972 9 885 6747
More information can be found at www.xmpie.com
XMPie provides this publication "as is" without warranty of any kind, either express or implied. This publication may
contain technical inaccuracies or typographical errors. While every precaution has been taken in the preparation of
this document, the publisher and author assume no responsibility for errors or omissions. Nor is any liability assumed
for damages resulting from the use of the information contained herein. Changes are periodically made to the
information herein; these changes will be incorporated in new editions of the publication. XMPie may make
improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time.
ADOR, PersonalEffect, uChart, uCreate, uDirect, uEdit, uImage, uPlan, uProduce, uStore, X-DOT XLIM, XMPie, the
XMPie logo, and the slogan one to one in one are trademarks and/or registered trademarks of XMPie Inc. its
subsidiaries, and/or affiliates in the United States and/or other countries. All other company or product names are
the trademarks or registered trademarks of their respective holders. All rights not expressly granted are reserved.
Adobe Acrobat, Adobe Dreamweaver Adobe GoLive, Adobe Illustrator, Adobe InDesign, and Adobe Photoshop are
trademarks of Adobe Systems Incorporated.
SQL Server 2005, Windows Server 2003, Windows Vista, and Windows XP are trademarks or registered trademarks of
Microsoft Corporation.
Mac OS is a trademark of Apple Computer, Inc.
ComponentArt is a trademark of ComponentArt Inc.
Other trademarks and service marks are the property of their respective owners.
Contents
iii
Contents
Preface ............................................................................. xiii
Chapter 1: Introduction to PersonalEffect .......................... 1
The PersonalEffect Solution - Overview ...................................... 1
Dynamic Documents ........................................................ 1
Campaigns ..................................................................... 2
How Does PersonalEffect Work? ....................................... 3
PersonalEffect Core Applications ................................................ 4
uPlan ............................................................................. 5
uCreate .......................................................................... 6
uProduce ........................................................................ 6
PersonalEffect Architecture ........................................................ 8
Chapter 2: Working with uCreate Print ............................... 9
Installation and Upgrades from Previous Versions ..................... 10
Before Starting the Installation ....................................... 10
Installing uCreate .......................................................... 10
Hardware and Software Requirements ............................ 10
uCreate Palette ...................................................................... 11
Accessing the Options Menu ........................................... 13
Linking a Document to your Campaign Logic ............................. 16
Linking a Document to a Plan ......................................... 17
Linking a Document to a Data Source ............................. 19
Using the Rule Editor to Define Content Objects .............. 22
Adding Dynamic Images using uImage ........................... 30
Tagging Design Objects with Content Objects ........................... 43
Tagging a Design Object with a Text Content Object ........ 44
Tagging a Design Object with a Graphic Content Object ... 45
Tagging a Design Object with a Text File Content Object .. 45
Contents
iv
Adding or Removing a Style Content Object to or from Your
Design .......................................................................... 46
Tagging a Design Object with a Table Content Object ...... 48
Accessing Dynamic Object Properties ....................................... 52
Accessing Dynamic Text Properties ................................. 52
Accessing Dynamic Story Properties ................................ 53
Accessing Dynamic Graphic Properties ............................. 57
Accessing Dynamic Text File Properties ........................... 60
Accessing Dynamic Table Properties ................................ 61
Working with Proof Sets .......................................................... 61
Creating a Proof Set ...................................................... 62
Linking to a Proof Set .................................................... 62
Working with Content Samples ................................................ 64
Using XMPie Exchange Packages .............................................. 65
Generating a XLIM PDF Preview ...................................... 66
Importing Formatted Text into a Design ................................... 67
XNIP (*.xnip) File Format ............................................... 67
Importing Formatted Text using Content Objects ............. 69
Using Nested Composition .............................................. 70
Using Visibility Content Objects ................................................ 72
Using the Set Assets Folder Option ........................................... 75
Using the Dynamic Print Option ............................................... 75
Common Dynamic Print Properties .................................. 77
Policies View ................................................................. 77
Copies View .................................................................. 79
Step & Repeat View ....................................................... 79
Advanced View .............................................................. 81
Controlling Adobe PDF Settings ................................................ 83
Using Media Selection for Printing ............................................ 85
Using the Find and Replace Option ........................................... 86
Contents
v
Registering the uCreate License ............................................... 88
Setting Up XLIM Document Editing Permissions ......................... 88
Chapter 3: Working with uCreate XM ............................... 91
Installation and Upgrades from Previous Versions ..................... 93
Before Starting the Installation ....................................... 93
Installing uCreate XM .................................................... 93
Hardware and Software Requirements ............................ 93
Workflow Overview................................................................. 94
Setting up a New Dreamweaver Site ........................................ 95
Connecting the Dreamweaver Site to the uProduce Server ......... 98
Connecting the Dreamweaver Site to a Campaign Port on uProduce
............................................................................................ 99
uCreate XM for Dreamweaver ................................................. 100
Creating Your Sites Landing Page ................................. 100
Using uCreate XM Email ......................................................... 104
Creating the Email Message Content using Adobe
Dreamweaver with uCreate XM ..................................... 106
Creating an Email Activity ............................................. 108
Configuring uCreate XM to Track Web Events .......................... 111
uCreateXM ToolbarTracking Menu .............................. 111
Tracking Page Visits ..................................................... 112
Tracking Web Page Elements ........................................ 113
Appendix A: uCreate XM Web Server Prerequisites ........ 117
Verifying that IIS is Installed .................................................. 118
Creating a Virtual Folder ........................................................ 119
Verifying that Session State is Enabled .................................... 122
Caching ISAPI Applications ..................................................... 123
Appendix B: uCreate Rule Editing Functions ................... 125
String Functions .................................................................... 125
TitleCase Function ........................................................ 125
Contents
vi
lowercase Function ...................................................... 126
UPPERCASE Function ................................................... 126
Length Function .......................................................... 126
SubString Function ...................................................... 126
Find Function .............................................................. 127
Replace Function ......................................................... 127
FindAndReplace Function ............................................. 128
Trim Function .............................................................. 128
LeftTrim Function ........................................................ 128
RightTrim Function ...................................................... 128
Date Functions ..................................................................... 129
Age Function ............................................................... 129
FormatDate Function ................................................... 129
GetDay Function .......................................................... 129
GetMonth Function ...................................................... 129
GetYear Function ......................................................... 130
GetDayOfWeek Function .............................................. 130
GetHour Function ........................................................ 130
GetMinute Function ..................................................... 130
GetSecond Function ..................................................... 131
Now Function .............................................................. 131
Numeric Functions ................................................................ 131
ABS Function .............................................................. 131
Ceiling Function ........................................................... 131
Floor Function ............................................................. 132
FormatNumber Function .............................................. 132
Random Function ........................................................ 132
Round Function ........................................................... 132
Conversion Functions ............................................................ 133
Contents
vii
AsBoolean Function ...................................................... 133
AsDate Function ........................................................... 133
AsNumber Function ...................................................... 134
AsString Function ......................................................... 134
Bar Code Functions................................................................ 134
Defining a Dynamic Bar Code Content Object ................. 136
XMPBarCode128 Function ............................................. 138
XMPCODABAR Function ................................................ 138
XMPCode39 Function .................................................... 138
XMPEAN8 Function ....................................................... 139
XMPEAN13 Function ..................................................... 139
XMPInt2Of5 Function .................................................... 139
XMPMSI Function ......................................................... 139
XMPOneCode Function ................................................. 139
XMPPOSTNET (USPSZIP) Function ................................. 140
XMPUPCA Function ....................................................... 140
XMPUPCE Function ....................................................... 140
Miscellaneous Functions ......................................................... 140
FileExist Function ......................................................... 140
GetEnv ........................................................................ 140
Appendix C: Working with uChart ................................... 141
Using Enhanced Options ........................................................ 145
Appendix D: XLIM Capabilities ........................................ 151
Production ............................................................................ 151
Page Elements ...................................................................... 152
Image Content ...................................................................... 153
Text Content ......................................................................... 154
Inline Content ....................................................................... 154
Lines .................................................................................... 154
Contents
viii
Glossary ........................................................................... 155
Index ............................................................................... 161
List of Figures
ix
List of Figures
Figure 1: Dynamic Document Components ........................................... 1
Figure 2: Example Campaign: Different Documents Sharing the Same
Plan and Data Sources ............................................................................... 3
Figure 3: Handling Dynamic Documents with PersonalEffect ............ 4
Figure 4: uProduce Interactive Content Ports Technology ................... 7
Figure 5: PersonalEffect Architecture ...................................................... 8
Figure 6: XMPie uCreate PaletteAdobe InDesign ............................ 11
Figure 7: XMPie uCreate PaletteDesign Linked to a Plan ............... 12
Figure 8: uCreate Palette Options Menu ............................................... 13
Figure 9: Specify a Separator dialog ...................................................... 20
Figure 10: Specify a Separator dialog .................................................... 20
Figure 11: Convert to Plan File Confirmation Message ...................... 21
Figure 12: Save Plan As dialog ............................................................... 21
Figure 13: Rule EditorEdit Content Object "First Name" ................ 23
Figure 14: Style Overrides dialog ........................................................... 25
Figure 15: Rule EditorExample Text Content Object Rule .............. 27
Figure 16: Select Data Source dialog ...................................................... 29
Figure 17: Rule EditorTable Content Object ..................................... 29
Figure 18: uCreate PaletteNew Table Content Object ..................... 30
Figure 19: uImage Settings dialog .......................................................... 31
Figure 20: uImage Settings dialog - Advanced Settings ..................... 32
Figure 21: New Content Object dialog - uImage Template Properties
..................................................................................................................... 33
Figure 22: Insert Object dialog ................................................................ 34
Figure 23: uImage Defaults ..................................................................... 39
Figure 24: XMPie Exchange Import dialog ........................................... 40
List of Figures
x
Figure 25: Changing the Type of an Assigned Content Object
Warning ..................................................................................................... 41
Figure 26: Deleting an Unassigned Content ObjectWarning ......... 42
Figure 27: Deleting an Assigned Content ObjectWarning.............. 43
Figure 28: Edit Content Object dialog ................................................... 47
Figure 29: Style Overrides dialog ........................................................... 48
Figure 30: Dynamic Table Properties dialog ........................................ 49
Figure 31: Example Dynamic TablePopulated by the Table Content
Object Values ............................................................................................ 50
Figure 32: Dynamic Table Properties dialog ........................................ 51
Figure 33: Example Dynamic Table (before Table Content Object
columns are assigned to the Mold rows) .............................................. 51
Figure 34: Dynamic Story Length Handling dialog ............................ 55
Figure 35: Dynamic Graphic Properties dialog .................................... 57
Figure 36: Maintaining Transparency using X-DOT Technology ..... 59
Figure 37: Example Proof Set (Displayed using uPlans Proof Set Viewer)
.................................................................................................................... 61
Figure 38: Proofing Options list ............................................................. 62
Figure 39: Opening a Proof Set ............................................................... 63
Figure 40: Viewing Content Samples .................................................... 64
Figure 41: XLIM Preview Selection dialog ............................................ 67
Figure 42: Saving a Text Snippet as a XNIP File (*.xnip) .................... 68
Figure 43: Using XNIP files in your Document .................................... 69
Figure 44: Export Adobe InDesign Tagged Text File .......................... 71
Figure 45: Adobe InDesign Tagged Text Export Options .................. 71
Figure 46: Nested Composition - New Content Object ....................... 71
Figure 47: Nested Composition .............................................................. 72
Figure 48: Dynamic Print dialogPolicies view ................................. 76
Figure 49: Dynamic Print dialog Copies view .................................. 79
Figure 50: Dynamic Print dialogStep & Repeat view ...................... 79
List of Figures
xi
Figure 51: Dynamic Print dialogAdvanced view ............................. 81
Figure 52: Adobe PDF Presets ................................................................ 83
Figure 53: Edit PDF Export Presets ........................................................ 84
Figure 54: Save PDF Export Preset ......................................................... 85
Figure 55: Dynamic Media Selection dialog ......................................... 86
Figure 56: Find and Replace dialog ........................................................ 87
Figure 57: Document Lock Options dialog ........................................... 89
Figure 58: uCreate XM Typical Connection Layout ............................ 92
Figure 59: Site Definition, Editing Files Part 1 ................................... 95
Figure 60: Site Definition, Editing Files Part 2 ................................... 95
Figure 61: Site Definition, Editing Files Part 3 ................................... 96
Figure 62: Site Definition, Testing Files ................................................. 96
Figure 63: Site Definition Remote Server Location .............................. 97
Figure 64: Site Definition Summary ....................................................... 97
Figure 65: Deploy Supporting Files to Testing Server dialog ............ 98
Figure 66: uProduce Connection dialog ................................................ 98
Figure 67: ICP Connection Details ......................................................... 99
Figure 68: Port dialog ............................................................................. 100
Figure 69: Bindings Palette .................................................................... 100
Figure 70: Landing Page dialog ............................................................ 101
Figure 71: Preferences Window ............................................................ 101
Figure 72: Set ADORs dialog ................................................................ 104
Figure 73: Dreamweaver, Manage Sites dialog .................................. 105
Figure 74: Landing Page dialog ............................................................ 106
Figure 75: Dreamweaver, Files panel .................................................. 108
Figure 76: Send Email on Page Load Window ................................... 109
Figure 77: uCreateXM ToolbarTracking Options ........................... 111
Figure 78: Tracking Menu with Checkmarks Indicating Tracking .. 112
Figure 79: Track Page Visits dialog ...................................................... 112
List of Figures
xii
Figure 80: Server Behaviors Palette with a Tracked Page Visit ....... 113
Figure 81: Track This dialog ................................................................. 114
Figure 82: Server Behaviors Palette with a Tracked Page Element . 115
Figure 83: Windows Components window ........................................ 118
Figure 84: Internet Information Services (IIS) Components ............. 119
Figure 85: Internet Information Services Window ............................ 119
Figure 86: Virtual Directory Creation Wizard Welcome Window .. 120
Figure 87: Virtual Directory Alias Window........................................ 120
Figure 88: Web Site Content Directory Window ............................... 121
Figure 89: Access Permissions Window .............................................. 121
Figure 90: Virtual Directory Properties Window ............................... 122
Figure 91: Application Configuration Window ................................. 122
Figure 92: Internet Information Services Window ............................ 123
Figure 93: Default Web Site Properties dialog ................................... 124
Figure 94: Application Configuration dialog ..................................... 124
Figure 95: Bar Code Creation Flow Chart ........................................... 135
Figure 96: New Content Object Bar Code dialog ............................ 136
Figure 97: uChart Properties dialog ..................................................... 142
Figure 98: Series Color Assignment dialog ......................................... 143
Figure 99: uChart, Example Chart Output before Modifications .... 149
Figure 100: uChart Enhanced Chart Options ..................................... 149
Figure 101: uChart, Example Chart Output after Modifications ..... 149
Preface
xiii
Preface
Welcome to PersonalEffect
TM
XMPie
InDesign
Technology. ADOR
stands for Automatic Dynamic-Object Replacement. This technology defines two key building
blocksDynamic Documents and Campaignsand provides the foundation for the applications
in the PersonalEffect suite and their interoperability.
Dynamic Documents
A Dynamic Document is a binding of three modular components: Data, Logic and Design
(Figure 1).
Figure 1: Dynamic Document Components
Production
Chapter 1: Introduction to PersonalEffect
2
The Design component is like a regular (Static) document, except that some of the design
objectssuch as text or graphic framesderive their content and/or appearance from
computations and vary for each recipient. Such design objects are called Dynamic Design
Objects (Dynamic Objects, in short). The terms (XMPie) Tagged Document or (XMPie) Dynamic
Document Template are sometimes used interchangeably with Design. The Logic component
of a Dynamic Document provides the set of Rules for such computations, and the Data
component provides the Data Source (for example, an Excel sheet or a database) for such
computations.
The modularity of the Dynamic Document construct enables changes in the Logic, Data, or
Design components to be carried out almost independently. Moreover, no special custom
programming is needed in order to bind these three components together into one Dynamic
Document. As a result, PersonalEffects implementation of Dynamic Documents promotes
highly concurrent and streamlined workflows.
Campaigns
A Campaign is a container that holds different Designs (such as a postcard; a personalized
website; a follow-up email etc.), which all share the same Logic and Data. Campaigns allow
you to efficiently produce different Dynamic Documents of various media types.
Practically speaking, the Dynamic Document components are represented by the following
Campaign components:
The Plan is represented by a Plan file
The Data is represented by Data Sources
The Design is represented by Documents
Campaigns are managed using XMPies uProduce Dashboard application (Figure 2).
The Campaign view is selected, showing the details of an example Campaign (Joy Travel).
The left pane shows a tree that lists the Campaigns shared components: a Plan, Data Sources
and Documents (as well as other components required to perform specific operations, such as
sending email). The Documents component is selected in the tree, displaying the Documents
page, which lists different Dynamic Documents that share the Campaigns Plan and
Data Sources.
The PersonalEffect Solution - Overview
3
Figure 2: Example Campaign: Different Documents Sharing the Same Plan and Data Sources
How Does PersonalEffect Work?
In PersonalEffect, the Dynamic Documents Logic component is represented by a Plan file; the
Data component is represented by a Data Source (for example, an Excel sheet or a database);
and the Design component is represented by a tagged, static document (for example, a tagged
InDesign document or a tagged HTML file).
The Plan defines the ADOR Objects (also known as Content Objects) that can be used by a
designer to tag design objects. Once a design object, such as a text frame or a graphic frame, is
tagged, it becomes dynamic. This means it derives its content and/or appearance from the
value of the ADOR Object with which it is tagged. For example, once a graphic frame is tagged
with a graphic ADOR Object named CarPicture, the frame will show the particular car
picture selected for this ADOR Object by the Plan's rules, as a function of each recipient's
profile (that is, the recipients data).
The Plan also defines the Data Schema, which describes the structure of a Data Source that can
be used by the Logic. The Data Schema specifies the following: the required tables; each tables
column headers (for example, First Name, Customer ID, etc.) and the type of data they
represent (for example, a string, an integer, etc.); and the relationship between these tables (for
example, a common field). For example, if the Data Schema defines a Data Source with three
tablesCustomers, Products, and Purchaseswhere each table has a given set of
column headers (holding given types of fields), and there is some relationship
1
between these
three tables, then any Data Source that supports this Data Schema can be used by the Dynamic
Document, regardless of whether it is an Oracle, MS SQL, or MS Access database.
In other words, whenever a particular Data Source and a Plan are bound together in a
Dynamic Document, they must adhere to the convention that the Data Sources schema (for
example, the databases schema) matches the Plans Data Schema.
1
An example of a relationship between tables is a common field: both the Customers table and the Purchases
table may share the customer_id field, where for Customers this field serves as a unique key, while for
Purchases it identifies purchases made by that customer.
Shared Components Different Documents
Campaign
Chapter 1: Introduction to PersonalEffect
4
The Design component of the Dynamic Document can be of several different types: for print it
is an Adobe InDesign document; for electronic media it is an HTML document; and other
types of Designs may be added in the future, or as you continue using the PersonalEffect
solution. The Dynamic Objects in the Design are tagged with the names and types of ADOR
Objects. Whenever a Design file and a Plan file are bound together as part of a Dynamic
Document, they must adhere to the convention that every tagged design object is calling upon
ADOR Objects that are defined in the Plan.
As described earlier, ADOR technology also provides the Campaign object, which essentially
defines a collection of Dynamic Documents. The unique property of a Campaign is that all of
its tagged Designs can be matched to the ADOR Objects defined by its Plan, and that the
Campaign's Data Source matches the Data Schema defined by its Plan. Whenever a Design is
added to a Campaign, it is automatically checked to see if it matches the Plans ADOR Objects.
Similarly, whenever the Data component is changed, it is automatically checked to see if it
matches the Data Schema. If there is a match, then the binding of the three components
Logic, Data and Designis automatic.
PersonalEffect Core Applications
PersonalEffect consists of three main applications: uPlan for specifying the Logic component
of a Dynamic Document (essentially the Rules, the Data Schema and the ADOR Objects
exported to the Design); uCreate for creating the Design component (that is, the Tagged
Documents); and uProduce for adding the Data component, binding the Logic, Data, and
Design into Dynamic Documents, and for processing them as needed (Figure 3).
Figure 3: Handling Dynamic Documents with PersonalEffect
uProduce: Binding
uCreate uPlan uPlan,
uProduce
These applications are highly specialized to address the needs of the professionals they are
serving: uPlan for the programmer or database administrator, uCreate for the designer or
studio manager, and uProduce for the production manager. Sometimes these disciplines are
handled by different people in different departments or organizations, and sometimes by one
or two professionals that cover all disciplines.
PersonalEffect Core Applications
5
The use of separate tools for different professions, but with the common foundations of
Dynamic Documents and Campaigns supporting them all, promotes a distributed, parallel
and collaborative workflow. This removes unnecessary coordination bottlenecks, and makes
the implementation of Dynamic Publishing projects much simpler, much more timely, and yet
highly creative and sophisticated.
uPlan
uPlan is a standalone application installed on your desktop machine running a Windows
or a
Mac OS
operating system. It is used for creating the Campaigns Plan file, which defines the
ADOR Objects, Data Schema and Rules.
The Plan file consists of the following elements:
A Data Schema, which describes the structure of the Data Source needed to drive the
Campaign.
A set of ADOR Objects, which can be used for tagging design objects (for example, by
using uCreate), thereby transforming them into Dynamic Objects
A set of Variables, which are similar to ADOR Objects, except that they cannot be used for
tagging design objects (they are internal to the Plan). Their use is for computing
intermediate results, and using such values in computing values for ADOR Objects.
For example, a Plan may have a Variable called discount that holds the percentage discount
one is entitled to, based on the given individuals purchase history, or affiliation with the
Platinum, Gold, or Silver levels of some membership club. This discount Variable can be
used to compute the value of an ADOR Object called, for example, discountAmount, which
will appear in the document, showing the monetary value (as opposed to the percentage
value) of a discount that one receives. Variables allow for avoiding repetitive
computations or data retrievals, as well as improved readability of the Plan, for later
revisions, etc.
A set of Rules QLingo or SQL expressions that compute the values of the Plan's ADOR
Objects and Variables, once for each recipient.
In high-level terms, one should think of a Plan as a program that is being repeatedly executed,
once for each recipient. In each of these iterations, the Plan performs computations that result
in a set of values: one recipient-specific value for each ADOR Object. The process that
"executes" such Plan programs is known as Plan Interpreter, and it is part of uPlan and
uProduce.
For more information on uPlan, see the uPlan User Guide.
Chapter 1: Introduction to PersonalEffect
6
uCreate
uCreate is a plug-in that adds dynamic design capabilities to the Adobe InDesign application.
uCreate integrates seamlessly with its host application and allows creating Tagged
Documents. By linking to the relevant Plan file or Data Source, a designer can populate the
uCreate palette with the Content Objects that had been defined for the Campaign (in the Plan
file) or derived from the Data Source, and then use simple point-and-click operations to tag
design objects with the desired Content Objects.
uCreate supports online previewing or proofing by linking to Proof Sets or Content Samples,
which essentially bind the Design with some Data. This allows for WYSIWYG previewing of
document instances, by scrolling through the records of the bound Data.
uCreate now allows designers to implement calls to XMPies uImage
add-on application.
uImage allows Adobe Photoshop
or
Illustrator
scratch files.
uCreate is described in detail in Chapter 2: Working with uCreate on page 9.
uProduce
uProduce is server-based software for managing and producing Campaigns. The user can
operate uProduce through its browser-based application, known as the uProduce Dashboard.
This Dashboard supports Campaign creation, Campaign management, Campaign production,
Job management, and other operations. uProduce also supports a rich set of APIs that enable
driving it from other programs, automatically, without relying on manual operation of the
Dashboard user interface.
As discussed earlier, Campaigns are actually compact representations of many potential
Dynamic Documents: when each Document is bound to the Plan and Data Sources, it becomes
a Dynamic Document. Therefore, whenever a Design in the Campaign is selected, and an
operation such as proofing or processing is performed, that Design is implicitly bound to the
Logic and Data. This binding allows the uProduce algorithms to process the bound
components, and create the needed personalized Document instances in the desired target
media.
uProduce allows you to organize Campaigns into Accounts, which represent different clients of
the uProduce user. For example, if the uProduce user has a client named ABC, this user can
PersonalEffect Core Applications
7
create an Account named Account ABC, and conveniently organize all of ABCs Campaigns
under that Account.
Being a server, and supporting operations such a checking-in and checking-out Plans,
Documents, and other objects, make uProduce not only a production center, but also a
collaboration hub. As such, uProduce enhances and streamlines the workflow of multi-person,
or even multi-site, Campaign development teams.
uProduce is also the manifestation of the Platform nature of the PersonalEffect solution:
through its APIs and remote connection to databases, uProduce enables application
development for supporting customers specific needs, such as automation (also known as
"Lights-Out operation"), or custom-made Web-to-print solutions.
Starting from release 3.0, uProduce includes the Interactive Content Ports (ICP) technology,
which is the key to a full creative freedom in dynamic web development and print/web
synchronicity in Cross Media Campaigns. This revolutionary technology allows for the design
of web sites for Cross Media Campaigns using industry-standard software without XMPie
proprietary tools through Interactive Content Ports. It provides you with direct connection to
variables as if they were a standard database or available via Web Services without needing to
host the Campaigns web pages on uProduce.
Figure 4: uProduce Interactive Content Ports Technology
For more information on uProduce, see the uProduce User Guide.
Chapter 1: Introduction to PersonalEffect
8
uCreate Cross Media (XM) is XMPies new platform for cross-media campaigns that utilizes
the Interactive Content Ports (ICP) as its main engine for using ADOR objects. To learn more
about uCreate XM, see Chapter 3: Working with uCreate XM on page 91.
PersonalEffect Architecture
PersonalEffects basic architecture is illustrated in Figure 5.
Figure 5: PersonalEffect Architecture
Programmer/DBA Tool
uCreate
Designer Tool
Personalized
Communication
uProduce
Dashboard & Production Server
uPlan
(e.g.Oracle, MS Access,
MS SQL etc.)
Database
Different members of the Campaign development team can work on various aspects of the
same Campaign independently, as long as they do not change the Data Schema or the list of
ADOR Objects. After creating an initial Plan that defines the ADOR Objects, the database
professionals, programmers and sometimes even business managers can continue using uPlan,
to further refine the Campaign's Data and Logic. At the same time, designers and studio
professionals can use uCreate to work on the Design.
The binding of the various components into one coherent Dynamic Document is automatic,
because they all adhere to the formal interfaces of ADOR Objects on the Plan/Design side and
of Data Schema on the Plan/Data side. This allows moving to production at any given
moment, and it is the key behind PersonalEffect superior support of extremely fast
incorporation of last-minute-changes.
9
Chapter 2: Working with uCreate Print
uCreate Print (uCreate, in short) is a plug-in designed for Adobe InDesign. The uCreate plug-
in lets you create dynamic design objects, within the relevant design layout. You can do this by
assigning (binding) the Content Objects defined in uPlan, or in the uCreate Rule Editor, to the
relevant design objects (for example, picture box, a text word, text box, etc.), thus creating a
dynamic document. For example, a static picture box that is bound to a Graphic Content
Object will be dynamically replaced with the actual picture during production.
Similar to static objects, you can manipulate dynamic objects freely using the various tools
available in the design application.
When the design is uploaded to the uProduce server, the document can be proofed, printed, or
published to the Web, provided that the associated Plan, Data Source, and Assets have also
been uploaded to the server. You can also create a Proof Set directly from uCreate (as
described in Creating a Proof Set on page 62). Upon production (or proofing), the dynamic
objects in the design are replaced with actual data taken from the database and the rules
defined in uPlan or in the Rule Editor are applied; this stage creates personalized instances of
the dynamic document.
There are two ways to use uCreate:
Associate a Plan or a Data Source with the document before the document is designed. If
you first associate a Plan or a Data Source with a document, you can insert dynamic
objects into the document during the design stage.
Associate a Plan with the document, or use the Rule Editor to create your design Logic,
after the document has been designed. Using this method, you do not need any special
plans when designing the document. You can insert regular objects (such as text boxes)
into the document and replace these objects with the relevant Content Objects when you
link the design to a Plan or to a Data Source.
A typical workflow consists of a combination of the above approaches. Usually, the initial
draft(s) of the document is designed before a Plan is ready. Once the draft is ready, the
designer may have additional requirements from the Plan creator. In this case, the Plan creator
updates the Plan, and provides updated Plans for more advanced drafts of the design
document. Moreover, using the Rule Editor, as opposed to designs that are linked to a Plan
file, the designer can change the design Logic and add or remove Content Objects directly
from uCreate without having to use uPlan.
Chapter 2: Working with uCreate Print
10
Installation and Upgrades from Previous Versions
Note: To install uCreate, you must be a system administrator.
uCreate can be installed on both PC and Mac computers.
Before Starting the Installation
1. If you are upgrading uCreate, you are required to manually uninstall previous versions of
uCreate before installing the new uCreate version.
2. If your InDesign application has never been launched, launch it now (and then close the
application).
Note: If both the English and the Japanese InDesign CS2/CS3 versions are installed on the
same machine, the XMPie plug-ins are added only to the English version.
Installing uCreate
Install uCreate by inserting the installation CD into your CD-Rom drive and following the
instructions.
Hardware and Software Requirements
Windows
Processor: Intel
Pentium
4 or better
Operating System:
Microsoft
Windows XP
Pentium
4 or better
Operating System:
Microsoft
Windows XP
8 or CS3
Workflow Overview
To create dynamic web sites using uCreate XM, perform the following tasks:
1. Follow the uCreate XM for Dreamweaver prerequisites carefully and make sure they are
met prior to working with the application (see Appendix A: uCreate XM Web Server
Prerequisites on page 117).
2. Use Dreamweaver to setup a new site and save it on your Web Server (page 95).
3. Connect the site to the uProduce Server (page 98).
4. Connect the site to a Port defined on the uProduce Server (page 99).
5. Use uCreate XM to make the site dynamic, by tagging web page elements with Content
Objects (page 100).
Setting up a New Dreamweaver Site
95
Setting up a New Dreamweaver Site
uCreate XM supports sites created using ASP .Net C# technology.
To define a new site:
1. In Dreamweaver menu bar, select Site New Site
The Site Definition window is displayed. By default, the Basic tab is opened. This tab will be
used to define a new site.
Figure 59: Site Definition, Editing Files Part 1
2. Enter your site name and URL and click Next.
The Site Definition, Editing Files Part 2 window is displayed.
Figure 60: Site Definition, Editing Files Part 2
Chapter 3: Working with uCreate XM
96
3. Select Yes, I want to use a server technology and select ASP .NET C# from the list. Click Next.
The Site Definition, Editing Files Part 3 window is displayed.
Figure 61: Site Definition, Editing Files Part 3
4. Select how you want to work with your files during development and where these files are
located (whether locally or on a remote server).
Note: It is advisable not to select the second option as you will not be able to test your
work unless you upload the files to a testing server.
5. Click Next. The Site Definition, Testing Files window is displayed.
Figure 62: Site Definition, Testing Files
6. Enter the location of your testing site (whether a local host or a remote server) and click
Next. The Site Definition Remote Server Location window is displayed.
Setting up a New Dreamweaver Site
97
Figure 63: Site Definition Remote Server Location
7. You can now choose to upload files to a Web Server when completing your work. If you
select Yes, you will be instructed to specify the Web Server URL. Click Next when finished.
The Summary window is displayed containing information on your site setup.
Figure 64: Site Definition Summary
8. Click Done to complete the process.
9. In Dreamweaver menu bar, select Site Advanced Deploy Supporting Files.
The Deploy Supporting Files to Testing Server dialog is displayed.
Chapter 3: Working with uCreate XM
98
Figure 65: Deploy Supporting Files to Testing Server dialog
10. Select the folder, in which you are creating your site (the Virtual Folder), and add \bin at
the end of the displayed path. Click Deploy when finished.
Connecting the Dreamweaver Site to the uProduce
Server
A Dreamweaver site may be connected to several types of Databases. A connection to the
uProduce Server is a specific type of Database connection.
To connect to uProduce:
1. Open the Databases panel in the Application palette, click the button and select
uProduce Connection from the drop-down list. The uProduce Connection dialog is displayed.
Figure 66: uProduce Connection dialog
2. In Connection name enter a name for the ICP connection. Allowed characters are
alphanumeric characters and underscores.
3. In uProduce Server enter the path for the uProduce Server. Use the format:
IP Address or Machine Name (if you are in a local network)\Server Name.
Note: In a typical PersonalEffect installation, the path for the uProduce Server shall be
<Machine Name>\XMPIE. For example, VENUS\XMPIE.
Connecting the Dreamweaver Site to a Campaign Port on uProduce
99
4. In uProduce user name, enter the customer name followed by your user name. Use the
format Customer Name\User Name (for example, company_name\john).
5. In uProduce password, enter your account password.
6. Click Test if you want to test your connection.
7. Click OK to save your connection settings.
You can now see your ICP connection details in the Databases panel of the Application palette.
Figure 67: ICP Connection Details
Connecting the Dreamweaver Site to a Campaign
Port on uProduce
Now, when you have completed establishing a connection with the uProduce Server, you can
connect to a Campaign Port. Naturally, such a Port must be defined in uProduce for the
Campaign you want to use. Once the connection to a Port has been made, you are
automatically provided with all Content Objects that are defined for the selected Campaign in
uProduce. For further information on creating Campaign Ports, see the uProduce Users
Guide.
To connect to a Port:
1. In the document toolbar of Dreamweaver, click the Connect button. The Port dialog
is displayed.
Note: You will be directed to create an ASP .Net C# site if you have not created such yet.
Chapter 3: Working with uCreate XM
100
Figure 68: Port dialog
2. Select the Account, Campaign and Port you want to use. Note that each list depends on the
list above it in the hierarchy.
3. You can choose to display debugging information on failure or you can direct to a URL.
4. Click OK to save your settings. You can see all the Content Objects for the selected Port in
the Bindings panel of the Application palette.
Figure 69: Bindings Palette
uCreate XM for Dreamweaver
Creating Your Sites Landing Page
A Landing Page is a web page that users access through a URL that identifies them (optionally
utilizing a Friendly URL). For best results, these pages are highly targeted for the reader and
specific to the ad. A Landing page contains the users user name and password thereby allows
you to define these parameters once (in the landing page). These parameters are then
automatically populated to each page on your site.
To define a landing page:
1. In the uCreate XM toolbar, click the Landing Page button. The Landing Page
dialog is displayed.
uCreate XM for Dreamweaver
101
Figure 70: Landing Page dialog
2. Select the This is a Landing Page check box and then enter the parameter name, whose value
will get the Campaign's Primary Field of each recipient. For further information on
selecting Primary Fields, see the uPlan User's Guide.
If a friendly URL is defined for the used Port, use the same parameter name as defined in
the Port. For further information on creating Campaign Ports, see the uProduce User
Guide.
If you want the Content Objects values in your landing page to refresh automatically with
each record, click the Live Data View button in the Dreamweaver's Document toolbar.
Setting up Dreamweaver Preview in Browser Option for uCreate XM
It is now recommended to set the Preview in Browser options of Dreamweaver to facilitate the
workflow of uCreate XM.
1. In Dreamweaver menu bar, select Edit Preferences. The Preferences window is displayed.
Figure 71: Preferences Window
2. In the Category list, select Preview in Browser.
Chapter 3: Working with uCreate XM
102
3. Select Preview using temporary file and click OK.
Note: Preview in Browser option is available for landing pages only.
Working with Content Objects
To insert a Content Object (whether text or image) to your design, simply double-click it in the
Bindings panel of the Application palette. If you want to include the Content Object textual
value regardless of its type (image or text), simply drag it to your design. For instance, if you
double-click an Image Content Object, the image will appear in your design, while dragging
an Image Content Object to your design will result in displaying the image file name.
Click the right and left arrows in the Recipient Records box to browse between
recipients records.
The following table lists the various Content Objects behavior when double clicking a Content
Object in the Bindings palette.
Double Click a
Content Object
of Type
To
Text Insert a Text Content Object.
If text is already selected, it will be replaced with the selected Text
Content Object.
Text File Add an IFRAME tag whose attribute is derived from the appropriate
Text File Content Object value.
If an IFRAME tag is already selected, it will be replaced with the
selected Text File Content Object.
Image Add an IMG tag whose attribute is derived from the appropriate Image
Content Object value.
If an image is already selected, it will be replaced with the selected
Image Content Object.
Style In case a tag is selected: add a class attribute (to the selected tag) that
is derived from the appropriate Style Content Object value.
In case no tag is selected: add a SPAN tag whose class attribute is
derived from the appropriate Style Content Object value.
Visibility Add server side code that hides or shows the selected tag according to
the Visibility Content Object value.
Link Transforms the HREF tag of a selected link to a dynamic one.
If a link is not selected, then a new link (an A tag), with a dynamic
HREF attribute, is added.
uCreate XM for Dreamweaver
103
Binding Content Objects Attributes
Dragging Content Objects is useful for binding HTML attributes to data. You can dynamically
change the appearance of a page by binding HTML attributes to data. For example, you can
change the background image of a table by binding the tables background attribute to a
Content Object attribute.
To make HTML attributes dynamic with the Bindings panel:
1. In Design view, select an HTML object (whether an image, a table, etc.).
2. In the Bindings panel, select a Content Object from your list.
3. In the Bind To box, select an HTML attribute from the pop-up menu.
4. Click Bind.
Using Content Objects in Code View
This section is targeted at advanced users who wish to enhance uCreate usability by using
Dreamweavers Code View.
While the easiest way to use Content Objects is by using the Design View, it is important to
mention that all uCreate operations result in standard ASP.NET C# code being added to your
design pages. At any time you can switch to Code View to review these additions.
Advanced users can adapt Content Objects to their specific needs via Dreamweavers Code
View. Users can drag Content Objects from the Bindings panel into the proper location in the
code, using Content Objects as if they are regular C# variables, allowing complex Logic to be
built around personalized values derived from uProduce.
Updating Content Objects
Using XMPies Interactive Content Technology (ICP), allows you to create ASP .NET forms
that will be used to update Content Object values.
To create a Content Object update mechanism:
1. Create an HTML form, and place INPUT controls in it (for example, text type INPUT
control). For further assistance, see the Dreamweaver help.
2. Click the Update button from the uCreate XM toolbar. The Set ADORs dialog is
displayed.
Chapter 3: Working with uCreate XM
104
Figure 72: Set ADORs dialog
3. Select the Form you want to use from the Submit values from: list.
4. In the Field list of each Content Object, select the form field that will be used to update the
listed Content Object. You can use a value that has been entered in a designated entry field
or even a button.
Select None for Content Objects that you do not want to update.
5. Enter the sequential pages for success and failure. You can chose to display debugging
information instead of a web page on failure.
6. Click OK.
Using uCreate XM Email
The uCreate XM Email feature lets you send email messages in response to the actions taken
by customers who visit your personalized web site. This feature enables you to promote your
Campaigns by delivering offers, newsletters, greetings and follow-up messages. You can
define the actions that trigger such emails, for example: the loading of a web page, a form
being filled out, an order submitted, and so forth. For example, when a customer logs into a
personalized website, you may send an email saying Dear George, thank you for visiting our
web site.
To use uCreate XM Email you need to perform the following five major tasks:
1. Define a Dreamweaver site. See Setting up a New Dreamweaver Site on page 95.
2. Connect to the uProduce server. See Connecting the Dreamweaver Site to the uProduce
Server on page 98.
3. Connect to a uProduce Port. See Connecting the Dreamweaver Site to a Campaign Port on
page 99.
4. Create the email message content using Adobe Dreamweaver with uCreate XM. See
Creating the Email Message Content using Adobe Dreamweaver with uCreate XM on
page 106.
5. Create an Email Activity. See Creating an Email Activity on page 108.
Using uCreate XM Email
105
If uProduce and the Dreamweaver workstation are located inside your intranet, you can skip
Steps 1-3 mentioned above and create your site as well as connect to the uProduce server and
Port using the Site Definitions file, which is generated by uProduce. Doing so will allow you to
use the uProduce Email - Local Hosting mechanism.
Once the Site Definitions file is created in uProduce, use Dreamweaver's Manage Sites feature
to import it.
The procedure described below is applicable only if your uProduce machine and the
Dreamweaver designer's workstation are located in the same network and the
Dreamweaver user can access the shared folder: \\uProduceServer\XMPIe.
To create a site in Dreamweaver using the Site Definitions (*.ste) file:
1. In the Dreamweaver menu bar, select Site Manage Sites.
The Manage Sites dialog is displayed.
Figure 73: Dreamweaver, Manage Sites dialog
2. Click Import
3. Browse to the *.ste file you want to import and click Open to import it.
A new site, with the same name as the *.ste file, is created.
If you choose to import the Site Definitions file while uProduce is connected
remotely, you must define the Access parameters, whether Local/Network,
FTP or WebDAV, of your site to conform to your local network. Doing so
enables you to use the uProduce Email - Local Hosting mechanism.
For further assistance on defining access parameters, refer to your system
administrator.
Chapter 3: Working with uCreate XM
106
Creating the Email Message Content using Adobe
Dreamweaver with uCreate XM
The following section demonstrates how to use uProduce Email when using a
Dreamweaver designer's workstation that is located in the same network as
uProduce.
However, it is possible to use uProduce Email when uProduce is installed on a
remote machine. In that case, you should define the Access parameters, of your
site to conform to your local network.
Defining access parameters for a remotely connected uProduce machine is beyond
the scope of this document. For further assistance on defining access parameters,
refer to your system administrator.
To create the email message using Adobe Dreamweaver:
1. Create a new ASP.NET C# document. Make sure the page encoding you are using is
Unicode (UTF-8).
To view the page encoding, press <Ctrl>+<J> to open the Page Properties
dialog and then select Title/Encoding from the Category list on the left.
2. Save the document as a *.aspx file.
3. Set the page to be used as a landing page with the default rid parameter:
In the uCreate XM toolbar, click the Landing Page button. The Landing Page
dialog is displayed.
Figure 74: Landing Page dialog
Using uCreate XM Email
107
Select the This is a Landing Page check box and then enter the parameter name, whose
value will get the Campaign's Primary Field of each recipient.
Further reading in the uPlan User's Guide:
For further information on selecting Primary Fields, see "Creating a
Plan using the uPlan Wizard".
4. Design the page to be used as the email message. When inserting references to static image
files (Resources), make sure the web server on which these images are stored is available
to the email recipients.
The URL that links to the image must be an absolute one, for example,
http://www.mydomain.com/images/picture.jpg.
Synchronizing the Testing Server with the Remote (Production)
Server
The uProduce machine acts as a Web server that incorporates both the Testing and Remote
(that is, Production) servers. When you import the Site Definitions file (*.ste) and actually
create a new site in Dreamweaver, you are defining the Testing and Remote servers on your
Web server.
When you design your site, you are in fact working on the Testing server; therefore all related
files, such as images, are stored on that server.
When you want to use uProduce Email, you should synchronize the Testing server with the
Remote server thus having your files available for uProduce. Remember, uProduce email uses
only the files that are on the Remote server.
If uProduce is connected remotely, you must define the Access parameters, of your
site to conform to your local network. For further assistance on defining access
parameters, refer to your system administrator.
Chapter 3: Working with uCreate XM
108
To synchronize the Testing server with the Remote server:
1. Open the Files panel by selecting Files from the Windows menu.
2. Select your site in the Site list.
Figure 75: Dreamweaver, Files panel
3. Click the Options menu in the upper-right corner of the Files panel and select Site
Synchronize.
You can also click the Synchronize button ( ) at the top of the Files panel to
synchronize files.
Creating an Email Activity
When you create an Email Activity you should provide the following information:
Delivery - the server or service that will be used to send the email messages.
Message Header - all the message fields other than the message contents.
Message Body - a single document (single part) or more (multi-part) to be sent as the
message body.
To create a new Email Activity:
1. In uCreate XM toolbar, click the button to display the Send Email on Page Load
window (Figure 76).
Using uCreate XM Email
109
Figure 76: Send Email on Page Load Window
2. Select the Send a single email as soon as this page is loaded check box and then fill in the
required field values as specified below. Click OK to save your settings.
Window Item Description
Delivery Select a delivery provider. Email providers are defined in uProduce
for each Campaign. For more information on how to define a
delivery provider, see the uProduce User's Guide.
Some delivery providers may not allow you to define the From and
Reply To fields. In such cases, those fields will remain disabled.
Chapter 3: Working with uCreate XM
110
Window Item Description
Message Header Define the email message headers. An email message header may
include the following fields: From (Name and Email Address), Reply
to and To (Name and Email Address) fields. Mandatory fields are
denoted with a red asterisk (*).
You can add Content Objects to any of the fields in the message
headers by either typing them in or by selecting the relevant
Content Object from the list on the right.
From (Name and
Email Address)
Specify the sender's name and email address. These fields can
contain ADOR values to make them dynamic.
Reply to Specify an email address that can be used by the addressee to
reply to your email. This field can contain an ADOR value to make it
dynamic.
To (Name and Email
Address)
Specify the addressee's name and email address. These fields can
contain ADOR values to make them dynamic.
For example, you can enter the ADOR {{FirstName}} in the
Name field and the same ADOR in the Email address, as follows:
{{FirstName}}@MyDomain.com.
Subject Specify the text of the email's subject line. You can insert Content
Objects in the message subject to make it dynamic.
For example, "Greatings {{FirstName}} {{LastName}} from Wine
Lovers!".
Character Set Select the character set to use for presenting the email headers.
Message Body Select the documents to be used for the email message contents.
You can use multiple documents for multi-part
2
email messages.
Main Document Select the document to use for the email message contents. Select
a document from the Document list and the character set to use for
presenting the message body from the Character Set list.
If you select an HTML document as the email message contents,
you should also determine whether linked images should be
embedded in the email message or be kept as links. Select Embed
or Keep as links accordingly.
2
Multi-part email messages contain several copies of the same content, each in a different format (HTML, Text or
RTF). Email messages that have their contents in HTML or RTF format are commonly sent with another copy of the
content in Text format, to support email software that cannot display HTML.
Configuring uCreate XM to Track Web Events
111
Window Item Description
Send Multi-Part
Message
Select this option to attach a secondary email message to the main
email message for multi-part email messages.
If you select an HTML document as the secondary message, you
should also determine whether linked images should be embedded
in the email message or be kept as links. Select Embed or Keep as
links accordingly.
Select the character set to use for presenting the message body
from the Character Set list.
Configuring uCreate XM to Track Web Events
uCreate XM allows you to track different types of web events, that is the occurrence of actions
relating to the Campaigns various web elements:
Web pagestrack the users landing on the specified web pages.
Page elementstrack OnClick (focus) and OnBlur (lost focus) events concerning HTML
elements and ASPX controls.
Linkstrack the clicking of the specified links.
Custom tracking insert your own JavaScript code to track any required event.
uCreateXM ToolbarTracking Menu
Web events are tracked as Server Behaviors, managed via the uCreateXM toolbar.
The toolbars Tracking button ( ) opens a menu that includes two items:
Track Page Visits and Track This (Figure 77):
Figure 77: uCreateXM ToolbarTracking Options
Chapter 3: Working with uCreate XM
112
When the page and/or the currently edited page element (a native HTML element or an ASPX
control) are tracked, a matching item is added to the Server Behaviors palette, and a checkmark
is shown near the corresponding menu item (Figure 78):
Figure 78: Tracking Menu with Checkmarks Indicating Tracking
Tracking Page Visits
You can determine whether or not a web page is tracked.
To track visits to this web page:
1. From the Tracking toolbar, choose Track Page Visits
The Track Page Visits dialog is displayed (Figure 79).
Figure 79: Track Page Visits dialog
2. Configure tracking as follows and click OK:
Click... To...
Track visits for this
page
Track visits to the named web page.
When this option is unchecked, the Page name field is
disabled. If this page had been tracked in the past and
has a corresponding Server Behavior, this behavior is
deleted.
Page name Enter the name of the page whose visits are to be
tracked. You may specify any value, using up to 255
characters.
Note: The Page name parameter is shared between all uCreateXM tracking dialogs. Changing
it in one dialog will affect all other dialogs.
Configuring uCreate XM to Track Web Events
113
When the page is tracked, the following takes place:
A checkmark is added to the Track Page Visits menu command (see Figure 78
on page 112).
A matching Server Behavior, labeled Track Page Visit (<Page Name>), is listed in the
Server Behavior palette (Figure 80).
Figure 80: Server Behaviors Palette with a Tracked Page Visit
Tracking Web Page Elements
You can now track individual web page elements. An element may be a native HTML element
(for example, <A> (link), <BODY>, <P>) or an ASPX control. Both are tracked using
JavaScript-based Server Behaviors.
Note: Tracking is applied to the currently selected web page element.
To track a web page element:
1. From the Tracking toolbar, choose Track This
The Track This dialog is displayed (Figure 81).
Chapter 3: Working with uCreate XM
114
Figure 81: Track This dialog
Note: The dialog title and labels change, depending on the type of element that is currently
selected (for example a paragraph, a button etc.).
2. Configure tracking as follows, and click OK:
Click... To...
Track Use of This
<Element Type>
Adds tracking to the currently edited HTML element or
ASPX control.
The event that is tracked by default depends on the
selected element:
OnBlur event (lost focus)for dropdowns, radio
button groups, checkboxes, textboxes, listboxes,
and checkbox lists.
OnClick event (focus)for all other element types.
When this option is unchecked, the Page name and
Action name fields are disabled.
Page name Enter the name of the page containing the element to
be tracked. You may specify any value, using up to 255
characters.
Note: The Page name parameter is shared
between all uCreateXM tracking dialogs.
Changing it in one dialog will affect all other
dialogs.
Configuring uCreate XM to Track Web Events
115
Click... To...
Action name The logical action performed. This name is used by the
marketing person in the Marketing Console, as a non-
technical term that describes the action the user
performed, disregarding the technical method used (link
was clicked/button was clicked/text box was edited etc.)
The default action name is Paragraph; you may
override it with a meaningful name that describes this
action, for example Offer Image Clicked.
When the element is tracked:
A checkmark is added to the Track This menu command (see Figure 78 on page 112).
The event type saved to the database is Navigated for links and ActionPerformed for all
element types.
A matching Server Behavior, labeled Track This (<Page name>, <Action Name>), is listed
in the Server Behavior palette (Figure 80).
Figure 82: Server Behaviors Palette with a Tracked Page Element
117
Appendix A: uCreate XM Web Server
Prerequisites
uCreate XM is a software add-on designed specifically for Adobe Dreamweaver. The software
is installed on the developers work station and as such it does not require any specific
software or operating system prerequisites.
However, to process dynamic web pages, you need an Application Server (that is, a .NET
Framework). An Application Server is software that helps a Web Server (that is, Live Server as
shown in Figure 58: uCreate XM Typical on page 92) to process web pages that contains
server-side scripts or tags.
The following Web Server prerequisites must be met to enable the Web Server to process
dynamic web pages. Before your web site is deployed on the Web Server make sure to:
Install .NET Framework 2.0 (or 1.1) and register it.
A free download of Microsoft .NET Framework 1.1 is available at:
http://msdn.microsoft.com/netframework/downloads/framework1_1/
A free download of Microsoft .NET Framework 2.0 is available at:
http://www.microsoft.com/downloads/details.aspx?FamilyID=0856EACB-4362-
4B0D-8EDD-AAB15C5E04F5&displaylang=en
For more information on registering your copy of .NET Framework, refer to:
http://msdn2.microsoft.com/en-us/library/k6h9cz8h.aspx
Verify that IIS is installed, see page 118.
After installing the .NET Framework, create a Virtual Folder, see page 119.
Verify that Session State is enabled, see page 122.
If your system is running Windows 2000, install the Microsoft Data Access Components
(MDAC) version 2.7 or higher to allow creating Web sites using the ICP technology.
For more information on the Microsoft Data Access Components (MDAC), go to:
http://msdn.microsoft.com/library/default.asp?url=/library/en-
us/dnmdac/html/data_mdacinstall.asp
You can download the latest version of MDAC from:
http://www.microsoft.com/downloads/details.aspx?DisplayLang=en&FamilyID=6c050f
e3-c795-4b7d-b037-185d0506396c
Appendix A: uCreate XM Web Server Prerequisites
118
Verifying that IIS is Installed
By default, IIS is not installed as part of the Windows XP operating system. Because this
component is essential for the correct functioning of uCreate XM, this section explains how to
verify that this component is indeed installed and configured to run on your system.
To verify that IIS is installed:
3. Go to Start menu > Settings > Control Panel > Add/Remove Programs and select
Add/Remove Windows Components.
The Windows Components Wizard is displayed, showing its Windows Components window
(Figure 83).
Figure 83: Windows Components window
4. Select the Internet Information Services (IIS) check box and click Details
The Internet Information Services (IIS) window is displayed, listing the IIS subcomponents
(Figure 84).
Creating a Virtual Folder
119
Figure 84: Internet Information Services (IIS) Components
5. Verify the following subcomponents are selected:
Common Files
Internet Information Services Snap-In
World Wide Web Server
6. Click OK to save your settings and close the window.
Creating a Virtual Folder
To create a virtual folder:
1. Go to Start menu > Settings > Control Panel > Administrative Tools and double click the
Internet Information Services icon.
The Internet Information Service window is displayed.
Figure 85: Internet Information Services Window
Appendix A: uCreate XM Web Server Prerequisites
120
2. Right click Default Web Sites and select New > Virtual Directory
The Virtual Directory Creation Wizard Welcome window is displayed.
Figure 86: Virtual Directory Creation Wizard Welcome Window
3. Click Next. The Virtual Directory Alias window is displayed.
Figure 87: Virtual Directory Alias Window
4. Type the alias you want to use to gain access to the created Web virtual directory and
click Next.
The Web Site Content Directory window is displayed.
Creating a Virtual Folder
121
Figure 88: Web Site Content Directory Window
5. Enter the path to the directory that contains the content and click Next.
The Access Permissions window is displayed.
Figure 89: Access Permissions Window
6. Make sure that Read and Run scripts (such as ASP) options are selected and click Next.
Click Finish when prompted.
Appendix A: uCreate XM Web Server Prerequisites
122
Verifying that Session State is Enabled
To verify that Session State is enabled:
1. In the Internet Information Service main window (Figure 85 on page 119), right click the
virtual folder you have just created and select Properties.
The Virtual Directory Properties window is displayed.
Figure 90: Virtual Directory Properties Window
2. In the Virtual Directory tab click Configurationand select the Options tab in the Application
Configuration window that is displayed.
Figure 91: Application Configuration Window
Caching ISAPI Applications
123
3. Select Enable session state and click Apply.
4. In the ASP.NET tab of the Virtual Directory Properties window (Figure 90 on page 122), select
the ASP.NET version you want to use.
Caching ISAPI Applications
It is possible to configure the manner in which Microsoft Internet Information Services (IIS)
caches Internet Server Application Programming Interface (ISAPI) applications. If you change
the default selection from caching ISAPI applications to not caching ISAPI applications, this
may cause the data connection to fail and uCreate will not be able to test its connection with
uProduce. This situation will produce an error message indicating that The requested
Resource is in use".
To cache ISAPI applications:
1. Go to Start menu > Settings > Control Panel > Administrative Tools and double click the
Internet Information Services icon.
The Internet Information Service window is displayed.
Figure 92: Internet Information Services Window
2. Right click Default Web Sites and select Properties.
The Default Web Site Properties dialog is displayed.
Appendix A: uCreate XM Web Server Prerequisites
124
Figure 93: Default Web Site Properties dialog
3. Select the Home Directory tab and click the Configuration... button.
The Application Configuration dialog is displayed.
Figure 94: Application Configuration dialog
4. In the Mappings tab, make sure the Cache ISAPI applications option is selected.
125
Appendix B: uCreate Rule Editing Functions
When linking your document to a Data Source, you can use the Rule Editor to design your
Campaign Logic. The Rule Editor enables you to create or edit Content Objects and their
definitions by enabling you to select functions that let you perform conversions and
manipulations on the Data Source values. Several groups of functions are available, including
those for strings, dates, numeric, and barcode manipulation.
The following list includes the functions available from the uCreate Content Object Editor.
String (see String Functions) TitleCase, lowercase, UPPERCASE, Length, SubString, Find,
Replace, FindAndReplace, Trim, LeftTrim, RightTrim
Date (see Date Functions) Now, GetDay, GetMonth, GetYear, GetDayOfWeek, GetHour,
GetMinute, GetSecond, Age, FormatDate
Numeric (see Numeric Functions) Random, Round, ABS, Floor, Ceiling, FormatNumber
Conversion (see Conversion Functions) AsNumber, AsString, AsBoolean, AsDate
Bar Code (see Bar Code Functions) Code 128, CODABAR, Code 39, EAN13, EAN8,
Interleaved 2 of 5 (ITF), MSI (Modified Plessey), OneCode, POSTNET (USPSZIP), UPCA,
UPCE
Miscellaneous (see Miscellaneous) FileExists, GetEnv
String Functions
TitleCase Function
The TitleCase function assigns title style formatting. It changes the expression so that every
new word (starting after a non-alphabetical character) will start with an upper case character
and returns a string. The expression is always regarded as a string; even if it appears as a date
or number, it will be interpreted as a string.
Syntax:
TitleCase(expression)
Example:
TitleCase("formatting functions") returns the value "Formatting Functions".
Appendix B: uCreate Rule Editing Functions
126
lowercase Function
The lowercase function assigns lower case formatting. It changes the expression to lower case
characters and returns a string. The expression is always regarded as a string; even if it
appears as a date or number, it will be interpreted as a string.
Syntax:
lowercase(expression)
Example:
lowercase("HELLO") returns the value "hello".
UPPERCASE Function
The UPPERCASE function assigns upper case formatting. It changes the expression to upper
case characters and returns a string. The expression is always regarded as a string; even if it
appears as a date or number, it will be interpreted as a string.
Syntax:
UPPERCASE(expression)
Example:
UPPERCASE("This is it") returns the value "THIS IS IT"
Length Function
The Length function returns the number of characters required to describe the
string/number/date resulting from the evaluated expression.
Syntax:
Length(expression)
Example:
Length("abc") returns the value of 3
SubString Function
The SubString function retrieves a sub-string from expression1, with expression3 characters,
starting from the position expression2,
Syntax:
SubString(expression1,expression2,expression3)
String Functions
127
Where:
expression1 is always regarded as a string; even if it appears as a date or number, it will be
interpreted as a string.
expression2 indicates the starting position of the substring.
For example, 0 represents the first character position in expression1, 1 represents the
second character position, etc.
expression3 is the number of characters retrieved.
For example, 3 retrieves three characters, 0 retrieves an empty string, etc. A value of 1
indicates that all characters until the end of expression1 should be retrieved.
Examples:
SubString("abcd",1,2) = "bc"
SubString("James",2,2) = "me"
SubString(1973,0,2) = "19"
SubString("James",2,-1) = "mes"
Find Function
The Find function gets the character index (zero based) in the string (expression1) where the
string (expression2) is found. The search starts from the character index (expression3 zero
based). The result is -1 in case the string is not found; expression3 is optional and defaults to 0
(beginning).
Syntax:
Find(expression1, expression2, expression3)
Example:
Find("hello WORLD", "WORLD", 0) = 6
Replace Function
The Replace function replaces a part of the string (expression1) starting from character index
(expression3 zero based) of length (expression4) with the string (expression 2).
Syntax:
Replace(expression1, expression2, expression3, expression4)
Example:
Replace("hello WORLD", "EARTH", 6, 5) = "hello EARTH"
Appendix B: uCreate Rule Editing Functions
128
FindAndReplace Function
The FindAndReplace function replaces all instances of the string (expression2) in the string
(expression1) with the string (expression3).
Syntax:
FindAndReplace(expression1, expression2, expression3)
Example:
FindAndReplace("hello WORLD", "WORLD", "EARTH") = "hello EARTH"
Trim Function
The Trim function trims leading and trailing white spaces in the string (expression).
Syntax:
Trim(expression)
Example:
Trim(" hello WORLD ") = "hello WORLD"
LeftTrim Function
The LeftTrim function trims leading white spaces in the string (expression).
Syntax:
LeftTrim(expression)
Example:
LeftTrim(" hello WORLD ") = "hello WORLD "
RightTrim Function
The RightTrim function trims trailing white spaces in the string (expression).
Syntax:
RightTrim(expression)
Example:
RightTrim(" hello WORLD ") = " hello WORLD"
Date Functions
129
Date Functions
Date functions allow you to retrieve information on the date and manipulate the date display.
Age Function
The Age function gets the age calculated from the current date/time, including the year (for
example, 31 and a half years old = 31.5) of the date expression.
Syntax:
Age(date expression)
Example:
GetAge ("31/01/1973") = 33.5
FormatDate Function
The FormatDate function formats the date in expression1 according to the format specification
in expression2.
Syntax:
FormatDate(expression1, expression2)
Example:
FormatDate(#27/06/2006#, "dddd, MMMM dd, yyyy") = "Tuesday, June 27, 2006"
GetDay Function
The GetDay function gets the day (1 to 31) of the date expression.
Syntax:
GetDay(date expression)
Example:
GetDay("02/07/2006 12:57:20") = 2
GetMonth Function
The GetMonth function gets the month (1 to 12) of the date expression.
Syntax:
GetMonth(date expression)
Appendix B: uCreate Rule Editing Functions
130
Example:
GetMonth("02/07/2006 12:57:20") = 7
GetYear Function
The GetYear function gets the year of the date expression.
Syntax:
GetYear(date expression)
Example:
GetYear("02/07/2006 12:57:20") = 2006
GetDayOfWeek Function
The GetDayOfWeek function gets the day of the week (1 to 7, where 1 denotes Sunday) of the
date expression.
Syntax:
GetDayOfWeek(date expression))
Example:
GetDayOfWeek("02/07/2006 12:57:20") = 1
GetHour Function
The GetHour function gets the hour (0 to 23) of the date expression.
Syntax:
GetHour(date expression)
Example:
GetHour("02/07/2006 12:57:20") = 12
GetMinute Function
The GetMinute function gets the minute (0 to 59) of the date expression.
Syntax:
GetMinute(date expression)
Numeric Functions
131
Example:
GetMinute ("02/07/2006 12:57:20") = 57
GetSecond Function
The GetSecond function gets the second (0 to 59) of the date expression.
Syntax:
GetSecond(date expression)
Example:
GetSecond ("02/07/2006 12:57:20") = 20
Now Function
The Now function gets the current date/time.
Syntax:
Now()
Example:
Now() = "02/07/2006 12:57:20"
Numeric Functions
ABS Function
The ABS function gets the absolute value of the number expression.
Syntax:
ABS(number expression)
Example:
ABS(-5) = 5
Ceiling Function
The Ceiling function ceils the number expression.
Syntax:
Ceil(number expression)
Appendix B: uCreate Rule Editing Functions
132
Example:
Ceil(3.12) = 4
Floor Function
The Floor function floors the number expression.
Syntax:
Floor(number expression)
Example:
Floor(3.78) = 3
FormatNumber Function
The FormatNumber function formats the number in expression1 according to the format
specification in expression2.
Syntax:
FormatNumber(expression1, expression2)
Example:
FormatNumber(1000000.1, "#,###,##0.00") = 1,000,000.10
Random Function
The Random function generates a random integer between 0 and the calculated integer value
of the expression, not including the value itself. If the value of the expression is 1, a floating-
point number between 0 and 1 (exclusive), will be returned.
Syntax:
Random(expression)
Examples:
Random(5) can return a value of 1
Random(1) can return a value of 0.2376
Round Function
The Round function rounds off the calculated number value of expression1 as an integer, with
expression2 as the number of precision digits.
Conversion Functions
133
Syntax:
Round(expression1,expression2)
Example:
Round(12.344, 2) returns the value of 12.34.
Conversion Functions
Conversion functions allow you to convert different types of data.
AsBoolean Function
The AsBoolean function evaluates the expression as True/False.
The Null value is false regardless of the data type.
For a Number expression, 0 is False; otherwise it is True.
For String expressions, Empty String is False; otherwise it is True.
Date expression is always true.
Syntax:
AsBoolean(expression)
Example:
AsBoolean(1) = True
AsDate Function
The AsDate function attempts to evaluate the expression as a date, if possible. "23/02/1994" ->
23/02/1994
If the expression cannot be evaluated as a date, the function will fail and an error will be
reported. Null value conversion will return the current date/time.
Syntax:
AsDate(expression)
Example:
AsDate("02\07\2006") = 02\07\2006
Appendix B: uCreate Rule Editing Functions
134
AsNumber Function
The AsNumber function evaluates the expression as a number.
Null becomes zero.
True and False are evaluated to 1 and 0, respectively.
A string beginning with a number (or leading spaces followed by a number) returns the
number. Any other string is evaluated as 0.
Syntax:
AsNumber(expression)
AsNumber(23ab) is evaluated as 23.
AsNumber(ab23) is evaluated as 23, and "ab" is evaluated as 0.
Example:
AsNumber("5") = 5
AsString Function
The AsString function evaluates the expression as a string.
Null becomes an empty string.
Syntax:
AsString(expression)
Examples:
Expression Outcome
AsNumber("+24") 24
AsNumber("23
rd
street") 23
AsNumber("James") 0
AsDate("1/1/2002") 01/01/2002
AsString(12) the string "12"
Bar Code Functions
Historically, different bar code symbologies, such as Code 128, Code 39, etc., were developed
for different purposes and industries, and therefore have different encoding capabilities, in
terms of encoded data length, valid content and appearance. To produce a bar code, special
Bar Code Functions
135
fonts are used. Each font is used for the creation of bar codes in a different bar code
symbology.
Creating a bar code involves two steps, as follows:
1. An input string (the bar code "value") is encoded using a font-specific (and bar code-
symbology-specific) encoding function, resulting in an encoded string.
2. The encoded string is rendered using the barcode font.
Figure 95: Bar Code Creation Flow Chart
3 3 0 2 3 8 1 2
Input
String
1. Encoding
Function
V X 3 1 H B C D
Encoded
String
D V
2. Font
2 0
Fonts of the same barcode symbology from different vendors require slightly different
encoding functions, depending on the font vendor's implementation. Therefore, the font and
the encoding function are tightly bonded; a string is always encoded for a specific font and
may not work with a different font for the same barcode symbology.
Appendix B: uCreate Rule Editing Functions
136
Defining a Dynamic Bar Code Content Object
You can define a dynamic Bar Code Content Object if your Data Source has a field that should
be displayed as a bar code. By defining the Content Object type as Text with Style, you can
select fonts for the Bar Code, apply a style to it, or override any built-in style definitions (see
Overriding Style Definitions on page 47).
Note: All the Bar Code fonts are provided as part of the uDirect Installation CD.
To define a dynamic Bar Code Content Object:
1. Right-click anywhere in the uDirect Palette (Figure 7) and select New Content Object.
The New Content Object dialog box is displayed (Figure 96).
Figure 96: New Content Object Bar Code dialog
2. In the Name field, enter a name for the Content Object.
3. From the Type drop-down list, select Text with Style and select the Extended Functions
checkbox.
4. In the Rule section, apply the XMPCode39 function to your bar code field.
Note: We are using the XMPCode39 function as an example. In your Campaign, you may
use a different bar code function.
5. If you wish to override the built-in font style, click the plus sign next to the Apply
Style drop-down list to set the correct font for this bar code text.
The Style Overrides dialog is displayed (Figure 14).
Bar Code Functions
137
6. Select the Override font check box, select XMPCode 39 from the drop-down list, and click OK
to close the dialog.
7. Click OK to close the New Content Object dialog.
8. Scroll through the Data Source records to see the Bar Code Content Object dynamically
change within the image.
Note: If the selected font is missing within InDesign, the Content Object displays in pink.
Make sure all the Bar Code fonts have been installed correctly. They are provided on the
uDirect installation CD.
The following table summarizes the available bar code fonts supported by uCreate and their
corresponding QLingo functions for uCreate version 3.2 and its successor -
uCreate version 4.0.x.
Bar code
Symbology
3.2
Function
3
4.0.x
Function
Font Name Valid
Characters
Valid Input
Length
Code 128 BarCode128B
BarCode128C
XMPBarCode128 XMP128.ttf
XMP128N.ttf
XMP128W.ttf
All 128 ASCII
characters
Not limited
CODABAR CODABAR XMPCODABAR XMPCODABAR.ttf A-D as first or
last characters
Not limited
Code 39 Code39 XMPCode39 XMPCode39.ttf
XMPCode39N.ttf
XMPCode39W.ttf
XMPCode39T.ttf
XMPCode39TN.ttf
XMPCode39TW.ttf
0-9 A-Z - $ / +
% space
Variable. Output
optionally contains
a checksum.
Maximum length:
without checksum:
30, with
checksum: 27
EAN13 EAN13 XMPEAN13 XMPEAN13.ttf 0-9 12
EAN8 EAN8 XMPEAN8 XMPEAN8.ttf 0-9 7
Interleaved 2
of 5 (ITF)
ITF XMPInt2Of5 XMPInt2of5.ttf
XMPInt2of5N.ttf
XMPInt2of5W.ttf
0-9 Not limited, but
must be even. If
odd, '0' is added
at the start point
(left side).
MSI (Modified
Plessey)
MSI XMPMSI XMPMSI.ttf 0-9 Variable.
Maximum length:
3
Although bar code functions of uCreate version 3.2 are still supported, you cannot use them with the new bar code
fonts that are supplied with the uCreate version 4.0.x software pack. To get the full bar code fonts support, use the
new bar code functions of uCreate 4.0.x, as described in the table above and in the sections that follows.
Appendix B: uCreate Rule Editing Functions
138
Bar code
Symbology
3.2
Function
3
4.0.x
Function
Font Name Valid
Characters
Valid Input
Length
13
OneCode N.A. XMPOneCode XMPOneCode.ttf 0-9. The
second digit
must be in
range of 04
20, 25, 29 or 31.
POSTNET
(USPSZIP)
USPSZIP,
POSTNET
XMPPOSTNET XMPPOSTNET.ttf 0-9 5, 9, or 11
UPCA UPCA XMPUPCA XMPUPCA.ttf 0-9 11
UPCE UPCE XMPUPCE XMPUPCE.ttf 0-9 11
Note: All "Valid Input Length" values refer to the function input string only, without correction
characters and start/stop characters created in the bar code output. All bar code functions
accept a single parameter, which is the barcode input, except for XMPCode39 and
XMPInt2Of5 that accept two parameters: the barcode input, followed by a Boolean parameter
indicating whether or not a checksum should be generated.
For example: XMPCode39 ("123456789", true)
XMPBarCode128 Function
The XMPBarCode128 function creates a bar code 128 encoding of the expression.
Syntax:
XMPBarCode128 (expression)
XMPCODABAR Function
The XMPCODABAR function creates a CODABAR encoding of the expression.
Syntax:
XMPCODABAR (expression)
XMPCode39 Function
The XMPCode39 function creates a Code39 encoding of expression1, and if expression2 is
evaluated to true, then adds a checksum.
Syntax:
XMPCode39 (expression1, expression2)
Bar Code Functions
139
XMPEAN8 Function
The XMPEAN8 function creates an EAN8 encoding of the expression.
Syntax:
XMPEAN8 (expression)
XMPEAN13 Function
The XMPEAN13 function creates an EAN13 encoding of the expression.
Syntax:
XMPEAN13 (expression)
XMPInt2Of5 Function
The XMPInt2Of5 function creates an Interleaved 2 of 5 encoding of expression1, and if
expression2 is evaluated to true, then adds a checksum. Note that the valid input length is not
limited but must be even; if odd, the value '0' is added at the starting point (left side).
Syntax:
XMPInt2Of5 (expression1, expression2)
XMPMSI Function
The XMPMSI function creates an MSI encoding of the expression.
Syntax:
XMPMSI (expression)
XMPOneCode Function
The XMPOneCode function creates a OneCode encoding of the expression.
Syntax:
XMPOneCode (expression)
Appendix B: uCreate Rule Editing Functions
140
XMPPOSTNET (USPSZIP) Function
The XMPPOSTNET function gets the digits in expression1, validates that the number of digits
is 5, 9 or 11 and adds a digit at the end for check sum, concatenates expression2 character to
the start and end of the result; expression2 is optional and defaults to empty string.
Syntax:
XMPPOSTNET (expression1, expression2)
XMPUPCA Function
The XMPUPCA function creates a UPCA encoding of the expression.
Syntax:
XMPUPCA (expression)
XMPUPCE Function
The XMPUPCE function creates a UPCE encoding of the expression.
Syntax:
XMPUPCE (expression)
Miscellaneous Functions
FileExist Function
The FileExist function returns true if the file path/URL (expression) exists, otherwise returns
false.
Syntax:
FileExist(expression)
Example:
FileExist("C:\\myfile.txt") = True
GetEnv
The GetEnv function retrieves the current record number (1 based). Where the expression
must be a specific literal string: CurRecordNumber.
Syntax:
GetEnv(expression)
141
Appendix C: Working with uChart
uChart is the XMPie add-on to uCreate that allows you to use a Table Content Object as a Data
Driven Graphic.
When you add a Table Content Object to a graphic frame (as opposed to a text frame), the data
is automatically converted from tabular format into data driven graphic format. To control the
type of graphics displayed (for example, pie charts, bar charts, etc.), you need to use the
uChart add-on to uCreate, which enables you to launch the uChart Properties dialog.
Note: You need uChart license to use data driven graphics.
To display the Table Content Object data in Data Driven Graphic format:
1. Click any of the graphic frame tool icons (for example, Rectangle Frame Tool icon) and use
the mouse to draw a placeholder frame in the document.
2. In the uCreate palette, double-click the name of the desired Table Content Object.
The placeholder frame displays a pie chart indicating that the frame has been associated
with the selected Table Content Object; the pie chart does not reflect the Table Content
Object data at this time.
3. Specify how the Table Content Object data should be presented in this graphic, by right
clicking anywhere in the graphic frame and selecting uChart Properties from the context
menu.
The uChart Properties dialog is displayed (Figure 97).
Appendix C: Working with uChart
142
Figure 97: uChart Properties dialog
4. Make any necessary modifications, as explained in the table at the end of this section.
5. Click OK to close the dialog.
The graphic is updated according to the settings you have specified.
6. When the Table Content Object column values populate the data driven graphic, the
appropriate image is displayed for each recipient.
The Dynamic Table Properties dialog includes the following fields and options:
Select this
option
To
Type Select the desired type of graphic representation. Available
options are Pie, Bar, Line, Area and Compound.
Note that the fields in the dialog differ slightly, depending on
the selected graphic type.
Colors & Data Choose the color in which the graphic will be shown (you can
add colors to the list by selecting Windows> Swatches from
the InDesign menu).
Appendix C: Working with uChart
143
Select this
option
To
Colors & Data
(Pie charts only)
Select either a single color or multiple colors.
To select a color, click the adjacent gray box. The selection is
indicated by a green V mark .
Select as many colors as needed, and use the Up and Down
buttons to determine their order. If the number of slices is
larger than the number of colors you have selected, the colors
shades will be used to distinguish between slices.
Note that the number of selected colors is indicated at the
bottom of this pane.
Colors & Data
(Bar, Line, Area or
Compound)
Choose the following:
Select a single color by clicking the color box. The
adjacent gray box is colored white to indicate your
selection.
Select the Table Content Object column to be shown in
the chosen color, and specify the text to be shown as the
datas label, by double clicking the color name (or
description).
The Series Color Assignment dialog is displayed. You can
use this dialog to choose the relevant column from the
Series drop-down list, and enter the label text into the
Display Name field (Figure 98).
Note that when using a Compound chart, the last selected
color in the Color list is assigned to the Line graph.
Figure 98: Series Color Assignment dialog
Options (All Types)
Font Select the font typeface and size of all text appearances (for
example, the legend text, the bar chart grid text, etc.).
Appendix C: Working with uChart
144
Select this
option
To
Legend Add a legend by choosing its location with respect to the
graphic from the drop-down list.
Available options include None, Left or Right.
Pie charts include additional options: Circular and Legend
Only, which can be set per slice (that is, per Table
Content Object column).
3D Effect Add a three dimensional perspective to the graphic.
Options
(Pie Chart only)
Separate Slices Break apart and separate the different slices of the chart.
Merge Small Slices Combine all slices whose value is less than a specified amount
into a single slice.
If less than Specify the minimal percentage of the data a value must
represent in order to be displayed as a separate slice. All slices
whose values are lower than this percentage will be combined
into a single general slice, whose default Title is Other.
Title Enter the title to be given to the general slice, which merges
all Small Slices whose values are less than the specified
percentage.
The default Title is Other.
Options
(Bar, Line or Area)
Show Bar Values Include the bar values in the graphic.
Show Grid Display the graphic on a grid.
Annotate Specify which of the axes on which the graphic is displayed
are to be annotated. Available options are None, X Axis, Y
Axis and Both Axes.
X Series Select the Table Content Object column to be used as the
graphics X-axis from the drop-down list.
Preview See an advance viewing of the graphic, reflecting the
properties you specify in this dialog.
Note that your changes are saved only after you click OK or
Apply.
Chart Options Enter a command to enhance the look of your chart. Available
commands are listed in the Using Enhanced Options section
below.
Appendix C: Working with uChart
145
Using Enhanced Options
uChart allows you to further enhance the look of your chats by simply entering commands in
the Chart Options area of the uChart Properties dialog.
When entering uChart parameters, take into account that:
Each parameter should be entered in a new line.
Parameter names are case sensitive.
Parameter names do not contain spaces.
Parameter names must be preceded with a forward slash '/' with no spaces between the
parameter name and the slash.
Parameter names must be followed with a space.
The commonly used commands are listed in the following table.
Commands Parameters Effect Applicable
To
4
/3DDepth 0.0 to 1.0 Depth of 3D effect BLP
/3DViewAngle 0 to 90 Apparent position of 3D
effects point of view
BLP
/Aspect 0.1 to 10.0 Overall chart width BLP
/AxisColor color Color of all axes BL
/AxisStyle lineStyle Drawing style of axes BL
/AxisWidth 0 to 1000 Width of all axes BL
/BarGap 0 to 100.0 Size of the inter-bar gaps B
/CalloutLayout Around, Side Layout of pie charts callout
lines
P
/CalloutLineColor color Color of callout lines P
/CalloutLineLength 0.04 to 1.0 Callout line length P
/CalloutLineStyle lineStyle Style of callout lines P
/CalloutLineWidth 0 to 9999 Width of callout lines P
4
B=Bar, L=Line, P=Pie
Appendix C: Working with uChart
146
Commands Parameters Effect Applicable
To
4
/ChartLabelSize 0.1 to 100 On-chart value text size BLP
/ChartValueSize 0.1 to 1000 On-chart value text size BLP
/ColorListLabels [ (label1)...
(labelN) ]
Drawing color for specific
labels
BLP
/CompressHighLow No, Yes Compress out bottom space BL
/CutoutText No, Yes Cut out text from
surroundings
BLP
/FillBelow No, Yes Fill in space below data line L
/FloorSize 0.1 to 100 Font height of Floor text BL
/GridLineColor color Color of grid BL
/GridLineStyle lineStyle Drawing style of grid lines BL
/GridLineWidth 0 to 1000.0 Width of grid lines BL
/GroupGap 0 to 10.0 Inter-group space BL
/GroupSize 0.1 to 100 Font height of Group text BL
/HighValue number Top of range for data values BL
/KeepZeroData Yes, No Discard 0-valued data BLP
/LabelColor color Color of labels BLP
/LabelFormat ( stringFormat ) Transforms label text BLP
/LabelLocation location On-chart label-value location BL
/LabelLocation location On-chart label-value location P
/LabelOverflow Ignore,... Clipping of on-chart labels
that are too long
BLP
/Layer Begin layer data; Separates
layers
B
/Layering Overlay, Group, Interleave Grouping of data layers BL
/LayerLabel ( text ) LayerLabel text for layers BL
/LayerLabelFormat ( stringFormat ) Transforms /LayerLabel text BL
/LayerLabelLocation location Location of /LayerLabel BL
/LeftGap 1.0 to 10.0 Gap width before leftmost
column
BL
Appendix C: Working with uChart
147
Commands Parameters Effect Applicable
To
4
/LeftScaleFormat (numberFormat ) Formatting of scale numbers BL
/LeftScaleSize 0.1 to 100 Font height of scale numbers BL
/LeftTextLimit - 1000.0 to 1000.0 Leftmost limit for text BLP
/LegendOutlineWidth 0 to 10.0 Width of spots outlines in
legend
BLP
/LegendOverflow Ignore,... Clipping of chart legends that
are too long
BLP
/LegendPosition 1.0 to 10.0 Shifts legend to right BLP
/LegendSize 0.1 to 100 Size of Legend spot and text BLP
/LineFromOrigin No,Yes Draws an initial line L
/LowValue number Bottom of range BL
/MarkerColor color Color of data point markers L
/MarkerShape shape Shape of data point markers L
/MarkerSize 0 to 9999 Size of data point markers L
/MaxGridDivisions 1 to 10 Max number vertical divisions BL
/MergeLabels No, Yes Merge same-label data BLP
/NegativeColor color Color of negative data BLP
/OutlineColor color Color of edging lines BLP
/OutlineStyle lineStyle Drawing style of lines/edging BLP
/OutlineWidth 0 to 1000.0 Width of edging BLP
/PieType FullPie, HalfPieUp,
HalfPieDown
Overall shape of pie charts P
/PieValueInPercent Yes, No, or 0 to 5 Print pie data as %; force
total = 100% (int)
P
/PrintBottomAxis Yes, No Show/hide zero-axis BL
/PrintBottomTics No, Yes, IfLabel Print tic marks on bottom BL
/PrintCalloutLine IfNeeded, No, Yes Print callout lines P
/PrintFloor No,Yes Show/hide line below axis BL
/PrintGrid Yes, No Show/hide grid lines BL
Appendix C: Working with uChart
148
Commands Parameters Effect Applicable
To
4
/PrintLabel Yes, No,
ExceptPlaceholder
Show/hide data labels BLP
/PrintLeftAxis Yes, No Show/hide left vertical axis BL
/PrintLeftScale Yes, No Show/hides left scale
numbers
BL
/PrintLeftTics Yes, No Show/hide left tic marks BL
/PrintValue Yes, No Show/hide data labels BLP
/RightGap 1.0 to 10.0 Gap width after rightmost
column
BL
/RightTextLimit - 1000.0 to1000.0 Rightmost limit for text BLP
/SliceCutaway 0.0 to 0.5 Space between pie slices P
/TextShrinkList [ list of .99 to .2 ] Text-reduction steps for
ShrinkToFit
BLP
/ValueColor color Color of values BLP
/ValueFormat ( numberFormat ) Formatting of values BLP
/ValueLocation Header, ... On-chart location of values BL
/ValueLocation Header, ... On-chart location of values P
/ValueOverflow Ignore,... Clipping of on-chart values
that are too long
BLP
In the following example we have taken a regular two-dimensional bar graph (see Figure 99)
and changed its color and 3D properties as follows (see Figure 100):
We first enabled three dimensional view by issuing the command '/3D Yes'. Then we have set
the depth of the 3D effect to 30 degrees (/3DViewAngle 30) and the apparent position of the
3D effects point of view to '1' (/3DDepth 1). Finally, we have changed the color of the chart's
grid from black to red (/GridLineColor Red). The resulting bar graph is shown in Figure 101.
Appendix C: Working with uChart
149
Figure 99: uChart, Example Chart Output before Modifications
Figure 100: uChart Enhanced Chart Options
Figure 101: uChart, Example Chart Output after Modifications
151
Appendix D: XLIM Capabilities
XLIM (pronounced: "slim") is an acronym that stands for XMPie Less is More. This
composition technology from XMPie significantly increases the speed of generating Print
Output files for graphically simple (print) designs. Such designs are exported by uCreate as
".xlim" files and can be uploaded to a uProduce Campaign. uProduce includes the algorithms
that process XLIM Dynamic Documents to generate Print Output files in an extremely speedy
and efficient way.
This section provides a complete description of XLIM capabilities. The XLIM capabilities are
organized in the following list by design elements in hierarchical manner (that is, document -
page - page elements, etc.).
Production
XLIM Composition Engine supports the following output formats:
PostScript.
VPS, external reference for images (Asset Resources).
VIPP, external reference for images (Asset Resources).
PPML (using Base64 encoding for internal data), external reference for images (Assets
Resources).
According to user selection: PPML version 1.5 or 2.1, the JOB tag is used for PPML version
1.5 and DOCUMENT_SET for PPML version 2.1 as the tag surrounding the job content.
PDF (via distilled PostScript).
PDF and JPEG proof generation.
XLIM supports the following production-related options:
Creating a number of copies (dynamic and static values).
Step & Repeat Imposition.
Bleeding - Bleed enlarges the original design page size by the bleed measurements and
places all elements accordingly (offset according to the bleed).
Spread Visibility Content Object and Layer Visibility Content Object (including
Visibility++).
Dynamic Media selection.
Appendix D: XLIM Capabilities
152
Page Elements
XLIM supports the following page elements of a design:
Supported page elements: Text frames, Graphic frames, Text stories with inline graphic
frames where each inline frame has a single image. No other content of inline frames is
supported.
Background color (plain, no gradients, including tint).
Copy fitting algorithms (overflow, underflow, overflow and underflow. Uses binary
search for fast retrieval of best fitting algorithm modifiers):
Line Height
Font Size
Overflow policy handling.
Text Composition in XLIM is slightly different from InDesign:
Words are moved to the next line when there is insufficient space in the current line.
Break (hyphenation) occurs only when the next line does not have enough space to
contain the word ('best fit' oriented).
Spaces are removed from the beginning of a line if it is 'broken'.
The Suppress trailing spaces option is always on.
Frame transformations (skew, rotation, etc.).
Paragraph features:
Alignment, last line alignment and justification
The size of spacing between paragraphs (space before and space after)
Vertical alignment of InDesign text frames
Linked InDesign text frames
Left and right indentation of paragraphs from the left and right edges (respectively) of
the frame
Solid borders (plain color, no gradients, including tint).
Appendix D: XLIM Capabilities
153
Image Content
XLIM support the following image content of a design:
JPEG (Baseline JPEG), TIFF (TIFF 6.0 Baseline including colorized monochrome TIFF) and
EPS image types.
Image Transformation (inside image box).
Missing Image Asset handling (including emitting missing image code).
Missing Links handling (document Resources that are not Assets). The missing links are
replaced by missing image code representations.
XLIM support for TIFF images follows the TIFF 6.0 Baseline specification closely while
adding it features from the rest of the TIFF 6.0 specifications (mainly CMYK support).
The following lists the supported features:
1-Bit TIFF/Bi-level:
'1' value bits appear with the color applied in InDesign.
'0' value bits are transparent (mask).
Grayscale, CMYK and RGB (no colorimetric data support, both full RGB and Palette
RGB) images.
Grayscale images will use the box and image applied background colors in InDesign
to define their color, and will refer to the image data to define the specific pixel
percentage of that color. Real grayscale may be achieved by setting the image
foreground color to black, and the box background to white (which are the defaults).
Images must be stripped (not tiled). Single or multiple strips are supported.
If there is no resolution information, the image will use InDesign logic to appear
the same.
Supported compressions (with reference to relevant image information) are as follows:
uncompressed, CCITT G3/G4, LZW and PackBits.
FillOrder 1 and 2 are supported.
There should be a single image in a file (if not, only the first image is used).
Transparency information (associated and unassociated alpha) is not supported and
will create corrupted output as the alpha bits are not ignored.
Appendix D: XLIM Capabilities
154
Text Content
XLIM supports the following text content and attributes of a design:
Foreground color (plain color, no gradients, including tint).
Font types: OTF, TTF, Type 1 (same as uProduce) and unicode fonts (including Symbol).
Text File Content Objects shall be plain text (that is, *.txt files containing strings only).
Missing text Assets handling (including emitting missing text code).
Subscript and superscript support. The parameters for subscript and superscript are
defined in the document level.
'Indent to here' character support.
Inline Content
XLIM supports the following inline content of a design:
Inline box content is images only (meaning, no text in inline box, no background, etc.).
All image features described in Image Content are supported when in inline.
Lines
XLIM supports the following line properties of a design:
Straight lines (two points in path).
Color (plain color, no gradients, including tint).
155
Glossary
The following concepts and terms are used throughout this guide.
ADOR Object (also known as Content Object)an object of the Plan that is visible to a Design
(via the Link to Plan operation of uCreate). ADOR Objects can be of various design-centric
types, for example, text, graphic, etc. The designer uses simple point-and-click operations to
tag a design object (such as a text frame or graphic frame) with the desired ADOR Object. Such
a tagged design object becomes a Dynamic Object: a design object that derives its content
and/or appearance from the ADOR Objects value. ADOR Object values are calculated by the
Plans Rules, using the given Data Source(s). These calculations are performed iteratively,
once for each recipient, resulting in a set of recipient-specific values for each ADOR Object. In
a way, one can think of ADOR Objects as the intermediaries between the Logic (Plan) and Data
(Data Source) and the Design (an XMPie Tagged Document).
ADOR technologystands for Automatic Dynamic Object Replacement (ADOR) technology,
which encompasses all of XMPies foundation technologies that provide Dynamic Publishing
solutions.
Asset Sourcein the context of PersonalEffect, this term refers to a collection of Campaign
Assets (for example, images, formatted text files, etc.) and its location. You can define one or
more Asset Sources for a single Campaign.
Assetsin the context of PersonalEffect, this term refers to content (such as graphic files and
text files) that feeds the Dynamic Objects in a Design (as opposed to Resources, which are static
content).
Bindingthe integration of Logic, Data and Design into a Dynamic Document. With ADOR
technology, binding is automatic.
Business rulesee Rule.
Campaigna representation of a set of Dynamic Documents, possibly of different types, all
sharing the same Plan file, Data Source(s) and Asset Source(s).
Content Objectsee ADOR Object.
Content Samplesa set of possible values, defined by the user, for a given ADOR Object;
different ADOR Objects can have different sets of values associated with them. There are no
constraints on these values; except that they need to adhere to the type of ADOR Object with
which they are associated (for example, the Content Samples associated with a Graphic ADOR
Object should be a set of images). For example, one can define three images CarA, CarB,
and CarCas the possible values of a CarPitcutre Graphic ADOR Object. It is then
possible to flip through these Content Samples, to see how the different images appear in the
Glossary
156
Design, without being forced to rely on a complete Plan or on Proof Sets that may not
necessarily be available at the early stages of the design process.
Content sourcethe source that provides values that feed the Content Objects (via Rules or
directly), which in turn change the content (or format) of the Dynamic Objects in your design.
There are different types of content sources, including Data Sources, Proof Sets and Content
Samples.
Dataone of the Dynamic Documents basic components. In PersonalEffect, the Data
component is represented by Data Sources and Asset Sources.
Data Schemaa description of the Data Source structure that is expected by the Logic. The
Data Schema specifies the following: the required tables; each tables column headers (for
example, First Name, Customer ID, etc.) and the type of data they represent (for example,
a string, an integer, etc.); and the relationship between these tables (for example, a common
field).
Data Sourcerepresents the Dynamic Documents Data component, which is common to all
Dynamic Documents in a given Campaign. The schema of the Data Source must adhere to the
Data Schema defined by the Campaign's Plan file. Each Campaign may have multiple Data
Sources, in any ODBC compliant format (including Oracle, MS-SQL, MySQL, IBM-DB2, CVS,
XML and MS Access).
Design(also known as Tagged Document, Dynamic Document Template and uProduce
Document)An Adobe InDesign document that includes regular and tagged design objects.
Tagging is performed using the uCreate plug-in of Adobe InDesign.
Document instance a copy of the Design that was instantiated for a given recipient. For
example, a production run of a given Dynamic Document for a batch of 1000 recipients will
result in 1000 Document instances.
Dynamic Documenta modular binding of three components: Logic, Data and Design.
Practically speaking, these components are represented by a Plan file, a Data Source and a
Design (respectively).
Dynamic Document Template (also known as a Tagged Document)see Design.
Dynamic Publishing - a discipline of Publishing that aims to produce any customizable
document, in any media, on-demand. Dynamic Publishing extends Variable Data Printing
(VDP) into digital print and electronic media, focusing not only on final output media but also
on creating documents with dynamic content, from Design to Production.
Dynamic Objecta design object (for example, a text frame or a graphic frame) that is tagged
by an ADOR Object. This tagging transforms the design object from static to dynamic. A
Dynamic Object derives its content and/or appearance from the ADOR Objects recipient-
specific value (as opposed to showing a pre-set, static value).
Glossary
157
Logicthe set of ADOR Objects; the QLingo expressions that compute their values for a given
recipient; and the interface to Data.
Output Elementa representation of a design element (such as text box, image box, lines and
other shapes) in the Print Output file. There are two types of output elements:
Reusable content - a reusable content is an output element reused within a personalized
print job (also known as Recurring content). Typical examples include a logo image, a
signature, boilerplate text, etc.
Unique content - a unique content is an output element that is unique to a record within a
personalized print job. Typical examples include text box with the recipient name and/or
address, social security number, etc.
In general, all images are classified as Reusable content. However, an image may be
considered a Unique content when you apply transparency techniques to the image, which
eventually results in utilizing XMPie's X-DOT technology. Transparency techniques are:
Drop shadow
Feathering
Opacity lower than 100%
Transparency (unique to images)
Planthe encoding of Logic in PersonalEffect; it is encoded in XML, and stored in files with a
".plan" extension. The Plan file consists of the following elements:
A Data Schema, which describes the structure of the Data Source needed to drive the
Campaign.
A set of ADOR Objects, which can be used for tagging design objects (for example, by
using uCreate), thereby transforming them into Dynamic Objects
A set of Variables, which are similar to ADOR Objects, except that they cannot be used for
tagging design objects (hence, they are internal to the Plan). Their use is for computing
intermediate results, and using such values in computing values for ADOR Objects.
For example, a Plan may have a Variable called discount that holds the percentage discount
one is entitled to, based on the given individuals purchase history, or affiliation with the
Platinum, Gold, or Silver levels of some membership club. This discount Variable can be
used to compute the value of an ADOR Object called discountAmount, which will appear in
the document, showing the monetary value (as opposed to the percentage value) of a
discount that one receives. Variables allow for avoiding repetitive computations or data
retrievals, as well as improved readability of the Plan, for later revisions, etc.
A set of Rules QLingo or SQL expressions that compute the values of the Plan's ADOR
Objects and Variables, once for each recipient.
Glossary
158
In high-level terms, one should think of a Plan as a program that is being repeatedly executed,
once for each recipient. In each of these iterations, the Plan performs computations that result
in a set of values: one recipient-specific value for each ADOR Object. The process that
"executes" such Plan programs is known as Plan Interpreter, and it is part of uPlan and
uProduce.
Print Output filean output file (also known as Print Stream) in one of the print or Variable
Information (VI, in short) data printing formats (PDF, VPS, PPML, VIPP, PPML/VDX or
PostScript), which is further processed by a print controller (RIP). The processing of a print file
by a print controller produces a series of hard-copy printed Document Instances, each
representing the variations made for a specific individual.
Plan Interpretersee Plan.
Proof Setan XML-encoded table where columns represent ADOR Objects and rows
represent a set of valuesone for each ADOR Objectfor a given recipient. Proof Sets are
generated by uPlan, uCreate or uProduce. They are typically generated for a subset of the
recipients list, with possibly a few more filtering criteria, by executing the Plan for each such
selected recipient and storing the resulting ADOR Object values in that recipients row.
Sometimes Proof Sets may represent the whole set for which a specific production run is going
to be executed. In such cases they may be referred to as Production Sets.
QLingoa scripting language developed by XMPie, to allow the use of classical conditional
logicsuch as 'if-then-else' or 'switch' constructsin expressions that compute values for
ADOR Objects or Variables in a Plan file. QLingo also supports many domain-specific
constructs for formatting, process control, and other data manipulation functions. Together
with SQL and the ability to call upon external functions, QLingo makes the Plan file
expressions (for example, Rules) extremely powerful, yet not overly complex.
Recipientthe person who receives an individual instance of the Dynamic Document. If the
Document is static, all recipients receive identical copies; if the Document is dynamic, each
recipient receives a unique Document instance, which has been personalized based on this
recipients specific data.
Recipient Lista table whose records represent the recipients of a particular Dynamic
Document. At production time, a personalized Dynamic Document instance is generated for
each recipient (that is, record) in this Recipient List.
Resourcesstatic graphic files, which are used in the design and are fixed throughout
production (as opposed to Assets, which change per-recipient). An example may be the
company logo.
Rule (also known as business rule)part of the Logic defined in the Campaigns Plan file.
Rules are expressions that calculate Content Objects values for each recipient.
Static Documenta regular desktop publishing document, such as an InDesign document.
Glossary
159
Tagged Documentsee Design.
Variablean internal object of the Plan, which can be assigned values of expressions (QLingo,
SQL, etc.). A Variable can also be used as input for expressions that compute values of ADOR
Objects. Variables allow for avoiding repeat computations or data retrievals, as well as
improved readability of the Plan, for later revisions, etc. Variables are not visible to uCreate
(hence to the designer).
X-DOTan acronym that stands for XMPie Dynamic Object Transparency (X-DOT).
X-DOT accurately reproduces, by using opaque objects, the visual effect of transparency in
Print Output formats that do not support live transparency. It creates one 'mega object' out of
several 'atomic objects' that need to be combined to preserve the transparency effects between
them. Transparency may be created when special effects (such as shadow, feathering or
opacity) are used, or in an image file that contains transparency.
XLIMan acronym that stands for XMPie Less is More. This composition technology from
XMPie significantly increases the speed of generating Print Output files for graphically simple
(print) Designs. Such Designs are exported by uCreate as ".xlim" files and can be uploaded as
such to a uProduce Campaign. uProduce includes the algorithms that process XLIM Dynamic
Documents for generating Print Output files in an extremely speedy and efficient way.
161
Index
A
Adding
Graphic Content Object, 45
Style Content Object, 46
Table Content Object, 48
Text Content Object, 44
Text File Content Object, 45
Visibility Content Object, 73
Adjust Font, 56
Adobe Dreamweaver, 91
Adobe InDesign, 6, 9
ADOR Object. See Content Object
ADOR Technology, 1, 155
Asset Source, 155
Assets, 63, 155
embed, 81
location, 75
setting folder, 15
Assets Folder
setting, 15
Auto Flow, 54
options, 55
Auto Leading, 54, 56
B
Bar Code Functions, 134
Blank Spaces
suppressing, 54
Bleed Values, 82
C
Cache Element Locally, 58
Cache ISAPI Applications, 123
Campaign, 2
Campaign packages, 65
Center in Frame, 57
Clear Global Cache, 16
Code View, 103
Compress output, 77
Conditions
Rule, 25
Content Object, 3
deleting, 42
duplicating, 41
editing, 125
evaluating, 15
example Rules, 26
Graphic, 57
properties, 52
properties, 24
renaming, 40
Style, 46
Table, 61
Text, 52
Text File, 60
type, 41
updating, 103
Visibility, 72
Content Samples, 64, 155
clearing, 15
deleting, 65
Conversions, 133
Copy Fitting, 54
Counter Data Source, 19
linking to, 14
Cut and Stack, 80
Cut Marks, 80
D
Data Driven Graphic, 48, 49
adding a table Content Object as, 141
Data Schema, 3
Data Source, 2
Counter Data Source, 19
linking, 19
Data Source File
linking to, 13
Deleting
Content Object, 42
Content Samples, 65
Index
162
Document
linking to Data Source, 19
static, 158
Document package, 15, 65
Dreamweaver, 91
Duplex Printing, 80
Duplicating
Content Object, 41
Dynamic Document, 3, 9
Dynamic images, 30
Dynamic Objects, 3
highlighting, 12, 43
Dynamic Print, 16, 75
Dynamic publishing, 1
Dynamic Story
Length Handling, 53
Length Handling, 54
properties, 53
Suppress Trailing on Empty Content, 53
Dynamic Table, 49
E
Editing
Content Object, 125
Plan, 18
Plan, 14
Email
description, 104
Email Activity, 108
Email Activity, 108
Embed
Assets, 81
fonts, 81
Resources, 81
Empty Spaces, 53
Error Policies, 77
Evaluating Content Objects, 15
Exchange Export, 15, 66
XLIM, 65
XLIM file, 15
XLIM package, 15
Exchange Import, 15, 66
Export
Proof Set, 15
Exporting
document or XLIM packages, 66
F
Find and Replace, 15, 86
Fit Frame to Contents, 57
Fit Proportionally, 57
Fit to Frame, 57
Font
adjusting, 56
embed, 81
G
Gap, 80
Global Cache
clearing, 16
using, 82
Graphic
data driven, 48, 49
Graphic Content Object
adding, 45
properties, 57
H
Help, 16
Highlight Dynamic Objects, 12, 43
Horizontal Scale, 56
Hyphenation, 52
I
ICP
connecting to uProduce Server, 98
IIS, 118
Importing
document or XLIM packages, 66
document packages, 15
Importing Rules, 39
InDesign, 6, 9
using uCreate with, 11
ISAPI Applications
cache, 123
K
Key, 28
Index
163
L
Link to Counter, 14
Link to Data Source File, 13
Linking
Document to Data Source, 19
Document to Plan, 17
Document to Proof Set, 62
Linking to
Plan, 14
Proof Set, 14
Logical Pages, 80
Lower Case Formatting, 126
M
Maintain Transformation, 58
Media Selection, 85
Missing Assets, 77
Missing Fonts, 77
Mold Row
specify number, 50
N
Nested Composition, 60
Non-Breaking Spaces, 52
O
Online Help, 16
Options menu, 13
Output element
definition, 157
Overflow, 53, 54, 56
P
Page Dimensions, 80
PDF
Variable Information output format, 88
Personalization, 157
Plan
editing, 14
linking to, 14, 17
reloading, 14
Plan
editing, 18
Plan
reloading, 18
Plan, 157
Port
connecting to, 99
PPML
adding metadata to each record, 82
embed Assets or Resources, 81
extract unique content to external files, 82
output format, 88
tagging each record as a document group, 82
tagging fixed background as a master page,
82
Variable Information output format, 88
version, 82
Preflight, 16
Primary Field, 28
Print Output file, 158
format, 75
Printing
with media selection, 85
Proof Set, 61, 158
Creating, 62
export, 15
linking to, 14, 62
Proofing, 43
Properties
Graphic Content Object, 57
Table Content Object, 61
Text Content Object, 52
Text File Content Object, 60
Proportional & Centered, 57
PS
Variable Information output format, 88
Q
QLingo, 158
R
Random Integer, 132
Recipient, 158
Recipient List, 158
Reloading
Plan, 18
Plan, 14
Index
164
Renaming
Content Object, 40
Resources, 158
embed, 81
Rounding Numbers, 132
Rule, 22
Conditions, 25
examples, 26
Functions, 26
importing, 39
Values, 26
Rule Editor, 22
S
Sample Data, 43
Scale
horizontal, 56
Server Behaviors, 111
Session State
enable, 122
Setting
Assets Folder, 15, 75
location of Assets, 75
Site
setting up, 95
Static Document, 158
Step & Repeat, 81
Style Content Object
adding/removing, 46
Rule, 25
Suppress Trailing on Empty Content, 53
Suppress Trailing Spaces on Empty Content,
53
T
Table
dynamic, 49
Table Content Object, 61
adding, 48
example Rule, 28
Text Content Object
adding, 44
example Rule, 26
Rule, 24
Text File Content Object, 60
adding, 45
example Rule, 27
Title Style Formatting, 125
Tracking
description, 111
menu, 111
Web page element, 113
Web page visit, 112
Transformation, 58
Trial Version
uCreate, 16
U
uChart, 141
uCreate, 6
Options menu, 13
overview, 9
palette, 11
registering trial version, 16
uCreate XM, 91
uCreate XM
code view, 103
Content Objects usage, 102
prerequisites, 117
working with, 100
uCreate XM
Benefits, 91
uEdit, 88
Lock options, 88
Permissions, 88
uImage, 6, 30
Underflow, 53, 56
uPlan, 5
Upper Case Formatting, 126
uProduce, 6
Use Global Caching, 82
V
Variable, 159
Variable Information output format
PDF, 88
PPML, 88
PS, 88
VDX-PDM, 88
VIPP, 88
Index
165
VPS, 88
VDX
tagging fixed background as a master page,
82
VDX PDM
Variable Information output format, 88
VI output format. See Variable Information
output format
VI Stream Options, 58
Viewing
Content Samples, 64
Proof Sets, 14
VIPP
embed Assets or Resources, 81
extract reusable content to external files, 82
extract unique content to external files, 82
Variable Information output format, 88
VIPP Output Files
project name, 82
Virtual Folder, 119
Visibility, 72
icons, 73
Visibility Content Object, 72
adding, 73
assigning to layers and spreads, 74
example Rule, 27
Rule, 24
VPS
embed Assets or Resources, 81
extract unique content to external files, 82
Variable Information output format, 88
X
X-DOT, 58
definition, 159
XLIM, 88
capabilities, 151
definition, 159
exchange export, 65
PDF Preview, 66
XNIP, 67