Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Current »

Overview


This structure represents the results of a time card insert or update. Multiple time cards can be submitted for insert 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 failure by returning a collection of these structures.


PwsSaveTimecardResult

Elements


Element

Data Type

Description

Sample Data

ErrorDetail

PwsErrorDetail

The error detail regarding a failed time card insert or update.


ReferenceId

String

Reference id (used to affiliate PwsSaveTimeCardResult records with associated PwsTimeCardDetail records). This is most useful when inserting new time cards.


TimeCard

PwsTimeCardDetail

This structure contains the complete set of information about the time card.


Usage Example(s)


Example 01 - successful response
 <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>
Example 02 - failed response
s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <s:Fault>
         <faultcode>s:Client</faultcode>
         <faultstring xml:lang="en-US">The creator of this fault did not specify a Reason.</faultstring>
         <detail>
            <PwsFault xmlns="http://projectorpsa.com/DataContracts/Shared/Common/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
               <Messages>
                  <PwsMessage>
                     <AdditionalErrorText>Error 64219, State 2: Reported time off not found (installation = 2378, reported time off id/uid = (null)/1152921504646141261)</AdditionalErrorText>
                     <ErrorCode>SpecifiedTimeoffCardDoesNotExist</ErrorCode>
                     <ErrorNumber>64219</ErrorNumber>
                     <ErrorText>The specified time off card does not exist.</ErrorText>
                     <Type>Error</Type>
                     <ReferenceId1 i:nil="true"/>
                     <ReferenceId2 i:nil="true"/>
                  </PwsMessage>
               </Messages>
               <ResponseId>1</ResponseId>
               <ServiceName>PwsGetTimeCardsRs</ServiceName>
               <LockHolderUserIdentity i:nil="true"/>
               <LockHolders/>
               <LockTaker i:nil="true"/>
            </PwsFault>
         </detail>
      </s:Fault>
   </s:Body>
</s:Envelope>
  • No labels