You are on page 1of 22

Mapping Tab (Transformations View) Page 1 sur 22

Mapping Tab (Transformations View)

In the Transformations view of the Mapping tab, you can configure settings for connections, sources,
targets, and transformations.

You can configure the following nodes:

 Connections
 Sources
 Targets
 Transformations

Connections Node

The Connections node displays the source, target, lookup, stored procedure, FTP, external loader,
and queue connections. You can choose connection types and connection values. You can also edit
connection object values.

Figure A-7 displays the Connections settings on the Mapping tab:

Figure A-7. Mapping Tab - Connections Settings

Table A-7 describes the Connections settings on the Mapping tab:

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 2 sur 22

Table A-7. Mapping Tab - Connections Settings


Connections
Node Required/Optional Description
Settings

Enter the connection type for relational and non-relational


sources and targets. Specifies Relational for relational
sources and targets.
You can choose the following connection types for flat file,
XML, and MQSeries sources/Targets:

 Queue. Select this connection type to access a


MQSeries source if you are using MQ Source
Qualifiers. For static MQSeries targets, set the
connection type to FTP or Queue. For dynamic
MQSeries targets, the connection type is set to Queue.
MQSeries connections must be defined in the
Workflow Manager prior to configuring sessions. For
more information, see the PowerCenter Connect for
IBM MQSeries User and Administrator Guide .
 Loader. Select this connection type to use the
External Loader to load output files to Teradata,
Oracle, DB2, or Sybase IQ databases. If you select this
option, select a configured loader connection in the
Value column.
To use this option, you must use a mapping with a
relational target definition and choose File as the
writer type on the Writers tab for the relational target
Type Required instance. As the PowerCenter Server completes the
session, it uses an external loader to load target files to
the Oracle, Sybase IQ, DB2, or Teradata database.
You cannot choose external loader for flat file or XML
target definitions in the mapping.
Note to Oracle 8 users: If you configure a session to
write to an Oracle 8 external loader target table in bulk
mode with NOT NULL constraints on any columns,
the session may write the null character into a NOT
NULL column if the mapping generates a NULL
output.
For details on using the external loader feature, see
External Loading.
 FTP. Select this connection type to use FTP to access
the source/target directory for flat file and XML
sources/targets. If you select this option, select a
configured FTP connection in the Value column. FTP
connections must be defined in the Workflow
Manager prior to configuring sessions. For details on
using FTP, see Using FTP.
 None. Choose None when you want to read from a
local flat file or XML file, or if you are using an
associated source for a MQSeries session.

The type also specifies lists the connections in the mapping,

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 3 sur 22

such as $Source connection value and $Target connection


value.
You can also configure connection information for Lookups
and Stored Procedures.
Partitions N/A Displays the partitions if the session is partitioned.
Enter a source and target connection based on the value you
choose in the Type column. You can also specify the
$Source and $Target connection value:

 $Source connection value. Enter the database


connection you want the PowerCenter Server to use
for the $Source variable. Choose a relational or
application database connection. You can also choose
a $DBConnection parameter. You can use the $Source
variable in Lookup and Stored Procedure
transformations to specify the database location for the
lookup table or stored procedure. If you use $Source in
a mapping, you can specify the database location in
this field to ensure the PowerCenter Server uses the
correct database connection to run the session. If you
use $Source in a mapping, but do not specify a
database connection in this field, the PowerCenter
Server determines which database connection to use
when it runs the session. If it cannot determine the
database connection, it fails the session. For more
information, see the Transformation Guide.
Value Required
 $Target connection value. Enter the database
connection you want the PowerCenter Server to use
for the $Target variable. Choose a relational or
application database connection. You can also choose
a $DBConnection parameter. You can use the $Target
variable in Lookup and Stored Procedure
transformations to specify the database location for the
lookup table or stored procedure. If you use $Target in
a mapping, you can specify the database location in
this field to ensure the PowerCenter Server uses the
correct database connection to run the session. If you
use $Target in a mapping, but do not specify a
database connection in this field, the PowerCenter
Server determines which database connection to use
when it runs the session. If it cannot determine the
database connection, it fails the session. For more
information, see the Transformation Guide.

