Versions Compared

Key

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

Overview


This web service transfers one or more time cards to another project and/or rate and/or role and/or project task

...

Panel
titlePwsTransferTime

...

Element

Data Type

Required?

Default

Description

Sample Data

RequestIdInt32No
Click here for more information
1
SessionTicket

String

Yes
Click here for more information
AWuKIeUvHQC5lNzuzE3Ugg==
AdjustRoleDatesAsNeededFlagBooleanNofalseIf set to true, the start and/or end date on any associated roles will be adjusted to accommodate the work date on the time card(s)
true
AdjustmentCodeIdentityPwsAdjustmentCodeRefNo
This structure represents the unique key fields associated with identifying an adjustment code. Adjustment codes are required whenever you make a monetary adjustment to a time or cost card.  This is not applicable to this service.
AdjustmentTypeStringYes

The type of time transfer adjustment to be applied. This must be one of the following values:

'TPT' for Transfer Time to Role

'TRT' for Transfer and Exclude Time

'CTT' for Change Task/Task Code


Explanation

String (1024)

No
An explanation as to why this adjustment was applied.
Transferring time to the active project
ReportOnlyFlagBooleanNo
If set to "true", the time card importing process is exercised, but not completed. If there is any error triggered during the importing process, it will be reported in the response.
false
TransferOrdersPwsTimeTransferOrder
Yes
This structure represents the nature of the time card transfer to be appliedtime cards that will be transferred

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:PwsTransferTime>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AWuKIeUvHQC5lNzuzE3Ugg==</req:SessionTicket>
            <tim:AdjustProjectRoleDatesAsNeededFlag>true</tim:AdjustProjectRoleDatesAsNeededFlag>
            <tim:AdjustmentCodeIdentity>
               <com:AdjustmentCodeName>Other</com:AdjustmentCodeName>
               <com:AdjustmentCodeUid>1152921504606858479</com:AdjustmentCodeUid>
            </tim:AdjustmentCodeIdentity>
            <tim:AdjustmentType>TPT</tim:AdjustmentType>
            <tim:Explanation>Transferring time to the active project</tim:Explanation>
            <tim:ReportOnlyFlag>false</tim:ReportOnlyFlag>
            <tim:TransferOrders>
               <tim:PwsTimeTransferOrder>
                  <tim:NewProjectIdentity>
                     <com:ProjectCode>P001556-001</com:ProjectCode>
                     <com:ProjectId>603784</com:ProjectId>
                     <com:ProjectUid>1152921504607450760</com:ProjectUid>
                  </tim:NewProjectIdentity>
                  <tim:NewProjectRateTypeIdentity>
                     <!--com:ExternalSystemIdentifier>?</com:ExternalSystemIdentifier-->
                     <com:ProjectRateTypeId>563091</com:ProjectRateTypeId>
                     <com:ProjectRateTypeUid>1152921504607410067</com:ProjectRateTypeUid>
                  </tim:NewProjectRateTypeIdentity>
                  <tim:NewProjectRoleIdentity>
                     <com:ExternalSystemIdentifier>?</com:ExternalSystemIdentifier>
                     <com:ProjectRoleId>2954826</com:ProjectRoleId>
                     <com:ProjectRoleUid>1152921504609801802</com:ProjectRoleUid>
                  </tim:NewProjectRoleIdentity>
                  <tim:NewProjectRoleName>Developer</tim:NewProjectRoleName>
                  <tim:NewProjectTaskIdentity>
                     <!--com:ExternalSystemIdentifier>?</com:ExternalSystemIdentifier-->
                     <com:ProjectTaskId>2093964</com:ProjectTaskId>
                     <com:ProjectTaskUid>1152921504608940940</com:ProjectTaskUid>
                  </tim:NewProjectTaskIdentity>
                  <tim:TimeCardIdentities>
                     <tim:PwsVersionedTimecardRef>
                        <!--com:ReferenceId>?</com:ReferenceId-->
                        <com:TimecardId>45639611</com:TimecardId>
                        <com:TimecardType>T</com:TimecardType>
                        <com:TimecardUid>1152921504652486587</com:TimecardUid>
                        <!--tim:Timestamp>?</tim:Timestamp-->
                     </tim:PwsVersionedTimecardRef>
                  </tim:TimeCardIdentities>
               </tim:PwsTimeTransferOrder>
            </tim:TransferOrders>
         </pws:serviceRequest>
      </pws:PwsTransferTime>
   </soapenv:Body>
</soapenv:Envelope>

...

Panel
titlePwsTransferTime Response

...