ExportTimeCards
- Thomas Sherman (Deactivated)
- Bettina Borces
Rate Limiting
In order to protect our servers from inadvertent service overuse or intentional attack, and to fairly distribute services to all our customers, we have implemented a rate limiting algorithm. When fully deployed, this new algorithm will cause services to either succeed with new warnings or fail with new errors when services are consumed at too high a rate. Programs that consume Projector services should be enhanced to handle rate limiting errors so that they can continue functioning properly. For more information please visit: Projector Rate Limiting Behavior.
Request
The service request contains:
Name | Data Type | Required? | Default Value | Discussion |
|---|---|---|---|---|
MinWorkDate | date | no | Export is limited to cards no earlier than this date. | |
MaxWorkDate | date | no | Export is limited to cards no later than this date. | |
ApprovedMinTimestamp | dateTime | no | Export is limited to cards approved on or after this time. To avoid skipping or duplicating cards set this to the last ApprovedTimestamp from the previous result set. | |
ApprovedIdsAfter | int | no | 0 | Export is limited to cards with a ReferenceSystemId greater than this. Note that Projector assigns a ReferenceSystemId that is greater than any previously assigned value. To avoid skipping or duplicating cards set this to the last ReferenceSystemId from the previous result set. |
MaxRowsToReturn | int | no | 1000 | The maximum number of cards to be exported. Values greater than 1000 may fail due to system-enforced transaction time limits. |
CurrencyCode | string | no | If the currency is not specified, then monetary amounts are returned in the engagement currency. | |
IncludeBillableOnly | boolean | no | false | If true, then only billable time cards are exported. |
OnlyCountRows | boolean | no | false | If true, then only the RowCount is returned. |
Response
For each card in the result set the following data is returned:
Name | Data Type | Discussion |
|---|---|---|
AdjustedRevenueAmount | double | |
ApprovedTimestamp | dateTime | Time at which the card was approved. |
ContractRevenueAmount | double | |
CurrencyCode | string | Currency of the reported monetary amounts. This is either the engagement currency (if no currency is specified in the request) or the specified currency. |
Narrative | string | |
ProjectCode | string | Unique code identifying the project |
ProjectTaskName | string | The task code on which time was reported. |
ReferenceSystemId | int | Unique integer identifying the card. |
ResourceReferenceSystemId | string | Unique code identifying the resource. |
RoleName | string | The role on which time was reported. |
SystemRevenueAmount | double | |
WorkDate | date | Date for which the time was reported. |
WorkMinutes | int | The number of minutes worked. |
LocationName | string | |
ProjectTaskTypeName | string(50) | |
ProjectRateTypeName | string(50) | |
NonBillableFlag | boolean | Deprecated. Always returns false. |
Changelog
4.4
Parameter | Notes |
|---|---|
ProjectTaskTypeName | Added as a response parameter |
ProjectRateTypeName | Added as a response parameter |
NonBillableFlag | Deprecated. Always returns false. |