You can also specify the lookup and stored procedure


location information value, if your mapping has lookups or
stored procedures.

Sources Node

The Sources node lists the sources used in the session and displays their settings. If you want to view
and configure the settings of a specific source, select the source from the list.

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 4 sur 22

You can configure the following settings:

 Readers. The Readers settings displays the reader the PowerCenter Server uses with each
source instance. For more information, see Readers Settings.
 Connections. The Connections settings allows you to configure connections for the sources.
For more information, see Connections Settings.
 Properties. The Properties settings allows you to configure the source properties. For more
information, see Properties Settings.

Readers Settings

You can view the reader the PowerCenter Server uses with each source instance. The Workflow
Manager specifies the necessary reader for each source instance. For relations sources the reader is
Relational Reader and for file sources it is File Reader.

Figure A-8 displays the Readers settings on the Mapping tab (Sources node):

Figure A-8. Mapping Tab - Sources Node - Readers Settings

Connections Settings

You can configure the connections the PowerCenter Server uses with each source instance.

Figure A-9 displays the Connections settings on the Mapping tab (Sources node):

Figure A-9. Mapping Tab - Sources Node - Connections Settings

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 5 sur 22

Table A-8 describes the Connections settings on the Mapping tab (Sources node):

Table A-8. Mapping Tab - Sources Node - Connections Settings


Connections
Required/Optional Description
Settings
Enter the connection type for relational and non-relational
sources. Specifies Relational for relational sources.
You can choose the following connection types for flat file,
XML, and MQSeries sources:

 Queue. Select this connection type to access a


MQSeries source if you are using MQ Source
Qualifiers. MQSeries connections must be defined in
the Workflow Manager prior to configuring sessions.
For more information, see the PowerCenter Connect
for IBM MQSeries User and Administrator Guide .
Type Required  FTP. Select this connection type to use FTP to access
the source directory for flat file and XML sources. If
you want to extract data from a flat file or XML
source using FTP, you must specify an FTP
connection when you configure source options. If you
select this option, select a configured FTP connection
in the Value column. FTP connections must be
defined in the Workflow Manager prior to configuring
sessions. For details on using FTP, see Using FTP.
 None. Choose None when you want to read from a
local flat file or XML file, or if you are using an
associated source for a MQSeries session.
Enter a source connection based on the value you choose in
Value Required
the Type column.

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 6 sur 22

Properties Settings

Click the Properties settings to define source property information. The Workflow Manager displays
properties for both relational and file sources.

Figure A-10 displays the Properties settings on the Mapping tab (Sources node):

Figure A-10. Mapping Tab - Sources Node - Properties Settings

Table A-9 describes Properties settings on the Mapping tab for relational sources:

Table A-9. Mapping Tab - Sources Node - Properties Settings (Relational Sources)
Relational
Source Required/Optional Description
Options
Owner Name Optional Specified the table owner name.
Specifies the condition used to join data from multiple
sources represented in the same Source Qualifier
User Defined
Optional transformation. For more information about user defined
Join
join, see “Source Qualifier Transformation” in the
Transformation Guide.
Specifies the amount of detail included in the session log
when you run a session containing this transformation. You
Tracing
N/A can view the value of this attribute when you click Show all
Level
properties. For more information about tracing level, see
Setting Tracing Levels.
Select
Optional Selects unique rows.
Distinct

Pre-session SQL commands to run against the source

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 7 sur 22

database before the PowerCenter Server reads the source.


Pre SQL Optional For more information about pre-session SQL, see Using Pre-
and Post-Session SQL Commands.
Post-session SQL commands to run against the source
database after the PowerCenter Server writes to the target.
Post SQL Optional
For more information about post-session SQL, see Using
Pre- and Post-Session SQL Commands.
Defines a custom query that replaces the default query the
PowerCenter Server uses to read data from sources
Sql Query Optional represented in this Source Qualifier. A custom query
overrides entries for a custom join or a source filter. For
more information, see Overriding the SQL Query.
Specifies the filter condition the PowerCenter Server applies
Source Filter Optional when querying records. For more information, see “Source
Qualifier Transformation” in the Transformation Guide.

