TFORMer E
TFORMer E
V ers io n 7 .5
White Paper
23 Se p tem be r 20 1 9
T EC - IT Da te n v er arb e it un g G m bH
Ha ns -W agner - Str a s s e 6
A- 44 0 0 S te yr , A us t ri a
t + + 43 ( 0)7 2 52 72 7 20
f + + 43 ( 0)7 2 52 72 7 20 77
of f ic e @ tec - i t.c om
ww w. tec - i t.c om
Content
TFORMer Suite Content 2
TFORMer Product Family 3
Software for Labeling and Reporting 3
Software Components 4
Principle 5
Highlights 6
TFORMer Designer 9
Create and Print Labels and Reports 9
Instant Printing 9
Scenario 1: Printing Industry Compliant Forms 10
Scenario 2: Instant Printing / Serial Numbers 11
Scenario 3: Pre-Press Applications 12
TFORMer SDK 13
Reporting SDK for Software Developers 13
Highlights 14
Using TFORMer SDK 15
Sample Code 16
Document Layout Selection 17
Providing Document Data 17
Data Source Parameters 18
Field Mappings 18
Scenario 1: Client-Side Reporting 19
Scenario 2: Reporting and Labeling with Web-Clients 20
Scenario 3: Server-Side Reporting and PDF Creation 21
Scenario 4: Hosted Reporting Solution 22
Datasheets 23
TFORMer Designer 23
TFORMer SDK 24
Licenses 25
TFORMer Designer 25
TFORMer SDK 25
Pricing 25
Contact 26
These software tools for printing, labeling and reporting fulfill all output
requirements. The modular concept of TFORMer was optimized to cover
scenarios like
Re p ort i ng an d
La b e li n g f o r
E nd Us er s
De v e lo p er s
E nt er pr is es
TFORMer Suite
TFORMer Designer
The visual document editor is used to create arbitrary document layouts like
forms, lists, tables, serial letters, reports and labels. End-users are able to
print these documents immediately with data entered manually or imported
from external data sources.
Pr od uc t F am il y
Ins ta n t Pr i nt i ng Software developers use the software component TFORMer SDK as advan-
ced output- and reporting generator: TFORMer SDK embeds the output and
O ut p ut- E n gi n e
printing functionality of TFORMer Designer into your applications. The SDK
Re p ort G e n er at or prints or exports documents with data provided by your application or
database.
P DF G en er at or
O ut p ut TFORMer Server 1
Ma n ag em en t
TFORMer Server offers an industry-compliant, centralized and enterprise-
wide output solution. It connects to arbitrary host-systems, collects output
requests and sends the resulting documents to the specified target devices or
folders. TFORMer Server is configured graphically with TFORMer Designer.
1
TFORMer Server is described in a separate document.
TFORMer Suite A document layout created with TFORMer contains static content and
dynamic data. Dynamic data is provided manually by the user, by external
data sources (e.g. a database) or via program code by your application.
TFORMer uses the document layout along with the dynamic data provided by
your application or database to generate perfect output. Output is either
printed directly or generated in a supported export format like PDF,
PostScript ® or ZPL-II.
W ork f lo w
Cre at e D oc um ent
Pr o v id e D at a
Pr i nt
TFORMer is a lean but powerful output solution for reporting and labeling. The
software is used by end users as well as by software developers.
TFORMer Designer was optimized for quick and easy document design, high
flexibility and complete device as well as database independence. All types of
documents can be created: reports, barcode labels, industry labels, serial
letters, business forms, etc.
Complete
All of the mentioned features are integrated part of TFORMer. Costly add-ons
(e.g. for PDF or bar codes) are not required.
Ready-To-Use Templates
With TFORMer you print compliance labels and industry forms in no time at
all. Standard layouts for industry and logistic (e.g. VDA4902, ODETTE, AIAG,
GS1, UPS®, FedEx ®, ...) are included.
Output Formats
The integrated barcode support for all linear, 2D, composite, RSS and GS1
In te gr at e d bar codes in common use save hardware costs. No special printers are
required.
B ar Co d es
Data Sources
PD F O u tp ut
P os t Sc r i pt A document can be printed with dynamic data from different data sources:
HT ML Manual input
ZP L- I I Database import (ODBC)
File import (XML, TXT, CSV, TSV)
Im age Ex p or t From within Office applications (e.g. a Microsoft® Excel® spreadsheet)
Program code (see TFORMer SDK)
TFORMer Suite TFORMer separates data from document design. Document layouts are
completely independent from a specific data source and can be reused as
often as required.
Reusability
Printer Independent
Database Independent
The reporting engine TFORMer SDK is available for all platforms and
operating systems 1 in common use.
Easy Deployment
Both small-scale (e.g. per user) as well as large-scale (per enterprise) re-
quirements are covered. Document layouts can be used as stand -alone forms
or they may be organized in so-called repositories. Repositories provide a
structured overview of all document layouts and simplify maintenance and
deployment.
Hi g h li g hts Open Architecture
Re a d y- T o- Us e The interfaces of TFORMer are well documented and disclosed. XML is used
Doc um en t
for internal purposes as well as for communication with 3rd party software.
T em plat es
Proprietary interfaces or configuration files are avoided. This makes it easy to
Re us ab l e L a yo u ts integrate the solution into existing workflows.
Fu l l B ar c o d e Smart Documents
S up p or t
Mu l t i- F or m at The integrated scripting capabilities support the creation of dynamic
O ut p ut documents. Via layout and element properties, data-fields and printing
conditions TFORMer provides complete control over the generated output.
Dir ec t Pr i nt i ng Moreover, serial numbers and computations are implemented without
Sc r i pt i ng programming.
1
Supported operating systems are listed below.
TFORMer Suite TFORMer document layouts supports dynamic tray-control, paper selection
(e.g. A4 vs. Letter) and printer mode control (e.g. Duplex printing).
Un i v er s al
In d us tr y F or m s
B arc o d e L ab e ls
For m s
Re p or ts
L is ts
T abl es
S er ia l L et t er s
T im e S a vi n g
Doc um en t
T em plat es
W YSIW YG
Un d o/ Re d o
Instant Printing
Besides document creation TFORMer Designer also supports manual printing
tasks. The data to be printed is either entered manually or imported from ex-
ternal data sources.
VDA4902 Sample
The sample given below shows a so-called VDA-4902 form (“VDA 4902
transport label”). This shipping label is mostly used in the automotive industry
in Europe:
A ut om ot i ve
AI AG
VD A , V D A4 9 02
G a l ia
O d et te
GTL
Lo g is t ic s
UP S
Fe d Ex
T NT
DH L
GS1
TFORMer comes with the free add-on QuickPrint. QuickPrint is ideally suited
for untrained users. It is designed for straight-forward manual data input and
for quickly printing existing layouts.
After the document layout was selected QuickPrint automatically displays the
used data-fields. QuickPrint saves the user input automatically – so there is
no need to re-enter the values in the next session.
By sharing the layouts in a central location you can easily use serial numbers
In tu i t i ve in a multi-user environment. The TFORMer print engine ensures an auto-
matic, consecutive and unique numbering.
Q u ic k Pr i nt
No T ra in i ng
Re q ui r e d
A pp l ic ab l e
S er ia l N um ber s
Mu l t i- Us er
TFORMer Designer is the ideal solution for many business requirements (e.g.
serial letters) and for the high volume document creation in pre-press
applications.
Pr of es s io n a l
Fas t PD F Cre a ti o n
P os t Sc r i pt ®
Manual Data Entry or Data Import
Sm art L a yo u ts
Da ta Im po r t Documents created with TFORMer Designer are printed with a few mouse-
clicks. The dynamic data used in a document is entered either manually or
Da ta En tr y imported from an external data source (ODBC database, XML, CSV or TXT
file). Data printed in the last output session is stored by TFORMer
automatically – re-entering data is reduced to a minimum.
TFORMer’s scripting features are used to control the behavior and the
appearance of the generated output. Conditional printing, tray control and em-
bedded formulas are part of the package.
With a few function calls, this reporting SDK prints or exports the documents
created with TFORMer Designer with dynamic data provided by the
application program or an external data source.
O ut p ut F or m ats
Dir ec t Pr i nt i ng
PD F
P os t Sc r i pt
HT ML
T ex t
ZP L- I I
Im ages
In ter f ac es If required, end-users are able to create or modify1 document layouts with
TFORMer Designer by themselves. A seamless visual integration of
DL L, C O M , TFORMer Designer into applications or systems is supported by „Branding“.
.N ET , J A V A
S har e d L ib r ar y
Com m and L in e
1
Requires end-user licenses for TFORMer Designer.
TFORMer SDK was optimized to meet all demands in the areas of output
quality, performance and flexibility. This reporting SDK covers requirements in
the areas of client-side reporting, server-side reporting and web-reporting.
Cross-Platform
APIs
DLL
COM Object
.NET 2.0 Assembly
JAVA JNI (Java Native Interface)
Command line tool tfprint
Shared Library1
Numerous samples including source code will help you to get started.
Perfect Encapsulation
For creating output TFORMer SDK requires the name of the document layout,
the user data (if any) and the specification of the output file (or output device).
The output generation is completely encapsulated within TFORMer SDK.
Minimized Dependencies
O ut p ut Q ua l it y Easy Deployment
P erf orm anc e
Installation and deployment of TFORMer SDK is simple. CAB-based setups
P ort a bi l i t y for an internet-based installation and so called merge module (MSMs – which
are to be used with common installer products) are available.
Res o ur c es
De p lo ym e nt Small Footprint
The core requirements for TFORMer SDK are minimal. It may even be used
as part of an ASP .NET web-service with limited heap-size.
1
Only on Linux® and UNIX®.
TFORMer Suite For generating output the following data must be specified:
For passing the layout and the data to TFORMer SDK you can choose be-
tween various methods:
In te gr at i o n
E as y
S eam l es s On the next page you see a small sample application. This example creates
business cards as PDF output. The data for the single business card s is
provided via program code.
job.RepositoryName = "C:/Documents/Demos.tfr";
job.ProjectName = "TFORMer_Runtime_Examples";
job.FormName = "BusinessCard_Multi";
// set the data-field values for the 1st label (Email, JobTitle, Name)
// set the data-field values for the 2nd label (Email, JobTitle, Name)
job.OutputName = "C:/temp/out.pdf";
job.PrinterType = PrinterType.PdfFile;
job.Print();
The Result
In order to select a document layout specify the desired layout file created by
TFORMer Designer:
' Method 1: Specify the filename
TFORMer.RepositoryName = "C:/Layouts/MyLayout.tff"
TFORMer.RepositoryName = "https://www.tec-it.com/Layout/HostedLayout.tff"
The document layouts may also be zipped – this is handled by TFORMer SDK
automatically.
BASE64 Stream
TFORMer SDK is able to import data for printing from files (XML, TXT, CSV,
...). Just specify the filename (or the URL of such a file):
' Method 1: import document data from XML-files
Fi l e
BASE64 Streams
Com pres s e d
Fi l e Passing a BASE64 encoded streams instead of a file is the perfect method
when using TFORMer SDK in web-clients (e.g. in combination with AJAX).
Str e am
Document data is provided by the server application as BASE64 stream. This
Com pres s e d stream is sent to the client as part of the HTML code and output creation is
Str e am triggered via JavaScript. This method saves bandwidth – especially if the
stream is compressed (TFORMer SDK automatically supports zipped BASE64
streams)!
' Method 3: pass document data (origin is XML) as BASE64 string
TFORMer Suite TFORMer SDK is able to query databases using arbitrary SQL SELECT
statements. The resulting table is used as data-source for creating output:
' Method 4: Retrieve document data from a database (ODBC, SQL-SELECT)
Via API
The values for the data-fields used in a document can also be set directly via
your program code.
' Method 6: Pass document data via API calls
myData.Records.Add(new Record());
myData.Records[0].Data.Add("ArticleName", "Speaker System HF1");
myData.Records[0].Data.Add("ArticleNo", "12001234");
myData.Records[0].Data.Add("ArticlePrice", "498.98");
Field Mappings
Fields of a data source (a source field like a specific column of a table) can be
assigned freely to data fields in a document layout. In addition, computations
can be performed with source fields. Both features help you to decouple a
document layout from a specific data source completely.
The Solution
Loc a l Us e
Dir ec t Pr i nt i ng
PD F
P os t Sc r i pt Provide Document Data
HT ML Document data is provided either directly by your software via API -calls or by
Im age O ut pu t using external data sources like ODBC databases or import files.
ZP L- I I Installation and Deployment
The Solution
Embed the COM component of TFORMer SDK into the HTML page. In this
case TFORMer SDK is available as “object” within this page and can be
programmed via JavaScript or VBScript. Because TFORMer SDK is installed
on the PC of the client, direct printing of labels and reports t o all printers
available to this PC is possible.
Br o ws er Us e
Ne t work Pr i n ter s
Loc a l Pr i nt er s
Installation and Deployment
PD F
P os t Sc r i pt Usually the deployment of TFORMer SDK is automated by using so-called
CAB based setups. A CAB based setup is hosted on a central server (e.g. the
HT ML web-server). TFORMer SDK is installed automatically on the client by Internet
Im age O ut pu t Explorer when needed. Please contact us if you need help regarding this
matter.
ZP L- I I
It is also possible to install TFORMer SDK using the standard setup
application available from TEC-IT.
Variant 1
Utilize TFORMer SDK exclusively on the server. The clients retrieve the
generated output in electronic form (e. g. a PDF documents which are printed
on the client thereafter).
Variant 2
Hos te d R ep or t in g Questions?
Doc um en t Des i gn
Document Layouts
Form a nd L a b el Formatted text
T em plat es Graphics, pictures and images
B arc o d es Page X of Y
Date/Time functions
T ra y- Co nt r o l
Z-order support
L if e Pr e v ie w Color support
Fill patterns
Auto-sized text
Watermarking (background-images)
Basic HTML formatting features
Document Data
Manual input TFORMer Designer and
QuickPrint
Import from text file
Re p ort i ng SD K Import from CSV/TSV file
TFORMer SDK
The API for TFORMer SDK is available on Microsoft ® Windows as COM
component, as DLL, as .NET assembly, as JAVA class and as command line
application. It includes no design functionality and it is intended for printing or
output generation only.
For Linux ® and UNIX ® TFORMer SDK is available as JAVA API, as shared
library, as .NET assembly for MONO applications and as command line
application.
Output formats which are available on all platforms are PostScript, PDF,
HTML, image output like PNG, JPG or GIF, ZPL-II and ASCII. On Microsoft
Windows direct printing to any printer is available in addition.
TFORMer SDK does not include any design application – this software
component provides solely the output functionality of TFORMer Designer.
Com bi n at i o ns
O n R eq u es t
Address: Hans-Wagner-Str. 6
AT-4400 Steyr
Austria
Phone: ++43 (0)7252 / 72 72 0
Fax: ++43 (0)7252 / 72 72 0 – 77
Email: [email protected]
Web: www.tec-it.com
All other products mentioned are trademarks or registered trademarks of their respective companies. If any
trademark on our web site or in this document is not marked as trademark (or registered trademark), we ask you to
send us a short message (mailto:[email protected]).