updateProgram

Purpose

This operation updates a program in PPM Center.

Function

This operation updates a program according to the ProgramInfo object you input.

To perform this operation, the user must meet one of the following conditions:

• Have the Edit All Programs access grant.

• Be the manager of the program and have the Edit Programs access grant.

Related Information

Operation: createProgram

Input

A ProgramInfo object.

Return

If the operation is successful, nothing will be returned to the client.

Java Examples

See webservice_toolkit:

java\client\src\examples\pgm\ProgramServiceClient.java

updateProgram()

Errors and Exceptions

Possible root cause descriptions:

Exception/Message Code	Message	Cause(s)	Possible Corrective Action
ObjectNotFoundException	No program found	The program ID or name is invalid.	Validate the program ID or name.
ITGException	Unable to get program type for program <program name>	Program type ID or name is invalid.	Validate the program type ID or name.
AuthorizationException	You do not have the privilege to take this action. Please consult your PPM Administrator.	The user has no access granted to update programs.	Grant the appropriate access to the user. For more information, see Function
ProgramRollupableConversionException/ pgm.exception.non-rollupable	Portfolio Management cannot be disabled for this program because it is already included in a portfolio.	Program is already included in a portfolio.	Remove the program from the associated portfolio.
ProgramRollupableConversionException/ pgm.exception.rollupable	Portfolio Management cannot be enabled for this program because some of its content is already included in a portfolio or in another program that has Portfolio Management enabled.	Projects in this program is already included in a portfolio.	Validate the associated projects for this program.