Datacard® TruCredential™ Software

The Datacard® ID Works to TruCredential Migration Guide

June 2015

Part No. 527677-001, Rev. A

Notice
This publication and the accompanying software are proprietary to Entrust Datacard 
Corporation and are protected by U.S. patent and copyright laws as well as various 
international laws and treaties. This publication may not be copied, translated, sold, or 
otherwise transferred to a third party, in whole or in part, without the express written 
permission of Entrust Datacard Corporation.

Information in this publication is subject to change without notice. Entrust Datacard 
Corporation assumes no responsibility for any errors that may appear in this publication.

Names and logos in sample screens are fictitious. Any similarity to actual names, 
trademarks, or trade names is coincidental.
Trademark Acknowledgments
TruCredential, ID Works, and IDCentre are trademarks and Datacard is a registered 
trademark and service mark of Entrust Datacard Corporation in the United States and 
other countries.

All other product names are the property of their respective owners.

Proprietary Notice
The design and information contained in these materials are protected by US and 
international copyright laws.

All drawings and information herein are the property of Entrust Datacard Corporation. All 
unauthorized use and reproduction is prohibited. 

Entrust Datacard Corporation
1187 Park Place
Shakopee, MN 55379
Phone: 952‐933‐1223
Fax: 952‐933‐7971
www.entrustdatacard.com

Copyright © 2015 Entrust Datacard Corporation. All rights reserved.

ii
 Revision Log
The ID Works to TruCredential Migration Guide

Revision Date Description of Changes

1 June 10, 2015 The first release of this document.

iii
iv
 Table of Contents
Chapter 1: Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Important Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
About This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Conventions Used in This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Support and Service Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Chapter 2: Export an ID Works 6.5 Software Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Export an ID Works 6.5 Software Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 3: Migrate ID Works Projects Into TruCredential Software. . . . . . . . . . . . . . . . . . 7

Migration of ID Works Software Files into TruCredential Software . . . . . . . . . . . . . . . . . . . . . . . 7
Project Migration Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Chapter 4: Post-Migration Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Map Data-Driven Workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Transfer Externally Stored Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Verify the Configuration of the Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
The ID Works Project Used a Microsoft Access Data Source . . . . . . . . . . . . . . . . . . . . . . . . 9
The ID Works Software Project Used a Microsoft SQL Server Data Source . . . . . . . . . . . . 10
The ID Works Project Used an Oracle Data Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 5: Differences Between ID Works Software and TruCredential Software . . . . . 11

Behavioral Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
ID Works Software Features That Are Not Available in TruCredential Software . . . . . . . . . . . 11
Field Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Card Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Card Field Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

v
vi
Chapter 1: Introduction

This section provides an overview of this document and the prerequisites 
required to migrate your Datacard® ID Works 6.5® or 
Datacard® IDCentre™ 6.5 software project to the Datacard® 
TruCredential 7.1 or later software environment.

Important Notes
• Do not install TruCredential software on the same computer on which you have 
installed ID Works or IDCentre software. Use a dedicated computer for the 
TruCredential software to avoid potential port and smart card conflicts.

• The migration process completes most of the conversion work. However, due to the 
differences in the software applications, manual steps might be required to complete 
the process.

• Bar codes might display differently in TruCredential software than they did in 
ID Works software.

• Hardware support differences: before migrating to TruCredential software, make 
sure that it supports your printer, camera, scanner, or other hardware.

• “Saved Searches” in ID Works are not migrated or supported in TruCredential 
software, which has no concept of a “saved search”.

• Projects are not migrated to TruCredential software, which does not support them.
• Custom code written for ID Works software cannot be migrated to TruCredential 
software.

About This Document

This document describes how to migrate projects from ID Works 6.5 or IDCentre 6.5 
software to TruCredential 7.1 software. It is intended for developers who have 
experience with the technologies mentioned in the prerequisites or who have been 
trained by Entrust Datacard.

Conventions Used in This Document

Placeholder text appears in italic font. You replace the placeholder text with information 
that is correct for your environment. Example: http://servername:portnumber/
trucredential

