Versions Compared

Version Old Version 8 New Version Current
Changes made by

Min Zeng

Bettina Borces

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This web service retrieves one or a list of client locationlocations (PwsClientDetailPwsLocationSummary) , based upon a list of unique client identifiers (PwsClientRef).based on specified search criteria.  

Request Format


Panel
titlePwsGetLocations Request
  • PwsGetLocations
    • serviceRequest: PwsGetLocationsRq

...

Element

Data Type

Required?

Default

Description

Sample Data

RequestId

Int32

No


Click here for more information.


SessionTicket

String

Yes


Click here for more information.

ARNkL4C1bp7KLtsSXQW6/g==

IncludeInactiveFlag

Boolean

No

false

false

ListType

String (1)

Yes

The type of the location listIf set to 'true', both inactive and active locations will be returned in the response. Otherwise, only active locations are returned. Locations explicitly marked inactive, as well as locations that are not active for the specified list type (see ListType parameter) are considered to be inactive.

false

ListType

String (1)

Yes


The type of locations to retrieve:

C: enabled for cost

T: enabled for time

T

LocationIdentity

PwsLocationRef

No

MaximumRows


A set of unique key fields of a location. Specify a value here to retrieve a specific location. Click here for more information.


MaximumRows

Int32

No


If not set, the complete list of locations that fits fit the search criteria will be returned in the response.

10

SearchString

String (255)

No


A search string to narrow down the results. A location will be included in the results if the search string matches the location name. This value is disregarded if a location is specified in LocationIdentity.


Request Usage Example(s)

...

Code Block
languagexml
titleExample 01 - without location identity
collapsetrue
<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:PwsGetLocations>
         <pws:serviceRequest>
            <req:SessionTicket>ARNkL4C1bp7KLtsSXQW6/g==</req:SessionTicket>
            <tim:IncludeInactiveFlag>true</tim:IncludeInactiveFlag>
            <tim:ListType>T</tim:ListType>
            <tim:MaximumRows>10</tim:MaximumRows>
            <tim:SearchString>on</tim:SearchString>
         </pws:serviceRequest>
      </pws:PwsGetLocations>
   </soapenv:Body>
</soapenv:Envelope>


Code Block

...

panel
language

...

ServerTimestampUtc

...

DateTime

...

Click here for more information.

...

Locations

...

PwsLocationSummary

Response Usage Example(s)

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <PwsGetLocationsResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
Code Block
languagexml
titleExample 01 - without location identity
collapsetrue
xml
titlePwsGetLocations Response

Response Elements

...

Element

...

Data Type

...

Description

...

Sample Data

...

Messages

...

PwsMessage

...

ResponseId

...

Int32

...

Click here for more information.

...

Status

...

Example 02 - with location identity
collapsetrue
<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:PwsGetLocations>
         <pws:serviceRequest>
            <req:SessionTicket>ARNkL4C1bp7KLtsSXQW6/g==</req:SessionTicket>
            <tim:IncludeInactiveFlag>true</tim:IncludeInactiveFlag>
            <tim:ListType>T</tim:ListType>
            <tim:LocationIdentity>
               <com:LocationName>London</com:LocationName>
            </tim:LocationIdentity>
            <tim:MaximumRows>10</tim:MaximumRows>
         </pws:serviceRequest>
      </pws:PwsGetLocations>
   </soapenv:Body>
</soapenv:Envelope>


Response Format


Panel
titlePwsGetLocations Response

Response Elements


Element

Data Type

Description

Sample Data

Messages

PwsMessage[]

The web service response status and message. Click here for more information


ResponseId

Int32

Click here for more information.

0

Status

RequestStatusClick here for more informationOk

ServerTimestampUtc

DateTime

Click here for more information.

2018-03-07T18:49:19.6612047Z

Locations

PwsLocationSummary[]

The set of basic information about a location. Click here for more information.



Response Usage Example(s)


