UpdateTicket

Aktualisiert ein oder mehrere Felder eines Tickets. Nur Felder, die auf der Seite "Ticketing > Felder bearbeiten" aufgelistet sind, können aktualisiert werden.

Listenfelder aktualisieren

Im nachstehenden Beispiel ist das Feld Origin ein Feld vom Typ List mit vier möglichen Werten. Eine Anfrage übergibt den Namen des Felds (Origin) sowie eine Nummer, die die Position des Werts in der Liste angibt (ab 1 gezählt). Angenommen, der Wert Phone befindet sich an der zweiten Position in der Liste: Der Wert, der zum Ändern des Felds Origin in Phone übergeben wird, ist gleich 2.

Warnung: Durch eine Änderung der Reihenfolge der Feld-Dropdown-Liste, indem Sie diese neu ordnen oder in der Mitte der Liste einen neuen Wert eingeben, wird der vom Vorgang UpdateTicket ausgewählte Wert geändert. Benutzer müssen sich über diese Integrationsrestriktion im Klaren sein, bevor Änderungen an den Feldwerten unter Felder bearbeiten vorgenommen werden.

Ticket schließen

Bei der Aktualisierung eines Tickets kann auch die übertragene MonitorTicketID geschlossen werden, indem das Feld Status mit dem Wert 3 aktualisiert wird. Dieser stellt den dritten Wert in der Dropdown-Liste des Felds Status dar. Nachstehend wird ein Beispiel angezeigt. Dem nachstehenden Beispiel können weitere Namen/Wert-Elemente für <TicketField> hinzugefügt werden, um mehrere Felder zu aktualisieren.

<UpdateTicketRequest>

	<TicketID>1</TicketID>

	<TicketFields>

		<TicketField>

			<Name>Status</Name>

			<Value>3</Value>

		</TicketField>

	</TicketFields>

	<SessionID>13642146236194247244181221</SessionID>

</UpdateTicketRequest>

Andere Typen von Feldern aktualisieren

Die folgenden anderen Typen von Ticketfeldern können aktualisiert werden:

• String – Kann Text bis zu einer Länge von 500 Zeichen enthalten. Eignet sich am besten für Angaben, wie die Position eines Problems oder andere Variablen, die nicht in die Übersichtszeile gehören.
• Integer – Kann positive oder negative ganzzahlige Werte enthalten.
• Number (nn.d) – Zahl mit immer einer Dezimalstelle
• Number (nn.dd) – Zahl mit immer zwei Dezimalstellen
• Number (nn.ddd) – Zahl mit immer drei Dezimalstellen
• Number (nn.dddd) – Zahl mit immer vier Dezimalstellen
• AddNote – Fügt dem angegebenen Ticket eine Anmerkung im Nur-Text-Format hinzu.
• HideNote – Legt die Eigenschaft "Ausgeblendet" für die hinzugefügte Anmerkung fest.

Bei der Änderung von Feldern durch die Felderaufstellung wird dem angegebenen Ticket eine ausgeblendete Audit-Anmerkung mit Feldname, altem Wert und neuen Wert hinzugefügt. Beispiel: ~API~ [CR] Status has changed from Open to Closed.

Zurückgegebene Felder

Es wird ein einzelner Datensatz der folgenden Felder zurückgegeben.

Ticketanhänge

Der API-Webdienst kann nicht zum Abrufen oder Aktualisieren von Ticket-Dateianhängen verwendet werden. Ticket-Dateianhänge befinden sich gewöhnlich im Verzeichnis C:\Kaseya\WebPages\ManagedFiles des Kaseya Server. API-Entwickler müssen Code schreiben, damit Dateianhänge in diesem Verzeichnis abgelegt werden, bevor sie Webdienst-API-Anrufe tätigen.