Versions Compared

Key

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

Overview


This structure contains represents the results of a time card insert or update. Multiple time cards can be submitted for insert or save

...

or update in a single request to PwsSaveTimeCards. This operation can partially succeed, meaning some cards were successfully saved while others triggered errors and could not be saved. The web service will report back details about each time card, whether it succeeded or failed, by returning a collection of these structures. For failed cards, ErrorDetail will provide more details about the nature of the failure.


Panel
titlePwsSaveTimecardResult

Elements


Element

Data Type

Description

Sample Data

ErrorDetail

PwsErrorDetail

The error detail regarding

the

a failed time card insert or update. Null if the save was successful.

 


ReferenceId

String

Reference id (used to

affiliate PwsSaveTimeCardResult records  

affiliate PwsSaveTimeCardResult records with associated 

PwsTimecardDetail records).

PwsTimeCardDetail records). This is most useful when inserting new time cards.


TimeCard

PwsTimecardDetail

PwsTimeCardDetail

This structure contains the complete set of information about

a time card. The structure is used both to retrieve detailed time card information and to pass information about a time card back to the server to get updated. 

the time card.


Usage Example(s)


Code Block
languagexml
titleExample 01 - successful response
collapsetrue
 <PwsGetTimeCardsResult 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-06T21:12:36.6834614Z</ServerTimestampUtc>
            <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>
                  <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>
            </a:Locations>
            <a:TimeEntryProjects>
               <a:PwsTimeEntryProject>
                  <a:AllowAssignmentFlag>true</a:AllowAssignmentFlag>
                  <a:AllowBookingFlag>true</a:AllowBookingFlag>
                  <a:CanOpenFlag>false</a:CanOpenFlag>
                  <a:CloseDate i:nil="true"/>
                  <a:DescriptionRequiredFlag>false</a:DescriptionRequiredFlag>
                  <a:OpenDate>2018-01-01T00:00:00Z</a:OpenDate>
                  <a:OpenFlag>true</a:OpenFlag>
                  <a:PmModuleEnabledFlag>true</a:PmModuleEnabledFlag>
                  <a:ProjectDescriptor>
                     <ProjectCode xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">P001395-001</ProjectCode>
                     <ProjectId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                     <ProjectUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504607412209</ProjectUid>
                     <a:EngagementDescriptor>
                        <EngagementCode xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">E001395</EngagementCode>
                        <EngagementId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <EngagementUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504607324698</EngagementUid>
                        <a:ClientDescriptor>
                           <ClientId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <ClientNumber xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">PR-PSA</ClientNumber>
                           <ClientUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606961482</ClientUid>
                           <a:ClientName>Projector PSA</a:ClientName>
                           <a:ParentClientDescriptor i:nil="true"/>
                        </a:ClientDescriptor>
                        <a:EngagementManager xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:UserDisplayName>Jack Spratt</b:UserDisplayName>
                           <b:UserId i:nil="true"/>
                           <b:UserReferenceSystemId>E123</b:UserReferenceSystemId>
                           <b:UserUid>1152921504607112369</b:UserUid>
                           <b:EmailAddress>jack@revcorp.bb</b:EmailAddress>
                           <b:FirstName>Jack</b:FirstName>
                           <b:LastName>Spratt</b:LastName>
                           <b:MiddleName i:nil="true"/>
                        </a:EngagementManager>
                        <a:EngagementName>Web Services Engagement</a:EngagementName>
                        <a:EngagementTypeDescriptor>
                           <EngagementTypeId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <EngagementTypeName xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">Billable - Time and Materials</EngagementTypeName>
                           <EngagementTypeShortName xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">TandM</EngagementTypeShortName>
                           <EngagementTypeUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606863884</EngagementTypeUid>
                           <a:BillableFlag>true</a:BillableFlag>
                        </a:EngagementTypeDescriptor>
                        <a:EngagementCurrencyDecimalDigits>2</a:EngagementCurrencyDecimalDigits>
                        <a:EngagementCurrencyIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:CurrencyCode>USD</b:CurrencyCode>
                           <b:CurrencyId i:nil="true"/>
                           <b:CurrencyUid>1152921504606851838</b:CurrencyUid>
                        </a:EngagementCurrencyIdentity>
                     </a:EngagementDescriptor>
                     <a:LocationIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:LocationId i:nil="true"/>
                        <b:LocationName>USA</b:LocationName>
                        <b:LocationUid>1152921504606855985</b:LocationUid>
                     </a:LocationIdentity>
                     <a:ProjectCloseDate i:nil="true"/>
                     <a:ProjectDescription i:nil="true"/>
                     <a:ProjectManager xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:UserDisplayName>Jack Spratt</b:UserDisplayName>
                        <b:UserId i:nil="true"/>
                        <b:UserReferenceSystemId>E123</b:UserReferenceSystemId>
                        <b:UserUid>1152921504607112369</b:UserUid>
                        <b:EmailAddress>jack@revcorp.bb</b:EmailAddress>
                        <b:FirstName>Jack</b:FirstName>
                        <b:LastName>Spratt</b:LastName>
                        <b:MiddleName i:nil="true"/>
                     </a:ProjectManager>
                     <a:ProjectName>New Web Services Project (A)</a:ProjectName>
                     <a:ProjectOpenDate>2018-01-01T00:00:00Z</a:ProjectOpenDate>
                     <a:ProjectRoles>
                        <a:PwsRole>
                           <ExternalSystemIdentifier i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <ProjectRoleId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <ProjectRoleUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504609522500</ProjectRoleUid>
                           <a:RoleEndDate i:nil="true"/>
                           <a:RoleName>JS</a:RoleName>
                           <a:RoleStartDate>2018-01-01T00:00:00Z</a:RoleStartDate>
                        </a:PwsRole>
                     </a:ProjectRoles>
                     <a:ProjectStageIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:ProjectStageId i:nil="true"/>
                        <b:ProjectStageName>Delivery</b:ProjectStageName>
                        <b:ProjectStageShortName>Delivery</b:ProjectStageShortName>
                        <b:ProjectStageUid>1152921504606853304</b:ProjectStageUid>
                     </a:ProjectStageIdentity>
                     <a:UnavailableReasonCode i:nil="true"/>
                     <a:Udf1InactiveFlag>false</a:Udf1InactiveFlag>
                     <a:Udf1Values xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                     <a:Udf2InactiveFlag>false</a:Udf2InactiveFlag>
                     <a:Udf2Values xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                     <a:Udf1DefaultValue i:nil="true"/>
                     <a:Udf2DefaultValue i:nil="true"/>
                     <a:ExpenseTypeIdentities xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                  </a:ProjectDescriptor>
                  <a:ProjectRateTypes xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                     <b:PwsProjectRateTypeSummary>
                        <b:ExternalSystemIdentifier i:nil="true"/>
                        <b:ProjectRateTypeId i:nil="true"/>
                        <b:ProjectRateTypeUid>1152921504607370460</b:ProjectRateTypeUid>
                        <b:ProjectRateTypeName>Regular</b:ProjectRateTypeName>
                     </b:PwsProjectRateTypeSummary>
                  </a:ProjectRateTypes>
                  <a:ProjectTaskTypes>
                     <a:PwsTaskType>
                        <ExternalSystemIdentifier i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <ProjectTaskTypeId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <ProjectTaskTypeUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504608115974</ProjectTaskTypeUid>
                        <a:AllowedProjectRateTypes xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:PwsProjectRateTypeSummary>
                              <b:ExternalSystemIdentifier i:nil="true"/>
                              <b:ProjectRateTypeId i:nil="true"/>
                              <b:ProjectRateTypeUid>1152921504607370460</b:ProjectRateTypeUid>
                              <b:ProjectRateTypeName>Regular</b:ProjectRateTypeName>
                           </b:PwsProjectRateTypeSummary>
                        </a:AllowedProjectRateTypes>
                        <a:DefaultProjectRateTypeIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectRateTypeId i:nil="true"/>
                           <b:ProjectRateTypeUid>1152921504607370460</b:ProjectRateTypeUid>
                        </a:DefaultProjectRateTypeIdentity>
                        <a:InactiveFlag>false</a:InactiveFlag>
                        <a:NarrativeRequiredFlag>false</a:NarrativeRequiredFlag>
                        <a:ProjectTaskTypeName>Task Type 01</a:ProjectTaskTypeName>
                        <a:StandardTaskTypeIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:StandardTaskTypeCode>TT01</b:StandardTaskTypeCode>
                           <b:StandardTaskTypeId i:nil="true"/>
                           <b:StandardTaskTypeName>Task Type 01</b:StandardTaskTypeName>
                           <b:StandardTaskTypeUid>1152921504606848772</b:StandardTaskTypeUid>
                        </a:StandardTaskTypeIdentity>
                     </a:PwsTaskType>
                  </a:ProjectTaskTypes>
                  <a:ProjectTasks>
                     <a:PwsProjectTask>
                        <ExternalSystemIdentifier i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <ProjectTaskId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <ProjectTaskUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504608644258</ProjectTaskUid>
                        <a:Description i:nil="true"/>
                        <a:Name>Task A1</a:Name>
                        <a:Notes/>
                        <a:OpenForTimeFlag>true</a:OpenForTimeFlag>
                        <a:ParentProjectTaskIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectTaskId i:nil="true"/>
                           <b:ProjectTaskUid>1152921504608637335</b:ProjectTaskUid>
                        </a:ParentProjectTaskIdentity>
                        <a:ParentTaskName>Task A</a:ParentTaskName>
                        <a:PlannedEndDateTime>2018-03-30T08:00:00Z</a:PlannedEndDateTime>
                        <a:PlannedStartDateTime>2018-03-01T00:00:00Z</a:PlannedStartDateTime>
                        <a:ProjectTaskTypeIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectTaskTypeId i:nil="true"/>
                           <b:ProjectTaskTypeUid>1152921504608115974</b:ProjectTaskTypeUid>
                        </a:ProjectTaskTypeIdentity>
                        <a:Roles>
                           <a:PwsProjectTaskRole>
                              <ProjectRoleIdentity xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">
                                 <ExternalSystemIdentifier i:nil="true"/>
                                 <ProjectRoleId i:nil="true"/>
                                 <ProjectRoleUid>1152921504609522500</ProjectRoleUid>
                              </ProjectRoleIdentity>
                              <ProjectTaskIdentity xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">
                                 <ExternalSystemIdentifier i:nil="true"/>
                                 <ProjectTaskId i:nil="true"/>
                                 <ProjectTaskUid>1152921504608644258</ProjectTaskUid>
                              </ProjectTaskIdentity>
                              <ProjectTaskRoleId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                              <ProjectTaskRoleUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504608549425</ProjectTaskRoleUid>
                              <a:ActualMinutesSinceAsOfDate>0</a:ActualMinutesSinceAsOfDate>
                              <a:BudgetedMinutes>10560</a:BudgetedMinutes>
                              <a:CompletedFlag>false</a:CompletedFlag>
                              <a:Estimates/>
                              <a:LateFlag>false</a:LateFlag>
                              <a:TotalMinutesToDate>0</a:TotalMinutesToDate>
                              <a:CompletedFlagAtLatestPostAsOfDate i:nil="true"/>
                              <a:LateEligibleFlag>false</a:LateEligibleFlag>
                              <a:LatestAsOfDatePostDateRange i:nil="true"/>
                              <a:RemainingMinutesPostDateRange i:nil="true"/>
                              <a:RemainingMinutesPriorToDateRange>10560</a:RemainingMinutesPriorToDateRange>
                              <a:TotalMinutesPostTimesheet>0</a:TotalMinutesPostTimesheet>
                           </a:PwsProjectTaskRole>
                        </a:Roles>
                        <a:SequenceNumber>1</a:SequenceNumber>
                        <a:WbsCode>1.1</a:WbsCode>
                        <a:ParentTaskWbsCode>1</a:ParentTaskWbsCode>
                     </a:PwsProjectTask>
                  </a:ProjectTasks>
                  <a:RoleCount>1</a:RoleCount>
                  <a:TaskCount>2</a:TaskCount>
                  <a:TimeCards>
                     <a:PwsTimecardDetail>
                        <ReferenceId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <TimecardId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <TimecardType xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">T</TimecardType>
                        <TimecardUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504646141261</TimecardUid>
                        <a:Description>Initial research</a:Description>
                        <a:DescriptionClearFlag>false</a:DescriptionClearFlag>
                        <a:RejectedByUser i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <a:RejectedReason i:nil="true"/>
                        <a:RejectedTimestamp i:nil="true"/>
                        <a:Status>Submitted</a:Status>
                        <a:WorkDate>2018-03-05T00:00:00Z</a:WorkDate>
                        <a:WorkMinutes>480</a:WorkMinutes>
                        <a:Timestamp>AAAAAA64Niw=</a:Timestamp>
                        <a:CardStatus>S</a:CardStatus>
                        <a:LocationClearFlag>false</a:LocationClearFlag>
                        <a:LocationIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:LocationId i:nil="true"/>
                           <b:LocationName>USA</b:LocationName>
                           <b:LocationUid>1152921504606855985</b:LocationUid>
                        </a:LocationIdentity>
                        <a:ProjectIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ProjectCode>P001395-001</b:ProjectCode>
                           <b:ProjectId i:nil="true"/>
                           <b:ProjectUid>1152921504607412209</b:ProjectUid>
                        </a:ProjectIdentity>
                        <a:ProjectRateTypeIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectRateTypeId i:nil="true"/>
                           <b:ProjectRateTypeUid>1152921504607370460</b:ProjectRateTypeUid>
                        </a:ProjectRateTypeIdentity>
                        <a:ProjectTaskIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectTaskId i:nil="true"/>
                           <b:ProjectTaskUid>1152921504608644258</b:ProjectTaskUid>
                        </a:ProjectTaskIdentity>
                        <a:RoleClearFlag>false</a:RoleClearFlag>
                        <a:RoleIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectRoleId i:nil="true"/>
                           <b:ProjectRoleUid>1152921504609522500</b:ProjectRoleUid>
                        </a:RoleIdentity>
                        <a:Udf1 xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:UdfId i:nil="true"/>
                           <b:UdfName>TC-Jira</b:UdfName>
                           <b:UdfUid>1152921504606857618</b:UdfUid>
                           <b:BooleanValue i:nil="true"/>
                           <b:DataType>P</b:DataType>
                           <b:DateValue i:nil="true"/>
                           <b:IntegerValue i:nil="true"/>
                           <b:ResourceIdentityValue i:nil="true"/>
                           <b:TextValue i:nil="true"/>
                           <b:UdfTreatment>A</b:UdfTreatment>
                           <b:StoplightValues/>
                           <b:NumericValue i:nil="true"/>
                           <b:RelationValue>
                              <b:CodeValue>SD-23</b:CodeValue>
                              <b:TextValue>2 laptops for demo</b:TextValue>
                              <b:UidValue>10022</b:UidValue>
                           </b:RelationValue>
                        </a:Udf1>
                        <a:Udf1ClearFlag>false</a:Udf1ClearFlag>
                        <a:Udf2 xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:UdfId i:nil="true"/>
                           <b:UdfName>TC-Zendesk</b:UdfName>
                           <b:UdfUid>1152921504606857619</b:UdfUid>
                           <b:BooleanValue i:nil="true"/>
                           <b:DataType>P</b:DataType>
                           <b:DateValue i:nil="true"/>
                           <b:IntegerValue i:nil="true"/>
                           <b:ResourceIdentityValue i:nil="true"/>
                           <b:TextValue i:nil="true"/>
                           <b:UdfTreatment>A</b:UdfTreatment>
                           <b:StoplightValues/>
                           <b:NumericValue i:nil="true"/>
                           <b:RelationValue i:nil="true"/>
                        </a:Udf2>
                        <a:Udf2ClearFlag>false</a:Udf2ClearFlag>
                        <a:ExternalGroupingIdentifier i:nil="true"/>
                        <a:ExternalGroupingIdentifierClearFlag>false</a:ExternalGroupingIdentifierClearFlag>
                     </a:PwsTimecardDetail>
                  </a:TimeCards>
                  <a:Udf1Treatment>A</a:Udf1Treatment>
                  <a:Udf2Treatment>A</a:Udf2Treatment>
               </a:PwsTimeEntryProject>
            </a:TimeEntryProjects>
            <a:TimeEntryTimeOff/>
         </PwsGetTimeCardsResult>

...