Versions Compared

Version Old Version 2 New Version 3
Changes made by

Bettina Borces

Bettina Borces

Saved on

Key

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

Overview

This web service saves changes to time cards. This service should be used to save changes to existing time cards, to insert new time cards or to delete time cards. It is also capable of saving estimates (remaining minutes), saving task notes and performing a submit operation.
The service is written such that a failure to save or delete a time card or time off card, or to save an estimate or task note, will not prevent the saving of other changes, however any failure to save will prevent the submit from occurring, even if the service requests it. Individual errors processing time cards, time off cards, estimates and task notes are reported in the response.

Request Format

Panel
titlePwsSaveTimeCards Request

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.

...

AdministratorComments

...

String

...

No

...

Administrator comments for entering time on behalf of others

...

DeleteTimeCards

...

PwsTimeCardRef [???]

...

No

...

The identity of the time card(s) that will be deleted

...

DeleteTimeOffCards

...

PwsTimeCardRef [???]

...

No

...

The identity of the time off time card(s) that will be deleted

...

EndDate

...

DateTime

...

Yes

...

The EndDate defines the last work or time off date that affected time cards can be logged against. Only time cards with work or time off dates prior to this EndDate will be included when the web service is executed.

...

Estimates

...

PwsEstimate [???]

...

No

...

The estimate to complete for a given task. This is only applicable for time cards logged against a project with detailed task management.

...

InsertIfNotFoundOnUpdateFlag

...

Boolean

...

No

...

false

...

If set to 'true', the specified time card or time off time card details will be inserted as a new time card or time off time card if it does not currently exist

...

ResourceIdentity

...

PwsResourceRef

...

No - unless inserting a new time card

...

The identity of the resource associated with the time card or time off time card

...

SaveTimeCards

...

PwsTimeCardDetail [???]

...

No - unless inserting a new time card

...

The details of the time card to be saved / updated

...

SaveTimeOffCards

...

PwsTimeOffCardDetail [???]

...

No - unless inserting a new time off time card

...

The details of the time off time card to be saved / updated

...

SendNotificationEmailFlag

...

Boolean

...

No

...

false

...

If set to 'true', a notification email will be sent to the resource associated with the time card. This is applicable only when entering time on behalf of others.

...

StartDate

...

DateTime

...

Yes

...

Overview


This web service saves changes to time cards. This service should be used to save changes to existing time cards, to insert new time cards or to delete time cards. It is also capable of saving estimates (remaining minutes), saving task notes and performing a submit operation.
The service is written such that a failure to save or delete a time card or time off card, or to save an estimate or task note, will not prevent the saving of other changes, however any failure to save will prevent the submit from occurring, even if the service requests it. Individual errors processing time cards, time off cards, estimates and task notes are reported in the response.

Request Format


Panel
titlePwsSaveTimeCards Request

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.

AUtZcJgtdfVGhgjNekiP9w==

AdministratorComments

String

No


Administrator comments for entering time on behalf of others

Web Service Testing

DeleteTimeCards

PwsTimeCardRef [???]

No


The identity of the time card(s) that will be deleted


DeleteTimeOffCards

PwsTimeCardRef [???]

No


The identity of the time off time card(s) that will be deleted


EndDate

DateTime

Yes


The EndDate defines the last work or time off date that affected time cards can be logged against. Only time cards with work or time off dates after prior to this StartDate EndDate will be included when the web service is executed.

SubmitFlag

Boolean
2018-03-31T00:00:00.000Z

Estimates

PwsEstimate [???]

No

false

If set to 'true', a submit operation will be performed as part of this request. To submit a specific time card or time off card, use SubmitTimeCardIdentity.


Tasks

PwsProjectTaskNote [???]

No

Notes to be saved with the task associated with the time card

SubmitSavedCardsOnlyFlagThe estimate to complete for a given task. This is only applicable for time cards logged against a project with detailed task management.


