Versions Compared

Key

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

...

ElementData TypeRequired?DefaultDescription
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.

Request Usage Example(s

...

)


Code Block
languagexml
titleRequest 01
collapsetrue
      <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>

...

ElementData TypeDescription
ClientIdentityPwsClientRef [0..1]

Response Usage Example(s)

...


Code Block
languagexml
titleResponse 01
collapsetrue
      <PwsDeleteClientResponse>
         <PwsDeleteClientResult>
            <Messages>
               <PwsMessage>
                  <AdditionalErrorText i:nil="true"/>
                  <ErrorCode i:nil="true"/>
                  <ErrorNumber i:nil="true"/>
                  <ErrorText i:nil="true"/>
                  <Type i:nil="true"/>
                  <ReferenceId1 i:nil="true"/>
                  <ReferenceId2 i:nil="true"/>
               </PwsMessage>
            </Messages>
            <ResponseId>1</ResponseId>
            <Status>Ok</Status>
            <ServerTimestampUtc>2017-12-21T16:14:01.7558585Z</ServerTimestampUtc>
            <ClientIdentity>
               <ClientId i:nil="true"/>
               <ClientNumber>C000117</ClientNumber>
               <ClientUid>1152921504606989806</ClientUid>
            </ClientIdentity>
         </PwsDeleteClientResult>
      </PwsDeleteClientResponse>

...