Table A-10 describes the Properties settings on the Mapping tab for file sources:

Table A-10. Mapping Tab - Sources Node - Properties Settings (File Sources)
File Source
Required/Optional Description
Options
Enter the directory name in this field. By default, the
PowerCenter Server looks in the server variable directory,
$PMSourceFileDir, for file sources.
If you specify both the directory and file name in the Source
Source File Filename field, clear this field. The PowerCenter Server
Optional
Directory concatenates this field with the Source Filename field when it
runs the session.
You can also use the $InputFileName session parameter to
specify the file directory.
For details on session parameters, see Session Parameters.
Enter the file name, or file name and path. Optionally use the
$InputFileName session parameter for the file name.
The PowerCenter Server concatenates this field with the
Source File Directory field when it runs the session. For
example, if you have “C:\data\” in the Source File Directory
Source
Required field, then enter “filename.dat” in the Source Filename field.
Filename
When the PowerCenter Server begins the session, it looks for
“C:\data\filename.dat”.
By default, the Workflow Manager enters the file name
configured in the source definition.
For details on session parameters, see Session Parameters.

Allows you to configure multiple file sources using a file list.


Indicates whether the source file contains the source data, or a
Source list of files with the same file properties. Choose Direct if the
Required
Filetype source file contains the source data. Choose Indirect if the
source file contains a list of files.
When you select Indirect, the PowerCenter Server finds the

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 8 sur 22

file list then reads each listed file when it executes the session.
For details on file lists, see Using a File List.
Set File Allows you to configure the file properties. For more
Optional
Properties information, see Setting File Properties for Sources.
Datetime
N/A Displays the datetime format for datetime fields.
Format*
Thousand
N/A Displays the thousand separator for numeric fields.
Separator*
Decimal
N/A Displays the decimal separator for numeric fields.
Separator*
*You can view the value of this attribute when you click Show all properties. This attribute is
read-only. For more information, see the Designer Guide.

Setting File Properties for Sources

Configure flat file properties by clicking the Set File Properties link in the Sources node. You can
define properties for both fixed-width and delimited flat file sources.

You can configure flat file properties for non-reusable sessions in the Workflow Designer and for
reusable sessions in the Task Developer.

Figure A-11 shows the Flat Files dialog box that appears when you click Set File Properties:

Figure A-11. Flat Files Dialog Box for Sources

Select the file type (fixed-width or delimited) you want to configure and click Advanced.

Configuring Fixed-Width Properties for Sources

To edit the fixed-width properties, select Fixed Width in the Flat Files dialog box and click the
Advanced button. The Fixed Width Properties dialog box appears.

Note: Edit these settings only if you need to override those configured in the source definition.

Figure A-12 displays the Fixed Width Properties dialog box for flat file sources:

Figure A-12. Fixed Width Properties

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 9 sur 22

Table A-11 describes the options you define in the Fixed Width Properties dialog box for sources:

Table A-11. Fixed-Width Properties for File Sources


Fixed-Width
Properties Required/Optional Description
Options
Indicates the character representing a null value in the file.
Null
This can be any valid character in the file code page, or any
Character: Required
binary value from 0 to 255. For more information about
Text/Binary
specifying null characters, see Null Character Handling.
If selected, the PowerCenter Server reads repeat NULL
characters in a single field as a single NULL value. If you
do not select this option, the PowerCenter Server reads a
single null character at the beginning of a field as a null
field. Important: For multibyte code pages, Informatica
Repeat Null
Optional recommends that you specify a single-byte null character if
Character
you are using repeating non-binary null characters. This
ensures that repeating null characters fit into the column
exactly.
For more information about specifying null characters, see
Null Character Handling.
Select the code page of the fixed-width file. The default
Code Page Required
setting is the client code page.
The PowerCenter Server skips the specified number of
rows before reading the file. Use this to skip header rows.
Number of
One row may contain multiple rows. If you select the Line
Initial Rows to Optional
Sequential File Format option, the PowerCenter Server
Skip
ignores this option.
You can enter any integer from zero to 2147483647.