The ID Works to TruCredential Migration Guide 1

 User interface text appears in boldface font. Example: When work is complete, select 
userID > Sign Out.

This is an example of a note. Notes contain special information that you should be sure 
to read carefully.

Support and Service Resources

Go to entrustdatacard.com/support for information about getting support in your region 
of the world. Be prepared to access shipping documents (before installation) or the 
TruCredential software (after installation) to view software version and product key 
information.

2 Introduction
ID Works or IDCentre Software to TruCredential
Software Migration Prerequisites
You must have the following to complete the migration process:

• Projects in ID Works 6.5 or IDCentre 6.5 software or projects that were exported 

from it to .iwx files.
• If the destination (TruCredential software) computer does not have ID Works 6.5 
software installed, and if a Microsoft Access data source is pointing to a drive letter 
that does not exist on the destination computer, then create the same drive letter on 
the destination computer.

• TruCredential software must be installed and running on the destination computer.
• You must be a TruCredential software administrator to complete the migration 
process.

The ID Works to TruCredential Migration Guide 3

4 Introduction
Chapter 2: Export an
ID Works 6.5 Software Project

This section provides the information that you need to export 
ID Works 6.5 software projects to files that can be migrated to 
TruCredential software.

Export an ID Works 6.5 Software Project

ID Works 6.5 software projects are exported using the ID Works 6.5 Administrator 
application to bundle all components of an ID Works 6.5 software project into a single 
.iwx file.

1. Run Datacard ID Works software as an Administrator.

2. Select Tools > Export Projects.

3. From the list of projects available, select the projects that you want to export.

4. (Optional) To include magnetic stripe configurations, select the box for that option.

5. Click Browse and select the folder to which you want to export the project(s).

6. Click Export. Click OK when you see the success message, and close or minimize the 
ID Works Administrator application.

The ID Works to TruCredential Migration Guide 5

 These ID Works 6.5 software design components are bundled in .iwx files:

• The production form
• Card designs
• Field connections
• The data source
• Images, if applicable
• The Microsoft Access database only if it was created by ID Works 6.5 software (no 
external databases are included)

Report designs of ID Works 6.5 projects are not included.

6 Export an ID Works 6.5 Software Project

Chapter 3: Migrate ID Works
Projects Into TruCredential
Software
This section provides the information that you need to migrate exported 
ID Works software projects into TruCredential software.

Migration of ID Works Software Files into

TruCredential Software
1. Run the TruCredential application.
2. Sign in as an administrator of TruCredential software.

3. Select the settings icon   > Settings > Tools > Migration.

4. On the Migration page, click Browse and locate the folder to which you saved the 
.iwx files exported from ID Works software. Select one or more files to import. Click 
Open.

5. On the Migration page, select any appropriate options:

 Prefix project name to production forms and card designs
 Rename “production form” to “workflow”

 Rename “card design” to “credential design”

6. Click Import to begin the migration process. A migration summary window displays 
information about the progress of the migration. Click Close to return to the 
Migration page.

7. After migration is complete, a Migration Summary window displays detailed 
information about the process. Click Close.
8. The Migration page now displays a table that shows all migrated projects. 

9. Important: Click the view button   and the table button   to get detailed 

summaries about each migrated project. This information tells you how to proceed to 
make sure that each migrated item is ready for use in TruCredential software.

The ID Works to TruCredential Migration Guide 7

Project Migration Troubleshooting
Migration is not supported in any of the following cases:

• An unsupported image format, Adobe Photoshop 3.0 (.psd) or Targa (.tga), is used 
for the Photo field in the Production Form.

• Any card’s print job identifier field is not mapped to a production form field in field 
connections.

• Data source migration that is ODBC‐DSN‐based is not supported.
• A project from software earlier than ID Works 6.5 is not supported.
• The original ID Works software exported project file (.iwx) was renamed.
• Duplicate names for a workflow, credential design, or data source exist in the file.
• The Microsoft Access database file (.mdb) is not included in the ID Works software 
project file (.iwx).

8 Migrate ID Works Projects Into TruCredential Software

Chapter 4: Post-Migration
Activities

