Business Object Based Services

Create, Read, Update, and Delete Operations

Business object based services provide create, read, update, and delete operations, depending on whether the business object supports the respective operation. Most business objects implement all four operations.

Users familiar with SOA terminology might prefer the term entity services instead of the term business object based services when referring to these services.

Additionally, some business object based services contain a special readxxxpath operation that provides hierarchical information about the business object. As an example, you can determine where in the EPS hierarchy a particular project resides by passing its ProjectObjectId into the ReadProjectEPSPath operation. The operation returns a collection of ancestor elements. The following business object based services contain a ReadxxxPath operation:

Service

ReadxxxPath Operation

ActivityCode

ReadActivityCodePath

CostAcount

ReadCostAccountPath

Document

ReadDocumentPath

EPS

ReadEPSPath

ReadProjectEPSPath

FundingSource

ReadFundingSourcePath

OBS

ReadOBSPath

ProjectCode

ReadProjectCodePath

Resource

ReadResourcePath

ResourceCode

ReadResourceCodePath

Role

ReadRolePath

WBS

ReadActivityWBSPath

ReadWBSPath

Special Operations

The following services support special operations unique to their scope, beyond Create, Read, Update, Delete, and ReadxxxPath:

User Defined Fields (UDFs)

Some business objects support UDFs. UDFs enable users to add custom fields and values to the project database. For example, additional activity data, such as delivery dates and purchase order numbers, can be tracked using UDFs. Not all business objects support UDFs. Business objects that support UDFs include the Activity, ActivityExpense, ActivityStep, ActivityStepTemplateItem, BaselineProject, Document, EPS, Project, ProjectIssue, Risk, Resource, ResourceAssignment, and WBS objects.

Some UDF values are based on calculations. The UDFValue service has a ReadCalculatedUDFValues operation that you use to obtain the value of a calculated field after any calculations have been made.


Last Published Friday, February 9, 2024