Versions Compared

Key

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

Overview


This web service updates the user defined fields on one or more time cards. 

...

Panel
titlePwsAdjustTimeUserDefinedField

...

Element

Data Type

Required?

Default

Description

Sample Data

RequestIdInt32No
Click here for more information
1
SessionTicket

String

Yes
Click here for more information
AWuKIeUvHQC5lNzuzE3Ugg==
AdjustmentCodeIdentityPwsAdjustmentCodeRefNo
This structure represents the unique key fields associated with identifying an adjustment code.
PwsTimeUdfAdjustmentOrderPwsTimeUdfAdjustmentOrderYes
This structure represents the fields associated with a time card user defined field adjustment
Explanation

String (1024)

No
An explanation as to why this adjustment was applied.
Time Card UDF update
UdfSortOrderInt32No
This identifies which UDF is being updated, since time cards can only have 2 User Defined Fields, this value must be 1 or 2.
1

Request Usage Example(s)

...

Code Block
languagexml
titleExample 01
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:PwsAdjustTimeUserDefinedField>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AWuKIeUvHQC5lNzuzE3Ugg==</req:SessionTicket>
            <tim:AdjustmentCodeIdentity>
               <com:AdjustmentCodeId>11503</com:AdjustmentCodeId>
               <com:AdjustmentCodeName>Other</com:AdjustmentCodeName>
               <com:AdjustmentCodeUid>1152921504606858479</com:AdjustmentCodeUid>
            </tim:AdjustmentCodeIdentity>
            <tim:AdjustmentOrders>
               <tim:PwsTimeUdfAdjustmentOrder>
                  <tim:NewValue>
                     <com:RelationValue>
                        <com:CodeValue>TC-Jira</com:CodeValue>
                        <com:TextValue>SD-23</com:TextValue>
                        <com:UidValue>1152921504606857618</com:UidValue>
                     </com:RelationValue>
                  </tim:NewValue>
                  <tim:TimeCardIdentities>
                     <tim:PwsVersionedTimecardRef>
                        <com:TimecardId>45639608</com:TimecardId>
                        <com:TimecardType>T</com:TimecardType>
                        <com:TimecardUid>1152921504652486584</com:TimecardUid>
                     </tim:PwsVersionedTimecardRef>
                  </tim:TimeCardIdentities>
               </tim:PwsTimeUdfAdjustmentOrder>
            </tim:AdjustmentOrders>
            <tim:Explanation>Time Card UDF update</tim:Explanation>
            <tim:UdfSortOrder>1</tim:UdfSortOrder>
         </pws:serviceRequest>
      </pws:PwsAdjustTimeUserDefinedField>
   </soapenv:Body>
</soapenv:Envelope>

Response Format


Panel
titlePwsAdjustTimeUserDefinedField response

Response Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsAdjustTimeUserDefinedFieldResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsAdjustTimeUserDefinedFieldResult 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/">1</ResponseId>
            <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2019-11-07T18:49:15.1180888Z</ServerTimestampUtc>
            <a:TimeCardIdentities xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsTimecardRef>
                  <b:ReferenceId i:nil="true"/>
                  <b:TimecardId>45639608</b:TimecardId>
                  <b:TimecardType>T</b:TimecardType>
                  <b:TimecardUid>1152921504652486584</b:TimecardUid>
               </b:PwsTimecardRef>
            </a:TimeCardIdentities>
         </PwsAdjustTimeUserDefinedFieldResult>
      </PwsAdjustTimeUserDefinedFieldResponse>
   </s:Body>
</s:Envelope>


PwsAdjustTimeUserDefinedField - Common Errors and Warnings


ErrorNumber

ErrorCode

ErrorText

10117ValueOutOfRangeThe value specified in the field "UdfSortOrder" in the class "PwsAdjustTimeUserDefinedFieldRq" is out of range. The value must be between 1 and 2.
50024EntityNotFoundTime Card was not found. Another user may have deleted it.
64365OneOrMoreTimeCardsIneligibleForAdjustment

Adjustment cannot be completed because one or more cards has changed or is ineligible for adjustment.