Next Topic

Previous Topic

Book Contents

GetIncidentList

Recupera una lista de incidentes que coinciden con los criterios de solicitud.

La solicitud es:

IncidentListRequest

 

La lista de incidentes que se deben recuperar. La lista se puede filtrar mediante los siguientes elementos:

  • ServiceDeskName: el nombre del Departamento de servicios al que se debe consultar.
  • Status: uno o más valores de estado con los cuales debe haber coincidencias. Si no se suministran valores de estado, los tickets se recuperan sin considerar el estado.
  • Priority: uno o más valores de prioridad con los cuales debe haber coincidencias. Si no se suministran valores de prioridad, los tickets se recuperan sin considerar la prioridad.
  • Stage: uno o más valores de etapa con los cuales debe haber coincidencias. Si no se suministran valores de etapa, los tickets se recuperan sin considerar la etapa.
  • SummarySearch: una cadena o expresión para buscar en el resumen de tickets.
  • Organization: el nombre completo o parcial de las organizaciones con los que debe haber coincidencias. Si no se suministra, los tickets se recuperan para todas las organizaciones dentro del ámbito.
  • OrganizationStaff: el nombre de un miembro del personal de la organización asociado con los tickets. Si no se suministra, los tickets se recuperan para todas las organizaciones dentro del ámbito.
  • Machine: el nombre de una máquina con el que debe haber coincidencia. Si no se suministra, los tickets se recuperan para todas las máquinas dentro del ámbito.
  • MachineGroup: el nombre de un grupo de máquinas con el que debe haber coincidencia. Si no se suministra, los tickets se recuperan para todos los grupos de máquinas dentro del ámbito.
  • Assignee: el nombre completo o parcial de los asignatarios con los que debe haber coincidencias. Si no se suministra, los tickets se recuperan para todos los asignatarios dentro del ámbito.
  • StartingIncident: al paginar, este es el siguiente número de incidente que se debe recuperar. Este valor viene desde el valor nextStartingIncident de una solicitud previa GetIncidentList.
  • IncidentCount: cuando se indica, especifica el número de incidentes que se deben recuperar.
  • SortField: cuando se indica, ordena los resultados por el nombre de campo.

SessionId

decimal

La ID de sesión del servicio Web.

ReturnDescription

boolean

Si es verdadero, la respuesta incluye un elemento Description para cada incidente de la lista. Si es falso, el elemento Description no se incluye en la respuesta.

La respuesta es la siguiente:

IncidentList

 

La lista de incidentes coincidentes.

Se devuelven los siguientes atributos.

  • totalIncidents: el número total de incidentes que coinciden con la solicitud.
  • nextStartingIncident: el identificador del siguiente incidente que se debe recuperar.

Cada incidente devuelve los siguientes elementos:

  • ServiceDeskName
  • IncidentNumber
  • Summary: la línea de resumen del ticket.
  • Description: la descripción del incidente. Sólo se proporciona si la solicitud incluye el elemento ReturnDescription establecido en verdadero.
  • Status
  • Stage
  • CreateDateTime
  • LastEditDateTime
  • OrgID
  • OrganizationName
  • Machine
  • MachineGroup
  • IsUnread: el ticket aún no se abrió.

Method

string

La operación que solicitó esta respuesta.

TransactionID

decimal

La ID única de mensaje para este mensaje.

ErrorMessage

string

Si está en blanco, no devolvió error.

ErrorLocation

string

Si está en blanco, no devolvió error.