UpdateTicket

Actualiza uno o más campos de un ticket. Sólo se pueden actualizar los campos incluidos en la página Editar campos de Sistema de tickets.

Actualización de campos de la lista

En el siguiente ejemplo, el campo Origin es un tipo de campo List con cuatro valores posibles. Una solicitud envía el nombre del campo, Origin, y un número que representa la posición del valor en la lista contando a partir de 1. Por ejemplo, el valor Phone está en la segunda posición de la lista, por lo que el valor transmitido para modificar el campo Origin a Phone es 2.

Advertencia: Al cambiar el orden de los valores de las listas desplegables de los campos mediante un cambio en su secuenciación o la introducción de un nuevo valor en el medio de la lista, se modifica el valor seleccionado por la operación Actualizar ticket. Asegúrese de que los usuarios estén al tanto de esta limitación de integración antes de hacer cambios en los valores del campo Editar campos.

Cierre de un ticket

La actualización de un ticket puede incluir el cierre de un MonitorTicketID enviado al actualizar el campo Estado con un valor de 3, el cual representa el tercer valor en la lista desplegable del campo Estado. A continuación se muestra un ejemplo. Se pueden agregar elementos adicionales de nombre/valor de <TicketField> al siguiente ejemplo para actualizar varios campos.

<UpdateTicketRequest>

	<TicketID>1</TicketID>

	<TicketFields>

		<TicketField>

			<Name>Status</Name>

			<Value>3</Value>

		</TicketField>

	</TicketFields>

	<SessionID>13642146236194247244181221</SessionID>

</UpdateTicketRequest>

Actualización de otros tipos de campos

Pueden actualizarse los siguientes tipos de campos de ticket:

• String: puede contener cualquier texto con hasta 500 caracteres de longitud. Utilizado principalmente para mantener datos como ser ubicación del problema o otras variables que no pertenecen a la línea de resumen.
• Integer: puede contener cualquier valor entero positivo o negativo.
• Number (nn.d): un número que siempre muestra un dígito a la derecha de la coma decimal.
• Number (nn.dd): un número que siempre muestra dos dígitos a la derecha de la coma decimal.
• Number (nn.ddd): un número que siempre muestra tres dígitos a la derecha de la coma decimal.
• Number (nn.dddd): un número que siempre muestra cuatro dígitos a la derecha de la coma decimal.
• AddNote: agrega una nota de texto sin formato al ticket especificado.
• HideNote: establece la propiedad de oculta de la nota que se agrega.

Los campos que modifica el conjunto de campos escriben una nota de auditoría oculta en el ticket especificado que incluye nombre de campo, valor anterior y nuevo valor. Por ejemplo, ~API~ [CR] Status has changed from Open to Closed.

Campos devueltos

Se devuelve un registro simple de los siguientes campos.

Adjuntos de ticket

El servicio Web API no puede usarse para obtener o actualizar adjuntos de archivos de ticket. Los datos adjuntos de los tickets se suelen ubicar en el directorio C:\Kaseya\WebPages\ManagedFiles del Kaseya Server. Los desarrolladores de API son responsables de escribir el código para ubicar los archivos adjuntos en este directorio antes de hacer las llamadas del servicio Web API con referencia a estos adjuntos.