OpsImportTimeCards
This web service is used to import time cards into Projector. It cannot be used to import time-off. To import time-off, please use OpsUpdateResourceTimeoff.
Request
The service request contains:
Name | Data Type | Required? | Default Value | Discussion |
|---|---|---|---|---|
BatchId | int | yes |
| The batch ID created by invoking the OpenTimeCardBatch service. |
TimeCards | list of TimeCard items | no |
| See description of TimeCard below |
Each TimeCard item contains:
Name | Data Type | Required? | Default Value | Discussion |
|---|---|---|---|---|
TimeCardReferenceSystemId | string | yes |
|
|
ProjectCode | string | yes |
|
|
ResourceReferenceSystemId | string | yes |
|
|
Role | string | sometimes |
| Required unless UseFirstRoleFlag is set in the CloseTimeCardBatch service. |
ProjectTaskName | string | no |
| ProjectTaskName is a backward-compatibility synonym for ProjectTaskTypeName |
ProjectWbsTaskCode | string | no |
| Required for time cards on PM-module enabled projects unless UseFirstTaskFlag is set in the CloseTimeCardBatch service. Leave null for non-PM-module enabled projects. |
ProjectWbsTaskName | string | no |
| Required for time cards on PM-module enabled projects unless UseFirstTaskFlag is set in the CloseTimeCardBatch service. Leave null for non-PM-module enabled projects. |
Narrative | string | sometimes |
| Required depending on project and system configuration. |
WorkDate | date | yes |
| Date for which the time was reported. |
WorkMinutes | int | yes |
| The number of minutes worked. |
ContractRevenue | float | sometimes |
| In import mode, do not specify. In replace mode it is required. |
AdjustedRevenue | float | sometimes |
| In import mode, do not specify. In replace mode it is required. |
SystemRevenue | float | sometimes |
| In import mode, do not specify. In replace mode it is required. |
CurrencyCode | string | sometimes |
| In import mode, do not specify. In replace mode it is required. |
LocationName | string | no |
|
|
NonBillableFlag | bit | no | false | Deprecated. Do not use. |
ProjectTaskTypeName | string(50) | sometimes |
| Required for time cards on non-PM-module enabled projects unless UseFirstTaskFlag is set in the CloseTimeCardBatch service. Leave null for PM-module enabled projects. Preferred synonym for ProjectTaskName |
ProjectRateTypeName | string(50) | no |
|
|
| ExternalGroupingIdentifier | int | no | Allows for grouping a collection of timecards to facilitate searching and purging. |
Response
The following data is returned:
Name | Data Type | Discussion |
|---|---|---|
TimeCardErrors | list of TimeCardError items | see below |
Each TimeCardError item contains:
Name | Data Type | Discussion |
|---|---|---|
Index | int | Index of the time card (position in TimeCards) that failed. |
OpsError | OpsWebError | See Responses |
Changelog
4.4
Parameter | Notes |
|---|---|
ProjectRateTypeName | Added as a request parameter |
ProjectTaskTypeName | Added as a request parameter |
NonbillableFlag | Deprecated. Do not use. |