File Layout

Agenda
Understanding File Layout
Why and how it is used?
Properties
Few Error cases

File Layout

A file layout is a definition that represents the data structure of a file to be

processed.

Facilitates transactions between a PeopleSoft application and a third-party

system when the third-party system doesnt support PeopleSoft Integration
Broker or component interfaces.

File Layout
PeopleCode programs that are needed to perform data import are automatically
generated.
Field Formats in a Flat File
FIXED
CSV
XML
When we use the WriteRecord, ReadRowset, or WriteRowset file layout methods
for writing to records, the application record and the file record must have the
same name, and the application record fields and the file fields must have the
same names.

PROPERTIES
File Layout level
File Record Level
File Record Field Level

How to create a new File Layout

Login to PeopleSoft Application Designer > File > New > Select File Layout >
Click Ok

Specifying File Layout

Properties

The File Layout Definition Properties dialog box contains all of the
information that is stored at the file layout (root) level.
Access the dialog box by using one of the following methods:
Select File, Object Properties.
Press Alt+Enter.
Double-click the topmost (root) node of a file layout definition.
Right-click an open file layout, and select Data Object Properties.

Note: Individual properties are not usable by all format types. However, some are
Applicable.

FIXED Layout

CSV layout

Specifying File
Record Properties
The File Layout Segment Properties dialog box contains information that is
stored at the file record level.
Access the dialog box by using one of the following methods:
Double-click the file record node.
Right-click the file record node, and select Selected Node Properties.

FIXED Layout

CSV Layout

Specifying File
Layout Field
The File Layout Field Properties dialog box contains information that is
Properties
stored at the file field level.

Access the dialog box by using one of the following methods:

Double-click the file field node.
Right-click the file field node, and select Selected Node Properties

Specifying File Layout Field PropertiesFIXED Layout

Upper Case check box is applicable for character fields only.
The preceding dialog box shows the properties for a character type of
field.
Date Separator field is applicable for date fields only, and so on.

Character Field

Date Field

10

Specifying File Layout Field Properties CSV Layout

Character Field

Date Field

11

Previewing Input
Data
In PeopleSoft Application Designer, select File, New, File Layout, Preview.
Initially no information is displayed on the preview tab.
To preview the input data:
Click Browse and select the import file.
Select a file layout segment from the Segment drop-down list box.
Click the Refresh button on the toolbar to refresh the preview data.
Select one of the fields on the Field Name list.
Note: Preview file data is available only for FIXED and CSV file layouts not
for XML. However you can still generate and run an import program for all
types of layouts.

12

Previewing Input
Data

Previewing the CSV file.

13

Common Errors
The preview grid doesnt appear.
Only the first column of the preview grid is populated.
A field appears to start in the middle of the data (or) Data for a field appears
truncated in the preview grid.

14

Few points Regarding people code

in File Layout
&REC.ExecuteEdits();
&REC.IsEditError
&LogFile.WriteLine();
GetFile
&File.Isopen
&Sql.Execute

15

16