Next Topic

Previous Topic

Book Contents

ObterListaIncidentes

Recupera uma lista de incidentes que correspondem aos critérios de solicitação.

A solicitação é:

IncidentListRequest

 

A lista de incidentes a recuperar. A lista pode ser filtrada usando os seguintes elementos:

  • ServiceDeskName: o nome do service desk a ser consultado.
  • Status: um ou mais valores de status a serem correspondidos. Se nenhum valor de status for fornecido, os tickets serão recuperados, independentemente do status.
  • Priority: um ou mais valores de prioridade a serem correspondidos. Se nenhum valor de prioridade for fornecido, os tickets serão recuperados, independentemente da prioridade.
  • Stage: um ou mais valores de estágio a serem correspondidos. Se nenhum valor de estágio for fornecido, os tickets serão recuperados, independentemente do estágio.
  • SummarySearch: uma sequência ou expressão para pesquisar o resumo dos tickets.
  • Organization: o nome ou nome parcial das organizações a serem correspondidas. Se não for fornecido, os tickets serão recuperados para todas as organizações dentro do escopo.
  • OrganizationStaff: o nome de um membro da equipe organizacional associado aos tickets. Se não for fornecido, os tickets serão recuperados para todas as organizações dentro do escopo.
  • Machine: o nome de uma máquina a ser correspondida. Se não for fornecido, os tickets serão recuperados para todas as máquinas dentro do escopo.
  • MachineGroup: o nome de um grupo de máquinas a ser correspondido. Se não for fornecido, os tickets serão recuperados para todos os grupos de máquinas dentro do escopo.
  • Assignee: o nome ou nome parcial de destinatários a serem correspondidos. Se não for fornecido, os tickets serão recuperados para todos os cessionários dentro do escopo.
  • StartingIncident: ao paginar, é o número do próximo incidente a ser recuperado. Esse valor vem do valor PróximoIncidenteInício de uma solicitação ObterListaIncidente.
  • IncidentCount: quando presente, especifica o número de incidentes a serem recuperados.
  • SortField: quando presente, classifica os resultados no nome do campo.

SessionId

decimal

A ID da sessão do serviço da Web.

ReturnDescription

boleano

Se verdadeiro, a resposta inclui um elemento Description para cada incidente na lista. Se falso, o elemento Description não é incluído na resposta.

A resposta é a seguinte:

IncidentList

 

A lista de incidentes correspondentes.

Os seguintes atributos são retornados.

  • totalIncidents: o número total de incidentes que correspondem à solicitação.
  • nextStartingIncident: a ID do próximo incidente a ser recuperado.

Cada incidente retorna os seguintes elementos:

  • ServiceDeskName
  • IncidentNumber
  • Summary - a linha de resumo do ticket.
  • Description - a descrição do incidente. Fornecido somente se a solicitação incluir o elemento ReturnDescription definido como verdadeiro.
  • Status
  • Stage
  • CreateDateTime
  • LastEditDateTime
  • OrgID
  • OrganizationName
  • Machine
  • MachineGroup
  • IsUnread - o ticket ainda não foi aberto.

Method

string

A operação que solicitou essa resposta.

TransactionID

decimal

A ID única de mensagem para essa mensagem.

ErrorMessage

string

Se estiver em branco, nenhum erro foi retornado.

ErrorLocation

string

Se estiver em branco, nenhum erro foi retornado.