This section provides the information that you need after the migration 
to TruCredential software is complete.

Map Data-Driven Workflows

If a migrated workflow has data‐driven elements, manually map the values of List and 
Check box field(s) to the credential design. This is necessary because TruCredential 
software requires all fields to be mapped, whereas mapping is optional in ID Works 
software.

Do this mapping before attempting to open a migrated, data‐driven workflow. 
Otherwise, you cannot save the workflow.

Transfer Externally Stored Files

Move ID Works software photograph and signature files to the following locations:
installation_directory\Photos
installation_directory\Signatures

where installation_directory is the directory where TruCredential software was 
installed. By default, this directory is C:\Program Files\Datacard\TruCredential\.

Verify the Configuration of the Database

To configure data sources in TruCredential software, select the settings button   > 
Settings > Data Sources. Click Create to create a new data source or click the edit button 
 to view or edit an existing data source.

The ID Works Project Used a Microsoft Access Data Source

If Microsoft Access was the data source used in the original ID Works software project, 
you may need to do the following:
• If the Microsoft Access database is password protected and the password was not 
saved in ID Works software, enter the password in TruCredential software.

The ID Works to TruCredential Migration Guide 9

 • You must manually copy the Microsoft Access database into the configured path in 
the data source of that project in TruCredential software if either of the following 
occurred:

 An ID Works software project was created using the ID Works Designer 

application’s Save Project As feature and the Keep with project option was not 
selected.

 The Microsoft Access database path was configured as a custom path, rather 
than a default path.

The ID Works Software Project Used a Microsoft SQL Server

Data Source
If Microsoft SQL Server was the data source used in the original ID Works software 
project, you may need to do the following:

• If the Microsoft SQL Server database is password protected and the password was 
not saved in ID Works, enter the password in TruCredential software.

• Make sure that the TCP/IP port settings under <SQL Server Network Configuration> 
lists port 1433 or else you can not connect to the data source.

The ID Works Project Used an Oracle Data Source

If Oracle was the data source used in the original ID Works project, you may need to do 
the following:
• If the Oracle database is password protected and the password was not saved in 
ID Works software, enter the password in TruCredential software.
• If the Oracle database port number in ID Works software is something other than the 
default port 1521, configure the database port in TruCredential software to the 
actual port number used. Otherwise, you cannot connect to the data source.

• If the Oracle data source configured in ID Works software used a TNS service name in 
ID Works software, enter the database server name in the migrated data source 
configuration in TruCredential software.

10 Post-Migration Activities
Chapter 5: Differences
Between ID Works Software
and TruCredential Software
This section provides information about the differences between 
ID Works software and TruCredential software.

Behavioral Differences
Print job identifier: This is a card property in ID Works software, whereas it is a workflow 
personalize step field in TruCredential software.

Data driven: Copied values of List or Check Box fields in the Variable Graphic field can be 
further modified in ID Works software to configure a graphic. Therefore, modified values 
of the List or Check Box field are taken into consideration to configure data‐driven 
graphic properties in TruCredential software.

ID Works Software Features That Are Not

Available in TruCredential Software
The following are not supported by, or applicable in, TruCredential software:

• The production form’s size
• The production form’s background color or graphic
• The Binary field
• The Event field

The ID Works to TruCredential Migration Guide 11

Field Properties
Field properties in ID Works software that are not supported in TruCredential software.

Field Tab Property

Text General Write to log

Note: If an input 
format was used in  Appearance Use these colors when the Read Only field 
ID Works software,  option is selected
there are additional 
properties that must  Advanced When creating a new record
be entered in 
TruCredential 
When saving a change record
software: Input 
Use sample data as default data
format hint and 
Error message. You 
must also verify that 
the input format and 
maximum length are 
correct.

Photo General Write to log

Capture Options No capture

TWAIN: This is available via a different 
mechanism in TruCredential.

TWAIN (Fast)

Video for Windows

Video for Windows (fast)

Automatically when field selected

Storage Adobe Photoshop (3.0) (.psd)

Targa image file format (.tga)

12 Differences Between ID Works Software and TruCredential Software

 Field Tab Property