Code Block
languagexml
titleExample 01 - without location identity
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsGetLocationsResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsGetLocationsResult 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-07T18:49:19.6612047Z</ServerTimestampUtc>
            <a:Locations xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsLocationSummary>
                  <b:LocationId i:nil="true"/>
                  <b:LocationName>Boston</b:LocationName>
                  <b:LocationUid>1152921504606852816</b:LocationUid>
                  <b:CurrencyIdentity>
                     <b:CurrencyCode>USD</b:CurrencyCode>
                     <b:CurrencyId i:nil="true"/>
                     <b:CurrencyUid>1152921504606849879</b:CurrencyUid>
                  </b:CurrencyIdentity>
                  <b:InactiveFlag>false</b:InactiveFlag>
                  <b:MileageUom>M</b:MileageUom>
                  <b:OpsCurrencyIdentity>
                     <b:OpsCurrencyCode>USD</b:OpsCurrencyCode>
                     <b:OpsCurrencyId i:nil="true"/>
                  </b:OpsCurrencyIdentity>
                  <b:EnabledForCostcardsFlag>true</b:EnabledForCostcardsFlag>
                  <b:EnabledForProjectsFlag>true</b:EnabledForProjectsFlag>
                  <b:EnabledForResourcesFlag>true</b:EnabledForResourcesFlag>
                  <b:EnabledForTimecardsFlag>true</b:EnabledForTimecardsFlag>
               </b:PwsLocationSummary>
               <b:PwsLocationSummary>
                 <PwsGetLocationsResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><b:LocationId i:nil="true"/>
                 <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/><b:LocationName>Location using LAK</b:LocationName>
                  <b:LocationUid>1152921504606855808</b:LocationUid>
                 <ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId><b:CurrencyIdentity>
                 <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>   <b:CurrencyCode>LAK</b:CurrencyCode>
         <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-07T18:49:19.6612047Z</ServerTimestampUtc>             <a<b:LocationsCurrencyId xmlnsi:bnil="true"http://projectorpsa.com/DataContracts/Shared/Common/">/>
                     <b:CurrencyUid>1152921504606851801</b:PwsLocationSummary>CurrencyUid>
                  <b</b:LocationId i:nil="true"/>CurrencyIdentity>
                   <b:LocationName>Boston<InactiveFlag>true</b:LocationName>InactiveFlag>
                  <b:LocationUid>1152921504606852816<MileageUom>M</b:LocationUid>MileageUom>
                  <b:CurrencyIdentity>OpsCurrencyIdentity>
                     <b:CurrencyCode>USD<OpsCurrencyCode>LAK</b:CurrencyCode>OpsCurrencyCode>
                     <b:CurrencyIdOpsCurrencyId i:nil="true"/>
                     <b:CurrencyUid>1152921504606849879<</b:CurrencyUid>OpsCurrencyIdentity>
                  <<b:EnabledForCostcardsFlag>true</b:CurrencyIdentity>EnabledForCostcardsFlag>
                  <b:InactiveFlag>false<EnabledForProjectsFlag>true</b:InactiveFlag>EnabledForProjectsFlag>
                  <b:MileageUom>M<EnabledForResourcesFlag>true</b:MileageUom>EnabledForResourcesFlag>
                  <b:EnabledForTimecardsFlag>true</b:OpsCurrencyIdentity>EnabledForTimecardsFlag>
                     <b:OpsCurrencyCode>USD<</b:OpsCurrencyCode>
   PwsLocationSummary>
                 <b:OpsCurrencyId i:nil="true"/>PwsLocationSummary>
                   </b:OpsCurrencyIdentity><b:LocationId i:nil="true"/>
                  <b:EnabledForCostcardsFlag>true<LocationName>Location using Won</b:EnabledForCostcardsFlag>LocationName>
                  <b:EnabledForProjectsFlag>true<LocationUid>1152921504606855807</b:EnabledForProjectsFlag>LocationUid>
                  <b:EnabledForResourcesFlag>true</b:EnabledForResourcesFlag>CurrencyIdentity>
                     <b:EnabledForTimecardsFlag>true<CurrencyCode>KRW</b:EnabledForTimecardsFlag>CurrencyCode>
                      </b:PwsLocationSummary><b:CurrencyId i:nil="true"/>
                     <b:CurrencyUid>1152921504606851800</b:PwsLocationSummary>CurrencyUid>
                  <b:LocationId i:nil="true"/></b:CurrencyIdentity>
                  <b:LocationName>Location using LAK<InactiveFlag>true</b:LocationName>InactiveFlag>
                  <b:LocationUid>1152921504606855808<MileageUom>M</b:LocationUid>MileageUom>
                  <b:CurrencyIdentity>OpsCurrencyIdentity>
                     <b:CurrencyCode>LAK<OpsCurrencyCode>KRW</b:CurrencyCode>OpsCurrencyCode>
                     <b:CurrencyIdOpsCurrencyId i:nil="true"/>
                     <b:CurrencyUid>1152921504606851801<</b:CurrencyUid>OpsCurrencyIdentity>
                  <<b:EnabledForCostcardsFlag>true</b:CurrencyIdentity>EnabledForCostcardsFlag>
                  <b:InactiveFlag>true<EnabledForProjectsFlag>true</b:InactiveFlag>EnabledForProjectsFlag>
                  <b:MileageUom>M<EnabledForResourcesFlag>true</b:MileageUom>EnabledForResourcesFlag>
                  <b:EnabledForTimecardsFlag>true</b:EnabledForTimecardsFlag>
          <b:OpsCurrencyIdentity>      </b:PwsLocationSummary>
               <b:OpsCurrencyCode>LAK</b:OpsCurrencyCode>PwsLocationSummary>
                     <b:OpsCurrencyIdLocationId i:nil="true"/>
                  <<b:LocationName>London</b:OpsCurrencyIdentity>LocationName>
                  <b:EnabledForCostcardsFlag>true<LocationUid>1152921504606850976</b:EnabledForCostcardsFlag>LocationUid>
                  <b:EnabledForProjectsFlag>true</b:EnabledForProjectsFlag>CurrencyIdentity>
                     <b:EnabledForResourcesFlag>true<CurrencyCode>GBP</b:EnabledForResourcesFlag>
 CurrencyCode>
                <b:EnabledForTimecardsFlag>true</b:EnabledForTimecardsFlag>                </b:PwsLocationSummary><b:CurrencyId i:nil="true"/>
                     <b:PwsLocationSummary>CurrencyUid>1152921504606849882</b:CurrencyUid>
                  <b:LocationId i:nil="true"/></b:CurrencyIdentity>
                  <b:LocationName>Location using Won<InactiveFlag>false</b:LocationName>InactiveFlag>
                  <b:LocationUid>1152921504606855807<MileageUom>M</b:LocationUid>MileageUom>
                  <b:CurrencyIdentity>OpsCurrencyIdentity>
                     <b:CurrencyCode>KRW<OpsCurrencyCode>GBP</b:CurrencyCode>OpsCurrencyCode>
                     <b:CurrencyIdOpsCurrencyId i:nil="true"/>
                  </b:OpsCurrencyIdentity>
                  <b:CurrencyUid>1152921504606851800<EnabledForCostcardsFlag>true</b:CurrencyUid>EnabledForCostcardsFlag>
                  <<b:EnabledForProjectsFlag>true</b:CurrencyIdentity>EnabledForProjectsFlag>
                  <b:InactiveFlag>true<EnabledForResourcesFlag>false</b:InactiveFlag>EnabledForResourcesFlag>
                  <b:MileageUom>M<EnabledForTimecardsFlag>true</b:MileageUom>EnabledForTimecardsFlag>
               </b:PwsLocationSummary>
   <b:OpsCurrencyIdentity>         </a:Locations>
         </PwsGetLocationsResult>
      <b:OpsCurrencyCode>KRW</b:OpsCurrencyCode></PwsGetLocationsResponse>
   </s:Body>
   </s:Envelope>


