OpsUpdateProject

Owned by Thomas Sherman (Deactivated)
Last updated: Sept 06, 2011Version comment
3 min read

Request

The service request contains:

Name

Data Type

Required?

Default Value

Discussion

Projects

list of ProjectDescriptors

yes

 

See description of Project below


ProjectDescriptor

Name

Data Type

Required?

Default Value

Discussion

EngagementCode

string(20)

yes - see discussion for insert

 

If your installation is configured to autogenerate engagement codes then a blank value can be passed in for insert. Autogenerated codes are the default for all installations. Otherwise you will need to provide an engagement code that matches your installation code mask.

ProjectCode

string(24)

yes - see discussion for insert

 

If your installation is configured to autogenerate project codes then a blank value can be passed in for insert. Autogenerated codes are the default for all installations. Otherwise you will need to provide a project code that matches your installation code mask.

LocationName

string(50)

yes for insert

 

Null on update means leave as is.

Name

string(50)

yes

 

Project name

ProjectStage

string(15)

no

 

Null on insert means use first project stage. Null on update means leave as is.

MgrReferenceSystemId

string(20)

no

engagement manager

Project manager. Null on update means leave as is.

EmEmailFlag

bool

no

true

Set to true for the engagement manager to get project emails. Null on update means leave as is.

BeginDate

date

no

 

 

EndDate

date

no

 

 

OpenForTimeFlag

bool

no

true

Null on update means leave as is.

OpenForCostFlag

bool

no

true

Null on update means leave as is.

PmTimeCardApprovalFlag

bool

no

false

Null on update means leave as is.

BookedResourcesOnlyFlag

bool

no

false

Null on update means leave as is.

NarrativeRequiredFlag

bool

no

false

Null on update means leave as is.

TimePlccMappingType

char

no

"R"

Selects which cost center gets time card revenue: "R"=resource "E"=engagement Null on update means leave as is.

CostPlccMappingType

char

no

"R"

Selects which cost center gets cost card revenue and expenses: "R"=resource "E"=engagement Null on update means leave as is.

OpenForTimeTransfersFlag

bool

no

Defaults to true on insert.

Null on update means leave as is.

OpenForCostTransfersFlag

bool

no

Defaults to true on insert.

Null on update means leave as is.

TimeBudgetAmount

float

no

Defaults to null on insert.

Null on update means leave as is. Note: there is no way to change the budget to null on update.

Cost BudgetAmount

float

no

Defaults to null on insert.

Null on update means leave as is. Note: there is no way to change the budget to null on update.


If the ProjectCode matches that of a record already in Projector, then the new information replaces the old information.
A created projects always uses the default rate card defined by the client/cost center's default rate card. Also, if the project is being added underneath an engagement that already has an engagement currency that is different from the client/cost center default currency, then an error will occur. The workaround is to change the rate card of the default client/cost center rate to the desired rate card, import the project, and then change the default client/cost center rate card back again.

Response

The following data is returned:

Name

Data Type

Discussion

ProjectStatusList

list of ProjectStatus items

see below

ProjectErrors

list of ProjectError items

see below



Each ProjectStatus item contains:

Name

Data Type

Discussion

LineItemStatus

string

"ItemInserted" = Item did not previously exist.
"ItemUpdated" = Existing item was updated
"ItemFailed" = Check the error list

OpsError

OpsWebError

See Responses


Each ProjectError item contains:

Name

Data Type

Discussion

Index

int

Index of the record (position in ProjectList) that failed.

OpsError

OpsWebError

See Responses