Overview

This web service inserts or updates a single resource's history record (PwsResourceHistor) for a specified resource (PwsResourceRef). The service returns the identity of the resource (PwsResourceRef) that has been updated.

Request Format

PwsSaveResourceHistory Request

PwsSaveResourceHistory
- serviceRequest: PwsSaveResourceHistoryRq
  - RequestId: Int32
  - SessionTicket: String
  - History: PwsResourceHistory[]
  - ResourceIdentity: PwsResourceRef
  - ResourceTimestamp: String
  - SetNullValuesFromResourceTypeFlag: Boolean

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	AaJ0FpWv/5xR3lRe/9G87g==
History	PwsResourceHistory[]	Yes		The resource history record
ResourceIdentity	PwsResourceRef	Yes		The resource identity
ResourceTimestamp	String	No		This is a Base64 encoded timestamp optionally utilized for resource locking
SetNullValuesFromResourceTypeFlag	Boolean	No	false	If set to 'true', resource attributes that are currently set to null will take on the values associated with the assigned resource type	false

Request Usage Example(s)

Example 01

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveResourceHistory>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AaJ0FpWv/5xR3lRe/9G87g==</req:SessionTicket>
            <req:History>
               <com:PwsResourceHistory>
                  <com:BeginDate>2018-11-01T00:00:00.000Z</com:BeginDate>
                  <com:Record>
                     <com:ActualHolidaysFlag>true</com:ActualHolidaysFlag>
                     <com:AllowApproveOwnTimecardsFlag>true</com:AllowApproveOwnTimecardsFlag>
                     <com:BillableFlag>true</com:BillableFlag>
                     <com:CostCenterIdentity>
                        <com:CostCenterName>IT Team (USA)</com:CostCenterName>
                        <com:CostCenterNumber>IT Team (USA)</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:ExpenseReportVendorIdentity>
                        <com:VendorName>Credit Card</com:VendorName>
                        <com:VendorNumber>Credit Card</com:VendorNumber>
                     </com:ExpenseReportVendorIdentity>
                     <com:InactiveFlag>false</com:InactiveFlag>
                     <com:LocationIdentity>
                        <com:LocationName>USA</com:LocationName>
                     </com:LocationIdentity>
                     <com:MissingTimeEmailFlag>true</com:MissingTimeEmailFlag>
                     <com:PayCategory>O</com:PayCategory>
                     <com:RdcException>
                        <com:CurrencyIdentity>
                           <com:CurrencyCode>USD</com:CurrencyCode>
                        </com:CurrencyIdentity>
                        <com:HourlyRate>55.15</com:HourlyRate>
                     </com:RdcException>
                     <com:ResourceTypeIdentity>
                        <com:ResourceTypeCode>FTE</com:ResourceTypeCode>
                        <com:ResourceTypeName>Full Time Employee</com:ResourceTypeName>
                     </com:ResourceTypeIdentity>
                     <com:ScheduledHolidaysFlag>false</com:ScheduledHolidaysFlag>
                     <com:TemporaryWorkerFlag>false</com:TemporaryWorkerFlag>
                     <com:TitleIdentity>
                        <com:DepartmentIdentity>
                           <com:DepartmentName>IT Team</com:DepartmentName>
                        </com:DepartmentIdentity>
                        <com:TitleName>Level 2</com:TitleName>
                     </com:TitleIdentity>
                     <com:TrackMissingTimeFlag>true</com:TrackMissingTimeFlag>
                     <com:WorkingScheduleOverrides>
                        <com:PwsResourceWorkingScheduleDay>
                           <com:DayOfWeek>Friday</com:DayOfWeek>
                           <com:StartTimeMinutesSinceMidnight>540</com:StartTimeMinutesSinceMidnight>
                           <com:WorkingMinutes>240</com:WorkingMinutes>
                        </com:PwsResourceWorkingScheduleDay>
                     </com:WorkingScheduleOverrides>
                  </com:Record>
               </com:PwsResourceHistory>
            </req:History>
            <req:ResourceIdentity>
               <com:ResourceDisplayName>Ben Smith</com:ResourceDisplayName>
               <com:ResourceReferenceSystemId>E1101</com:ResourceReferenceSystemId>
            </req:ResourceIdentity>
            <req:SetNullValuesFromResourceTypeFlag>false</req:SetNullValuesFromResourceTypeFlag>
         </pws:serviceRequest>
      </pws:PwsSaveResourceHistory>
   </soapenv:Body>
</soapenv:Envelope>

Response Format

PwsSaveResourceHistory Response

PwsSaveResourceHistoryResponse
- PwsSaveResourceHistoryResult: PwsSaveResourceHistoryRs
  - Messages: PwsMessage[]
  - ResponseId: Int32
  - Status: RequestStatus
  - ServerTimestampUtc: DateTime
  - History: PwsResourceHistory[1.100]
  - ResourceIdentity: PwsResourceRef
  - Timestamp: String

Response Elements

Element	Data Type	Description
Messages	PwsMessage[]	The web service response status and message. Click here for more information
ResponseId	Int32	Click here for more information
Status	RequestStatus	Click here for more information
ServerTimestampUtc	DateTime	Click here for more information
History	PwsResourceHistory[1..100]	This structure contains a resource's history record
ResourceIdentity	PwsResourceRef	This structure represents the unique key fields associated with identifying a resource.
Timestamp	String	This is a Base64 encoded timestamp optionally utilized for resource locking.