InsertIfNotFoundOnUpdateFlag

Boolean

No

false

If set to 'true', draft time cards associated with the provided resource identity will be submitted

SubmitTimeCardIdentity

PwsTimeCardRef

No

The specific time card(s) to be submitted, see SubmitFlag

PreserveTimeCardStatusFlag

Boolean

No

false

If set to 'true', the time card status of the affected time card(s) will be preserved

Request Usage Example(s)

...

languagexml
titleExample 01 - saving a new time card
collapsetrue

...

the specified time card or time off time card details will be inserted as a new time card or time off time card if it does not currently exist

true

ResourceIdentity

PwsResourceRef

No - unless inserting a new time card


The identity of the resource associated with the time card or time off time card


SaveTimeCards

PwsTimeCardDetail [???]

No - unless inserting a new time card


The details of the time card to be saved / updated


SaveTimeOffCards

PwsTimeOffCardDetail [???]

No - unless inserting a new time off time card


The details of the time off time card to be saved / updated


SendNotificationEmailFlag

Boolean

No

false

If set to 'true', a notification email will be sent to the resource associated with the time card. This is applicable only when entering time on behalf of others.

false

StartDate

DateTime

Yes


The StartDate defines the first work or time off date that affected time cards can be logged against. Only time cards with work or time off dates after this StartDate will be included when the web service is executed.

2018-03-09T00:00:00.000Z

SubmitFlag

Boolean

No

false

If set to 'true', a submit operation will be performed as part of this request. To submit a specific time card or time off card, use SubmitTimeCardIdentity.

true

Tasks

PwsProjectTaskNote [???]

No


Notes to be saved with the task associated with the time card


SubmitSavedCardsOnlyFlag

Boolean

No

false

If set to 'true', draft time cards associated with the provided resource identity will be submitted

true

SubmitTimeCardIdentity

PwsTimeCardRef

No


The specific time card(s) to be submitted, see SubmitFlag


PreserveTimeCardStatusFlag - deprecated

Boolean

*** deprecated ***


*** deprecated ***


Request Usage Example(s)


