Understanding PeopleBooks

This chapter discusses:

Click to jump to parent topicPeopleBooks Structure

PeopleSoft PeopleBooks follow a common structure. By understanding this structure, you can use PeopleBooks more efficiently.

The PeopleBooks structure conveys conceptual material and a task-based hierarchy of information. Each chapter describes a process that is required to set up or use the application. Chapter sections describe each task in the process. Subsections within a section describe a single step in the process task.

Some PeopleBooks may also be divided into parts. PeopleBook parts can group together similar implementation or business process chapters within an application or group together two or more applications that integrate into one overall business solution. When a book is divided into parts, each part is divided into chapters.

The following table provides the order and descriptions of chapters in a PeopleBook:

Chapters

Description

Preface

This chapter explains:

  • The structure of the PeopleBook you are reading.

  • Common elements used in the PeopleBook, if applicable.

  • Additional resources.

Getting Started With…

(Optional) This chapter discusses product implementation guidelines. It explains:

  • The business processes documented within the book.

  • Integrations between the product and other products.

  • A high-level documentation of how our documentation maps to the overall implementation process; it doesn’t offer step-by-step guidance on how to perform an actual implementation.

Setup and Implementation

This can be one or more chapters. These chapters contain documentation to assist you in setting up and implementing the product. For example, if functionality X is part of a product, this chapter would be devoted to explaining how to set up functionality X, not necessarily how to use functionality X. You would look to the corresponding business process chapter to learn how to use the functionality.

Note. There may be times when a small amount of business process information is included in a setup chapter if the amount of business process documentation was insufficient to create a separate section in the book.

Business Process

This can be one or more chapters in the application PeopleBooks. These chapters contain documentation that addresses specific business processes with each chapter generally devoted to a specific functional area. For example, if functionality X is part of a product, this chapter would be devoted to explain how the functionality works, not necessarily how to set up functionality X. You would look to the corresponding setup and implementation chapter to learn how to set up the functionality.

Note. There may be times when a small amount of setup and implementation information is included in a business process chapter if the amount of setup and implementation documentation was insufficient to create a separate chapter in the book.

Appendixes

(Optional) If the book requires it, one or more appendixes might be included in the book. Appendixes contain information considered supplemental to the primary documentation.

Delivered Workflow Appendix

(Optional) The delivered workflow appendix describes all of the workflows that are delivered for the application.

Note. Not all applications have delivered workflows.

Reports Appendix

(Optional) This appendix contains an abbreviated list of all of the product’s reports. The detailed documentation on the use of these reports is usually included in the related business process chapter.

Click to jump to parent topicTypographical Conventions and Visual Cues Used in PeopleBooks

This section discusses:

Click to jump to top of pageClick to jump to parent topicTypographical Conventions

This table contains the typographical conventions that are used in PeopleBooks:

Typographical Convention or Visual Cue

Description

Bold

Indicates PeopleCode function names, business function names, event names, system function names, method names, language constructs, and PeopleCode reserved words that must be included literally in the function call.

Italics

Indicates field values, emphasis, and PeopleSoft Enterprise or other book-length publication titles. In PeopleCode syntax, italic items are placeholders for arguments that your program must supply.

We also use italics when we refer to words as words or letters as letters, as in the following: Enter the letter O.

Key+Key

Indicates a key combination action. For example, a plus sign (+) between keys means that you must hold down the first key while you press the second key. For Alt+W, hold down the Alt key while you press the W key.

Monospace font

Indicates a PeopleCode program or other code example.

“ ” (quotation marks)

Indicate chapter titles in cross-references and words that are used differently from their intended meanings.

. . . (ellipses)

Indicate that the preceding item or series can be repeated any number of times in PeopleCode syntax.

{ } (curly braces)

Indicate a choice between two options in PeopleCode syntax. Options are separated by a pipe ( | ).

[ ] (square brackets)

Indicate optional items in PeopleCode syntax.

& (ampersand)

When placed before a parameter in PeopleCode syntax, an ampersand indicates that the parameter is an already instantiated object.

Ampersands also precede all PeopleCode variables.

Click to jump to parent topicISO Country and Currency Codes

PeopleBooks use International Organization for Standardization (ISO) country and currency codes to identify country-specific information and monetary amounts.