The PowerCenter Server skips the specified number of


Number of bytes between records. For example, you have an ASCII
Bytes to Skip file on Windows with one record on each line, and a
Optional carriage return and line feed appear at the end of each line.
Between
Records If you want the PowerCenter Server to skip these two
single-byte characters, enter 2.
If you have an ASCII file on UNIX with one record for

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 10 sur 22

each line, ending in a carriage return, skip the single


character by entering 1.
If selected, the PowerCenter Server strips trailing blank
Strip Trailing
Optional spaces from records before passing them to the Source
Blanks
Qualifier transformation.
Line
Select this option if the file uses a carriage return at the end
Sequential File Optional
of each record, shortening the final column.
Format

Configuring Delimited File Properties for Sources

To edit the delimited properties, select Delimited in the Flat Files dialog box and click the Advanced
button. The Delimited File Properties dialog box appears.

Note: Edit these settings only if you need to override those configured in the source definition.

Figure A-13 displays the Delimited File Properties dialog box for flat file sources:

Figure A-13. Delimited Properties for File Sources

Table A-12 describes the options you can define in the Delimited File Properties dialog box for flat
file sources:

Table A-12. Delimited Properties for File Sources


Delimited
File
Required/Optional Description
Properties
Options

Character used to separate columns of data in the source


file. Use the Browse button to the right of this field to enter
Delimiters Required a different delimiter. Delimiters can be either printable or
single-byte unprintable characters, and must be different
from the escape character and the quote character (if
selected). You cannot select unprintable multibyte

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 11 sur 22

characters as delimiters. The delimiter must be in the same


code page as the flat file code page.
Select None, Single, or Double. If you select a quote
character, the PowerCenter Server ignores delimiter
characters within the quote characters. Therefore, the
PowerCenter Server uses quote characters to escape the
delimiter.
For example, a source file uses a comma as a delimiter and
contains the following row: 342-3849, 'Smith,
Jenna', 'Rockville, MD', 6.
If you select the optional single quote character, the
PowerCenter Server ignores the commas within the quotes
and reads the row as four fields.
Optional
Required If you do not select the optional single quote, the
Quotes
PowerCenter Server reads six separate fields.
When the PowerCenter Server reads two optional quote
characters within a quoted string, it treats them as one quote
character. For example, the PowerCenter Server reads the
following quoted string as I'm going tomorrow:
2353, 'I''m going tomorrow.', MD
Additionally, if you select an optional quote character, the
PowerCenter Server only reads a string as a quoted string if
the quote character is the first character of the field.
Note: You can improve session performance if the source
file does not contain quotes or escape characters.
Select the code page of the delimited file. The default
Code Page Required
setting is the client code page.
Character immediately preceding a delimiter character
embedded in an unquoted string, or immediately preceding
the quote character in a quoted string. When you specify an
escape character, the PowerCenter Server reads the
Escape
Optional delimiter character as a regular character (called escaping
Character
the delimiter or quote character).
Note: You can improve session performance for mappings
containing Sequence Generator transformations if the
source file does not contain quotes or escape characters.
Remove
Escape This option is selected by default. Clear this option to
Optional
Character include the escape character in the output string.
From Data

By default, the PowerCenter Server reads pairs of


delimiters as a null value. If selected, the PowerCenter
Server reads any number of consecutive delimiter
Treat characters as one.
Consecutive For example, a source file uses a comma as the delimiter
Optional
Delimiters as character and contains the following record: 56, , , Jane
One Doe. By default, the PowerCenter Server reads that record
as four columns separated by three delimiters: 56, NULL,
NULL, Jane Doe. If you select this option, the PowerCenter
Server reads the record as two columns separated by one

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 12 sur 22

