RPMException

Description

Package: com.ibm.rpm.framework

Extends: Exception

Usage

RPMException is the class used to communicate errors in the Rational Portfolio Manager Web Services API. It contains abnormal behavior information that occur during a call.

Supported API Calls

None

Security Restrictions

N/A

Fields

The following table lists the fields for this object.

Table 1. RPMException Field Description
Field Detail
className

Type: string

Default value: null

Description: The name of the class where the error has occured.

This field is read-only.

This field is null if not applicable.

Field validation description: N/A

Additional field security restrictions: N/A

containerID

Type: string

Default value: null

Description: The unique ID of the object that caused the error.

This field is read-only.

This field value is null if not applicable or if the container has not yet been saved.

Field validation description: N/A

Additional field security restrictions: N/A

errorID

Type: int

Default value: 0

Description: The unique error ID of the error message which indicates the type of error that has occurred.

This field is read-only.

This field value is 0 if not applicable.

For a compilation of fields associated with error IDs, refer to section on ErrorCodes.

Field validation description: N/A

Additional field security restrictions: N/A

fieldName

Type: string

Default value: null

Description: The name of the field which caused the error.

This field is read-only.

This field value is null if not applicable.

Field validation description: N/A

Additional field security restrictions: N/A

Message

Type: string

Default value: N/A

Description: A descriptive error message. This field is read-only.

Field validation description: N/A

Additional field security restrictions: N/A

secondaryFieldName

Type: string

Default value: null

Description: The name of the field that caused the error.

This field is read-only.

This field value is null if not applicable.

Field validation description: N/A

Additional field security restrictions: N/A

severity

Type: SeverityLevel

Default value: Error

Description:Specifies the severity level of an exception. Possible values are Information, Warning, Error, SevereError, and FatalError.

Field validation description: N/A

Additional field security restrictions: N/A

ErrorCodes

Table 2. Validation Error Codes
Codes Descriptions

401001

Cannot assign multiple attributes deriving from the stated classification ID because the selectType field is set to ‘Single’.

407001

If the Profile's grandparent is not of type GenericProject, the grandparent's project assignmentType must be set to 'Work'.

407002

There were no changes made that can be accepted or rejected.

407004

If the published field is set to 'ToTemplate', the generic project must have a saved parent.

407005

PublishedType 'ToTemplate' is not currently supported.

407003

Please specify which fields to accept/reject. The accept/reject fields for EETC and forecastDates cannot both be set to false.

408001

Cannot start a workflow on an object of this type.

408002

Workflow must be activated.

409002

The datafield specified is not in the required datafield category.

409001

If the datafieldCategory field is set to null, the defaultValue field must also be set to null.

409002

The datafield specified is not in the required datafield category.

409001

If the datafieldCategory field is set to null, the defaultValue field must also be set to null.

410002

The charge code’s financial category is not compatible with the financial category of the associated charge code.

410003

Financials with system charge codes set to FTE are read-only.

410004

WBS Financials are read-only.

410001

The financial category stated is reserved for system charge codes.

410005

Cannot save a TimePhasedFinancial container with a null ID or a null grandparent ID.

400065

Field cannot be updated to null.

400067

Class cannot be saved under the root parent provided.

400007

Field is mandatory under the stated condition.

400075

Field cannot match the field to which it is being compared.

400037

Field must be greater than or equal to the field to which it is being compared.

400049

Field must be greater than or equal to a constant value.

400005

Field cannot contain the stated characters.

400008

Failure validation message for the occurrence of a particular condition.

400004

Failure validation message for the comparison of two dates, where one date must be smaller than or equal to the other.

400052

Invalid hour value.

400013

Container is of the wrong type.

400025

Scope object is of the wrong type.

400014

Container is of an invalid type.

400041

The field must be set to one of a set of valid values.

400040

The field cannot contain a leading space.

400038

Field must be less than or equal to the field to which it is being compared.

400006

The field is mandatory.

400001

String exceeds the maximum allowable length.

400002

Array exceeds the maximum allowable size.

400070

A module must be used to create or load this container.

400051

The value cannot contain more than 2 decimal digits.

400012

The field must be null or empty under the stated condition.

400011

The container ID must be specified.

400018

A parent must be supplied for this container.

400017

