Developing An Application
Chapter 1: Developing An ApplicationDeveloping An ApplicationDeveloping An ApplicationChapter 1: Developing An Application
seq chapter \h\r2Chapter 1:Developing An ApplicationIn this chapter, you will learn how to create and modify PeopleSoft definitions using the Application Designer. Chapter Objectives
This chapter teaches you how to: Create a Project
Define a Field Definition Create a Record Definition Build SQL Tables Create a Page Definition
Create a Component Definition
This chapter contains the following lessons:
Lesson 1: Creating a Project2Lesson 2: Creating a Field Definition6Lesson 3: Creating a Record Definition10Lesson 4: Building an SQL Tables13Exercise 4-1: Create an SQL Table18Lesson 5: Creating a Page Definition20Exercise 5-1: Creating a Page Definition31Lesson 6: Creating a Component Definition32
Lesson 1:Creating a Project
The Project Window of the Application Designer is a graphical representation of the definitions within PeopleSoft. While creating a project is not a required step in development, it is useful in organizing definitions as you configure and develop in the application.Using projects will help:
Organize related definitions
Show definition relationships
Manage developers work
Simplify upgrade task
Before beginning to save PeopleSoft object definitions into a project, it is a good idea to check the following settings.
From the Application Designer Menu click Tools ( Options(These settings only need to be done once in App Designer)
From the Application Designer Menu File ( Project Properties
Practice Creating a project
Access the application designer.
To create a new project:
1. Click File.
2. Click New3. Click Project
The project window should look like this.
5. Click File6. Click Project PropertiesAdd descriptions and comments7. Click 8. Click File9. Click Save Project As
10. Type in Project Name (ASU_JGS_PROJ)11. Click
Project Window should reflect the new project name.Lesson 2:Creating a Field DefinitionField definitions represent a column in a table or view. These are stand alone development definitions that can be used in multiple record definitions. A change to a field definition will be effected in any record definition it participates.
This is a partial example of the Personal Data table:
Personal Data Table
EMPLIDCOUNTRY_NM_FORMATNAMENAME INITIALSNAME PREFIX
This is a partial example of the Address table:
SA0001HOME1359 First St.
Type of attributes to a field definition include: Data Type Field Name Field Length
A PeopleSoft supplied translate table is used as a prompt table on certain fields that dont need individual tables for prompt values. Normally, a change to the values is requested and then made by a developer. Values from the translate table should be used if the following criteria is met on a field:
Field type is character
Field length is 1 to 4 characters
The set of values is static and not maintained by the users
No other fields relate to this field
A fields prompt values are not Y/N
If a field does not display these characteristics and needs a prompt validation, a separate prompt table should be constructed. To see a fields translate values, make the field definition active, choose File, Definition Properties, Translate Values tab.Example of the Translate table
Practice Creating a field definition
Access the application designer.
To create a new field definition:
12. Click File.
13. Click New14. Click Field
15. Click A new character field opens in the workspace area.
16. Fill in the Field attributes
Enter the Field Description.
17. Click 18. Click File19. Click SaveType Field Definition Name
20. Click Changing an existing field definition does not change the underlying SQL table in the database until after the build process.Lesson 3:Creating a Record DefinitionField definitions are grouped together to create a record definition. The record definition is a representation of how the underlying SQL database table will be built in the database and how it processes.
On the toolbar there are four buttons that will change the view of the record definition.ButtonTypeDescription
Field DisplayName Length, Format, Short Name, Long Name
Use DisplayKey related attributes, default values
Edits DisplayEdit Options
PeopleCode DisplayFields with PeopleCode
Practice Creating a Record DefinitionAccess the application designer.
To create a new record definition:
1. Click File2. Click New3. Click Record
4. Click The object workspace appears so that you can build a list of fields in a record definition.
5. Select tab and choose Record Type
6. Insert Fields into the Record Definition
7. Click File8. Click SaveType Record Definition Name
9. Click Creating or changing a record definition does not affect the underlying SQL table in the database until after the build process.
Lesson 4:Build SQL Tables
Field and record definitions are simply blueprints on how a table is to be built in the database. Until the build process is run for the record definition there is no physical database table in which to house the application data. The build process also has the ability to alter the table structure in the database should a change to an existing field or record definition occur. This allows changes to an existing database table without losing the data that is in the table.
The scope of the build is reflected in the scrolling window. This has the entire scope of the records in a project, whereas building only the current object in the definition window would have simply one record.
To check build settings:Click
Practice Building an SQL Table
Open a Record Definition in Application Designer.
To Build an SQL Table:
1. Click Build or Build Button2. Click Current Definitions
3. Check Create Tables & Create Indexes & Create Views4. Click 5. Check Output Window for Errors
6. Verify Record was created.Exercise 4-1: Create an SQL TableIn this exercise, you will create an SQL Table.
Create an SQL table that tracks an employees car license plate to a valid lot number. An employee can be eligible to park their car in more than one lot.There are four lots
1. North Lot
2. South Lot
3. East Lot
4. West Lot
Within each lot is different level of parking:
Include the following fields:
Save the table as XXX_ASU_PARKING.
Give any new field and/or record definitions a descriptionSave all object changes to a project as ASU_XXX_PARK
Build the SQL Table
Verify the database table
What fields are going to make the record unique? Use existing fields where appropriate.
License Plates can be a combination of numbers and letters In order to save database space the Lot number field should only take up one character but be able to display the character name.
Start a new project and save before beginning object modifications. Make sure to check settings so objects automatically save into your project. Lesson 5:Creating A Page Definition
The page interfaces between the user and the application database. It is used to make the application data accessible for viewing and maintaining.Level-Based Controls
The page design is a level-based construct in order to display parent-child relationship between the database records.
A page can display up to 4 nested levels Level 0, Level 1, Level 2, and Level 3.Level 0Level 0 contains the primary keys to the underlying record of the page is normally display only with data the users entered on the search page.
Level 1-3The subsequent scrollable level is related to the previous scroll level and related by their key values. These scroll levels will be displayed by one of the following page controls:
Grid Scroll Area
Page Definition ToolbarThe page definition toolbar is used to act upon the definition of the page itself. The following buttons will work when there is an active page in the work area.
Page PropertiesAlt+EnterPage Description, Page Type, Page Size, etc.
Hide/Display Project WorkspaceView, Project Workspace Or Alt+0Hides Project Workspace
Select GroupEdit, Select Group Or Ctrl+PSelect a group of page items
Default OrderingLayout, Default OrderingReorder all page controls based on page location
Test PageLayout, Test Mode Or Ctrl-TTest tab order of page design
Browser ButtonLayout, View in BrowserHow the page looks in the browser
Toggle InspectorView, Show Page Control InspectorHide/unhide Floating definition window
Auto SizeSize subpage or secondary page around page controls
Toggle GridView, Show