ISO country codes may appear as country identifiers, and ISO currency codes may appear as currency identifiers in your PeopleSoft PeopleBooks. Reference to an ISO country code in your PeopleBook does not imply that your application includes every ISO country code. Example of a country-specific heading: “(FRA) Hiring an Employee”

The PeopleSoft Currency Code table (CURRENCY_CD_TBL) contains sample currency code data. The Currency Code table is based on ISO Standard 4217, “Codes for the representation of currencies,” and also relies on ISO country codes in the Country table (COUNTRY_TBL). The navigation to the pages where you maintain currency code and country information depends on which PeopleSoft applications you are using. To access the pages for maintaining the Currency Code and Country tables, consult your application PeopleBooks for more information.

Click to jump to top of pageClick to jump to parent topicRegion, and Industry Identifiers

Information that applies only to a specific region, or industry is preceded by a standard identifier in parentheses. This identifier typically appears at the beginning of a section heading, but it may also appear at the beginning of a note or other text.

Example of a region-specific heading: “(Latin America) Setting Up Depreciation”

Region Identifiers

Regions are identified by the region name. The following region identifiers may appear in PeopleBooks:

Industry Identifiers

Industries are identified by the industry name or by an abbreviation for that industry. The following industry identifiers may appear in PeopleBooks:

Click to jump to parent topicCommon PeopleBooks

Common PeopleBooks are books of the same name that are used in multiple applications or books of particular interest to all customers.

Click to jump to top of pageClick to jump to parent topicApplication Fundamentals

Each application PeopleBook provides implementation and processing information for your PeopleSoft Enterprise applications.

For some applications additional, essential, information describing the setup and design of your system appears in a companion volume of documentation called the Application Fundamentals PeopleBook. Most product lines have a version of the application fundamentals PeopleBook. The preface of each PeopleBook identifies the application fundamentals PeopleBooks that are associated with that PeopleBook.

The application fundamentals PeopleBook consists of important topics that apply to many or all PeopleSoft Enterprise applications. Whether you are implementing a single application, some combination of applications within the product line, or the entire product line, you should be familiar with the contents of the appropriate application fundamentals PeopleBooks. They provide the starting points for fundamental implementation tasks.

Click to jump to top of pageClick to jump to parent topicUsing PeopleSoft Applications

The Enterprise PeopleTools PeopleBook: Using PeopleSoft Applications introduces you to the various elements of the PeopleSoft Pure Internet Architecture. It also explains how to use the navigational hierarchy, components, and pages to perform basic functions as you navigate through the system. While your application or implementation may differ, the topics in this PeopleBook provide general information about using PeopleSoft applications.

See PeopleTools PeopleBook: Using PeopleSoft Applications

Click to jump to parent topicCommon Elements Used in PeopleBooks

As of Date

The last date for which a report or process includes data.

Business Unit

An ID that represents a high-level organization of business information. You can use a business unit to define regional or departmental units within a larger organization.

Description

Enter up to 30 characters of text.

Effective Date

The date on which a table row becomes effective; the date that an action begins. For example, to close out a ledger on June 30, the effective date for the ledger closing would be July 1. This date also determines when you can view and change the information. Pages or panels and batch processes that use the information use the current row.

Once, Always, and Don't Run

Select Once to run the request the next time the batch process runs. After the batch process runs, the process frequency is automatically set to Don't Run.

Select Always to run the request every time the batch process runs.

Select Don't Run to ignore the request when the batch process runs.

Process Monitor

Click to access the Process List page, where you can view the status of submitted process requests.

Report Manager

Click to access the Report List page, where you can view report content, check the status of a report, and see content detail messages (which show you a description of the report and the distribution list).

Request ID

An ID that represents a set of selection criteria for a report or process.

Run

Click to access the Process Scheduler request page, where you can specify the location where a process or job runs and the process output format.

SetID

An ID that represents a set of control table information, or TableSets. TableSets enable you to share control table information and processing options among business units. The goal is to minimize redundant data and system maintenance tasks. When you assign a setID to a record group in a business unit, you indicate that all of the tables in the record group are shared between that business unit and any other business unit that also assigns that setID to that record group. For example, you can define a group of common job codes that are shared between several business units. Each business unit that shares the job codes is assigned the same setID for that record group.

Short Description

Enter up to 15 characters of text.

User ID

An ID that represents the person who generates a transaction.