Code Block
languagexml
titleExample 01 - saving a new time card
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:PwsSaveTimeCards>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AUtZcJgtdfVGhgjNekiP9w==</req:SessionTicket>
            <tim:AdministratorComments>Web Service Testing</tim:AdministratorComments>
            <tim:EndDate>2018-03-31T00:00:00.000Z</tim:EndDate>
            <tim:Estimates>
               <tim:PwsEstimate>
                  <tim:AsOfDate>2018-03-09T00:00:00.000Z</tim:AsOfDate>
                  <tim:CompletedFlag>false</tim:CompletedFlag>
                  <tim:ProjectTaskRoleIdentity>
                     <com:ProjectRoleIdentity>
                        <com:ProjectRoleUid>1152921504609525049</com:ProjectRoleUid>
                     </com:ProjectRoleIdentity>
                     <com:ProjectTaskIdentity>
                        <com:ProjectTaskUid>1152921504608637344</com:ProjectTaskUid>
                     </com:ProjectTaskIdentity>
                     <com:ProjectTaskRoleUid>1152921504608549426</com:ProjectTaskRoleUid>
                  </tim:ProjectTaskRoleIdentity>
                  <tim:RemainingMinutes>360</tim:RemainingMinutes>
               </tim:PwsEstimate>
            </tim:Estimates>
            <tim:InsertIfNotFoundOnUpdateFlag>true</tim:InsertIfNotFoundOnUpdateFlag>
            <tim:ResourceIdentity>
               <com:ResourceReferenceSystemId>E123</com:ResourceReferenceSystemId>
            </tim:ResourceIdentity>
            <tim:SaveTimeCards>
               <tim:PwsTimecardDetail>
                  <com:TimecardType>T</com:TimecardType>
                  <tim:DescriptionClearFlag>false</tim:DescriptionClearFlag>
                  <tim:Status>Submitted</tim:Status>
                  <tim:WorkDate>2018-03-09T00:00:00.000Z</tim:WorkDate>
                  <tim:WorkMinutes>60</tim:WorkMinutes>
                  <tim:CardStatus>Submitted</tim:CardStatus>
                  <tim:LocationClearFlag>false</tim:LocationClearFlag>
                  <tim:LocationIdentity>
                     <com:LocationName>USA</com:LocationName>
                  </tim:LocationIdentity>
                  <tim:ProjectIdentity>
                     <com:ProjectCode>P001396-001</com:ProjectCode>
                  </tim:ProjectIdentity>
                  <tim:ProjectRateTypeIdentity>
                     <com:ProjectRateTypeUid>1152921504607370468</com:ProjectRateTypeUid>
                  </tim:ProjectRateTypeIdentity>
                  <tim:ProjectTaskIdentity>
                     <com:ProjectTaskUid>1152921504608637344</com:ProjectTaskUid>
                  </tim:ProjectTaskIdentity>
                  <tim:RoleClearFlag>false</tim:RoleClearFlag>
                  <tim:RoleIdentity>
                     <com:ProjectRoleUid>1152921504609525049</com:ProjectRoleUid>
                  </tim:RoleIdentity>
                  <tim:Udf1ClearFlag>false</tim:Udf1ClearFlag>
                  <tim:Udf2ClearFlag>false</tim:Udf2ClearFlag>
                  <tim:ExternalGroupingIdentifierClearFlag>false</tim:ExternalGroupingIdentifierClearFlag>
               </tim:PwsTimecardDetail>
            </tim:SaveTimeCards>
            <tim:SendNotificationEmailFlag>false</tim:SendNotificationEmailFlag>
            <tim:StartDate>2018-03-09T00:00:00.000Z</tim:StartDate>
            <tim:SubmitFlag>true</tim:SubmitFlag>
            <tim:Tasks>
               <tim:PwsProjectTaskNote>
                  <tim:Notes>Added via the web service</tim:Notes>
                  <tim:ProjectTaskIdentity>
                     <com:ProjectTaskUid>1152921504608637344</com:ProjectTaskUid>
                  </tim:ProjectTaskIdentity>
                  <tim:EmailPmTeamFlag>false</tim:EmailPmTeamFlag>
               </tim:PwsProjectTaskNote>
            </tim:Tasks>
            <tim:SubmitSavedCardsOnlyFlag>false</tim:SubmitSavedCardsOnlyFlag>
            <tim:PreserveTimeCardStatusFlag>true</tim:PreserveTimeCardStatusFlag>
         </pws:serviceRequest>
      </pws:PwsSaveTimeCards>
   </soapenv:Body>
