PeopleCode

PeopleCode

Paradigm	multi-paradigm: object-oriented, imperative
Developer	Oracle Corporation

PeopleCode is a proprietary object-oriented programming language used to express business logic for PeopleSoft applications. Syntactically, PeopleCode is similar to other programming languages, and can be found in both loosely-typed and strongly-typed forms. PeopleCode and its run-time environment is part of the larger PeopleTools framework. PeopleCode has evolved over time and its implementation through the PeopleSoft applications lack consistency. PeopleCode offers some interoperability with the Java programming language. Definition name references, for example, enable you to refer to PeopleTools definitions, such as record definitions or pages, without using hard-coded string literals.^[1] Other language features, such as PeopleCode data types and metastrings, reflect the close interaction of PeopleTools and Structured Query Language (SQL). Dot notation, classes and methods in PeopleCode are similar to other object oriented languages, like Java. Object syntax was an important feature of PeopleTools 8.^[2]

Language features

Supported Functions

PeopleCode supports the following types of functions:^[3]

Built-in: The standard set of PeopleCode functions. These can be called without being declared.

Internal: Functions that are defined (using the Function statement) within the PeopleCode program in which they are called.

External PeopleCode: PeopleCode functions defined outside the calling program. These are generally contained in record definitions that serve as function libraries.

External non-PeopleCode: Functions stored in external (C-callable) libraries.

In addition, PeopleCode supports methods. The main differences between a built-in function and a method are:

-A built-in function, in your code, is on a line by itself, and does not (generally) have any dependencies.

-You do not have to instantiate an object before you can use the function.

-A method can only be executed by an object (using dot notation).

-You must instantiate the object first.

Describing Application Class Structure

• Import any classes that will be used by a class, including the superclass this class extends

  Import PackageName:Superclassname;

• A class is defined using the Class construct.

   Class Classname [Extends SuperClassname]
        [Method_declarations]
        [Property_declarations]
   [Private
        [Method_declaration]
        [Instance_decalarion]
        Constant declaration
    End-class;

• The first set of declarations are the properties and methods that are part of the public, external interface.

  Property datatype PropertyName [get][set];
  Method MethodName ([parameter_list])

• The private instance variables, constants, and the methods are declared following the keyword Private.

  Private
    Instance DataType &InstanceName;
    Constant &Constant = {Number | String | True | False | Null };

• The keyword end-class follows the declarations of properties, methods, instances, and constants.
• After the end-class keyword and before get and set definitions or method definitions, declare any variable and functions that will be used by methods.
• Get and set methods corresponds to properties declared with the get and set keywords.
• Use a get method definition to execute PeopleCode that will return a value.

  get Propertyname
   Return &Value;
  end-get;

• Use a set method definition to execute PeopleCode that will change a value.

  set PropertyName
   
  end-set;

• Method definitions are similar to function definitions.

  method Methodname
   statements;
  end-method;

• A special case of a method definition is the constructor.
• A constructor has the same name as the class and will always run when the class is instantiated.
• A class that does not extend some other class does not need any constructor.
• A class that does extend another class must have a constructor, and in the constructor, it must initialize its superclass.

Executing SQL in PeopleCode

• Where a SQLExec(built-in function) only delivers a single row, using the SQL class you can retrieve and process multiple rows.
• Instantiate a SQL object with the CreateSQL built-in function.
  • Use CreateSQL("SQLString") when you pass a text string to your SQL object.
  • Use GetSQL(SQL.sqlname) when you get the SQL from a SQL definition.

  &SQL = CreateSQL("SQL Statement",[bind values]);

You can also choose to omit the values for the bind variables and supply those values later. For Insert, Update, or Delete commands these values would be supplied using Execute method. (If you supply all the necessary input values, the SQL is executed immediately.)

   &SQL = CreateSQL("SQL Statement");
   &SQL.Execute([bind_values]);

• For a SQL object containing a Select statement, the Fetch method is used to retrieve the next row from the cursor.

PeopleCode Functions, retrieved 2008-12-14

See also

• PeopleSoft
• PeopleTools

External links

• For further documentation on PeopleCode
• http://download.oracle.com/docs/cd/E05317_01/psft/html/docset.html (Version 8.49)
• http://download-east.oracle.com/docs/cd/B31274_01/psft/html/docset.html (Version 8.48)

References

1. DeLia, Tony et al (2001). Essential Guide to Peoplesoft Development and Customization. Manning Publications Co. p.260
2. DeLia, Tony et al (2001). Essential Guide to Peoplesoft Development and Customization. Manning Publications Co. p.417
3. DeLia, Tony et al (2001). Essential Guide to Peoplesoft Development and Customization. p.375