OpsUpdateEngagement

Request

The service request contains:

Name

Data Type

Required?

Default Value

Discussion

Engagements

list of Engagement Descriptors

yes

 

See description of Engagement below


EngagementDescriptor


Name

Data Type

Required?

Default Value

Discussion

EngagementCode

string(20)

yes

 

 

Name

string(255)

yes

 

Engagement name

EngagementStage

string(15)

no

 

Null on insert means use first engagement stage; null on update means leave as is.

ClientNumber

string(20)

yes

 

 

MgrReferenceSystemId

string(20)

yes for insert

 

Null on update means leave as is.

CostCenterNumber

string(40)

CostCenterNumber or CostCenterName required for insert.

 

Null on update means leave as is.

CostCenterName

string(50)

no

 

 

EngagementType

string(15)

yes

 

 

CurrencyCode

string(3)

yes

 

 

PurchaseOrderNumber

string(50)

no

 

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.

TimeContractTerms

string(1)

no

Defaults to "T" on insert

"F"=fixed price, "T"=time and materials, "C"=time and materials with a cap, "R"=retainer. Null on update means leave as is.

CostContractTerms

string(1)

no

Defaults to "T" on insert

"F"=fixed price, "T"=time and materials, "C"=time and materials with a cap, "R"=retainer. Null on update means leave as is.

TimeContractAmount

float

Required if TimeContractTerms is "F" or "C". Ignored otherwise.

 

 

CostContractAmount

float

Required if CostContractTerms is "F" or "C". Ignored otherwise.

 

 


If the EngagementCode matches that of a client already in Projector, then the new client information replaces the old information.

Response

The following data is returned:

Name

Data Type

Discussion

EngagementStatusList

list of EngagementStatus items

see below

EngagementErrors

list of EngagementError items

see below



Each EngagementStatus 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 EngagementError item contains:

Name

Data Type

Discussion

Index

int

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

OpsError

OpsWebError

See Responses


Changelog

4.4

Parameter

Notes

EngagementDescriptor.Name

Character limited extended from 50 to 255