</soapenv:Envelope>
Code Block
languagexml
titleExample 02 - saving a new time off time card
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:PwsSaveTimeCards>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AUtZcJgtdfVGhgjNekiP9w==</req:SessionTicket>
            <tim:AdministratorComments>Web Service Testing</tim:AdministratorComments>
            <tim:EndDate>2018-03-31T00:00:00.000Z</tim:EndDate>
            <tim:InsertIfNotFoundOnUpdateFlag>true</tim:InsertIfNotFoundOnUpdateFlag>
            <tim:ResourceIdentity>
               <com:ResourceReferenceSystemId>E123</com:ResourceReferenceSystemId>
            </tim:ResourceIdentity>
            <tim:SaveTimeOffCards>
               <tim:PwsTimeOffCardDetail>
                  <tim:Description>Vacation Day</tim:Description>
                  <tim:DescriptionClearFlag>false</tim:DescriptionClearFlag>
                  <tim:Status>Draft</tim:Status>
                  <tim:WorkDate>2018-03-21T00:00:00.000Z</tim:WorkDate>
                  <tim:WorkMinutes>480</tim:WorkMinutes>
                  <tim:CardStatus>D</tim:CardStatus>
                  <tim:TimeOffReasonIdentity>
                     <com:TimeOffReasonName>Vacation</com:TimeOffReasonName>
                  </tim:TimeOffReasonIdentity>
               </tim:PwsTimeOffCardDetail>
            </tim:SaveTimeOffCards>
            <tim:SendNotificationEmailFlag>false</tim:SendNotificationEmailFlag>
            <tim:StartDate>2018-03-09T00:00:00.000Z</tim:StartDate>
            <tim:SubmitFlag>true</tim:SubmitFlag>
            <tim:Tasks>
               <tim:PwsProjectTaskNote>
                  <tim:Notes>Added via the web service</tim:Notes>
                  <tim:ProjectTaskIdentity>
                     <com:ProjectTaskUid>1152921504608637344</com:ProjectTaskUid>
                  </tim:ProjectTaskIdentity>
                  <tim:EmailPmTeamFlag>false</tim:EmailPmTeamFlag>
               </tim:PwsProjectTaskNote>
            </tim:Tasks>
            <tim:SubmitSavedCardsOnlyFlag>false</tim:SubmitSavedCardsOnlyFlag>
         </pws:serviceRequest>
      </pws:PwsSaveTimeCards>
   </soapenv:Body>
</soapenv:Envelope>
Code Block
languagexml
titleExample 03 - deleting a time card
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:PwsSaveTimeCards>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AUtZcJgtdfVGhgjNekiP9w==</req:SessionTicket>
            <tim:AdministratorComments>Web Service Testing</tim:AdministratorComments>
            <tim:DeleteTimeCards>
               <com:PwsTimecardRef>
                  <com:TimecardUid>1152921504646141266</com:TimecardUid>
               </com:PwsTimecardRef>
            </tim:DeleteTimeCards>
            <tim:EndDate>2018-03-31T00:00:00.000Z</tim:EndDate>
            <tim:ResourceIdentity>
               <com:ResourceReferenceSystemId>E123</com:ResourceReferenceSystemId>
            </tim:ResourceIdentity>
            <tim:SendNotificationEmailFlag>false</tim:SendNotificationEmailFlag>
            <tim:StartDate>2018-03-09T00:00:00.000Z</tim:StartDate>
            <tim:SubmitFlag>true</tim:SubmitFlag>
         </pws:serviceRequest>
      </pws:PwsSaveTimeCards>
   </soapenv:Body>
</soapenv:Envelope>


Response Format


Panel
titlePwsSaveTimeCards 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

1

Status

RequestStatus

Click here for more information


ServerTimestampUtc

DateTime

Click here for more information

2018-03-09T22:22:30.2317159Z

EstimateResults

PwsSaveEstimateResult [???]

The results from saving time card estimates


Locations

PwsLocationSummary [???]

The results from saving locations


SubmittedFlag

Boolean

If set to 'true', the time card has a status of submitted

true

TaskNoteResults

PwsSaveTaskNoteResult [???]

The results from saving task notes


TimeOffCardResults

PwsSaveTimeOffCardResult [???]

The results from saving time off time cards


TimecardResults

PwsSaveTimeCardResult [???]

The results from saving time cards


Response Usage Example(s)


