Gerenciamento de casos
Esta seção descreve as operações relacionadas ao tratamento de casos (criação, edição, consulta).
Criação de caso
Detalhes da petição
- URI: api/v8.6/item/add/{itemType}
- Tipo: POST
-
Títulos obrigatórios:
- tipo de conteúdo: application/json
- Autorização: TOKEN
Parâmetros:
Nome | Tipo de dado | Obrigatório | Descrição |
---|---|---|---|
AutorID | Número | Sim | ID do usuário que será registrado como autor do caso. |
ID da categoria | Número | Sim | ID da categoria associada ao caso. |
ID do cliente | Número | Não | ID do cliente para quem o caso será registrado. Só é necessário se o tipo de caso for diferente do problema. |
ID da empresa | Número | Não | ID da empresa na qual o caso será registrado. |
Identificação responsável | Número | Não | ID do usuário responsável pelo caso |
Descrição | Texto | Sim | Descrição do caso. |
ID do grupo | Número | Sim | ID do grupo de especialistas encarregado de gerenciar o caso. |
ID do serviço | Número | Sim | ID do serviço relacionado ao caso. |
Assunto | Texto | Não | Objecto do processo |
SlaId | Número | Sim | ID do SLA relacionado ao caso. |
ID do projeto | Número | Sim | A ID do projeto no qual o caso será criado. |
tipo de item | Número | Sim | Tipo de caso a ser criado. As opções são: 1. Incidente 2. Problema 3. Mudança 4. Requisito de serviço |
Identificação do Registro | Número | Sim | ID do meio pelo qual o caso é registrado. |
CiId | Número | Não | ID do IC associado ao caso. Só é necessário se o tipo de caso for problema. |
Corpo da petição
A solicitação consiste em uma matriz json de valor de campo com parâmetros possíveis, conforme necessário. Exemplo:
[
{"Field":"AuthorId","Value":3913},
{"Field":"CategoryId","Value":2499},
{"Field":"CustomerId","Value":8},
{"Field":"Description","Value":"Item description"},
{"Field":"GroupId","Value":33},
{"Field":"ProjectId","Value":2},
{"Field":"RegistryTypeId","Value":6},
{"Field":"ServiceId","Value":2418},
{"Field":"Sunbject","Value":"Item subject"},
{"Field":"SlaId","Value":2454},
{"Field":"UrgencyId","Value":3}
]
Responder
Como resposta, um objeto json é obtido, com as seguintes informações:
[
{
"Field": "itemId",
"Value": "4158"
},
{
"Field": "qs",
"Value": "?64B24DED26791E23A72364E9AF0E0430E93E2CF2F6D66AA4CB23CAAF7D8F"
},
{
"Field": "composedItemId", "Value": "IM-55175-2-19537"
},
{
"Field": "isClosed",
"Value": "False"
},
{
"Field": "result",
"Value": "True"
}
]
Mensagens de erro
Código | Status HTTP | Mensagem de erro |
---|---|---|
400 | Solicitação BadRequest | Dados de caso inválido |
400 | Solicitação BadRequest | Identificação de autor inválida |
400 | Solicitação BadRequest | Categoria inválida |
400 | Solicitação BadRequest | Empresa Inválida |
400 | Solicitação BadRequest | Descrição inválida |
400 | Solicitação BadRequest | Grupo Inválido |
400 | Solicitação BadRequest | InvalidItemType |
400 | Solicitação BadRequest | InvalidStateConfiguraton |
400 | Solicitação BadRequest | Tipo de registro inválido |
400 | Solicitação BadRequest | Serviço inválido |
400 | Solicitação BadRequest | InvalidSla |
400 | Solicitação BadRequest | InvalidUrgencyId |
400 | Solicitação BadRequest | InvalidSessionId |
401 | Desautorizado | Criação de Incidentes Não Autorizados |
401 | Desautorizado | Criação de Mudança Não Autorizada |
401 | Desautorizado | Criação de Problema Não Autorizado |
401 | Desautorizado | Criação de chamada de serviço não autorizada |
500 | Erro de servidor interno | FailureAddItem |