Chapter 6
Mapping Import Fields to Agile Fields
6-3
Manufacturer Part
Attachments
File Identifier
File Name
Compliance
Specification
Composition
Composition Type
2
General Info
Manufacturer Name
Manufacturer Part Number
Substance
Substance Name
Suppliers
Supplier
Part Group
Attachments
File Identifier
File Name
Compliance
Specification
General Info
Name
Parts
Part Number
Suppliers
Supplier
Product Service Request
Cover Page
Number
1
Affected Items
Item Number
Project Item
AML
Mfr Name
Mfr. Part Number
Attachments
File Identifier
File Name
BOM
Component Part Number
Items
Number
Published Price
Attachments
File Identifier
File Name
General Information
Customer
Item Number
Item Rev
Manufacturing Site
Mfr. Name
Mfr. Part Number
Number
1
Price Type
Program
Supplier
Price Lines
Price Effective From Date
Price Effective To Date
Qty
Ship From
Ship To
Table 6-1: Agile PLM key fields (continued)
Object
Tab
Key Fields
Batch 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
change pdf to jpg file; change pdf to jpg online
Batch 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 pages to jpg; convert pdf pictures to jpg
Agile PLM 9.2.1
6-4
Import and Export Guide
Notes:
1 If you don’t map the Number field or the data is not provided in the source file, the Import wizard uses an 
AutoNumber source to assign a number to a new object it creates. You can set the default AutoNumber 
sources used by the Import wizard. For more information, see “Setting Default AutoNumber Sources” on 
page8-4.
2 Composition Type determines what type of substances can be imported into the composition:
• Substance Composition – Substances and substance groups can be imported.
• Homogeneous Materials Composition – Subparts, materials, substance groups, and substances can be 
imported.
• Part Composition – No substances can be imported.
Quote History
General Information
Customer
Item Number
Item Rev
Manufacturing Site
Mfr. Name
Mfr. Part Number
Number
1
Price Type
Program
Supplier
Price Lines
Price Effective From Date
Price Effective To Date
Qty
Ship From
Ship To
Specification
Attachments
File Identifier
File Name
General Info
Name
Substances
Name
Substance
Attachments
File Identifier
File Name
Composition
Name
General Info
Name
Supplier
Commodities
Commodity
Continent
Ship-To
General Info
Name
Number
1
Manufacturers
Continent
Mfr. Name
Ship-To
Table 6-1: Agile PLM key fields (continued)
Object
Tab
Key Fields
JPEG to PDF Converter | Convert JPEG to PDF, Convert PDF to JPEG
software; Support a batch conversion of JPG to PDF with amazingly high speed; Get a compressed PDF file after conversion; Support
convert pdf into jpg; bulk pdf to jpg
JPG to GIF Converter | Convert JPEG to GIF, Convert GIF to JPG
Features and Benefits. High speed JPEG to GIF Converter, faster than other JPG Converters; file name when you convert the files in batch; Storing conversion
change pdf to jpg format; reader pdf to jpeg
Chapter 6
Mapping Import Fields to Agile Fields
6-5
In addition to key fields, Agile PLM also has required fields. The Agile PLM administrator can configure any field on 
Page One (
Title Block
Cover Page
, or 
General Information
), Page Two, or Page Three of an object to be a required field. To 
import new objects in Agile PLM, you must complete all required fields. However, if you are importing data to 
existing objects, required fields don’t need to be mapped. When you map fields for import, all required fields in the 
Edit Mapping File window are shown in green boldface type.
For a full list of required Agile PLM fields, print the Agile Classes Report from the Agile Web Client.
In the following figure, the 
Number
field is a key field and 
Description
and 
Product Line(s)
are required fields. If you are 
importing new parts, all three fields must be mapped. If you are importing data to existing parts, only the 
Number
field must be mapped.
Figure 6-1: Key fields and required fields
Some Agile PLM objects have special mapping requirements. See the following sections for more information.
BOM Mapping Requirements
Title Block > Number
and 
BOM > Item Number
are required fields. However, 
BOM > Find Num
and 
BOM > Qty
are optional key 
fields. If you don’t map the 
BOM > Find Num
field, the BOM tab shows 0 as the find number for all imported items. If 
you don’t map the 
BOM > Qty
field, all quantities on the BOM tab use the default quantity value set by the Agile PLM 
administrator.
Quote History and Published Price Mapping Requirements
Quote histories and published prices have special mapping requirements due to the multiple required and optional 
key fields that can be used to import them. For more information about the minimum required fields for quote 
histories, published prices, and price lines, see “Importing Quote Histories, Published Prices, and Price Lines” on 
page3-5.
Mapping Classes and Subclasses
For item, BOM, and AML imports, there are two separate target classes that may need to be mapped depending on 
what the source file contains. If the source file contains both parts and documents, then you must map both the Parts 
class and Documentation class, even if the mappings are the same.
Key field
Required fields
JPG to DICOM Converter | Convert JPEG to DICOM, Convert DICOM to
Open JPEG to DICOM Converter first; Load JPG images from local folders in "File" in toolbar Windows Explorer; Select "Batch Conversion" & Choose "DICOM" in
convert .pdf to .jpg online; convert multipage pdf to jpg
JPG to JBIG2 Converter | Convert JPEG to JBIG2, Convert JBIG2 to
Open JPEG to JBIG2 Converter first; Load JPG images from local folders in "File" in toolbar Windows Explorer; Select "Batch Conversion" & Choose "JBIG2" in
convert pdf into jpg format; convert pdf to jpeg on
Agile PLM 9.2.1
6-6
Import and Export Guide
If you do not map the 
Type
field for the object, or the 
Type
column of a particular row is blank, then the default type 
for the object is used, regardless of whether the object currently exists or not. For example, if your import file 
contains documents, but you don’t map the 
Type
field, documents could be imported as parts if that is the default 
item type selected in Import preferences. For items in the import file that already exist in the target system, a type 
mismatch rejection error occurs if the default type assumed by import does not match the existing object in the target 
system.
For information about how to specify default types for an import session, see “Setting Default Types” on page8-4.
Selecting a Change Order and Mapping File
When the Select Change Order and Mapping File page appears in the Import wizard, you can specify a change order 
and select a mapping file using the following options:
Change Order 
— If you are importing in Redlining mode (the default), click  to select a change order. If you are 
using Authoring mode, you may optionally specify a change order. For more information about redlining, see 
“Using Redlining or Authoring Mode” on page3-8.
Note
To change from Redlining mode to Authoring mode, click 
Preferences,
select 
Business Rule Options
, and 
change the value for the 
Change Mode
field.
Use an Existing Mapping File
— After selecting this option, type the path of a mapping file or click 
Browse
to select 
one. The mapping file must exist on your local system or on a network computer. Mapping files are not stored 
on the Agile PLM server.
Create a New Mapping
— After selecting this option, click 
Create New Mapping
to define a new mapping file.
Use Currently Defined Mapping Definition
— Use a mapping definition previously selected during this import session. 
If you have not specified a mapping file yet, this option does not appear.
Use Default Mapping Definition
— Use the default field mappings for the specified file type. This option is not available 
for Excel files and delimited text files that do not use a predefined template format.
Edit Chosen Mapping 
— Display the Edit Mapping File window for the selected mapping definition.
Once you select or create a mapping definition, the Import wizard stores it in memory for the current import session. 
After this, you can click 
Import
to begin the import process, or click 
Next
to select other options.
Creating a New Mapping File
If you are importing data from a new source, you need to create a mapping file. To create a mapping file, you select 
fields from the import data and map them to Agile fields.
To create a new mapping file:
1
In the Import wizard, proceed to the Select Change Order and Mapping File page.
2
Select 
Create a New Mapping
, and then click the 
Create New Mapping
button. The Edit Mapping File window appears.
Note
If the Edit Mapping File window has no fields, the source file may be invalid. If the source file is a delimited 
text file, make sure fields in the header row do not have carriage return or linefeed characters.
3
Click a field in the 
Import Fields
list.
Note
Only one field can be selected at a time in the Edit Mapping File window. However, you can map an import 
field to multiple Agile PLM fields.
4
Navigate to the corresponding field in the 
Agile Fields
list. Click the field to map it. An arrow 
appears next to 
the field along with the name of the import field to which it is mapped.
5
Repeat steps 3 and 4 for all fields that you want to map.
6
When you finish mapping all fields, click 
Save As
. The File Download dialog box appears.
JPG to JPEG2000 Converter | Convert JPEG to JPEG2000, Convert
Open JPEG to JPEG2000 Converter first; ad JPG images from local folders in "File" in toolbar Windows Explorer; Select "Batch Conversion" & Choose "JPEG2000" in
convert pdf to jpg c#; convert pdf file to jpg online
JPG to Word Converter | Convert JPEG to Word, Convert Word to JPG
Open JPEG to Word Converter first; Load JPG images from local folders in "File" in toolbar Windows Explorer; Select "Batch Conversion" & Choose "Word" in
batch pdf to jpg converter; change pdf file to jpg
Chapter 6
Mapping Import Fields to Agile Fields
6-7
7
Select 
Save this File to Disk
. Click 
OK
.
8
Type the name of the file, and click 
Save
.
9
Click 
Finished
to close the Edit Mapping File window.
To unmap a field in the Edit Mapping File window:
Click  to the right of the mapped field.
To show all fields in the Edit Mapping File window:
Click 
Expand All
.
Mapping Page Two and Page Three Fields
Only visible Agile fields can be mapped in the Edit Mapping File window. To map source fields to Page Two or Page 
Three fields, the Agile PLM administrator must configure those fields to be visible.
How Fields are Sorted in the Edit Mapping File Window
When you are importing data from a PDX package, the Edit Mapping File window displays import fields sorted in 
alphabetical order within each node in the package. The following figure shows how fields in a PDX package are 
sorted for the Item subclass.
Figure 6-2: Sorted import fields in a PDX package
When you import data from a delimited text file, the Edit Mapping File window does not sort the import fields. 
Instead, it displays the fields in the order in which they appear in the text file, as shown in the following figure.
Figure 6-3: Unsorted import fields in a text file
To make it easier to map fields in a text file, you may want to sort the fields in another application, such as Excel, 
before attempting to import the data.
JPG to PNG Converter | Convert JPEG to PNG, Convert PNG to JPG
Open JPEG to PNG Converter first; Load JPG images from local folders in "File" in toolbar Windows Explorer; Select "Batch Conversion" & Choose "PNG" in "Output
conversion pdf to jpg; pdf to jpeg
VB.NET Image: PDF to Image Converter, Convert Batch PDF Pages to
RasterEdge .NET Imaging PDF Converter makes it non-professional end users to convert PDF and PDF/A documents commonly in daily life (like tiff, jpg, png, bitmap
convert pdf into jpg online; change format from pdf to jpg
Agile PLM 9.2.1
6-8
Import and Export Guide
Agile fields are sorted in alphabetical order by the tab on which the field appears, as shown in the following figure.
Figure 6-4: Sorted Agile fields
Reusing a Mapping File
If you routinely import data from the same source (such as PDX packages originating from the same source system), 
you can maintain mapping files that correctly map source fields to Agile fields.
Mapping files are flexible and are designed to be reused for subsequent import sessions. The import source data 
generally varies from one import session to another. However, it’s possible to reuse the same mapping file for 
multiple source files if the mapping file contains fields common to them. For example, if you create a mapping file 
that contains mappings for all PDX objects, you can reuse that particular mapping file for any PDX file, including a 
file that only includes one type of object, such as Items. If a target field is mapped but doesn’t exist in the import 
source file, the Import wizard ignores the field and doesn’t import it.
Target fields in the Agile PLM system can also change from one import session to another. For example, the Agile 
PLM administrator can make fields invisible that may have been used in your mapping files. When a target field is 
mapped but isn’t visible in the Agile PLM system, the Import wizard ignores the field and doesn’t import it.
If you rename column headings in your import source file, any mapping files that you created for that particular 
source file will be invalid. To successfully import the data, you need to remap all fields that have been renamed. The 
Import wizard ignores any mapped fields that are not found in the source file.
If the Agile PLM administrator renamed classes or attributes used in a mapping file, the Import wizard resolves target 
fields by referencing their internal IDs. Therefore, mapping files that reference renamed fields are still valid. The 
Debug Mapping Window shows a warning message for every field that the Import wizard resolves to a different 
name.
To use an existing mapping file:
1
In the Import wizard, proceed to the Select Change Order and Mapping File page.
2
Select 
Use an Existing Mapping File
.
3
Type the path of the mapping file, or click 
Browse
to select it.
Note
After you select the file, you can confirm the field mappings by clicking 
Edit Chosen Mapping
.
4
Click 
Next
to continue.
Chapter 6
Mapping Import Fields to Agile Fields
6-9
Editing a Mapping File
If an import file has been modified (for example, new columns of data have been added), you need to modify its 
associated mapping file. Otherwise, the mapping file could be invalid for the revised data.
To edit a mapping file:
1
In the Import wizard, proceed to the Select Change Order and Mapping File page.
2
Select 
Use an Existing Mapping File
.
3
Type the path of the mapping file, or click 
Browse
to select it.
Note
Mapping files have an XML filename extension.
4
Click 
Edit Chosen Mapping
. The Edit Mapping File window appears.
When you reuse a mapping file to import a new source file, the Import wizard ensures that the mapping file 
correctly matches the source data. If the mapping file has errors, an Errors/Warnings box appears at the top of 
the window. You can click an error or warning in the box to highlight its related field.
5
Edit the mappings.
6
Click 
Save As
to save the file. The File Download dialog box appears.
7
Select 
Save this File to Disk
. Click 
OK
.
8
Type the name of the file, and click 
Save
.
9
Click 
Finished
to close the Edit Mapping File window.
Mapping PDX and aXML Packages
When you select 
Use Default Mapping Definition
on the Select Change Order and Mapping File page, the Edit Mapping 
File window provides default mappings for core Agile fields. Custom fields are not mapped by default; you have to 
map those fields manually.
Only PDX and aXML elements present in the source file are assigned default mappings. For example, if the file 
contains only items and no other types of import data, then the Edit Mapping File window shows default mappings 
for item fields only. If you save the mapping file to reuse it later, you can use it only to import items.
To create a mapping file with mappings for all types of import data, make sure all objects are selected in the Select 
Contents to Import page of the Import wizard. That way, default mappings are assigned for all objects, regardless if 
all objects are contained in the selected source file.
Agile PLM 9.2.1
6-10
Import and Export Guide
7-1
C
HAPTER
7
Creating Transformation
DefinitionFiles
If your import data originated in another system, you can use a transformation definition file to modify it for 
the target Agile PLM system. This chapter includes these topics:
About Transformation Definition Files
Required Columns and Column Headings
Using PREFIX, SUFFIX, or REPLACE Operations
Using Regular Expressions in the SourcePattern Field
Replacing Blank Fields with a Default Value
Generating a Transformation Template
Transforming Different Types of Data
Reusing Transformation Definition Files
About Transformation Definition Files
Source data that originates from a supplier or partner can contain incompatible data. That is, the data may be invalid 
or inconsistent with your company's Agile PLM system. Before you import data, you may need to transform the 
values in some fields to make them compatible with the target system.
Transformation definition files are especially helpful for importing data from PDX or aXML packages. Generally, 
PDX or aXML packages are read-only. You cannot change the values contained in an archived file. If there are data 
inconsistencies in a PDX or aXML package, you must try to correct them using a transformation definition file.
A transformation definition file is a comma-delimited text file. Optionally, you can qualify text strings in the file 
using double-quotes ("). The file must contain a set of required fields needed to transform import data.
Transformation definition files are optional for the Import wizard. If your source data does not need to be modified 
for your target system, you can skip the Select Transformation Definition File step in the Import wizard.
Every transformation that occurs during an import session is noted in the import log file.
Note
The Import wizard does not support transformation definition files created with previous Agile Product 
Cost Management or Agile Product Collaboration releases.
Agile PLM 9.2.1
7-2
Import and Export Guide
Required Columns and Column Headings
A transformation definition file must have the following six columns:
Note
You can add an optional 
Comments
column to document each row of the file.
Optionally, you can include the following three columns: 
ObjectTypeId
PropertyGroupId
, and 
PropertyId
. These columns 
appear automatically in a transformation template that you can generate from the Import wizard. The columns are 
not required, but they map the 
ObjectTypeName
PropertyGroupName
, and 
PropertyName
columns to unique internal Agile 
ID numbers. The ID columns ensure the validity of the transformation definition file in the event that an Agile field 
name—such as the name of a custom field—changes.
Caution!
You cannot change the column names. They must match the specified names exactly. Otherwise, the 
transformation definition file is invalid.
You can change the order of columns as long as you also change the respective column header. For example, you can 
make column A the 
PropertyName
column.
The header row (that is, the row with column names) must be the first row in the file. There should be no blank 
columns to the left of the first data column. For example, in an Excel file, the table should start at column A.
You can perform only one transformation per target value. This means that you cannot, for example, use a PREFIX 
and SUFFIX transformation on the same value. Nor can you chain transformations together in sequence to modify 
a value iteratively.
Transformations occur in sequential order from top to bottom in the transformation definition file. Only the first 
transformation for a target field’s value is used; other transformations for the same value are ignored.
Using PREFIX, SUFFIX, or REPLACE Operations
Transformation definition files allow you to add a prefix or suffix to values, or replace values.
A PREFIX operation simply adds a specified string to the beginning of a value.
A SUFFIX operation adds a specified string to the end of a value.
Table 7-1: Required transformation definition file columns
Column heading
Description
ObjectTypeName
The class or subclass name on the target system, for example, Parts Class.
PropertyGroupName
The name of the group (or tab) containing the property, for example, Title Block.
PropertyName
The name of a target field.
Operation
The transformation operation. Valid operations are “REPLACE,” “PREFIX,” or “SUFFIX.”
SourcePattern
A string to match the entire source value for the specified field. You can use regular expressions to 
match patterns of text. The pattern you specify is case-sensitive.
ParameterValue
The replacement, prefix, or suffix text used to transform the 
SourcePattern
string.
Operation
SourcePattern
ParameterValue
Result
PREFIX
12345
P-
12345 -> P-12345
PREFIX
1
P-
1 -> P-1
Operation
SourcePattern
ParameterValue
Result
SUFFIX
12345
-S
12345 -> 12345-S
SUFFIX
1
-S
1 -> 1-S
Documents you may be interested
Documents you may be interested