Overview
This web services returns transactional data about reported time. The service will return time reporting activity since a specified bookmark. A new bookmark is returned in the response. When invoking this service as a later time, the new bookmark can be passed to it to retrieve all activity since the last time the service was invokedcan be passed to it to retrieve all activity since the last time the service was invoked.
| Info | ||
|---|---|---|
| ||
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 Format
| Panel | ||
|---|---|---|
| ||
|
Request Elements
Element | Data Type | Required? | Default | Description | Sample Data |
|---|---|---|---|---|---|
RequestId | Int32 | No | Click here for more information. | 1 | |
SessionTicket | String | Yes | Click here for more information. | AdASLLZalvehjm71D72agw== | |
Bookmark64 | String | No | Bookmark (represents the last data previously exported by this web service a new bookmark value will be returned each time the service is executed) | AACjOQDZyD1UEAAAAAHhbLkAAAAAAAAAAg== | |
CostCenterIdentity |
No | The cost center to filter by | ||||
IncludeBillableTimeFlag | Boolean | No | false | If set to 'true', include billable time cards only | true |
IncludeMode | String | Yes | The include mode: 'S' for submissions 'A' for approvals 'B' for both submissions and approvals | B | |
IncludeNonbillableTimeFlag | Boolean |
No | false | If set to 'true', include non-billable time cards | true |
IncludeTempWorkersFlag | Boolean |
No | true | If set to 'true', include time cards associated with temporary workers | true |
IncludeTimeOffFlag | Boolean |
No | false | If set to 'true', include time off cards | true | ||
MaxRowsToReturn | Int32 | No | The maximum number of data rows to return | 1 | |
ResourceFilteringFlag | Boolean |
No | false | If 0, filter based upon engagement cost center, if 1 filter based upon resource cost center | false |
Request Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:tim="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
<soapenv:Header/>
<soapenv:Body>
<pws:PwsExportIncrementalTimeFeed>
<pws:serviceRequest>
<req:RequestId>1</req:RequestId>
<req:SessionTicket>AdASLLZalvehjm71D72agw==</req:SessionTicket>
<tim:Bookmark64>AACjOQDZyD1UEAAAAAHhbLkAAAAAAAAAAg==</tim:Bookmark64>
<tim:IncludeBillableTimeFlag>true</tim:IncludeBillableTimeFlag>
<tim:IncludeMode>B</tim:IncludeMode>
<tim:IncludeNonbillableTimeFlag>true</tim:IncludeNonbillableTimeFlag>
<tim:IncludeTempWorkersFlag>true</tim:IncludeTempWorkersFlag>
<tim:IncludeTimeOffFlag>true</tim:IncludeTimeOffFlag>
<tim:MaxRowsToReturn>1</tim:MaxRowsToReturn>
<tim:ResourceFilteringFlag>false</tim:ResourceFilteringFlag>
</pws:serviceRequest>
</pws:PwsExportIncrementalTimeFeed>
</soapenv:Body>
</soapenv:Envelope> |
...
| Panel | ||
|---|---|---|
| ||
|
Response Elements
...
Element | Data Type | Description | Sample Data |
|---|---|---|---|
Messages | The web service response status and message. Click here for more information. | ||
ResponseId | Int32 | Click here for more information | 1 |
Status | Click here for more information | Ok | |
ServerTimestampUtc | DateTime | Click here for more information | 2018-03-14T18:21:43.3061187Z |
Bookmark64 | String | Bookmark representing the last data returned by this invocation. Consumers will typically save this value and use it at a later time to retrieve additional activity. | AACjOQDZyD1UEAAAAAHhbLoAAAAAAAAAAg== |
Feed | The details of the time card | ||
RowCount | Int32 | The total number of rows returned by the service | 1 |
...