Code Block
languagexml
titleExample 01 - saving a new time card
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsSaveTimeCardsResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsSaveTimeCardsResult 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/">2018-03-09T22:22:30.2317159Z</ServerTimestampUtc>
            <a:EstimateResults>
               <a:PwsSaveEstimateResult>
                  <a:ErrorDetail i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                  <a:Estimates>
                     <a:PwsProjectTaskRoleRemaining>
                        <a:CompletedFlag>false</a:CompletedFlag>
                        <a:RemainingAsOfDate>2018-03-09T00:00:00Z</a:RemainingAsOfDate>
                        <a:RemainingMinutes>360</a:RemainingMinutes>
                     </a:PwsProjectTaskRoleRemaining>
                  </a:Estimates>
                  <a:ReferenceId i:nil="true"/>
               </a:PwsSaveEstimateResult>
            </a:EstimateResults>
            <a:Locations xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsLocationSummary>
                  <b:LocationId i:nil="true"/>
                  <b:LocationName>USA</b:LocationName>
                  <b:LocationUid>1152921504606855985</b:LocationUid>
                  <b:CurrencyIdentity>
                     <b:CurrencyCode>USD</b:CurrencyCode>
                     <b:CurrencyId i:nil="true"/>
                     <b:CurrencyUid>1152921504606851838</b:CurrencyUid>
                  </b:CurrencyIdentity>
                  <b:InactiveFlag>false</b:InactiveFlag>
                  <pws:serviceRequest><b:MileageUom>M</b:MileageUom>
            <req:RequestId>1</req:RequestId>      <b:OpsCurrencyIdentity>
      <req:SessionTicket>AUtZcJgtdfVGhgjNekiP9w==</req:SessionTicket>             <tim:AdministratorComments>Web Service Testing<<b:OpsCurrencyCode>USD</tim:AdministratorComments>b:OpsCurrencyCode>
                     <tim:EndDate>2018-03-31T00:00:00.000Z</tim:EndDate><b:OpsCurrencyId i:nil="true"/>
                  <tim:Estimates></b:OpsCurrencyIdentity>
                  <tim:PwsEstimate><b:EnabledForCostcardsFlag>true</b:EnabledForCostcardsFlag>
                  <tim:AsOfDate>2018-03-09T00:00:00.000Z</tim:AsOfDate><b:EnabledForProjectsFlag>true</b:EnabledForProjectsFlag>
                  <tim<b:CompletedFlag>false<EnabledForResourcesFlag>true</timb:CompletedFlag>EnabledForResourcesFlag>
                  <tim:ProjectTaskRoleIdentity><b:EnabledForTimecardsFlag>true</b:EnabledForTimecardsFlag>
               </b:PwsLocationSummary>
            <com:ProjectRoleIdentity></a:Locations>
            <a:SubmittedFlag>true</a:SubmittedFlag>
            <com<a:ProjectRoleUid>1152921504609525049<TaskNoteResults/com:ProjectRoleUid>>
            <a:TimeOffCardResults/>
        </com:ProjectRoleIdentity>    <a:TimecardResults>
                 <com<a:ProjectTaskIdentity>PwsSaveTimecardResult>
                  <a:ErrorDetail      <com:ProjectTaskUid>1152921504608637344</com:ProjectTaskUid>i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                     </com:ProjectTaskIdentity><a:ReferenceId i:nil="true"/>
                     <com:ProjectTaskRoleUid>1152921504608549426</com:ProjectTaskRoleUid><a:TimeCard>
                  </tim:ProjectTaskRoleIdentity>   <ReferenceId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
             <tim:RemainingMinutes>360</tim:RemainingMinutes>        <TimecardId        </tim:PwsEstimate>i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
            </tim:Estimates>             <tim:InsertIfNotFoundOnUpdateFlag>true</tim:InsertIfNotFoundOnUpdateFlag><TimecardType xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">T</TimecardType>
            <tim:ResourceIdentity>                <com:ResourceReferenceSystemId>E123</com:ResourceReferenceSystemId>
            </tim:ResourceIdentity><TimecardUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504646141267</TimecardUid>
            <tim:SaveTimeCards>         <a:Description i:nil="true"/>
     <tim:PwsTimecardDetail>                   <com:TimecardType>T</com:TimecardType><a:DescriptionClearFlag>false</a:DescriptionClearFlag>
                  <tim:DescriptionClearFlag>false</tim:DescriptionClearFlag>   <a:RejectedByUser        i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
       <tim:Status>Submitted</tim:Status>              <a:RejectedReason i:nil="true"/>
   <tim:WorkDate>2018-03-09T00:00:00.000Z</tim:WorkDate>                  <a:RejectedTimestamp <tim:WorkMinutes>60</tim:WorkMinutes>i:nil="true"/>
                     <tim<a:CardStatus>Submitted<Status>Submitted</tim:CardStatus>a:Status>
                     <tim:LocationClearFlag>false</tim:LocationClearFlag><a:WorkDate>2018-03-09T00:00:00Z</a:WorkDate>
                     <tim:LocationIdentity><a:WorkMinutes>60</a:WorkMinutes>
                     <com<a:LocationName>USA<Timestamp>AAAAAA64Nro=</coma:LocationName>Timestamp>
                  </tim:LocationIdentity>   <a:CardStatus>S</a:CardStatus>
               <tim:ProjectIdentity>      <a:LocationClearFlag>false</a:LocationClearFlag>
               <com:ProjectCode>P001396-001</com:ProjectCode>         <a:LocationIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
         </tim:ProjectIdentity>               <b:LocationId i:nil="true"/>
  <tim:ProjectRateTypeIdentity>                      <com<b:ProjectRateTypeUid>1152921504607370468<LocationName>USA</com:ProjectRateTypeUid>b:LocationName>
                        <<b:LocationUid>1152921504606855985</tim:ProjectRateTypeIdentity>b:LocationUid>
                     <tim</a:ProjectTaskIdentity>LocationIdentity>
                     <com:ProjectTaskUid>1152921504608637344</com:ProjectTaskUid>
     <a:ProjectIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
            </tim:ProjectTaskIdentity>            <b:ProjectCode>P001396-001</b:ProjectCode>
      <tim:RoleClearFlag>false</tim:RoleClearFlag>                  <b:ProjectId <tim:RoleIdentity>i:nil="true"/>
                        <com<b:ProjectRoleUid>1152921504609525049<ProjectUid>1152921504607412210</com:ProjectRoleUid>b:ProjectUid>
                     </tim:RoleIdentity>a:ProjectIdentity>
                     <tim:Udf1ClearFlag>false</tim:Udf1ClearFlag><a:ProjectRateTypeIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:ExternalSystemIdentifier <tim:Udf2ClearFlag>false</tim:Udf2ClearFlag>i:nil="true"/>
                        <b:ProjectRateTypeId <tim:ExternalGroupingIdentifierClearFlag>false</tim:ExternalGroupingIdentifierClearFlag>i:nil="true"/>
               </tim:PwsTimecardDetail>         <b:ProjectRateTypeUid>1152921504607370468</b:ProjectRateTypeUid>
   </tim:SaveTimeCards>             <tim:SendNotificationEmailFlag>false</tim:SendNotificationEmailFlag>     </a:ProjectRateTypeIdentity>
       <tim:StartDate>2018-03-09T00:00:00.000Z</tim:StartDate>              <tim:SubmitFlag>true</tim:SubmitFlag><a:ProjectTaskIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
            <tim:Tasks>            <b:ExternalSystemIdentifier i:nil="true"/>
  <tim:PwsProjectTaskNote>                      <tim:Notes>Added via the web service</tim:Notes><b:ProjectTaskId i:nil="true"/>
                          <tim:ProjectTaskIdentity><b:ProjectTaskUid>1152921504608637344</b:ProjectTaskUid>
                     <com:ProjectTaskUid>1152921504608637344<</com:ProjectTaskUid>a:ProjectTaskIdentity>
                     <<a:RoleClearFlag>false</tima:ProjectTaskIdentity>RoleClearFlag>
                  <tim:EmailPmTeamFlag>false</tim:EmailPmTeamFlag>   <a:RoleIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
           </tim:PwsProjectTaskNote>             </tim:Tasks><b:ExternalSystemIdentifier i:nil="true"/>
            <tim:SubmitSavedCardsOnlyFlag>false</tim:SubmitSavedCardsOnlyFlag>            <b:ProjectRoleId <tim:PreserveTimeCardStatusFlag>true</tim:PreserveTimeCardStatusFlag>i:nil="true"/>
          </pws:serviceRequest>       </pws:PwsSaveTimeCards>    </soapenv:Body> </soapenv:Envelope>
