updateTicket()

void updateTicket(string ticketNumber, TicketUpdate ticketUpdate)

This method updates an existing tickets' subject, body text, custom fields or owning account or subscription. It can be used by external systems which need to populate data into tickets.

Parameters

ticketNumber: Format: string; Purpose: Specifies the Smile ticket number to update.
ticketUpdate: Format: TicketUpdate XML; Purpose: Defines a TicketUpdate XML document that specifies the ticket details to update.

Example: Parameter title

This example shows a TicketUpdate XML document with updates to the ticket's subject and body fields, as well as setting the ticket to be owned by account/subscription 2142420625.

In the case where the USN refers to a subscription, the ticket's account is automatically updated to be the subscription's account. To clear the ticket's account or subscription, set clear to true on the USN tag.

<TicketUpdate xmlns="http://xml.inomial.com/smile/2.xsd">
  <Subject>Updated ticket subject</Subject>
  <USN clear="false">2142420625</USN>
  <Body>New ticket body text</Body>
  <Properties>
    <Object>
      <String name="ModemSerialNumber">aabbccddeeff</String>
    </Object>
  </Properties>
</TicketUpdate>

Results

This method updates an existing tickets' subject, body text, custom fields or owning account or subscription as given in the TicketUpdate XML document.

This method does not return any output. There are no messages defined by this method.

Faults

NoSuchItemException

This fault is returned when the provided ticket number does not exist or does not refer to a ticket.

InvalidRequestException

This fault is returned when the update request is not valid.

Java client syntax

java -cp build/smilewsv2-client.jar [options] com.inomial.smile.client.v2.examples.UpdateTicket ticketNumber filename

ticketNumber: Purpose: Specifies the Smile ticket number to update.
filename: Purpose: Defines the filename of the TicketUpdate XML document.

Note: For more information about the Java client and the options it accepts, see Java client syntax.