UpdateTicket

Atualiza um ou mais cmapos de um ticket. Somente os campos relacionados na página Emissão de ickets > Editar campos podem ser atualizados.

Atualizando campos listados

No exemplo abaixo, o campo Origin é um tipo de campo List com quatro valores possíveis. Uma solicitação passa o nome do campo, Origin, e um número que representa a posição do valor na lista, começando de 1. Por exemplo, o valor Phone está na segunda posição na lista, portanto, o valor passado para alterar o campo Origin para Phone é 2.

Aviso: A alteração da ordem dos valores na lista suspensa ao sequenciar novamente os mesmos, ou ao inserir um novo valor no meio da lista, alterará o valor selecionado pela operação UpdateTicket. Assegure que os usuários estejam cientes da restrição de integração antes que alterações sejam feitas nos valores do campo Editar campos.

Fechando um ticket

A atualização de um ticket pode incluir o encerramento de uma MonitorTicketID enviada ao atualizar o campo Status com um valor de 3, que representa o terceiro valor na lista suspensa do campo Status. Um exemplo é abaixo mostrado. Elementos adicionais de nome/valor para <TicketField> podem ser adicionados ao exemplo abaixo para atualizar múltiplos campos.

<UpdateTicketRequest>

	<TicketID>1</TicketID>

	<TicketFields>

		<TicketField>

			<Name>Status</Name>

			<Value>3</Value>

		</TicketField>

	</TicketFields>

	<SessionID>13642146236194247244181221</SessionID>

</UpdateTicketRequest>

Atualizando outros tipos de campos

Os seguintes outros tipos de campos do ticket pode ser atualizados:

• String: pode conter um texto com até 500 caracteres. Melhor utilizado para armazenar a localização do problma ou outras variáveis que não pertencem a linha de resumo.
• Integer: pode conter um valor inteiro positivo ou negativo.
• Number (nn.d): um número que sempre mostra um dígito à direita do ponto decimal.
• Number (nn.dd): um número que sempre mostra dois dígitos à direita do ponto decimal.
• Number (nn.ddd): um número que sempre mostra três dígitos à direita do ponto decimal.
• Number (nn.dddd): um número que sempre mostra quatro dígitos à direita do ponto decimal.
• AddNote: adiciona uma nota de texto simples ao ticket especificado.
• HideNote: define a propriedade oculta para a nota sendo adicionada.

Campos sendo modificados pela matriz de campos gravam uma nota de auditoria oculta ao ticket especificado com o nome de arquivo, valor antigo e novo valor. Por exemplo, ~API~ [CR] Status has changed from Open to Closed.

Campos retornados

Um registro único dos seguintes campos é retornado.

Anexos do ticket

A API do Serviço de Web não pode ser usada para obter ou atualizar anexos de ticket. Os anexos do arquivo do ticket estão normalmente localizados no diretório C:\Kaseya\WebPages\ManagedFiles do servidor da Kaseya. Os desenvolvedores da API são responsáveis porescrever o código para colocar os arquivos de anexos antes de efetuar chamadas da API do Serviço de Web que referenciam estes anexos.