Code Block
languagexml
titleExample 02 - saving a new time off time card
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 <b:ProjectRoleUid>1152921504609525049</b:ProjectRoleUid>
                     </a:RoleIdentity>
                     <a:Udf1 xmlns:b="http://projectorpsa.com/DataContracts/Shared/TimeAndCostCommon/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>>
                        <b:UdfId i:nil="true"/>
                        <b:UdfName>TC-Jira</b:UdfName>
              <pws:PwsSaveTimeCards>          <pws:serviceRequest><b:UdfUid>1152921504606857618</b:UdfUid>
            <req:RequestId>1</req:RequestId>            <b:BooleanValue <reqi:SessionTicket>AUtZcJgtdfVGhgjNekiP9w==</req:SessionTicket>nil="true"/>
            <tim:AdministratorComments>Web Service Testing</tim:AdministratorComments>             <tim:EndDate>2018-03-31T00:00:00.000Z</tim:EndDate><b:DataType>P</b:DataType>
            <tim:InsertIfNotFoundOnUpdateFlag>true</tim:InsertIfNotFoundOnUpdateFlag>            <b:DateValue <tim:ResourceIdentity>i:nil="true"/>
               <com:ResourceReferenceSystemId>E123</com:ResourceReferenceSystemId>         <b:IntegerValue i:nil="true"/>
  </tim:ResourceIdentity>             <tim:SaveTimeOffCards>         <b:ResourceIdentityValue i:nil="true"/>
     <tim:PwsTimeOffCardDetail>                   <tim<b:Description>Vacation Day</tim:Description>TextValue i:nil="true"/>
                        <tim<b:DescriptionClearFlag>false<UdfTreatment>A</timb:DescriptionClearFlag>UdfTreatment>
                  <tim:Status>Draft</tim:Status>      <b:StoplightValues/>
            <tim:WorkDate>2018-03-21T00:00:00.000Z</tim:WorkDate>            <b:NumericValue i:nil="true"/>
     <tim:WorkMinutes>480</tim:WorkMinutes>                   <tim:CardStatus>D</tim:CardStatus><b:RelationValue i:nil="true"/>
                     <tim</a:TimeOffReasonIdentity>Udf1>
                     <com<a:TimeOffReasonName>Vacation<Udf1ClearFlag>false</coma:TimeOffReasonName>Udf1ClearFlag>
                  </tim:TimeOffReasonIdentity>   <a:Udf2 xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
           </tim:PwsTimeOffCardDetail>             </tim<b:SaveTimeOffCards>
