Chapter 2
Preparing and Selecting Source Data
2-3
Maximum Length Values for Fields
Many Agile PLM fields have a maximum length. If a value exceeds the maximum length for a field, it is invalid and 
cannot be imported. The Import wizard has a preference that lets you handle values that fail length validation. You 
can choose to either reject such values or truncate them so they can be imported. For more information, see “Setting 
Parsing and Validation Options” on page8-1.
All text fields have a maximum length. Some text fields are restricted to just a few characters. Others, such as the 
Parts 
Class > BOM > BOM Notes
field can be much longer.
Date fields do not have a maximum length, but all date values must be a date format supported by the Agile PLM 
system. For more information, see “Supported Formats for Date Values” on page2-3.
Parent and Child Fields
Several read-only fields have a child relationship with other parent fields. Child fields derive their values from parent 
fields. Examples of child fields include BOM table attributes like “BOM.Item List02” and “BOM.Item Text01,” 
whose parent fields are located on Page Two.
It’s important for the Agile PLM administrator to ensure that all child fields are configured identically to their parent 
fields. Otherwise, problems could occur when you import data.
Supported Formats for Date Values
The Import wizard supports a variety of date formats based on several different criteria, including user preferences 
and locale.
Note
The upper limit for dates is today’s date + 150 years. Date values later than that are invalid and cannot be 
imported.
Setting the Preferred Date Format and Time Zone
Each Agile user can select a preferred date format.
To change date format preferences for your Agile account:
1
Use one of the Agile clients to set user preferences:
• In the Agile Web Client, click 
Settings > User Profile > Preferences > Edit
.
• In the Agile Java Client, click 
Settings > Current User > Preferences
.
2
Select the desired date format in the 
Preferred Date Format
field.
3
Select a GMT time zone in the 
Time Zone
field.
4
Click 
Save
.
Supported Date Formats
The Import wizard supports all combinations of date and time formats available in the 
java.text.DateFormat
class as well as additional formats. 
DateFormat
provides many date and time formatting styles based on locale. The 
following table shows date formats available for the U.S. locale, evaluated in order:
Table 2-3: Date formats for the U.S. locale
Date Format
Example
MMM-dd-yyyy HH:mm:ss
Jul-10-2001 14:08:35
MMM-dd-yyyy HH:mm
Jul-10-2001 14:08
MMM-dd-yyyy hh:mm:ss a
Jul-10-2001 02:08:35 PM
Best pdf to jpg converter online - Convert PDF to JPEG images in C#.net, ASP.NET MVC, WinForms, WPF project
How to convert PDF to JPEG using C#.NET PDF to JPEG conversion / converter library control SDK
convert pdf into jpg; convert pdf page to jpg
Best pdf to jpg converter online - VB.NET PDF Convert to Jpeg SDK: Convert PDF to JPEG images in vb.net, ASP.NET MVC, WinForms, WPF project
Online Tutorial for PDF to JPEG (JPG) Conversion in VB.NET Image Application
convert pdf into jpg online; convert pdf to gif or jpg
Agile PLM 9.2.1
2-4
Import and Export Guide
Each date format is specified using a time pattern string where
y
= year
M
= month in year
d
= day in month
H
= hour in military time (24-hour clock) 
h
= hour in AM/PM (1~12)
m
= minute in hour
s
= second in minute
E
= day in week
a
= AM/PM marker
z
= time zone
'
= escape for text
''
= single quote
The count of each letter such as “M” in the time pattern determines the format. For example, three “M” characters 
indicate that the month is represented as text instead of a number; less than three “M” characters means that the 
month is represented by a number.
For more information about Java date formats and time pattern syntax, see Sun’s documentation for the 
SimpleDateFormat
and 
DateFormat
classes:
http://www.javasoft.com/j2se/1.3/docs/api/index.html
MMM-dd-yyyy hh:mm a
Jul-10-2001 02:08 PM
MMM-dd-yyyy
Jul-10-2001
dd-MMM-yyyy HH:mm:ss
10-Jul-2001 14:08:35
dd-MMM-yyyy HH:mm
10-Jul-2001 14:08
dd-MMM-yyyy hh:mm:ss a
10-Jul-2001 02:08:35 PM
dd-MMM-yyyy hh:mm a
10-Jul-2001 02:08 PM
dd-MMM-yyyy
10-Jul-2001
EEEE, MMMM d, yyyy
Thursday, June 25, 1998
EEEE, MMMM d, yyyy h:mm a
Thursday, June 25, 1998 1:32 PM
EEEE, MMMM d, yyyy h:mm:ss a
Thursday, June 25, 1998 1:32:19 PM
EEEE, MMMM d, yyyy h:mm:ss a z z Thursday, June 25, 1998 1:32:19 PM GMT-05:00
MMMM d, yyyy
June 25, 1998
MMMM d, yyyy h:mm a
June 25, 1998 1:32 PM
MMMM d, yyyy h:mm:ss a
June 25, 1998 1:32:19 PM
MMMM d, yyyy h:mm:ss a z
June 25, 1998 1:32:19 PM GMT-05:00
MMM d, yyyy
Jun 25, 1998
MMM d, yyyy h:mm a
Jun 25, 1998 1:32 PM
MMM d, yyyy h:mm:ss a
Jun 25, 1998 1:32:19 PM
MMM d, yyyy h:mm:ss a z
Jun 25, 1998 1:32:19 PM GMT-05:00
M/d/yy
6/25/98
M/d/yy h:mm a
6/25/98 1:32 PM
M/d/yy h:mm:ss a
6/25/98 1:32:19 PM
M/d/yy h:mm:ss a z
6/25/98 1:32:19 PM GMT-05:00
Table 2-3: Date formats for the U.S. locale (continued)
Date Format
Example
Online Convert PDF to Jpeg images. Best free online PDF JPEG
Online PDF to JPEG Converter. Download Free Trial. Convert a PDF File to JPG. Drag and drop your PDF in the box above and we'll convert the files for you.
convert multi page pdf to single jpg; convert pdf to jpeg on
Online Convert Jpeg to PDF file. Best free online export Jpg image
Online JPEG to PDF Converter. Download Free Trial. Convert a JPG to PDF. You can drag and drop your JPG file in the box, and then start
convert pdf image to jpg online; convert pdf into jpg format
Chapter 2
Preparing and Selecting Source Data
2-5
Specifying Time Zones
Date values can specify a GMT time zone. If a date value omits the time zone, the user's time zone preference is used. 
Time zones must be entered in the following format:
GMT Sign hh:mm 
where:
GMT
= Greenwich Mean Time
Sign
= + or -
h
= hour in AM/PM (1~12)
m
= minute in hour
For example, “GMT-05:00” and “GMT+02:00” are valid time zones.
Note
Do not use three-character codes (such as PST or PDT) to specify time zones. Three-character time zone 
codes are unreliable because some are used for multiple time zones. Consequently, the Agile PLM server 
might resolve a three-character time zone code to an incorrect time zone.
aXML and PDX Package Date Formats
For aXML and PDX packages, the Import wizard supports a relaxed version of the ISO String date format: 
yyyy/MM/ddTHH:mm:ssZ. The T and Z characters are optional.
Importing Currency Values
Price Line and Supplier objects allow you to import values to currencyfields. Currency values can be imported if 
they are entered as a three-letter ISO 4217 currency code or the full currency name. For example, “USD” and “U.S. 
Dollar” are both valid currency values that can be imported. “U.S. Dollar (USD)”  cannot be imported.
Agile supports many different currencies. The list of available currencies is determined when the Agile PLM system 
is installed. For more information about ISO 4217 currency codes, see the following Web site:
http://www.iso.org/iso/en/prods-services/popstds/currencycodeslist.html
The following table lists Agile currency codes:
Table 2-4: Currency codes
Currency Display Name
Code
Andorran Peseta (ADP)
ADP
UAE Dirham (AED)
AED
Afghani (AFA)
AFA
Lek (ALL)
ALL
Armenian Dram
AMD
Netherlands Antillean Guilder (ANG)
ANG
New Kwanza (AON)
AON
Kwanza Reajustado (AOR)
AOR
Argentine Peso (ARP)
ARP
Shilling (ATS)
ATS
Australian Dollar (AUD)
AUD
Florin (AWF)
AWF
Aruban Guilder (AWG)
AWG
Azerbaijanian Manat (AZM)
AZM
Convertible Mark (BAK)
BAK
Barbados Dollar (BBD)
BBD
Taka (BDT)
BDT
Belgian Franc (BEF)
BEF
Lev (BGL)
BGL
Bahraini Dinar (BHD)
BHD
Burundi Franc (BIF)
BIF
Bermudian Dollar (BMD)
BMD
Brunei Dollar (BND)
BND
Boliviano (BOB)
BOB
Brazilian Real (BRL)
BRL
Bahamian Dollar (BSD)
BSD
Rupee (BTR)
BTR
Pula (BWP)
BWP
Belarussian Ruble (BYR)
BYR
Belize Dollar (BZD)
BZD
Canadian Dollar (CAD)
CAD
Congolese Franc (CDF)
CDF
Swiss Franc (CHF)
CHF
Chilean Peso (CLP)
CLP
Yuan Renminbi (CNY)
CNY
Table 2-4: Currency codes (continued)
Currency Display Name
Code
C# WPF PDF Viewer SDK to convert and export PDF document to other
Best PDF Viewer control as well as a powerful .NET WinForms application to image file formats with high quality, support converting PDF to PNG, JPG, BMP and
conversion pdf to jpg; best program to convert pdf to jpg
C# PDF Convert to Images SDK: Convert PDF to png, gif images in C#
Best PDF converter SDK for Visual Studio .NET for converting PDF to image in C#.NET Support exporting PDF to multiple image forms, including Jpg, Png, Bmp
convert pdf to jpg c#; batch pdf to jpg
Agile PLM 9.2.1
2-6
Import and Export Guide
Columbian Peso (COP)
COP
Costa Rican Colon (CRC)
CRC
Cuban Peso (CUP)
CUP
Cape Verde Escudo (CVE)
CVE
Cyprus Pound (CYP)
CYP
Czeck Koruna (CZK)
CZK
Deutsche Mark (DEM)
DEM
Djibouti Franc (DJF)
DJF
Danish Krone (DKK)
DKK
Dominican Peso (DOP)
DOP
Algerian Dinar (DZD)
DZD
Sucre (ECS)
ECS
Kroon (EEK)
EEK
Egyptian Pound (EGP)
EGP
Nakfa (ERN)
ERN
Spanish Peseta (ESP)
ESP
Ethiopian Birr (ETB)
ETB
Euro (EUR)
EUR
Markka (FIM)
FIM
Fiji Dollar (FJD)
FJD
Falkland Islands Pound (FKP)
FKP
French Franc (FRF)
FRF
Pound Sterling (GBP)
GBP
Lari (GEL)
GEL
Cedi (GHC)
GHC
Gibraltar Pound (GIP)
GIP
Dalasi (GMD)
GMD
Guinea Franc (GNF)
GNF
Drachma (GRD)
GRD
Quetzal (GTQ)
GTQ
Guyana Dollar (GYD)
GYD
Hong Kong Dollar (HKD)
HKD
Lempira (HNL)
HNL
Kuna (HRK)
HRK
Gourde (GTG)
HTG
Forint (HUF)
HUF
Rupiah (IDR)
IDR
Irish Pound (IEP)
IEP
Shekel (ILS)
ILS
Indian Rupee (INR)
INR
Iraqui Dinar (IQD)
IQD
Iranian Rial (IRR)
IRR
Iceland Krona (ISK)
ISK
Lira (ITL)
ITL
Jamaican Dollar (JMD)
JMD
Jordanian Dinar (JOD)
JOD
Japanese Yen (JPY)
JPY
Kenyan Shilling (KES)
KES
Som (KGS)
KGS
Riel (KHR)
KHR
Comoro Franc (KMF)
KMF
Noth Korean Won (KPW)
KPW
Table 2-4: Currency codes (continued)
Currency Display Name
Code
Korean Won (KRW)
KRW
Kuwaiti Dinar (KWD)
KWD
Cayman Islands Dollar (KYD)
KYD
Tenge (KZT)
KZT
Kip (LAK)
LAK
Lebanese Pound (LBP)
LBP
Sri Lanka Rupee (LKR)
LKR
Liberian Dollar (LRD)
LRD
Loti (LSL)
LSL
Lithuanian Litas (LTL)
LTL
Luxembourg Franc (LUF)
LUF
Latvian Lats (LVL)
LVL
Libyan Dinar (LYD)
LYD
Moroccan Dirham (MAD)
MAD
Moldovan Leu (MDL)
MDL
Malagasy Franc (MGF)
MGF
Denar (MKD)
MKD
Kyat (MMK)
MMK
Tugrik (MNT)
MNT
Pataka (MOP)
MOP
Ouguiya (MRO)
MRO
Maltese Lira (MTL)
MTL
Mauritius Rupee (MUR)
MUR
Rufiyaa (MVR)
MVR
Kwacha (MWK)
MWK
Mexican Nuevo Peso (MXP)
MXP
Malaysian Ringgit (MYR)
MYR
Metical (MZM)
MZM
Namibia Dollar (NAD)
NAD
Naira (NGN)
NGN
Cordoba Ora (NIO)
NIO
Netherlands Guilder (NLG)
NLG
Norwegian Krone (NOK)
NOK
Nepalese Rupee (NPR)
NPR
New Zealand Dollar (NZD)
NZD
Omani Riyal (OMR)
OMR
Balboa (PAB)
PAB
Nuevo Sol (PEN)
PEN
Kina (PGK)
PGK
Philippine Peso (PHP)
PHP
Pakistan Rupee (PKR)
PKR
Zloty (PLZ)
PLZ
Portuguese Escudo (PTE)
PTE
Guarani (PYG)
PYG
Qatari Riyal (QAR)
QAR
Leu (ROL)
ROL
Russian Ruble (RUR)
RUR
Rwanda Franc (RWF)
RWF
Saudi Riyal (SAR)
SAR
Solomon Islands Dollar (SBD)
SBD
Seychelles Rupee (SCR)
SCR
Sudanese Dinar (SDD)
SDD
Table 2-4: Currency codes (continued)
Currency Display Name
Code
VB.NET PDF - Convert PDF with VB.NET WPF PDF Viewer
Best WPF PDF Viewer control as well as a powerful PDF converter. PDF to image file formats with high quality, support converting PDF to PNG, JPG, BMP and GIF.
convert multiple page pdf to jpg; best way to convert pdf to jpg
VB.NET Create PDF from images Library to convert Jpeg, png images
Best and professional image to PDF converter SDK for Visual Studio .NET. Support create PDF from multiple image formats in VB.NET, including Jpg, Png, Bmp
convert pdf to jpg file; change pdf file to jpg
Chapter 2
Preparing and Selecting Source Data
2-7
Importing Money Values
The money datatype is a compound datatype that includes a numeric value and a currency code, such as “USD” for 
U.S. Dollars. When you import values for money fields, only numeric values are imported. The Import wizard 
assigns the user’s preferred currency to all imported money values.
If the source file is a delimited text file or an Excel file, money values should not include a currency code; the Import 
wizard will reject non-numeric money values. If the source file is an aXML file or a PDX package, the Import wizard 
ignores currency codes included with money values and substitutes the user’s preferred currency instead.
To change your preferred currency:
• In the Agile Web Client, click 
Settings > User Profile > Preferences > Edit
.
• In the Agile Java Client, click 
Settings > Current User > Preferences
.
Swedish Krona (SEK)
SEK
Singapore Dollar (SGD)
SGD
St. Helena Pound (SHP)
SHP
Tolar (SIT)
SIT
Slovak Koruna (SKK)
SKK
Leone (SLL)
SLL
Somali Shilling (SOS)
SOS
Surinam Guilder (SRG)
SRG
Dobra (STD)
STD
El Salvador Colon (SVC)
SVC
Syrian Pound (SYP)
SYP
Lilangeni (SZL)
SZL
Baht (THB)
THB
Tajik Ruble (TJR)
TJR
Manat (TMM)
TMM
Tunisian Dinar (TND)
TND
Pa\’anga (TOP)
TOP
Turkish Lira (TRL)
TRL
Trinidad and Tobago Dollar (TTD)
TTD
New Taiwan Dollar (TWD)
TWD
Tanzanian Shilling (TZS)
TZS
Uganda Shilling (UGX)
UGX
U.S. Dollar (USD)
USD
Peso Uruguayo (UYU)
UYU
Uzbekistan Som (UZS)
UZS
Bolivar (VEB)
VEB
Dong (VND)
VND
Vatu (VUV)
VUV
Tala (WST)
WST
CFA Franc BEAC (XAF)
XAF
East Carribean Dollar (XCD)
XCD
CFP Franc (XPF)
XPF
Yemeni Rial (YER)
YER
New Dinar (YUN)
YUN
Rand (ZAR)
ZAR
Kwacha (ZMK)
ZMK
Zimbabwe Dollar (ZWD)
ZWD
Table 2-4: Currency codes (continued)
Currency Display Name
Code
C# Create PDF from images Library to convert Jpeg, png images to
Best and professional C# image to PDF converter SDK for Visual Studio .NET. Batch convert PDF documents from multiple image formats, including Jpg, Png, Bmp, Gif
changing pdf to jpg file; convert pdf file to jpg on
VB.NET PDF Convert to Images SDK: Convert PDF to png, gif images
Best adobe PDF to image converter SDK for Visual Studio .NET. Convert PDF documents to multiple image formats, including Jpg, Png, Bmp, Gif, Tiff, Bitmap
.pdf to jpg; .pdf to .jpg online
Agile PLM 9.2.1
2-8
Import and Export Guide
Importing Mass Values
Several Product Governance & Compliance objects, including items, have Mass fields. Mass fields have both a 
numeric value and a unit of measure, for example, grams, kilograms, ounces, or pounds. The Import wizard allows 
you to import both the numeric portion of a Mass value and the unit portion. When you import Mass values, make 
sure you map both the 
Mass
and 
Mass-measure
fields.
Note
The default standard unit for Mass fields is Gram, although your Agile PLM administrator can choose 
a different standard unit.
Importing Geographical Locations
Customer, Supplier, and Manufacturer objects all have country and region fields. You must specify valid country 
and region names in your source data. Otherwise, the values won’t be imported.
To see valid country names and region names in the Agile Java Client:
1
Click the Admin tab.
2
Choose 
Data & Workflow Settings > Product Cost Management > Ship-To Location
.
3
Click the 
New
button.
4
Click the 
Continent
list, and select a continent.
5
Click the 
Country
list, and select a country.
6
Click the 
Province/Region/State
list, and select a region.
Importing Values to Dynamic Lists
The Import wizard supports importing values to list fields that use dynamic lists. Dynamic lists contain a selection 
of values that are updated at run time based on data that has been added to the system. The Items, Changes, Users, 
and Suppliers lists are examples of dynamic lists. Because dynamic lists can contain thousands of value objects, you 
can’t enumerate values for them.
The Import wizard can’t validate whether a dynamic list requires upper-case or lower-case values before sending the 
data to the server. Consequently, any list values that are the wrong case are rejected.
Note
Prior to Agile 9.0 SP3, the Suppliers list was a static, enumerable list. Now it’s a dynamic list. Although Web 
Client displays the Supplier field in the form supplierName - supplierNumber, you can import data to that 
field using either the supplier number or the composite form, supplierName - supplierNumber.
Importing Cascading Lists
An Agile PLM list field can be configured to be a cascading list. A cascading list presents its values in multiple 
hierarchical levels, letting you drill down to a specific value in the hierarchy.
To import values into a cascading list field, make sure you use the correct delimiter character to separate each level. 
The Cascade Delimiter Character preference specifies the character used to delimit cascading list values. For 
information about setting the Cascade Delimiter Character preference, see “Setting Parsing and Validation Options” 
on page8-1. The default setting for the Cascade Delimiter Character preference is vertical bar (|).
The following example shows source data that includes cascading list values for a Page Two field called Regional 
Contact, which has three levels.
Part Number
Regional Contact
P10011
Central|Chicago|Jeff Whaley
P10012
Western|Los Angeles|Jason Wong
P10013
Southern|Atlanta|Hsing-Hua Zhang
P10014
Northern|Boston|Leslie Ickes
Chapter 2
Preparing and Selecting Source Data
2-9
Using BOM Reference Designators
Reference designators are commonly used in the electronics industry as a labeling system to refer to components. If 
your company uses reference designators, you can use the 
BOM > Ref Des
field to assign and edit reference designators.
You can specify reference designators in several ways:
Delimited using comma (,), semicolon (;), or vertical bar (|). By default, the Import wizard uses a comma for the 
reference designator delimiter. To change the delimiter, see “Setting Business Rule Options” on page8-2.
Individually (
R1,R2,R3
) or compressed, using the specified range character (
R1-3
or 
R1-R3
). By default, the 
Import wizard uses a hyphen for the reference designator range character. To change the range character, see 
“Setting Business Rule Options” on page8-2.
Uppercase, lowercase, or mixed case (they will be converted to whatever format is specified by the Agile PLM 
administrator).
Using continuation rows if there are too many reference designators to fit in one cell. All other cells must be left 
empty in these rows.
If you have few reference designators, you can enter them one by one (for example, 
R1,R2,R3
). 
To add groups of reference designators that begin with different letters, separate each group with a parse character, 
usually a comma. For example, to enter the 10 designators A1, A2, A3, B4, B5, B6, B7, C8, C9 and C10 you would 
type:
A1-3,B4-7,C8-10
Depending on how your Agile database has been configured, the Agile Web Client may automatically contract ranges 
of reference designators. If you enter 
1,2,3,4,5
, when you press Tab
,
the Ref Des field shows 1-5.
If your Agile database has been configured to expand reference designators, then reference designators connected by 
hyphens (or another specified range character) are expanded when they are imported into the Agile database. For 
example, 
R1-5
becomes 
R1,R2,R3,R4,R5
.
Reference designators that end in a letter (for example, 
R1a,R2a,R3a
) must be entered individually. For more 
information about how Agile Import handles reference designator ranges, see “Reference Designator Ranges” on 
page2-9.
Reference Designator Ranges
The following rules determine how ranges of reference designators are treated by the Import wizard. If a reference 
designator does not qualify for expansion, the Import wizard treats the range as one reference designator.
The two reference designators in a range statement must end in a numeric character to qualify for expansion. If 
the last value in a reference designator string is a text character, it does not qualify for expansion.
Examples:
A202-A210 qualifies for expansion.
A202-A210a does not qualify for expansion.
A202a-A210a does not qualify for expansion.
If two reference designators in a range statement have prefixes, they must have the same prefix to qualify for 
expansion. Prefixes must be in 
<
CHAR
>
format.
Agile PLM 9.2.1
2-10
Import and Export Guide
Examples:
RB202-RB210 qualifies for expansion.
RB202-RC210 does not qualify for expansion.
If only the first reference designator in a range statement has a prefix, then the range qualifies for expansion.
Example:
RB202-210 qualifies for expansion.
If neither reference designator in a range statement has a prefix, then the range qualifies for expansion.
Example:
202-210 qualifies for expansion.
Using Leading Zeros in Reference Designator Ranges
If your Agile database has been configured to remove leading zeros in the numeric portion of reference designators, 
you should avoid using leading zeros in reference designator ranges in your import file. For example, the Import 
wizard may parse R0203-R0225 as R203-R225, removing the leading zeros.
In the Agile Java Client, you can click the Admin tab and choose 
Server Settings > Preferences > Reference Designators Allow 
Range Expand Collapse
to see whether reference designators can be expanded and collapsed on your Agile PLM system. 
If this preference is set to 
No
, all reference designator range behavior is turned off. This prevents leading zeros from 
being removed from reference designators, but it also causes each reference designator range, such as R0203-R0225, 
to be treated as one reference designator. In this case, to enter reference designators with leading zeros, you must 
enter them individually and not as ranges.
Note
For information about how to change the Reference Designators Allow Range Expand Collapse preference 
setting in the Agile Java Client, contact Agile Technical Support.
Importing Reference Designators from aXML and PDX Packages
To ensure that reference designator fields in aXML and PDX packages are parsed correctly when they are imported, 
follow these guidelines:
Use a comma to separate multiple reference designators (R1,R2,R3).
Use a hyphen to indicate a range of reference designators (R1–R3).
Guidelines for Excel Files and Delimited Text Files
After the Import wizard parses an Excel file, the data that it sends to the server is no different from data that 
originated from a delimited text file. Therefore, the structural guidelines that you must follow to successfully import 
data to the Agile PLM system are the same for both Excel files and delimited text files. 
Make sure Excel files and delimited text files conform to the following structural guidelines before importing them:
Although an Excel workbook can contain multiple sheets, you can import data from only one sheet at a time. 
Therefore, set up Excel sheets appropriately.
Numeric values in Excel files are converted to either integers or decimals before being imported. If you want an 
integer to be treated as a decimal, enter the value as text by preceding it with a single quotation mark. For 
example, to import the number 1.0 instead of 1, type 
’1.0
in the Excel cell.
Chapter 2
Preparing and Selecting Source Data
2-11
Formulas in Excel files must calculate to a numeric value. Otherwise, the Import wizard imports the formula 
string. If your Excel file has formulas that calculate to nonnumeric values, you can save the file to a .CSV file to 
ensure that the formula values will be imported correctly.
Column headers cannot be blank. For example, in a comma-separated file the following header row would be 
invalid due to the blank header between Number and Description:
Number,,Description,Product Lines,Category
The first row of import data, which is not necessarily the first row in an Excel file, must be the “header” row, 
which contains field names. When you select the source file, you can click 
Configure
to set the location of the 
header row.
Field names in the header row must be unique. Duplicate field names are not allowed.
Fields in the header row must not contain carriage returns or linefeed characters. If they do, the Import wizard 
will not parse the file correctly. For more information, see “Removing Carriage Returns and Linefeed Characters” 
on page12.
The header row cannot end with a delimiter character, such as a comma.
Rows that follow the header row must contain data. There should not be empty rows between rows of data.
Any rows of data that you do not want imported into the Agile database must be removed.
All fields that are required for the particular object type you are importing should contain data.
Fields must use the same delimiter character. For example, for a comma-separated values file, each field should 
be separated by a comma.
Your import data must conform to the maximum lengths specified for each Agile field by the Agile PLM 
administrator. Otherwise, the Import wizard’s 
Length Validation
preference will either reject or truncate the value.
An entry for a MultiList field (for example, the Product Line(s) field on the Title Block tab) must delimit separate 
list values. The default MultiList delimiter is a comma; you can also choose to use a vertical bar (|) or semicolon 
(;). For more information, see “Setting Parsing and Validation Options” on page8-1.
Here’s an example of a comma-delimited list of values for a MultiList field:
Scorpio,Taurus,Capricorn
Money fields must contain numeric values. They should not include currency codes. The user’s default currency 
is assigned to all imported money values.
For BOMs, parent item rows must be grouped contiguously. That is, all BOM components for a parent item 
should appear in one group of rows.
For BOMs, the maximum length of individual reference designators is 19 characters.
For BOMs, reference designators can continue on subsequent rows. On each reference designator continuation 
row, the only field with data should be the reference designator field. Other fields should be blank.
For BOMs, the value in the Quantity field should equal the number of reference designators. Otherwise, the 
Import wizard may display a warning message when you import the data.
For delimited text files, enclose text values within text qualifier characters (for example, quotation marks). 
Qualifying a text field allows the field’s delimiting character, such as a comma, to be used within the field’s text. 
In the following example, 
21" Monitor, Tilt Pedestal
is the item’s description, which has both a comma 
(the field delimiter) and a quotation mark within the text:
Number,Description,Rev,BOM Component Number,QPA
170-50,"21"" Monitor, Tilt Pedestal",A,172-92,1
Agile PLM 9.2.1
2-12
Import and Export Guide
Removing Carriage Returns and Linefeed Characters
To avoid file parsing errors when importing Excel files or delimited text files, make sure the header fields do not 
contain carriage returns or linefeed characters. Such characters may be hard to spot in a delimited text file, but you 
can easily find them and remove them in Excel.
To find and remove carriage returns or linefeed characters from header fields in Excel:
1
Click the 
Select All
button, the gray rectangle in the upper left corner of the worksheet where the row and column 
headings meet.
2
Choose 
Format > Row > AutoFit
.
Any header fields that have carriage returns or linefeed characters will have more than one line of text. In the 
following figure, fields A1 and C1 both have carriage returns.
Figure 2-1: Header row with carriage returns in A1 and C1
3
Delete any extra carriage returns or linefeed characters in the header.
4
Save the file.
Sorting BOM Components
Before importing a BOM from an Excel file or a delimited text file, make sure all BOM components for a parent item 
are grouped together in contiguous rows. If BOM components for a parent item are listed on noncontiguous rows, 
the Import wizard imports only the last group of BOM components for that parent item.
For example, the following BOM data is incorrect because the rows 4 and 5 are out of order.
Figure 2-1: BOM data with noncontiguous parent items
Here is the BOM data after it has been correctly sorted. BOM components for P001 are now grouped together.
Figure 2-2: BOM data with contiguous parent items
To sort the BOM, open the source file in Microsoft Excel and sort the rows in ascending order by the 
Parent Item 
Number
column.
Note
BOMs in aXML and PDX packages are automatically sorted appropriately.
An XML file declares its encoding within the file. Therefore, you don’t need to specify file encoding when 
you import data from aXML or PDX packages.
Documents you may be interested
Documents you may be interested