Next Topic

Previous Topic

Book Contents

UpdateTicket

Aktualisiert ein oder mehrere Felder eines Tickets. Nur Felder, die auf der Seite Ticketing > E-Mail-Leseprogramm aufgelistet sind, können aktualisiert werden.

Listenfelder aktualisieren

Im nachstehenden Beispiel ist das Feld Ursprung ein Feld vom Typ Liste mit vier möglichen Werten. Eine Anforderung gibt den Namen des Felds (Ursprung) sowie eine Nummer, die die Position des Werts in der Liste angibt (ab 1 gezählt), weiter. Angenommen, der Wert Telefon befindet sich an der zweiten Position in der Liste, so ist der Wert, der zum Ändern des Felds Ursprung zu Telefon weitergegeben wird, 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 Werten des Felds E-Mail-Leseprogramm vorgenommen werden.

Word 60% / HTML 100%

Ticket schließen

Die Aktualisierung eines Tickets kann ebenfalls das Schließen einer übertragenen MonitorTicketID einschließen, 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. Weitere <TicketField>-Namen/Werte können zu dem nachstehenden Beispiel 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:

  • Zeichenfolge - 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.
  • Ganzzahl - Kann positive oder negative ganzzahlige Werte enthalten.
  • Zahl (nn.d) - Eine Zahl, die stets eine Ziffer rechts vom Dezimalkomma enthält.
  • Zahl (nn.dd) - Eine Zahl, die stets zwei Ziffern rechts vom Dezimalkomma enthält.
  • Zahl (nn.ddd) - Eine Zahl, die stets drei Ziffern rechts vom Dezimalkomma enthält.
  • Zahl (nn.dddd) - Eine Zahl, die stets vier Ziffern rechts vom Dezimalkomma enthält.

Zurückgegebene Felder

Ein einzelner Datensatz der folgenden Felder wird zurückgegeben.

Method

Zeichenfolge

Der Vorgang, der diese Antwort anforderte.

TransactionID

Dezimalwert

Die eindeutige Nachrichten-ID dieser Nachricht.

ErrorMessage

Zeichenfolge

Wenn diese Angabe leer ist, wurde kein Fehler zurückgegeben.

ErrorLocation

Zeichenfolge

Wenn diese Angabe leer ist, wurde kein Fehler zurückgegeben.

Ticketanhänge

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