delimiter: 56, Jane Doe.


Number of The PowerCenter Server skips the specified number of rows
Initial Rows to Optional before reading the file. Use this to skip title or header rows
Skip in the file.

Targets Node

The Targets node lists the used in the session and displays their settings. If you want to view and
configure the settings of a specific target, select the target from the list.

You can configure the following settings:

 Writers. The Writers settings displays the writer the PowerCenter Server uses with each target
instance. For more information, see Writers Settings.
 Connections. The Connections settings allows you to configure connections for the targets.
For more information, see Connections Settings.
 Properties. The Properties settings allows you to configure the target properties. For more
information, see Properties Settings.

Writers Settings

You can view and configure the writer the PowerCenter Server uses with each target instance. The
Workflow Manager specifies the necessary writer for each target instance. For relational targets the
writer is Relational Writer and for file targets it is File Writer.

Figure A-14 displays the Writers settings on the Mapping tab (Targets node):

Figure A-14. Mapping Tab - Targets Node - Writers Settings

Table A-13 describes the Writers settings on the Mapping tab (Targets node):

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 13 sur 22

Table A-13. Mapping Tab - Targets Node - Writers Settings


Writers
Required/Optional Description
Setting
For relational targets, choose Relational Writer or File Writer.
When the target in the mapping is a flat file, an XML file, a SAP
BW target, or MQ target, the Workflow Manager specifies the
necessary writer in the session properties.
When you choose File Writer for a relational target you can use
an external loader to load data to this target. For more
information, see External Loading.
When you override a relational target to use the file writer, the
Writers Required
Workflow Manager changes the properties for that target
instance on the Properties settings. It also changes the
connection options you can define on the Connections settings.
After you override a relational target to use a file writer, define
the file properties for the target. Click Set File Properties and
choose the target to define. For more information, see
Configuring Fixed-Width Properties and Configuring Delimited
Properties.

Connections Settings

You can enter connection types and specific target database connections on the Targets node of the
Mappings tab.

Figure A-15 displays the Connections settings on the Mapping tab (Targets node):

Figure A-15. Mapping Tab - Targets Node - Connections Settings

Table A-14 describes the Connections settings on the Mapping tab (Targets node):

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 14 sur 22

Table A-14. Mapping Tab - Targets Node - Connections Settings


Connections
Required/Optional Description
Settings
Enter the connection type for non-relational targets.
Specifies Relational for relational targets.
You can choose the following connection types for flat file,
XML, and MQ targets:

 FTP. Select this connection type to use FTP to access


the target directory for flat file and XML targets. If
you want to load data to a flat file or XML target using
FTP, you must specify an FTP connection when you
configure target options. If you select this option,
select a configured FTP connection in the Value
column. FTP connections must be defined in the
Workflow Manager prior to configuring sessions. For
details on using FTP, see Using FTP.
 External Loader. Select this connection type to use
the External Loader to load output files to Teradata,
Oracle, DB2, or Sybase IQ databases. If you select this
option, select a configured loader connection in the
Value column.
To use this option, you must use a mapping with a
relational target definition and choose File as the
Type Required writer type on the Writers tab for the relational target
instance. As the PowerCenter Server completes the
session, it uses an external loader to load target files to
the Oracle, Sybase IQ, DB2, or Teradata database.
You cannot choose external loader for flat file or
XML target definitions in the mapping.
Note to Oracle 8 users: If you configure a session to
write to an Oracle 8 external loader target table in bulk
mode with NOT NULL constraints on any columns,
the session may write the null character into a NOT
NULL column if the mapping generates a NULL
output.
For details on using the external loader feature, see
External Loading.
 Queue. Choose Queue when you want to output to an
MQSeries message queue. If you select this option,
select a configured MQ connection in the Value
column. For more information, see the PowerCenter
Connect for IBM MQSeries User and Administrator
Guide.
 None. Choose None when you want to write to a local
