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 27 Next »

Overview

This web service deletes a specified client PwsClientRef. The service will return the identity PwsClientRef of the deleted client.

Request Format


PwsDeleteClientRq

Request Elements


ElementData TypeRequired?DefaultDescription
Common InputCommon Input


CascadeDeleteFlagBooleanNo"false"

This flag is set to "true" when the user wants to delete the client and, all of the client's children

  • If set to "false", an attempt to delete a client that has one more children will fail
  • If set to "true", and the client and all of its children can be deleted, all clients are deleted
  • If set to "true", and the InactivateIfInUseFlag is also set to true, the client and its children will be deleted if possible, otherwise they will be marked inactive. A client can be deleted if it is not in use elsewhere and all its children (if any) can be deleted. Otherwise, it must be inactivated
  • If set to "true", and the InactivateIfInUseFlag is set to false, an error is returned (because at least one client cannot be deleted, per bullet 2 above)
ClientIdentityPwsClientRef [1]

This is the identity of the client to be deleted
InactivateIfInuseFlagBooleanNo"false"If set to true, a client that cannot be deleted because it is in use will be set to inactive, otherwise the request will fail.

Usage Example(s) (Request)


Request 01 
      <PwsDeleteClient>
         <serviceRequest>
            <RequestId>1</RequestId>
            <SessionTicket>AVWN2cthcvkr13Vtxbkl4Q==</SessionTicket>
            <CascadeDeleteFlag>true</CascadeDeleteFlag>
            <ClientIdentity>
               <!--ClientId>?</com:ClientId-->
               <ClientNumber>C000117</com:ClientNumber>
               <!--ClientUid>?</com:ClientUid-->
            </ClientIdentity>
            <InactivateIfInuseFlag>true</InactivateIfInuseFlag>
         </serviceRequest>
      </PwsDeleteClient>


Response Format


PwsDeleteClientRs


Response Elements


ElementData TypeDescription
Common OutputCommon Output
ClientIdentityPwsClientRef [0..1]


Usage Example(s) Response


Response 01 
      <PwsDeleteClientResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsDeleteClientResult xmlns:a="http://projectorpsa.com/DataContracts/Responses/" 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 i:nil="true"/>
                  <b:ErrorCode i:nil="true"/>
                  <b:ErrorNumber i:nil="true"/>
                  <b:ErrorText i:nil="true"/>
                  <b:Type i:nil="true"/>
                  <b:ReferenceId1 i:nil="true"/>
                  <b:ReferenceId2 i:nil="true"/>
               </b:PwsMessage>
            </Messages>
            <ResponseId xmlns="http://projectorpsa.com/CommonServices/">1</ResponseId>
            <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2017-12-21T16:14:01.7558585Z</ServerTimestampUtc>
            <a:ClientIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:ClientId i:nil="true"/>
               <b:ClientNumber>C000117</b:ClientNumber>
               <b:ClientUid>1152921504606989806</b:ClientUid>
            </a:ClientIdentity>
         </PwsDeleteClientResult>
      </PwsDeleteClientResponse>



  • No labels