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