Versions Compared

Key

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

...

This web service deletes a specified project task role and returns the identity of the deleted project task role (PwsProjectTaskRoleRef). A project task role is the association of a role on a project with a task that the role is assigned to. Deleting a project task role is essentially removing the role from the task. The web service returns the identity of the deleted project task role (PwsProjectTaskRoleRef).

Request Format

Panel
titlePwsDeleteProjectTaskRoleRq

...

Panel
titlePwsDeleteProjectTaskRoleRs

...

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.

0

Status

RequestStatus

Click here for more information.

Ok

ServerTimestampUtc

DateTime

Click here for more information.

2018-02-28T20:46:37.5975698Z

ProjectTaskRoleIdentity

PwsProjectTaskRoleRef

This is the identity of the project task role that was deleted. Click here for more information.


EngagementTimestamp

String

This is a Base64 encoded timestamp utilized for engagement locking. To protect against overwriting other changes, you may optionally echo back the timestamp returned in a prior response. This will cause the request to fail if any change has been made between the two invocations.

AAAAAA+vpyM=

LockStolenFromUserIdentity

PwsUserRef

If a lock is stolen in the process of deleting the project task role, this identifies the user from whom the lock was stole. Click here for more information.


...

Code Block
languagexml
titleExample 02
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsDeleteProjectTaskRoleResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsDeleteProjectTaskRoleResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsMessage>
                  <b:AdditionalErrorText>Warning 106: {oldestSurvivingTimeCardWorkDateString}</b:AdditionalErrorText>
                  <b:ErrorCode>TaskRoleDeallocated</b:ErrorCode>
                  <b:ErrorNumber>106</b:ErrorNumber>
                  <b:ErrorText>The project task role could not be removed because time has been reported against it. The effort was zeroed out instead.</b:ErrorText>
                  <b:Type>Warning</b:Type>
               </b:PwsMessage>
            </Messages>
            <ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId>
            <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-01T16:14:24.0638561Z</ServerTimestampUtc>
            <a:ProjectTaskRoleIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:ProjectRoleIdentity>
                  <b:ExternalSystemIdentifier i:nil="true"/>
                  <b:ProjectRoleId i:nil="true"/>
                  <b:ProjectRoleUid>1152921504609594610</b:ProjectRoleUid>
               </b:ProjectRoleIdentity>
               <b:ProjectTaskIdentity>
                  <b:ExternalSystemIdentifier i:nil="true"/>
                  <b:ProjectTaskId i:nil="true"/>
                  <b:ProjectTaskUid>1152921504608735153</b:ProjectTaskUid>
               </b:ProjectTaskIdentity>
               <b:ProjectTaskRoleId i:nil="true"/>
               <b:ProjectTaskRoleUid>1152921504608653387</b:ProjectTaskRoleUid>
            </a:ProjectTaskRoleIdentity>
            <a:EngagementTimestamp>AAAAAA+xdSs=</a:EngagementTimestamp>
            <a:LockStolenFromUserIdentity i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
         </PwsDeleteProjectTaskRoleResult>
      </PwsDeleteProjectTaskRoleResponse>
   </s:Body>
</s:Envelope>

PwsDeleteProjectTaskRole Common Errors and Warnings

...