flat file or XML file.
Partitions N/A Displays the partitions if the session is partitioned.
Enter a target connection based on the value you choose in
Value Required
the Type column.

Properties Settings

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 15 sur 22

Click the Properties settings to define target property information. The Workflow Manager displays
different properties for the different target types: relational, flat file, and XML.

Properties Settings for Relational Targets

You can configure the writer and object instance attributes for a relational target.

Figure A-16 displays the Properties settings on the Mapping tab for relational targets:

Figure A-16. Mapping Tab - Targets Node - Properties Settings (Relational)

Table A-15 describes the Properties settings on the Mapping tab for relational targets:

Table A-15. Mapping Tab - Targets Node - Properties Settings (Relational)


Target Property Required/Optional Description

You can choose Normal or Bulk.


If you select Normal, the PowerCenter Server
loads targets normally.
You can only choose Bulk when you load to
Sybase, Oracle, or Microsoft SQL Server. If you
select Bulk for a Sybase, Oracle, or Microsoft
SQL Server target, Informatica invokes the bulk
API with default settings, bypassing database
logging.
If you select Bulk for other database types, the
PowerCenter Server reverts to a normal load.
Loading in bulk mode can improve session
performance, but limits your ability to recover
because no database logging occurs.
Note: Choose Normal mode if the mapping
contains an Update Strategy transformation.
Tip: When you choose Bulk mode for Microsoft

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 16 sur 22

SQL Server or Oracle targets, define a large


commit interval.
Consider the following database limitations when
you choose Bulk mode when loading to Oracle:

 Do not define CHECK constraints in the


database.
 Do not define primary-foreign keys in the
Target Load Type Required database. However, you can define primary-
foreign keys for the target definitions in the
Designer.
 Do not create indexes in the database.
 When you use the LONG datatype, verify it
is the last column in the table.

For more information, see your Oracle


documentation.
If selected, the PowerCenter Server inserts all
rows flagged for insert.
By default, this option is selected.
Insert Optional
For details on target update strategies, see “Update
Strategy Transformation” in the Transformation
Guide.
If selected, the PowerCenter Server updates all
rows flagged for update.
By default, this option is selected.
Update (as Update) Optional
For details on target update strategies, see “Update
Strategy Transformation” in the Transformation
Guide.
If selected, the PowerCenter Server inserts all
rows flagged for update.
By default, this option is not selected.
Update (as Insert) Optional
For details on target update strategies, see “Update
Strategy Transformation” in the Transformation
Guide.
If selected, the PowerCenter Server updates rows
flagged for update if it they exist in the target, then
inserts any remaining rows marked for insert.
Update (else Insert) Optional
For details on target update strategies, see “Update
Strategy Transformation” in the Transformation
Guide.
If selected, the PowerCenter Server deletes all
rows flagged for delete.
Delete Optional For details on target update strategies, see “Update
Strategy Transformation” in the Transformation
Guide.
If selected, the PowerCenter Server truncates the
Truncate Table Optional target before loading. For details on this feature,
see Truncating Target Tables.

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 17 sur 22

Enter the directory name in this field. By default,


the PowerCenter Server writes all reject files to the
server variable directory, $PMBadFileDir.
If you specify both the directory and file name in
the Reject Filename field, clear this field. The
Reject File Directory Optional PowerCenter Server concatenates this field with
the Reject Filename field when it runs the session.
You can also use the $BadFileName session
parameter to specify the file directory.
For details on session parameters, see Session
Parameters.
Enter the file name, or file name and path. By
default, the PowerCenter Server names the reject
file after the target instance name:
target_name.bad. Optionally use the
$BadFileName session parameter for the file
name.
The PowerCenter Server concatenates this field
Reject Filename Required with the Reject File Directory field when it runs
the session. For example, if you have
“C:\reject_file\” in the Reject File Directory field,
and enter “filename.bad” in the Reject Filename
field, the PowerCenter Server writes rejected rows
to C:\reject_file\filename.bad.
For details on session parameters, see Session
Parameters.
Rejected
Instructs the PowerCenter Server to write the
Truncated/Overflowed Optional
truncated and overflowed rows to the reject file.
rows*
Update Override* Optional Override the default UPDATE statement.
Table Name Prefix Optional Specify the owner of the target tables.
You can enter pre-session SQL commands for a
target instance in a mapping to execute commands
Pre SQL Optional
against the target database before the PowerCenter
Server reads the source.
Enter post-session SQL commands to execute
Post SQL Optional commands against the target database after the
PowerCenter Server writes to the target.
*You can view the value of this attribute when you click Show all properties. This attribute is
read-only. For more information, see the Designer Guide.