UdfId i:nil="true"/>
           <tim:SendNotificationEmailFlag>false</tim:SendNotificationEmailFlag>             <tim<b:StartDate>2018-03-09T00:00:00.000Z</tim:StartDate>UdfName>TC-Zendesk</b:UdfName>
                        <tim<b:SubmitFlag>true<UdfUid>1152921504606857619</tim:SubmitFlag>b:UdfUid>
               <tim:Tasks>         <b:BooleanValue i:nil="true"/>
     <tim:PwsProjectTaskNote>                   <tim:Notes>Added via the web service</tim:Notes><b:DataType>P</b:DataType>
                        <b:DateValue <tim:ProjectTaskIdentity>i:nil="true"/>
                        <com:ProjectTaskUid>1152921504608637344</com:ProjectTaskUid><b:IntegerValue i:nil="true"/>
                  </tim:ProjectTaskIdentity>        <b:ResourceIdentityValue i:nil="true"/>
          <tim:EmailPmTeamFlag>false</tim:EmailPmTeamFlag>                </tim:PwsProjectTaskNote><b:TextValue i:nil="true"/>
            </tim:Tasks>             <tim<b:SubmitSavedCardsOnlyFlag>false<UdfTreatment>A</timb:SubmitSavedCardsOnlyFlag>UdfTreatment>
              <tim:PreserveTimeCardStatusFlag>true</tim:PreserveTimeCardStatusFlag>          </pws:serviceRequest><b:StoplightValues/>
          </pws:PwsSaveTimeCards>     </soapenv:Body> </soapenv:Envelope>
