Understanding PeopleBooks

This chapter discusses:

Click to jump to parent topicThe PeopleBooks 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.

This table provides the order, types, and descriptions of prefaces, chapters, and appendixes in a PeopleBook:

Content Type

Description

Preface

The preface explains:

  • The structure of the PeopleBook you are reading.

  • Common elements that are used in the PeopleBook, if applicable.

  • Additional resources.

Getting Started With…

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

  • The business processes that are documented within the book.

  • Integrations between the product being discussed and other products.

  • A high-level overview of how the 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, these chapters explain how to set up functionality X, not necessarily how to use functionality X. The corresponding business process chapters explain how to use the functionality.

Note. A small amount of business process information might be included in a setup chapter if the amount of business process documentation is insufficient to require 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, these chapters explain how the functionality works, not necessarily how to set up functionality X. The corresponding setup and implementation chapters explain how to set up the functionality.

Note. A small amount of setup and implementation information might be included in a business process chapter if the amount of setup and implementation documentation is insufficient to require a separate chapter in the book.

Appendixes

(Optional) One or more appendixes might be included in the book. Appendixes contain information that is supplemental to the primary documentation.

Delivered Workflow Appendix

(Optional) The delivered workflow appendix describes all of the workflows that are delivered with 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 usually appears in the related business process chapters.

Click to jump to parent topicTypographical Conventions and Cues That Are Used in PeopleBooks

This table describes the typographical conventions and cues 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 or other book-length publication titles. In PeopleCode syntax, italic items are placeholders for arguments that your program must supply.

Italics also identify references to words or letters, as in the following example: 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. The following example is 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 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. This section discusses:

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

Each application PeopleBook provides implementation and processing information for your PeopleSoft 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 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 PeopleBook

PeopleTools 8.52: Using PeopleSoft Applications PeopleBook 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.

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.