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. |
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 |