Date General Write to log

Appearance Use these colors when the Read Only field 
option is selected

Advance When creating a new record

When saving a change record

Mask  Date format

List General Write to log

Appearance Use these colors when the Read Only field 
option is selected

Composite General Sample data

Write to log

Appearance Use these colors when the Read Only field 
option is selected

Print Count General Write to log

Display in table view

Appearance Use these colors when the Read Only field 
option is selected

Auto‐Sequence General Write to log

Appearance Use these colors when the Read Only field 
option is selected

Check Box General Write to log

Appearance This section is not present

Foreground color

Background color

Use these colors when the Read Only field 
option is selected

The ID Works to TruCredential Migration Guide 13

 Field Tab Property

Static Graphic Special Effects/ Transparent color: display selected color as 

Advanced transparent

Sizing/Advanced Original graphic size: original graphic dpi

Signature General Write to log

Capture Options No capture

Signature from file: This is available via a 
different mechanism in TruCredential.

Card Design
Properties of ID Works software card designs that are not supported in TruCredential 
software.

Property Description Details

General Disable direct movement 
or sizing for this card 
design

Background Display Tile Note: this migrates as “Center” in TruCredential 

software.

Stretch Note: this migrates as “Center” in 
TruCredential software.

Print Options Color Print black using YMC panels

Grayscale: This is  Use K‐panel if available
available via a different 
mechanism in 
TruCredential.

14 Differences Between ID Works Software and TruCredential Software

 Property Description Details

Lamination Laminator 1 Do not print card if laminator is unavailable

Laminator 2 Do not use this laminator

Use to laminate the front of the card

Use to laminate the back of the card

Use to laminate both sides of card

Use to laminate the front of the card twice

Do not print card if laminator is unavailable

Card Field Properties

Card field properties of ID Works software that are not supported in TruCredential 
software.

Property Tab Description Details

Photo Printing Color Print black using YMC 

Note: Inner properties of  panels
Color and Grayscale are 
not supported. Grayscale Use YMC panels

Use K‐panel 
(dithered)

Use topcoat panel 
(dithered)

The ID Works to TruCredential Migration Guide 15

 Property Tab Description Details

Bar Code Advance Bar code type HIBC

Note: To print the bar 
code with the black (K)  Interleaved 2 of 5
panel, you may need to 
change the TruCredential  MSI Plessey
software layer that the 
bar code field is placed on 
PostNet ZIP + 4
using the credential 
UCC 128
designer.

Checksum Mod 43
Note: TruCredential 
software may support  Mod 10Lib
these three checksums 
using different names for  Mod 10Lun
them.

Magnetic Stripe Encoding Device Datacard ImageCard 

Select/IV Magnetic 
Stripe Plug‐in

Datacard 275/280P/
295 Magnetic Stripe 
Plug‐in

Datacard 150i 
Magnetic Stripe Plug‐
in

Datacard Smart 
Driver Magnetic 
Stripe Plug‐in

Module: Preset/Track  Use driver settings
Type
AAMVA

Triple binary

Triple IATA

Module: Coercivity Use driver settings

Smart Card Encoding Device Smart Card 

Application Manager

Contactless Chip

16 Differences Between ID Works Software and TruCredential Software

 Property Tab Description Details

Variable Graphic Printing Color Print black using YMC 

Note: The “Variable  Note: Inner  panels
Graphic” feature is  properties of Color 
implemented differently  and Grayscale are not  Grayscale Use YMC panels
in TruCredential software  supported.
than in ID Works  Use K‐panel 
software. (dithered)

Use topcoat panel 
(dithered)

Static Graphic Sizing/Advanced Original Graphic Size Original graphic dpi

Special effects/ Transparent color Display selected color 

Advanced Section as transparent

Printing Color Print black using YMC 

Note: Inner  panels
properties of Color 
and Grayscale are not  Grayscale Use YMC panels
supported.
Use K‐panel 
(dithered)

Use topcoat panel 
(dithered)

The ID Works to TruCredential Migration Guide 17

18 Differences Between ID Works Software and TruCredential Software