When working with large PeopleSoft Compare Reports, developers often find themselves scrolling endlessly to identify and analyze differences across managed objects. Recognizing this challenge, PeopleSoft has introduced a set of intuitive navigation options in Application Designer designed to significantly improve usability and streamline the comparison process.
In PeopleSoft Application Designer, the Compare Report is a core tool used during upgrades, retrofits, and customizations to identify differences between:
- Source and target environments (e.g., Demo vs. Dev)
- Delivered and customized objects
- Old and new releases (e.g., 8.59 vs. 8.62)
Below is a detailed explanation of the Compare Report in Application Designer, including what it shows, how it works, and what the report’s details look like.

Compare Report in Application Designer – Details
Purpose of the Compare Report
To identify:
- Differences between object definitions
- Customizations vs. delivered changes
- Required merges or re-application of customizations after an update or upgrade
Types of Objects Compared
The tool compares:
- Records
- Pages
- Components
- Menus
- PeopleCode
- Fields
- Message Catalog entries
- Application Engine programs
- Security definitions and more…
Compare Report Contents – Key Sections
When you generate a compare report, here’s what you’ll typically see for each object:
Field Description
- Object Type – E.g., Record, Page, Component
- Object Name – Name of the definition being compared
- Compare Status – Status of the object (e.g., Changed, Unchanged, Absent, New)
- Upgrade Action – What Application Designer will do (e.g., Copy, None, Delete)
- Field-Level Differences For record definitions – field name, type, length, etc.
- PeopleCode Differences – Shows inserted, removed, or modified code
- Compare Flags – Optional indicators for specific differences
Example Compare Result: Record Definition
Attribute |
Source (8.59) |
(8.62) Target |
Status |
Upgrade Action |
Field: EMPLID |
CHAR (11) |
CHAR (11) |
Unchanged |
Same |
Field: NAME |
CHAR (30) |
CHAR (50) |
Changed |
Copy |
Field: BIRTHDATE |
DATE |
DATE |
Unchanged |
Same |
Record Type |
SQL |
SQL |
Unchanged |
Same |
Compare Status Meanings
- Changed Object exists in both but has differences
- Unchanged Object is the same in both environments
- Absent Object is missing in the target
- New Object exists only in the source (e.g., new delivered functionality)
- Same Synonym for “Unchanged” in some reports
- Copy will be copied during upgrade
- None. No action needed
- Delete will be removed (if the object is deleted in the new release)
Generating a Compare Report in Application Designer
- Open Application Designer (from the source environment).
- Navigate to: Tools > Compare and Report.
- Choose: Database or Project as the comparison type.
- Specify: Target database, username, and password.
- Click: Run Comparison.
- View results in: on-screen results pane, saved .txt or .html report, or exportable grid view.
Easier Navigation Through Object Differences
The updated navigation features make it much easier to move between the differences in objects within a Compare Report. Whether you’re a seasoned developer or new to PeopleSoft, these enhancements help you stay focused and efficient.

Fig 1: Differences in objects within Compare Report
You can navigate the differences using:
- Toolbar options
- Menu options
- Keyboard shortcuts

Fig 2: New options under the View tab
With these tools, developers can quickly jump to:
- First Difference
- Previous Difference
- Next Difference
- Last Difference
This makes it far more convenient to locate changes without manually scanning through every line.

Fig 3: Quick Jump options
Object-Level Navigation Made Simple
Not only can you navigate through individual differences, but the new features also enhance your ability to move across objects. As you switch from one object to another:
- The status bar displays relevant details.
- You’ll see both the index of the current object and the total number of objects in the report.
This provides better context and helps you track your progress through the report.

Fig 4: Index of the current object

Fig 5: Total number of objects
Best Practices for Using PeopleSoft Compare Reports Effectively
To maximize the accuracy and efficiency of your PeopleSoft development or upgrade process, it’s essential to follow proven best practices when using Compare Reports in Application Designer:
- Always Compare Against a Clean Demo or Vanilla Environment: Ensure your source or target environment is a clean Demo (vanilla) environment. This helps clearly identify customizations versus delivered changes, minimizing confusion and reducing the risk of overwriting valid updates.
- Mark Customized Objects in a Customization Project: Organize all custom objects into a dedicated customization project. This simplifies future comparisons, supports better traceability, and ensures that all modified components are accounted for during upgrades or retrofits.
- Use Change Control to Track Modifications: Leverage PeopleSoft’s Change Control feature to monitor changes made by developers. This promotes accountability, maintains version integrity, and prevents unauthorized or accidental modifications to objects.
- Carefully Review PeopleCode Changes: PeopleCode updates often have downstream impacts. Always examine inserted, modified, or deleted PeopleCode lines closely to ensure logic consistency and avoid introducing functional issues during migrations.
- For Upgrades, Use Change Assistant to Apply Changes: When performing an upgrade, use Oracle’s Change Assistant tool in conjunction with Compare Reports. It automates the application of upgrade actions like copy, delete, or merge—streamlining the process and reducing manual intervention.
By following these best practices, PeopleSoft developers and administrators can ensure smoother upgrades, fewer errors, and a more controlled application lifecycle management process.
Final Thoughts
The enhanced navigation features introduced in PeopleTools 8.62 are a significant step forward for developers working with large Compare Reports in PeopleSoft Application Designer. By enabling quicker access to object differences and streamlining how users move through changes, these updates help reduce manual effort, eliminate unnecessary scrolling, and improve overall productivity.
Whether you’re performing retrofits, upgrades, or analyzing customizations, these improvements make it easier to identify, understand, and act on object-level differences with clarity and precision. As PeopleSoft continues to evolve, features like these reinforce Oracle’s commitment to delivering a more intuitive and developer-friendly experience.
Optimize Your PeopleSoft Upgrades with Expert Guidance

Struggling to manage complex Compare Reports or plan your next PeopleSoft upgrade? At Kovaion, our seasoned consultants specialize in streamlining PeopleSoft environments—leveraging tools like Application Designer and Change Assistant to ensure smooth, error-free transitions.
Let our experts help you get the most out of PeopleTools 8.62. Whether it’s upgrades, retrofits, or customizations, we bring best practices, automation, and deep functional knowledge to every project.
Reach out today to explore how Kovaion can elevate your PeopleSoft development experience.
Author: Balakrishna Ramakrishna, PeopleSoft Consultant