Overview
This web service retrieves a list of resources that the authenticated user can enter time or cost on behalf of. The result set can be further narrowed down by a search string or a predefined resource (PwsResourceRef)
Request Format
Panel | ||
---|---|---|
| ||
|
Request Elements
...
Element
...
Data Type
...
Required?
...
Default
...
Description
...
Sample Data
...
RequestId
...
Int32
...
No
...
Click here for more information.
...
SessionTicket
...
String
...
Yes
...
Click here for more information.
...
AQ6SEBGgdJSg3aZ5kSDsDg==
...
BeginDate
...
DateTime
...
No
...
EndDate
...
DateTime
...
No
...
ListType
...
String (1)
...
Yes
...
The type of on-behalf-of users:
C: Cost
T: Time
...
MaximumRows
...
Int32
...
No
...
The maximum number of resources to be returned. This value is disregarded if a client is specified in ResourceIdentity.
...
ResourceIdentity
...
...
No
...
SearchString
...
String (255)
...
No
...
A search string to narrow down the results. A resource will be included in the results if the search string matches the resource's display name based upon the criteria. This value is disregarded if a client is specified in ResourceIdentity.
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:PwsGetOnBehalfOfResources>
<pws:serviceRequest>
<req:SessionTicket>AQ6SEBGgdJSg3aZ5kSDsDg==</req:SessionTicket>
<tim:BeginDate>2018-01-01z</tim:BeginDate>
<tim:EndDate>2018-03-31z</tim:EndDate>
<tim:ListType>T</tim:ListType>
<tim:MaximumRows>3</tim:MaximumRows>
<tim:SearchString>br</tim:SearchString>
</pws:serviceRequest>
</pws:PwsGetOnBehalfOfResources>
</soapenv:Body>
</soapenv:Envelope> |
...
language | java |
---|---|
title | Example 02 - with resource |
collapse | true |
...
Overview
This web service retrieves a list of resources that the authenticated user can view dashboard info or enter time, cost or requested time off on behalf of. The result set can be further narrowed down by a search string or a predefined resource (PwsResourceRef).
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. | ||
SessionTicket | String | Yes | Click here for more information. | AQ6SEBGgdJSg3aZ5kSDsDg== | |
BeginDate | DateTime | No | Applies only for ListType T. The response will be limited to resources for whom the caller has permission to enter time on behalf of at any point during the date range bounded by BeginDate and EndDate, If ListType is T and BeginDate is not specified, the first day of the current week is used as the BeginDate. | 2018-01-01z | |
EndDate | DateTime | No | See BeginDate, If ListType is T and EndDate is not specified, the last day of the current week is used as the EndDate. | 2018-12-31z | |
ListType | String (1) | Yes | The type of on-behalf-of users: C: Enter cost T: Enter time O: Enter time off requests D: View dashboard | T | |
MaximumRows | Int32 | No | The maximum number of resources to be returned. This value is disregarded if a resource is specified in ResourceIdentity. | 5 | |
ResourceIdentity | No | If a resource is identifier here, the results will be limited to the specified resource. If the caller does not have on behalf of permissions for the specified resource, an empty list will be returned. Click here for more information. | |||
SearchString | String (255) | No | A search string to narrow down the results. A resource will be included in the results if the caller has the appropriate on behalf of permissions for the resource and the search string matches the resource's display name. This value is disregarded if a resource is specified in ResourceIdentity. |
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/PwsProjectorServicesTimeAndCost/" xmlns:reqcom="http://projectorpsa.com/DataContracts/Requests/" xmlns:tim="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Shared/Common/"> <soapenv:Header/> <soapenv:Body> <pws:PwsGetOnBehalfOfResources> <pws:serviceRequest> <req:SessionTicket>AQ6SEBGgdJSg3aZ5kSDsDg==</req:SessionTicket> <tim:BeginDate>2018-01-01z</tim:BeginDate> <tim:EndDate>2018-03-31z</tim:EndDate> <tim:ListType>T</tim:ListType> <tim:MaximumRows>3</tim:MaximumRows> <tim:SearchString>br</tim:SearchString> </pws:serviceRequest> </pws:PwsGetOnBehalfOfResources> </soapenv:Body> </soapenv:Envelope> |
Response Format
Panelcode |
---|
...
Messages
...
...
ResponseId
...
Int32
...
Click here for more information.
...
ServerTimestampUtc
...
DateTime
...
Click here for more information.
...
Resources
...
Response Usage Example(s)
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
| ||||||
|
Response Elements
...
Element
...
Data Type
...
Description
...
Sample Data
| |||
<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:PwsGetOnBehalfOfResources>
<pws:serviceRequest>
<req:SessionTicket>AQ6SEBGgdJSg3aZ5kSDsDg==</req:SessionTicket>
<tim:BeginDate>2018-01-01z</tim:BeginDate>
<tim:EndDate>2018-03-31z</tim:EndDate>
<tim:ListType>T</tim:ListType>
<tim:MaximumRows>3</tim:MaximumRows>
<tim:SearchString>br</tim:SearchString>
</pws:serviceRequest>
</pws:PwsGetOnBehalfOfResources>
</soapenv:Body>
</soapenv:Envelope> |
Response Format
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. | 0 |
Status | RequestStatus | Click here for more information | Ok |
ServerTimestampUtc | DateTime | Click here for more information. | 2018-03-12T14:57:19.319861Z |
Resources | The resources that the authenticated user can act on behalf of in the requested manner (as specified in ListType). The resources must also meet the additional criteria, if specified. Click here for more information. |
Response Usage Example(s)
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <PwsGetOnBehalfOfResourcesResponse xmlns="http://projectorpsa.com/PwsProjectorServices/"> <PwsGetOnBehalfOfResourcesResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/> <ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId> <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status> <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-12T14:57:19.319861Z</ServerTimestampUtc> <a:Resources xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"> <b:PwsOnBehalfOfResource> <b:ResourceDisplayName>Bruce Wayne</b:ResourceDisplayName> <b:ResourceId i:nil="true"/> <b:ResourceReferenceSystemId>BW-01</b:ResourceReferenceSystemId> <b:ResourceUid>1152921504606968725</b:ResourceUid> <b:EmailAddress>bruce@revcorp.doc</b:EmailAddress> <b:FirstName>Bruce</b:FirstName> <b:LastName>Wayne</b:LastName> <b:MiddleName i:nil="true"/> <PwsGetOnBehalfOfResourcesResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <b:InactiveFlag>false</b:InactiveFlag> <Messages xmlns="http<b://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>DashboardOboFlag>true</b:DashboardOboFlag> <b:ExpenseReportingOboFlag>true</b:ExpenseReportingOboFlag> <ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId> <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status><b:TimeEntryOboFlag>true</b:TimeEntryOboFlag> <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-12T14:57:19.319861Z</ServerTimestampUtc> <b:TimeOffOboFlag>true</b:TimeOffOboFlag> <a:Resources xmlns<b:ShowBillableUtilizationOnDashboardFlag>true</b="http://projectorpsa.com/DataContracts/Shared/Common/">:ShowBillableUtilizationOnDashboardFlag> <b:ShowChargeableUtilizationOnDashboardFlag>true</b:PwsOnBehalfOfResource>ShowChargeableUtilizationOnDashboardFlag> <b:ResourceDisplayName>Bruce Wayne<ShowProductiveUtilizationOnDashboardFlag>true</b:ResourceDisplayName>ShowProductiveUtilizationOnDashboardFlag> <b:ResourceId i:nil="true"/> ShowTotalUtilizationOnDashboardFlag>true</b:ShowTotalUtilizationOnDashboardFlag> </b:PwsOnBehalfOfResource> <b:ResourceReferenceSystemId>BW-01</b:ResourceReferenceSystemId>PwsOnBehalfOfResource> <b:ResourceUid>1152921504606968725<ResourceDisplayName>Gabrielle Gonzalez</b:ResourceUid>ResourceDisplayName> <b:EmailAddress>bruce@revcorp.doc</b:EmailAddress>ResourceId i:nil="true"/> <b:FirstName>Bruce<ResourceReferenceSystemId>023</b:FirstName>ResourceReferenceSystemId> <b:LastName>Wayne<ResourceUid>1152921504606963004</b:LastName>ResourceUid> <b:MiddleName i:nil="true"/>EmailAddress>Gabrielle@revcorp.min.cnv1</b:EmailAddress> <b:InactiveFlag>false<FirstName>Gabrielle</b:InactiveFlag>FirstName> <b:DashboardOboFlag>true<LastName>Gonzalez</b:DashboardOboFlag>LastName> <b:ExpenseReportingOboFlag>true</b:ExpenseReportingOboFlag>MiddleName i:nil="true"/> <b:TimeEntryOboFlag>true<InactiveFlag>false</b:TimeEntryOboFlag>InactiveFlag> <b:TimeOffOboFlag>true<DashboardOboFlag>true</b:TimeOffOboFlag>DashboardOboFlag> <<b:ExpenseReportingOboFlag>true</b:PwsOnBehalfOfResource>ExpenseReportingOboFlag> <b:TimeEntryOboFlag>true</b:PwsOnBehalfOfResource>TimeEntryOboFlag> <b:ResourceDisplayName>Gabrielle Gonzalez<TimeOffOboFlag>true</b:ResourceDisplayName>TimeOffOboFlag> <b:ResourceId i:nil="true"/>ExpenseReportingOboSetting>U</b:ExpenseReportingOboSetting> <b:ResourceReferenceSystemId>023<TimeEntryOboSetting>U</b:ResourceReferenceSystemId>TimeEntryOboSetting> <b:ResourceUid>1152921504606963004<ShowBillableUtilizationOnDashboardFlag>true</b:ResourceUid>ShowBillableUtilizationOnDashboardFlag> <b:EmailAddress>Gabrielle@revcorp.min.cnv1<ShowChargeableUtilizationOnDashboardFlag>true</b:EmailAddress>ShowChargeableUtilizationOnDashboardFlag> <b:FirstName>Gabrielle<ShowProductiveUtilizationOnDashboardFlag>true</b:FirstName>ShowProductiveUtilizationOnDashboardFlag> <b:LastName>Gonzalez<ShowTotalUtilizationOnDashboardFlag>true</b:LastName>ShowTotalUtilizationOnDashboardFlag> </b:PwsOnBehalfOfResource> <b:MiddleName i:nil="true"/> </a:Resources> </PwsGetOnBehalfOfResourcesResult> <b:InactiveFlag>false</b:InactiveFlag></PwsGetOnBehalfOfResourcesResponse> </s:Body> </s:Envelope> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <b:DashboardOboFlag>true</b:DashboardOboFlag><s:Body> <PwsGetOnBehalfOfResourcesResponse xmlns="http://projectorpsa.com/PwsProjectorServices/"> <b:ExpenseReportingOboFlag>true</b:ExpenseReportingOboFlag><PwsGetOnBehalfOfResourcesResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <Messages <b:TimeEntryOboFlag>true</b:TimeEntryOboFlag> <b:TimeOffOboFlag>true</b:TimeOffOboFlag>xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/> <ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId> </b:PwsOnBehalfOfResource> </a:Resources> <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status> </PwsGetOnBehalfOfResourcesResult> </PwsGetOnBehalfOfResourcesResponse> </s:Body> </s:Envelope><ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-12T15:49:02.3452499Z</ServerTimestampUtc> | ||||||
Code Block | ||||||
| ||||||
<s:Envelope <a:Resources xmlns:sb="http://schemas.xmlsoap.org/soap/envelopeprojectorpsa.com/DataContracts/Shared/Common/"> <s:Body> <PwsGetOnBehalfOfResourcesResponse xmlns="http://projectorpsa.com/PwsProjectorServices/"><b:PwsOnBehalfOfResource> <PwsGetOnBehalfOfResourcesResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><b:ResourceDisplayName>Larry Krakauer</b:ResourceDisplayName> <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/><b:ResourceId i:nil="true"/> <ResponseId xmlns="http<b://projectorpsa.com/CommonServices/">0</ResponseId> ResourceReferenceSystemId>097</b:ResourceReferenceSystemId> <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status> <b:ResourceUid>1152921504606963016</b:ResourceUid> <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-12T15:49:02.3452499Z</ServerTimestampUtc> <a:Resources xmlns<b:b="http://projectorpsa.com/DataContracts/Shared/Common/">EmailAddress>Larry@revcorp.doc</b:EmailAddress> <b:FirstName>Larry</b:PwsOnBehalfOfResource>FirstName> <b:ResourceDisplayName>Larry Krakauer<LastName>Krakauer</b:ResourceDisplayName>LastName> <b:ResourceId i:nil="true"/>MiddleName>A</b:MiddleName> <b:ResourceReferenceSystemId>097<InactiveFlag>false</b:ResourceReferenceSystemId>InactiveFlag> <b:ResourceUid>1152921504606963016<DashboardOboFlag>false</b:ResourceUid>DashboardOboFlag> <b:EmailAddress>Larry@revcorp.doc<ExpenseReportingOboFlag>false</b:EmailAddress>ExpenseReportingOboFlag> <b:FirstName>Larry<TimeEntryOboFlag>true</b:FirstName>TimeEntryOboFlag> <b:LastName>Krakauer<TimeOffOboFlag>false</b:LastName>TimeOffOboFlag> <b:MiddleName>A<ExpenseReportingOboSetting>U</b:MiddleName>ExpenseReportingOboSetting> <b:InactiveFlag>false<TimeEntryOboSetting>U</b:InactiveFlag>TimeEntryOboSetting> <b:DashboardOboFlag>false<ShowBillableUtilizationOnDashboardFlag>true</b:DashboardOboFlag>ShowBillableUtilizationOnDashboardFlag> <b:ExpenseReportingOboFlag>false<ShowChargeableUtilizationOnDashboardFlag>true</b:ExpenseReportingOboFlag>ShowChargeableUtilizationOnDashboardFlag> <b:TimeEntryOboFlag>true<ShowProductiveUtilizationOnDashboardFlag>true</b:TimeEntryOboFlag>ShowProductiveUtilizationOnDashboardFlag> <b:TimeOffOboFlag>false<ShowTotalUtilizationOnDashboardFlag>true</b:TimeOffOboFlag>ShowTotalUtilizationOnDashboardFlag> </b:PwsOnBehalfOfResource> </a:Resources> </PwsGetOnBehalfOfResourcesResult> </PwsGetOnBehalfOfResourcesResponse> </s:Body> </s:Envelope> |
PwsGetOnBehalfofResourceResult - Common Errors and Warnings
- For all errors and warnings please refer to the Complete List of Errors and Warnings
...