The container’s parent must be saved prior to saving the container.

400034

The container’s active flag must be set.

400009

The value provided must previously exist.

400010

The value provided must be unique.

400032

The field cannot be set to the stated value when the conditional field does not contain a value.

400079

The fields must be set to null when the conditional field contains a value.

400003

The field value must be set within a stated range of values.

400076

The field is read-only when the conditional field is set to 0.

400077

The field is read-only when the two fields being compared have the same value.

400046

The field is read-only.

400030

The field is read-only when the conditional field has a value.

400031

The field is read-only when the conditional field does not have a value.

400044

The reload type provided is not valid.

400062

The timecode must be a child of the stated timecode category.

400045

Invalid number of fields set to be the default value.

400015

The parent is of an invalid type.

403001

Cannot specify a 'ReverifiedBy' Resource if the 'VerifiedBy' Resource is null.

404001

A scope element cannot have a duplicate scope element with the same ID.

404002

Scope elements can only have duplicates that are in the same project.

405001

Published property cannot be modified, use publish operation.

405002

Invalid number of selected responses for scorecard question.

405003

The context does not match the object the Scorecard container is being assigned to. This is possibly due to the use of an incorrect module object when creating the Scorecard container.

405004

Only one scorecard can be assigned to the specified container.

406001

The timecode must be assigned to the project.

406002

The weight of activities in TaskAssignment cannot exceed 100%.

406003

Creation failed. The project must be published to the team.

406004

Creation failed. The proposed dates must be copied to planned dates.

406005

There is no SummaryTimesheet specified for the project, resource, and weekOf.

406006

There is no SummaryTimesheet specified for the TaskAssignment.

406007

There is no SummaryTimesheet specified for the activity and weekOf.

406008

Cannot check out a submitted/approved timesheet. It must be rejected by the manager first.

Table 3. Manager Error Codes
Codes Descriptions

401500

The maximum number of currencies that can be created has been reached. Cannot create a new currency.

401501

The work intervals specified are not valid.

401502

A work interval must be specified.

401503

Invalid interval(s). An odd number of times is specified.

401504

The type of the attribute is invalid.

401505

The attribute’s root is not a valid type.

400508

Invalid message context. Message context cannot be null.

400507

The primary key cannot be null.

400506

The result set contains a line with an invalid primary key. This may be caused by the fact that the root object of this table has a primary key field equal to null. Please implement method getFilter().

400520

An object with the specified ID does not exist.

400519

The left condition/predicate is missing.

400516

Method getPrimaryKey() is not implemented for this manager. Use method getPrimaryKeyArray().

400515

The stored procedure did not return a result set or the result set did not include an error column.

400517

The property is not mapped to a column in the database table.

400518

The right condition/predicate is missing

400546

The contextName field is set to an invalid value.

400536

Cannot delete an Attribute with no context.

400513

The week day type specified is not valid.

400505

The container name is not valid and could not be mapped.

400547

Failed to register session on the RPMSESSION database.

400548

Session indentifier is either invalid or has timed-out.

400545

The user type specified is not valid.

400544

There is no manager implemented for the specified container.

400500

Usage of the specified method is mandatory.

400524

An error occured while creating an instance of the specified class.

400523

The zero argument constructor of the specified class is not public.

400522

The specified class does not have a zero argument constructor.

400549

A primary key must be provided in order to load the object.

400509

The containerName field is required for the specified method.

400551

The container cannot be created.

400550

The container cannot be deleted.

400510

The container cannot be loaded because its ID is null.

400501

Assignments can only be loaded using the parent object.

403500

The proficiency level specified does not exist.

Table 4. XPath Error Codes
Codes Descriptions

400300

Invalid container or field name.

400301

The specified field is not associated to a valid container. An object name starting with a @ is interpreted as a field.

400306

The relationship specified does not exist for these containers.

400307

The relationship specified does not exist for these containers.

400305

The field name is required. An object name starting with a @ is interpreted as a field.

400308

The parent container is mandatory.

400302

Cannot perform a loadFromXpath on the specified field.

400304

Cannot perform a loadFromXpath on the specified container.

400303

Either a loadFromXpath cannot be perfomed on the specified field or the specified container does not contain this field.

Inherited Fields

N/A

Related Objects