Code Block
languagexml
titleExample 03 - deleting a time card
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>      <b:NumericValue i:nil="true"/>
                        <b:RelationValue <pws:PwsSaveTimeCards>i:nil="true"/>
         <pws:serviceRequest>             <req:RequestId>1<</req:RequestId>
   a:Udf2>
        <req:SessionTicket>AUtZcJgtdfVGhgjNekiP9w==</req:SessionTicket>             <tim:AdministratorComments>Web Service Testing</tim:AdministratorComments><a:Udf2ClearFlag>false</a:Udf2ClearFlag>
            <tim:DeleteTimeCards>         <a:ExternalGroupingIdentifier i:nil="true"/>
     <com:PwsTimecardRef>                <a:ExternalGroupingIdentifierClearFlag>false</a:ExternalGroupingIdentifierClearFlag>
  <com:TimecardUid>1152921504646141266</com:TimecardUid>                </com:PwsTimecardRef>
  a:TimeCard>
         </tim:DeleteTimeCards>      </a:PwsSaveTimecardResult>
      <tim:EndDate>2018-03-31T00:00:00.000Z</tim:EndDate>      </a:TimecardResults>
      <tim:ResourceIdentity>   </PwsSaveTimeCardsResult>
      </PwsSaveTimeCardsResponse>
   </s:Body>
 <com:ResourceReferenceSystemId>E123</com:ResourceReferenceSystemId></s:Envelope>
Code Block
languagexml
titleExample 02 - deleting a time card
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
        </tim:ResourceIdentity><PwsSaveTimeCardsResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
            <tim:SendNotificationEmailFlag>false</tim:SendNotificationEmailFlag>
            <tim:StartDate>2018-03-09T00:00:00.000Z</tim:StartDate><PwsSaveTimeCardsResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Messages <tim:SubmitFlag>true</tim:SubmitFlag>xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
            <tim:PreserveTimeCardStatusFlag>true</tim:PreserveTimeCardStatusFlag>
         </pws:serviceRequest>
      </pws:PwsSaveTimeCards><ResponseId xmlns="http://projectorpsa.com/CommonServices/">1</ResponseId>
     </soapenv:Body>
</soapenv:Envelope>

Response Format

Panel
titlePwsSaveTimeCards Response

Response Elements

...

Element

...

Data Type

...

Required?

...

Default

...

Description

...

Sample Data

...

Messages

...

PwsMessage[]

...

ResponseId

...

Int32

...

Click here for more information.

...

Status

...

RequestStatus

...

Click here for more information.

...

ServerTimestampUtc

...

DateTime

...

Click here for more information.

...

EstimateResults

...

PwsSaveEstimateResult[]

...

Locations

...

PwsLocationSummary[]

...

SubmittedFlag

...

Boolean

...

TaskNoteResults

...

PwsSaveTaskNoteResult[]

...

TimeOffCardResults

...

PwsSaveTimeOffCardResult[]

...

TimecardResults

...

       <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-09T22:19:31.3446007Z</ServerTimestampUtc>
            <a:EstimateResults/>
            <a:Locations xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
            <a:SubmittedFlag>true</a:SubmittedFlag>
            <a:TaskNoteResults/>
            <a:TimeOffCardResults/>
            <a:TimecardResults/>
         </PwsSaveTimeCardsResult>
      </PwsSaveTimeCardsResponse>
   </s:Body>
</s:Envelope>