Next Topic

Previous Topic

Book Contents

GetIncidentList

Ruft eine Liste der Vorfälle ab, die mit den Anfragekriterien übereinstimmen.

Die Anforderung lautet:

IncidentListRequest

 

Die Liste der abzurufenden Vorfälle. Diese Liste kann unter Verwendung der folgenden Elemente gefiltert werden:

  • ServiceDeskName – Der Name des abzufragenden Service-Desks
  • Status – Ein oder mehrere Status, die abgerufen werden sollen. Wenn keine Status angegeben werden, werden die Tickets ungeachtet ihres Status abgerufen.
  • Priority – Ein oder mehrere Prioritätswert(e), der/die abgerufen werden soll(en). Wenn keine Prioritätswerte angegeben werden, werden die Ticket ungeachtet der Priorität abgerufen.
  • Stage – Ein oder mehrere Phasenwert(e), der/die abgerufen werden soll(en). Wenn keine Phasenwerte angegeben werden, werden die Ticket ungeachtet der Phase abgerufen.
  • SummarySearch – Eine Zeichenfolge oder ein Ausdruck für einen Suchvorgang in der Ticketübersicht
  • Organization – Der Name oder Teilname von Organisationen, der abgerufen werden soll Wenn keiner angegeben wird, werden Tickets für alle Organisationen im Umfang abgerufen.
  • OrganizationStaff – Der Name eines mit Tickets verknüpften Organisationsmitarbeiters Wenn keiner angegeben wird, werden Tickets für alle Organisationen im Umfang abgerufen.
  • Machine – Der Name eines Rechners, der abgerufen werden soll Wenn keiner angegeben wird, werden Tickets für alle Rechner im Umfang abgerufen.
  • MachineGroup – Der Name einer Rechnergruppe, die abgerufen werden soll Wenn keiner angegeben wird, werden Tickets für alle Rechnergruppen im Umfang abgerufen.
  • Assignee – Die Namen oder Teilnamen von Bearbeitern, die abgerufen werden sollen Wenn keiner angegeben wird, werden Tickets für alle Administratoren im Umfang abgerufen.
  • StartingIncident – Die nächste abzurufende Vorfallnummer beim Seitenwechsel Dieser Wert stammt aus dem Wert "nextStartingIncident" einer vorherigen GetIncidentList-Anforderung.
  • IncidentCount – Wenn vorhanden, gibt dies die Anzahl der abzurufenden Vorfälle an.
  • SortField – Wenn vorhanden, werden die Ergebnisse für den Feldnamen sortiert.

SessionId

decimal

Die ID der Webdienstsitzung

RückgabeBeschreibung

boolean

Wenn wahr, schließt die Antwort ein Description-Element für jeden Vorfall in der Liste ein. Wenn falsch, ist das Description-Element nicht in der Antwort eingeschlossen.

Die Antwort lautet folgendermaßen:

IncidentList

 

Die Liste der übereinstimmenden Vorfälle.

Die folgenden Attribute werden zurückgegeben.

  • totalIncidents – Die Gesamtzahl der Vorfälle, die mit der Anforderung übereinstimmen
  • nextStartingIncident – Die ID des nächsten abzurufenden Vorfalls

Jeder Vorfall gibt die folgenden Elemente zurück:

  • ServiceDeskName
  • IncidentNumber
  • Summary – Die Übersichtszeile des Tickets.
  • Description – Die Beschreibung des Vorfalls. Steht nur zur Verfügung, wenn die Anfrage das ReturnDescription-Element einschließt, das auf wahr eingestellt ist.
  • Status
  • Stage
  • CreateDateTime
  • LastEditDateTime
  • OrgID
  • OrganizationName
  • Machine
  • MachineGroup
  • IsUnread – Das Ticket ist noch nicht geöffnet worden.

Method

string

Der Vorgang, der diese Antwort anforderte

TransactionID

decimal

Die eindeutige Nachrichten-ID dieser Nachricht

ErrorMessage

string

Wenn leer, wurde kein Fehler zurückgegeben

ErrorLocation

string

Wenn leer, wurde kein Fehler zurückgegeben