Adaptación: SERVCGES-2344

Nuevo concepto de sección para la ubicación física de recursos de infraestructura

La ubicación física de un recurso de infraestructura establecía hasta ahora una estructura de Edificio, Planta y Sala.

Para un ajuste más fiel a la estructura real, ha sido necesario incorporar un nuevo concepto entre planta y sala denominado Sección.

Este cambio implica un conjunto de modificaciones en los siguientes métodos REST de la API para los que será necesaria su adaptación:

Listado y detalle de recursos de infraestructura:

La estructura jerarquizada de la ubicación física incluirá la sección dentro de la planta y la sala dentro de la sección, deprecándose el objeto sala dentro de la planta.

Creación y edición de recursos de infraestructura:

La misma jerarquía anterior aplica a los datos enviados en el cuerpo de la petición a la hora de crear y editar recursos. Queda por lo tanto deprecado el envío de la sala dentro del objeto de planta.
No será posible la edición de la información de la ubicación física por parte de técnicos si el usuario ha informado personalmente su ubicación en la aplicación de ayudaDIGITAL Escritorio.

Ubicación física para contactos:

El detalle de un contacto también pasará a contar con un nivel de jerarquía adicional en la estructura de la respuesta para incluir la sección.
La creación y edición de contactos (de uso exclusivo para herramientas internas) también recibirá la nueva estructura en el cuerpo de la petición.

Tablas maestras:

Se ha creado una consulta para extraer las secciones de una planta.
Se ha creado una consulta para extraer las salas de una sección.
La consulta del listado de plantas de un edificio dejará de mostrar las salas disponibles y mostrará las secciones disponibles. Cambián también los links para acceder a los recursos asociados a la planta.
Queda deprecada la consulta para extraer salas de una planta.
Del mismo modo, la creación y edición de plantas, secciones y salas (de uso exclusivo para Web Técnica) han sufrido modificaciones.

Índice Principal

Guía detallada

Métodos REST afectados:

Obtener recursos de infraestructura (listado y detalle)

No cambia la versión del método utilizada, pero debido a la retirada e inclusión de atributos, solo cambia la estructura de la respuesta.

GET /cgescms/recursos/infraestructura

Listado de recursos de infraestructura

GET /cgescms/recursos/infraestructura/{uuidRecurso}

Obtener recurso de infraestructura

Atributos deprecados

Atributos que sustituyen

{
    ...
    "recursos": [{
            ...
            "ubicacionFisica": {
                ...
                "edificio": {
                    ...
                    "planta": {
                        ...
						"sala": {
							"id": 0,
							"nombre": "string"
						}
                    }
                }
            }
        }
    ]
}

{
    ...
    "recursos": [{
            ...
            "ubicacionFisica": {
                ...
                "edificio": {
                    ...
                    "planta": {
                        ...
                        "seccion": {
                            "id": 0,
                            "nombre": "string",
                            "sala": {
                                "id": 0,
                                "nombre": "string"
                            }
                        }
                    }
                }
            }
        }
    ]
}

Crear y editar recursos de infraestructura

No cambia la versión del método utilizada, pero debido a la retirada e inclusión de atributos, solo cambia la estructura del cuerpo del mensaje.

POST /cgescms/recursos/infraestructura

Crear recurso de infraestructura

PUT /cgescms/recursos/infraestructura/{uuidRecurso}

Modificar recurso de infraestructura

Atributos deprecados	Atributos que sustituyen
"ubicacionFisica": { ... "edificio": { ... "planta": { ... "sala": { "id": 0 } } } }	"ubicacionFisica": { ... "edificio": { ... "planta": { ... "seccion": { "id": 0, "sala": { "id": 0 } } } } }

Ubicación física para contactos

No cambia la versión del método utilizada, pero debido a la retirada e inclusión de atributos, solo cambia la estructura de la respuesta.

GET /cges/links/contactos/{idContacto}

Obtener contacto según la clave recibida

Atributos deprecados

Atributos que sustituyen

"ubicacionFisica": {
	...
	"edificio": {
		...
		"planta": {
			...
			"sala": {
				"id": 0,
				"nombre": "string"
			}
		}
	}
}

"ubicacionFisica": {
	...
	"edificio": {
		...
		"planta": {
			...
			"seccion": {
				"id": 0,
				"nombre": "string",
				"sala": {
					"id": 0,
					"nombre": "string"
				}
			}
		}
	}
}

Para más información respecto al uso de métodos de la API, ver la definición.

Métodos que serán retirados

GET /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/salas

Obtener salas

POST /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/salas

Crear sala

PUT /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/salas/{idSala}

Modificar sala

Métodos que sustituyen

GET /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/secciones

Obtener sección

POST /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/secciones

Crear sección

PUT /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/secciones/{idSeccion}

Modificar sección

GET /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/secciones/{idSeccion}/salas

Obtener salas

POST /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/secciones/{idSeccion}/salas

Crear sala

PUT /cges/tablas/ubicaciones/{uuidUbicacion}/edificios/{idEdificio}/plantas/{idPlanta}/secciones/{idSeccion}/salas/{idSala}