En esta sección se describen las operaciones disponibles para agregar relaciones a un caso.
Agregar relación con incidente
Detalles de la petición**
-
URI: api/v8.6/item/addrelatedincident
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- Authorization: TOKEN
- content-type: application/json
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| IncidentId | Número | Si | Id de incidente |
| ITEMID | Número | Si | Id de caso |
| ITEMTYPE | Número | Si | Tipo de caso |
| CAUSEID | Número | Si | Id de la causa |
| USERID | Número | Si | Id de usuario |
Cuerpo de la petición
[
{"Field":"IncidentId","Value":"56087"},
{"Field":"ItemId","Value":"56030"},
{"Field":"ITEMTYPE","Value":"4"},
{"Field":"CAUSEID","Value":"1"},
{"Field":"UserId","Value":"471"}
]
Respuesta
El servicio retornará un Json con la siguiente información: Ejemplo: true
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | InvalidIncidentId\r\nNombre del parámetro: Id |
| 400 | BadRequest | InvalidItemId |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelation |
| 400 | BadRequest | CaseIsClosed |
| 500 | InternalServerError | FailureAddRelatedIncident |
Nota: El servicio no valida el proyecto de los casos o artículos, en este caso dicha validación le corresponde al usuario.
Agregar relación con Problema
Detalles de la petición*
-
URI: api/v8.6/item/addrelatedproblem
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- Authorization: TOKEN
- content-type: application/json
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| PROBLEMID | Número | Si | Id de problema |
| ITEMID | Número | Si | Id de caso |
| ITEMTYPE | Número | Si | Tipo de caso |
| CAUSEID | Número | Si | Id de la causa |
| USERID | Número | Si | Id de usuario |
Cuerpo de la petición
[
{"Field":"PROBLEMID","Value":"55936"},
{"Field":"ItemId","Value":"56082"},
{"Field":"ITEMTYPE","Value":"1"},
{"Field":"CAUSEID","Value":"1"},
{"Field":"UserId","Value":"471"}
]
Respuesta
El servicio retornará un Json con la siguiente información: Ejemplo: true
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | InvalidProblemId |
| 400 | BadRequest | InvalidItemId |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelation |
| 400 | BadRequest | CaseIsClosed |
| 500 | InternalServerError | FailureAddRelatedIncident |
Nota: El servicio no valida el proyecto de los casos o artículos, en este caso dicha validación le corresponde al usuario
Agregar relación con Cambio
Detalles de la petición
-
URI: api/v8.6/item/addrelatedchange
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- Authorization: TOKEN
- content-type: application/json
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| CHANGEID | Número | Si | Id de cambio |
| ITEMID | Número | Si | Id de caso |
| ITEMTYPE | Número | Si | Tipo de caso |
| CAUSEID | Número | Si | Id de la causa |
| USERID | Número | Si | Id de usuario |
Cuerpo de la petición
[
{"Field":"CHANGEID","Value":"692"},
{"Field":"ITEMID","Value":"39829"},
{"Field":"ITEMTYPE","Value":"1"},
{"Field":"CAUSEID","Value":"5"},
{"Field":"USERID","Value":"471"}
]
Respuesta
El servicio retornará un Json con la siguiente información: Ejemplo: true
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | InvalidChangeId |
| 400 | BadRequest | InvalidItemId |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelation |
| 400 | BadRequest | CaseIsClosed |
| 500 | InternalServerError | FailureAddRelatedIncident |
Nota: El servicio no valida el proyecto de los casos o artículos, en este caso dicha validación le corresponde al usuario
Agregar Relación con Requerimiento de Servicio
Detalles de la petición
-
URI: api/v8.6/item/addrelatedrequirement
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- Authorization: TOKEN
- content-type: application/json
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| RequirementId | Número | Si | Id de requerimiento |
| ITEMID | Número | Si | Id de caso |
| ITEMTYPE | Número | Si | Tipo de caso |
| CAUSEID | Número | Si | Id de la causa |
| USERID | Número | Si | Id de usuario |
Cuerpo de la petición
[
{"Field":"RequirementId","Value":"55893"},
{"Field":"ItemId","Value":"56073"},
{"Field":"ITEMTYPE","Value":"1"},
{"Field":"CAUSEID","Value":"1"},
{"Field":"UserId","Value":"471"}
]
Respuesta
El servicio retornará un Json con la siguiente información: Ejemplo: true
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | InvalidRequirementId |
| 400 | BadRequest | InvalidItemId |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelation |
| 400 | BadRequest | CaseIsClosed |
| 500 | InternalServerError | FailureAddRelatedRequirement |
Nota: El servicio no valida el proyecto de los casos o artículos, en este caso dicha validación le corresponde al usuario.
Agregar Relación con Elemento de Configuración
Detalles de la petición
-
URI: api/v8.6/item/addrelatedci
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- Authorization: TOKEN
- content-type: application/json
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| CIID | Número | Si | Id de cambio |
| ITEMID | Número | Si | Id de caso |
| ITEMTYPE | Número | Si | Tipo de caso |
| CAUSEID | Número | Si | Id de la causa |
| USERID | Número | Si | Id de usuario |
Cuerpo de la petición
[
{
"Field": "CIID",
"Value": "3129"
},
{
"Field": "ITEMID",
"Value": "39829"
},
{
"Field": "ITEMTYPE",
"Value": "1"
},
{
"Field": "CAUSEID",
"Value": "5"
},
{
"Field": "USERID",
"Value": "471"
}
]
Respuesta
El servicio retornará un Json con la siguiente información: Ejemplo: true
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | InvalidCiId |
| 400 | BadRequest | InvalidItemId |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelation |
| 400 | BadRequest | CaseIsClosed |
| 500 | InternalServerError | FailureAddRelatedCi |
Nota: El servicio no valida el proyecto de los casos o artículos, en este caso dicha validación le corresponde al usuario.
Agregar Relación con Error Conocido
Detalles de la petición
-
URI: api/v8.6/item/addrelatedknownerror
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- Authorization: TOKEN
- content-type: application/json
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| KnownErrorId | Número | Si | Id de error conocido |
| ITEMID | Número | Si | Id de caso |
| ITEMTYPE | Número | Si | Tipo de caso |
| CAUSEID | Número | Si | Id de la causa |
| USERID | Número | Si | Id de usuario |
Cuerpo de la petición
[
{
"Field": "KnownErrorId",
"Value": "55891"
},
{
"Field": "ItemId",
"Value": "56080"
},
{
"Field": "ITEMTYPE",
"Value": "1"
},
{
"Field": "CAUSEID",
"Value": "1"
},
{
"Field": "UserId",
"Value": "471"
}
]
Respuesta
El servicio retornará un Json con la siguiente información: Ejemplo: true
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | InvalidKnownErrorId |
| 400 | BadRequest | InvalidItemId |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelation |
| 400 | BadRequest | CaseIsClosed |
| 500 | InternalServerError | FailureAddRelatedKnownError |
Nota: El servicio no valida el proyecto de los casos o artículos, en este caso dicha validación le corresponde al usuario.
Agregar Relación con Artículo
Detalles de la petición
-
URI: api/v8.6/item/addrelatedarticle
-
Tipo: POST
-
Encabezados requeridos:
- content-type: application/json
- Authorization: TOKEN
- content-type: application/json
Parámetros:
| Nombre | Tipo de dato | Obligatorio | Descripción |
|---|---|---|---|
| ArticleId | Número | Si | Id de artículo |
| ITEMID | Número | Si | Id de caso |
| ITEMTYPE | Número | Si | Tipo de caso |
| CAUSEID | Número | Si | Id de la causa |
| USERID | Número | Si | Id de usuario |
Cuerpo de la petición
[
{
"Field": "ArticleId",
"Value": "692"
},
{
"Field": "ITEMID",
"Value": "39829"
},
{
"Field": "ITEMTYPE",
"Value": "1"
},
{
"Field": "CAUSEID",
"Value": "5"
},
{
"Field": "USERID",
"Value": "471"
}
]
Respuesta
El servicio retornará un Json con la siguiente información: Ejemplo: true
Mensajes de error
| Código | Estado HTTP | Mensaje de error |
|---|---|---|
| 400 | BadRequest | InvalidArticleId |
| 400 | BadRequest | InvalidItemId |
| 400 | BadRequest | InvalidItemType |
| 400 | BadRequest | InvalidRelation |
| 400 | BadRequest | CaseIsClosed |
| 500 | InternalServerError | FailureAddRelatedArticle |
Nota: El servicio no valida el proyecto de los casos o artículos, en este caso dicha validación le corresponde al usuario.