Properties Settings for Flat File Targets

Figure A-17 describes the Properties settings on the Mapping tab for file targets:

Figure A-17. Mapping Tab - Targets Node - File Properties Settings

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 18 sur 22

Table A-16 describes the Properties settings on the Mapping tab for file targets:

Table A-16. Mapping Tab - Targets Node - File Properties Settings


Target
Required/Optional Description
Property
When selected, the PowerCenter Server merges the partitioned
target files into one file when the session completes, and then
deletes the individual output files. If the PowerCenter Server
Merge fails to create the merged file, it does not delete the individual
Partitioned Optional output files.
Files You cannot merge files if the session uses FTP, an external
loader, or a message queue.
For details on configuring a session for partitioning, see
Pipeline Partitioning.
Enter the directory name in this field. By default, the
PowerCenter Server writes the merged file in the server
Merge File
Optional variable directory, $PMTargetFileDir.
Directory
If you enter a full directory and file name in the Merge File
Name field, clear this field.
Merge File Name of the merge file. Default is target_name.out. This
Optional
Name property is required if you select Merge Partitioned Files.

Enter the directory name in this field. By default, the


PowerCenter Server writes output files in the server variable
directory, $PMTargetFileDir.
Output File If you specify both the directory and file name in the Output
Optional Filename field, clear this field. The PowerCenter Server
Directory
concatenates this field with the Output Filename field when it
runs the session.
You can also use the $OutputFileName session parameter to
specify the file directory.

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 19 sur 22

For details on session parameters, see Session Parameters.


Enter the file name, or file name and path. By default, the
Workflow Manager names the target file based on the target
definition used in the mapping: target_name.out.
If the target definition contains a slash character, the
Workflow Manager replaces the slash character with an
underscore.
When you use an external loader to load to an Oracle
database, you must specify a file extension. If you do not
specify a file extension, the Oracle loader cannot find the flat
Output file and the PowerCenter Server fails the session. For more
Required
Filename information about external loading, see Loading to Oracle.
Enter the file name, or file name and path. Optionally use the
$OutputFileName session parameter for the file name.
The PowerCenter Server concatenates this field with the
Output File Directory field when it runs the session.
For details on session parameters, see Session Parameters.
Note: If you specify an absolute path file name when using
FTP, the PowerCenter Server ignores the Default Remote
Directory specified in the FTP connection. When you specify
an absolute path file name, do not use single or double quotes.
Enter the directory name in this field. By default, the
PowerCenter Server writes all reject files to the server
variable directory, $PMBadFileDir.
If you specify both the directory and file name in the Reject
Reject File Filename field, clear this field. The PowerCenter Server
Optional
Directory concatenates this field with the Reject Filename field when it
runs the session.
You can also use the $BadFileName session parameter to
specify the file directory.
For details on session parameters, see Session Parameters.
Enter the file name, or file name and path. By default, the
PowerCenter Server names the reject file after the target
instance name: target_name.bad. Optionally use the
$BadFileName session parameter for the file name.
The PowerCenter Server concatenates this field with the
Reject
Required Reject File Directory field when it runs the session. For
Filename
example, if you have “C:\reject_file\” in the Reject File
Directory field, and enter “filename.bad” in the Reject
Filename field, the PowerCenter Server writes rejected rows
to C:\reject_file\filename.bad.
For details on session parameters, see Session Parameters.
Set File Allows you to configure the file properties. For more
Optional
Properties information, see Setting File Properties for Targets.
Datetime
N/A Displays the datetime format selected for datetime fields.
Format*
Thousand
N/A Displays the thousand separator for numeric fields.
Separator*