Code Block
languagexml
titleExample 02 - with location identity
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
         <b:OpsCurrencyId i:nil="true"/<PwsGetLocationsResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsGetLocationsResult         </b:OpsCurrencyIdentity>xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Messages      <b:EnabledForCostcardsFlag>true</b:EnabledForCostcardsFlag>
  xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
               <b:EnabledForProjectsFlag>true</b:EnabledForProjectsFlag><ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId>
                  <b:EnabledForResourcesFlag>true</b:EnabledForResourcesFlag><Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
                  <b:EnabledForTimecardsFlag>true</b:EnabledForTimecardsFlag><ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-13T15:39:07.5601224Z</ServerTimestampUtc>
               </b:PwsLocationSummary><a:Locations xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsLocationSummary>
                  <b:LocationId i:nil="true"/>
                  <b:LocationName>London</b:LocationName>
                  <b:LocationUid>1152921504606850976</b:LocationUid>
                  <b:CurrencyIdentity>
                     <b:CurrencyCode>GBP</b:CurrencyCode>
                     <b:CurrencyId i:nil="true"/>
                     <b:CurrencyUid>1152921504606849882</b:CurrencyUid>
                  </b:CurrencyIdentity>
                  <b:InactiveFlag>false</b:InactiveFlag>
                  <b:MileageUom>M</b:MileageUom>
                  <b:OpsCurrencyIdentity>
                     <b:OpsCurrencyCode>GBP</b:OpsCurrencyCode>
                     <b:OpsCurrencyId i:nil="true"/>
                  </b:OpsCurrencyIdentity>
                  <b:EnabledForCostcardsFlag>true</b:EnabledForCostcardsFlag>
                  <b:EnabledForProjectsFlag>true</b:EnabledForProjectsFlag>
                  <b:EnabledForResourcesFlag>false</b:EnabledForResourcesFlag>
                  <b:EnabledForTimecardsFlag>true</b:EnabledForTimecardsFlag>
               </b:PwsLocationSummary>
            </a:Locations>
         </PwsGetLocationsResult>
      </PwsGetLocationsResponse>
   </s:Body>
</s:Envelope>

Common Errors and Warnings

...

ErrorNumberErrorCodeErrorText
57541LocationNotFoundSpecified location does not exist.
64223InvalidValueForListTypeThe specified value for ListType is invalid. Valid values are T for time or C for cost.

...