OpsImportTimeCards

Owned by Thomas Sherman (Deactivated)
Last updated: Nov 11, 2020 by Ronni Skerker (Unlicensed)Version comment

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

 

 

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