Decimal N/A Displays the decimal separator for numeric fields.

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 20 sur 22

Separator*
*You can view the value of this attribute when you click Show all properties. This attribute is
read-only. For more information, see the Designer Guide.

Setting File Properties for Targets

Click the Set File Properties button on the Mapping tab to configure flat file properties. You can
define flat file properties for both fixed-width and delimited flat file targets.

You can configure flat file properties for non-reusable sessions in the Workflow Designer and for
reusable sessions in the Task Developer.

Figure A-18 shows the Flat Files dialog box that appears when you click Set File Properties:

Figure A-18. Flat Files Dialog Box for Targets

Select the file type (fixed-width or delimited) you want to configure and click Advanced.

Configuring Fixed-Width Properties for Targets

To edit the fixed-width properties, select Fixed Width in the Flat Files dialog box and click the
Advanced button. The Fixed Width Properties dialog box appears.

Figure A-19 displays the Fixed-Width Properties dialog box for flat file targets:

Figure A-19. Fixed-Width Properties for File Targets

Table A-17 describes the options you define in the Fixed Width Properties dialog box:

Table A-17. Fixed-Width Properties for File Targets

Fixed-Width Required/Optional Description


Properties

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 21 sur 22

Options
Enter the character you want the PowerCenter Server to use
to represent null values. You can enter any valid character in
Null
Required the file code page.
Character
For more information about specifying null characters for
target files, see Null Characters in Fixed-Width Files.
Select this option to indicate a null value by repeating the
null character to fill the field. If you do not select this
Repeat Null option, the PowerCenter Server enters a single null character
Optional
Character at the beginning of the field to represent a null value. For
more information about specifying null characters for target
files, see Null Characters in Fixed-Width Files.
Select the code page of the fixed-width file. The default
Code Page Required
setting is the client code page.

Configuring Delimited Properties for Targets

To edit the delimited properties, select Delimited in the Flat Files dialog box and click the Advanced
button. The Delimited File Properties dialog box appears.

Figure A-20 displays the Delimited File Properties dialog box for flat file targets:

Figure A-20. Delimited Properties for File Targets

Table A-18 describes the options you can define in the Delimited File Properties dialog box for flat
file targets:

Table A-18. Delimited Properties for File Targets


Edit
Delimiter Required/Optional Description
Options
Character used to separate columns of data. Use the Browse
button to the right of this field to enter a non-printable
delimiter. Delimiters can be either printable or single-byte
Delimiters Required
unprintable characters, and must be different from the escape
character and the quote character (if selected). You cannot
select unprintable multibyte characters as delimiters.

Select No Quotes, Single Quote, or Double Quotes. If you


select a quote character, the PowerCenter Server does not treat

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010
Mapping Tab (Transformations View) Page 22 sur 22

delimiter characters within the quote characters as a delimiter.


For example, suppose an output file uses a comma as a
delimiter and the PowerCenter Server receives the following
row: 342-3849, 'Smith, Jenna', 'Rockville, MD', 6.
Optional
Required If you select the optional single quote character, the
Quotes
PowerCenter Server ignores the commas within the quotes
and writes the row as four fields.
If you do not select the optional single quote, the PowerCenter
Server writes six separate fields.
Select the code page of the delimited file. The default setting
Code Page Required
is the client code page.

Transformations Node

On the Transformations node, you can override properties that you configure in transformation and
target instances in a mapping. The attributes you can configure depends on the type of
transformation you select.

Figure A-21 displays the Transformations node on the Mapping tab:

Figure A-21. Mapping Tab - Transformations Node

Informatica Corporation
http://www.informatica.com
Voice: (650) 385-5000
Fax: (650) 385-5500

ms-its:C:\Program%20Files\Informatica%20PowerCenter%207.1.3\Client\WAG.chm... 02/02/2010