Historial de página

Tabla de contenidos

Presentación de hijos

Índice Principal

Presentación de hijos

page	API REST Servicios CGES

Modelo de entidad-relación a un nivel

draw.io Diagram

border	true

diagramName	Diagrama sin título-1722420819139
simpleViewer	false
width
links	auto
tbstyle	top
lbox	true
diagramWidth	955
height	805
revision	4

UI Expand

title	Desglose de atributos

de recurso

Atributo	Descripción	Entidad / Tabla Maestra
Nombre	Nombre del recurso de infraestructura
Tipo	Tipo del recurso, que a su vez pertenece a una familia	Tipos de recurso
Familia	Familia del recurso

,

(se edita cambiando el tipo)	Familias de recurso
Numero de serie
Modelo	Modelo del recurso, que a su vez pertenece a una marca	Modelos
Marca	Marca del recurso

,

(se edita cambiando el modelo)	Empresas
Ubicación	Ubicación del recurso	Ubicaciones
Edificio	Edificio de la ubicación donde está el recurso	Edificios
Planta	Planta del edificio donde se ubica el recurso	Plantas
Sección	Sección de la planta donde se ubica el recurso	Secciones
Sala	Sala de la

planta

sección donde se ubica el recurso	Salas
Rack	Rack donde está conectado el recurso
Toma de red	Toma de red donde está conectado el recurso
Conmutador	Conmutador donde está conectado el recurso
Boca	Boca donde está conectado el recurso
MAC	MAC principal
MAC2	MAC alternativa
IP	Dirección IP
Código SAS
Criticidad	Nivel de criticidad	Prioridades
Contacto asignado	Contacto primario del recurso	Contactos
Departamento organizativo	Organización

asociada

o departamento encargado	Organizaciones
Estado	Estado de la entidad	Estados del recurso
Notas	Notas sobre el recurso
Fecha de última modificación	Fecha en la que la entidad fue modificada por última vez
Modificado por	Usuario que modificó la entidad por última vez
Responsable de hardware	Usuario responsable del equipamiento	Contactos
Dominio
Fecha de último inventario	Fecha de último registro sobre el inventario
Código de recepción

Código de recepción del recurso


Software	El recurso está catalogado como software
Hardware	El recurso está catalogado como hardware
Fecha de adquisición
Fecha de

adquisición del recursoFecha de cambio recienteFecha de cambio reciende del recurso

cambio reciente

FHS

Factor de horario del servicio.

Esfuerzo de mantenimiento del hardware en base al horario de prestación del servicio

FHS

FMS

Factor de modelo-soporte genérico (se edita cambiando el modelo).

Esfuerzo en mantener el hardware de un modelo y fabricante concreto.

FHSFHS

	FMS
FMS específico	FMS sobreescrito para un recurso en específico	FMS
Tipo de mantenimiento básico	¿Tiene mantenimiento básico?
Soporte del fabricante	¿Cuenta con soporte del fabricante?
Contacto habitual Altiris	Contacto habitual del equipo registrado por Altiris
Último contacto Altiris	Último usuario logado en el equipo registrado por Altiris
Expediente de compra	Expediente bajo el cual se realizó la adquisición del recurso	Contratos
Contrato de mantenimiento	Contrato para el mantenimiento y soporte del recurso	Contratos

UI Expand

title	Desglose de atributos de ubicación

AtributoDescripciónEntidad / Tabla MaestraNombreNombre del centro o ubicaciónCiudadCiudad del centroCódigo postalFaxContactoContacto del centroContactos

Latitud

LongitudContacto de la sedeContactosTeléfono de contactoHorario de centro - LunesHorario de centro - MartesHorario de centro - MiércolesHorario de centro - JuevesHorario de centro - ViernesHorario de centro - SábadoHorario de centro - DomingoÁreaProvinciaNodoCódigo de área UI Expand

title	Desglose de atributos de contratos, puestos de trabajo y redes

Consulta

La API REST de Servicios CGES permite la consulta de todos los recursos de infraestructura (hardware) que pueden ser gestionados por el proveedor que realiza la llamada.

Los filtros disponibles y la información extraída en el listado son únicos para todos los usuarios de la API.
El parámetro uuid que devuelve el listado será el utilizado para realizar el resto de las operaciones con cada uno de los recursos contenidos en el mismo.

También será posible el empleo del parámetro codigo para la consulta segmentada de subconjuntos predefinidos para el total de recursos de infraestructura.

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);

Información sobre el contrato de mantenimiento (lectura)

AtributoDescripciónEntidad / Tabla MaestraNombreFecha de inicio de contratoFecha de fin de contratoDescripciónProveedor de mantenimientoContactos

Información sobre el expediente de compra (lectura)

AtributoDescripciónEntidad / Tabla MaestraNombreFecha de inicio de contratoFecha de fin de contratoDescripciónProveedor de garantíaContactos

Información extendida de puestos de trabajo

AtributoDescripciónEntidad / Tabla MaestraTipo de procesadorNúmero de procesadoresVelocidad del procesadorMemoria RAMCapacidad del discoNúmero de serie de la placa baseSistema operativoSistemas operativosFecha BIOSSubnet

Información extendida de redes

AtributoDescripciónEntidad / Tabla MaestraNombre de redIP de gestiónMáscara de subredTecnologíaProtocoloFlujo

Consulta

La API REST de Servicios CGES permite la consulta de todos los recursos de infraestructura (hardware) que pueden ser gestionados por el proveedor que realiza la llamada.

Los filtros disponibles y la información extraída en el listado son únicos para todos los usuarios de la API.
El parámetro uuid que devuelve el listado será el utilizado para realizar el resto de las operaciones con cada uno de los recursos contenidos en el mismo.

También será posible el empleo del parámetro codigo para la consulta segmentada de subconjuntos predefinidos para el total de recursos de infraestructura.

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Listado de recursos de infraestructura</div>
</div>
<div></div></div>

Los recursos de infraestructura pertenecen a un tipo concreto, y a su vez, estos tipos están agrupados en familias.
Estas son las familias que conforman el conjunto de recursos de infraestructura y que pueden gestionarse (dependiendo el perfil del proveedor) desde este apartado de la API:

Familia Hardware: Comprende equipos y elementos de hardware como monitores, impresoras, puestos de trabajo, servidores, etc.
- Hardware.Puesto de Trabajo
- Hardware.Impresoras
- Hardware.Monitor
- Hardware.Servidor
- ...
Familia Redes: Comprende elementos vinculados a comunicaciones como líneas, routers, switches, etc.
- Redes.Electrónica de Red
- Redes.Servicio de Datos
- Redes.Otros

Es posible consultar las familias y tipos disponibles en los siguientes métodos de tablas maestras de la API:

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/tablas/recursos/familias</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener familias de recursos</div>
</div>
</div>
<divdiv></div></div><div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/tablas/recursos/tipos</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener tipos de recursos</div>
</div>
<div></div></div>

Expandir

title	Capacidad de gestión por contrato

Familia	Tipo	Gestionable por...	Consulta segmentada
Hardware.Puesto de Trabajo	Todos	Soporte Provincial / AT2	codigo=PUESTOS_TRABAJO
Hardware.Monitor	Todos	Soporte Provincial / AT2	codigo=MONITORES
Hardware.Impresoras	Todos	Soporte Provincial / AT2	codigo=IMPRESORAS
Redes.Servicio de Datos	Linea Principal	Sistemas AT1	codigo=LINEAS
	Linea Backup	Sistemas AT1	codigo=LINEAS
	Direccionamiento	Sistemas AT1	codigo=DIRECCIONAMIENTOS
Redes.Electrónica de Red	Router Principal	Sistemas AT1	codigo=ROUTERS
	Router Respaldo	Sistemas AT1	codigo=ROUTERS
	Resto	Sistemas AT1 / Soporte Provincial / AT2	codigo=HWCPDYOTROS
Resto de familias	Todos	Sistemas AT1 / Soporte Provincial / AT2	codigo=HWCPDYOTROS

Para obtener más información acerca de un recurso de infraestructura se puede consultar el método destinado a tal fin en la API.

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/{uuidRecurso}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener recurso de infraestructura</div>
</div>
<div></div></div>

Este método devuelve información detallada del recurso de hardware como, por ejemplo, el número de serie, código SAS, la marca, el modelo, la ubicación, el estado y otros datos de interés.

La capacidad de consulta es análoga a la capacidad de gestión en los listados.

Además, en función de la familia y el tipo del recurso, podrá consultar algunos enlaces extendidos para extraer otra información adicional (ver apartados siguientes).

Creación y edición

Es posible realizar la creación de un recurso mediante el siguiente método:

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div><div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Crear recurso de infraestructura</div>
</div>
<div></div></div>

Requisitos funcionales

Advertencia
Debe enviarse siempre la estructura de datos completa del recurso. En caso de elementos opcionales que no quieran informarse, enviar null para borrar el dato.

- El nombre es obligatorio y debe tener un máximo de 100 caracteres.
- El tipo es obligatorio y debe ser un tipo válido y permitido para el proveedor.
- El modelo debe ser válido (únicamente opcional para líneas y direccionamientos).
- El número de serie es obligatorio y no debe existir en el sistema. Máximo 64 caracteres.
- El código SAS es opcional salvo para los recursos de tipo Puesto de Trabajo, Monitores e Impresoras.
- El código SAS y debe cumplir con un formato válido (6/7 cifras y una letra).
  - Formato Código SAS: ^\d{6,7}\D$
- Los valores de IP y MAC son opcionales, deben tener un máximo de 64 caracteres y cumplir con formatos válidos.
  - Formato IP: ^([01]?\d?\d|2[0-4]\d|25[0-5])(\.([01]?\d?\d|2[0-4]\d|25[0-5])){3}$
  - Formato MAC: ^[0-9A-F]{2}(-[0-9A-F]{2}){5}$
- La criticidad es obligatoria y debe ser válida.
- El parámetro notas es opcional y tiene un máximo de 255 caracteres.
- La ubicación del recurso debe ser válida y es obligatoria.
- Los parámetros de edificio.id, edificio.planta.id, edificio.planta.seccion.id y y edificio.planta.seccion.sala.id son opcionales y, en caso de informarse:
  - El identificador del edificio debe pertenecer a la ubicación del recurso.
  - El identificador de la planta debe pertenercer pertenecer al edificio enviado.
  - El identificador de la sección debe pertenecer a la planta enviada.
  - El identificador de la sala, debe pertenecer a la planta seleccionadasección enviada.
- En caso de recursos de tipo "Puesto de Trabajo", un técnico no podrá editar la ubicación, edificio, planta, sección o sala si el recurso tiene bloqueada su edición.
- Los parámetros de ubicación física son opcionales y deben cumplir lo siguiente:
  - Los parámetros sala, rack y toma de red deben tener un máximo de 30 caracteres.
  - El parámetro boca debe tener un máximo de 100 caracteres.
  - El parámetro conmutador debe tener un máximo de 255 caracteres.
- El departamento organizativo es opcional y debe ser una organización válida en caso de informarse.
- El contacto asignado es opcional y debe ser válido en caso de informarse.
- El responsable hardware es opcional y debe ser válido en caso de informarse.

En caso de querer registrar información adicional de puestos de trabajo o redes durante la creación, deberá lanzar primero este método y luego actualizar estos valores con los métodos disponibles (ver apartados posteriores).

Requisitos funcionales específicos para el proveedor de mantenimiento HW

- Sólo se permite la creación de recursos para ser utilizados como recursos de sustitución.
- El recurso quedará en un estado temporal y sin contrato hasta ser utilizado en la acción de sustitución de la solicitud.
- El proveedor podrá informar los campos extendidos de redes para aquellos recursos de un tipo compatible.
- El proveedor no tiene disponible la edición de recursos.

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #fca130;background: rgba(252,161,48,.1);">
<div><div style="border-color: #fca130;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #fca130;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">PUT</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/{uuidRecurso}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Modificar recurso de infraestructura</div>
</div>
<div></div></div>

Advertencia

title	¡Importante!

Para realizar correctamente la modificación se debe enviar el objeto completo cada vez que se consuma este recurso.
En caso de no enviar alguno de los valores, el recurso borrará la información para los atributos no informados.

Requisitos funcionales comunes

El recurso debe ser gestionable por el proveedor (visualizable en su listado)
Debe cumplir con los requerimientos de obligatoriedad y formato expresados en la creación.
El número de serie no es modificable.
No se podrá modificar el tipo a Router Principal (1000103) o Router Respaldo (1000606) en recursos que sean de la familia Redes.Electronica de red.

Existen tres versiones diferentes para la modificación de recursos de infraestructura:

v1.0 - Modificar recurso de infraestructura: Permite modificar al completo un recurso.

Requisitos funcionales

Debe enviarse siempre la información completa del recurso al editar.
Es obligatorio enviar el estado y debe ser válido.
En caso de cambiar el estado, el cambio debe estar permitido dentro de la matriz de estados de recursos.
Sólo se puede modificar el tipo dentro de una misma familia y si el recurso tiene expediente de compra DESCONOCIDO.
El modelo sólo podrá modificarse si el recurso tiene el expediente de compra DESCONOCIDO y si no tiene un contrato de mantenimiento en vigor.
El modelo debe ser compatible con el tipo de recurso.
La criticidad no es editable para operadores (solo para coordinadores).
Los recursos federados por ALTIRIS (cuentan con MDR de ALTIRIS_SAS asociado) tendrán limitada la edición a los siguientes campos, edificio, planta, seccion, sala, rack, toma de red, boca, conmutador, departamento organizativo y/o contacto asignado, no pudiéndose editar ningún otro.
En caso de recursos de tipo "Puesto de Trabajo", un técnico no podrá editar la ubicación, edificio, planta, sección o sala si el recurso tiene bloqueada su edición.

v2.0 - Modificar información de contratos para un recurso de infraestructura (de uso reservado para coordinadores de mantenimiento de hardware).

Requisitos funcionales

- Debe enviarse siempre la información completa del recurso al editar.
- El tipo de mantenimiento básico es obligatorio si el contrato es el contrato de mantenimiento hardware.
- Los valores del FMS específico y el FHS son opcionales.
- El soporte del fabricante es obligatorio cuando el tipo de mantenimiento básico no esté activo.
- En caso de informar un contrato de mantenimiento para el recurso, este debe ser válido y tener las fechas de contrato en vigor.

v3.0 - Modificar recurso de infraestructura (de uso reservado para ayudaDIGITAL Escritorio).

Requisitos funcionales

- Debe enviarse siempre la información completa del recurso al editar.
- Sólo se puede modificar el tipo dentro de una misma familia y si el recurso tiene expediente de compra DESCONOCIDO.
- El modelo sólo podrá modificarse si el recurso tiene el expediente de compra DESCONOCIDO y si no tiene un contrato de mantenimiento en vigor.
- El modelo debe ser compatible con el tipo de recurso.
- Los recursos sólo son editables si están federados por ALTIRIS (cuentan con MDR de ALTIRIS_SAS asociado).
- No se edita el campo notas.se edita el campo notas.
- La edición de puestos de trabajo por este método bloquea la edición a técnicos de los campos de ubicacion, edificio, planta, seccion y sala

Información adicional

Para consultar los MDR asociados al recurso y crear nuevos vínculos, se puede hacer uso del siguiente conjunto de métodos:

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/{uuidRecurso}/mdr</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener MDRs (por recurso)</div>
</div>
</div>
<divdiv></div></div><div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div><div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/{uuidRecurso}/mdr</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Crear relación entre recurso de infraestructura y MDR</div>
</div>
<div></div></div>

Información adicional por familias

Información adicional de puestos de trabajo

Este método permite consultar la información adicional acerca de un recurso de la familia "Hardware.Puesto de trabajo"

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/puestostrabajo/{uuidRecurso}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener información extendida de un puesto de trabajo</div>
</div>
</div> sans-serif;color: #3b4151;">Obtener información extendida de un puesto de trabajo</div></div></div>

UI Expand

title	Desglose de atributos extendidos de puestos de trabajo

Atributo	Descripción	Entidad / Tabla Maestra
Tipo de procesador
Número de procesadores	Cantidad de procesadores instalados en el equipo
Velocidad del procesador	Velocidad de los procesadores instalados
Memoria RAM	Memoria RAM instalada
Capacidad del disco	Capacidad de almacenamiento del equipo
Número de serie de la placa base
Sistema operativo		Sistemas operativos
Versión del sistema operativo		Versiones de sistemas operativos
Fecha BIOS
Subred
Bloqueo del cambio de ubicación	Indica si el recurso tiene limitada la edición de los atributos de ubicación, edificio, planta, sección y sala a técnicos

Información adicional de redes

Este método permite consultar la información adicional acerca de un recurso de las familias de "Redes"

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/redes/{uuidRecurso}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener información extendida de una red</div></div>
</div>
</div>div></div>

UI Expand

title	Desglose de atributos extendidos de redes

Atributo	Descripción	Entidad / Tabla Maestra
Nombre de red
IP de gestión
Máscara de subred
Tecnología
Protocolo
Flujo

Información adicional de máquinas virtuales

Este método permite consultar la información adicional acerca de un recurso de la familia "Hardware.Maquina Virtual"

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/maquinasvirtuales/{uuidRecurso}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener información extendida de una máquina virtual</div></div>
</div>
</div>div></div>

UI Expand

title	Desglose de atributos extendidos de máquinas virtuales

Atributo	Descripción	Entidad / Tabla Maestra
Subred
Fecha BIOS
Versión del sistema operativo		Versiones del sistema operativo

Información adicional de servidores

Este método permite consultar la información adicional acerca de un recurso de la familia "Hardware.Servidor"

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/servidores/{uuidRecurso}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener información extendida de un servidor</div>
</div>
</div>/div></div></div>

UI Expand

title	Desglose de atributos extendidos de servidores

Atributo	Descripción	Entidad / Tabla Maestra
Subred
Fecha BIOS
Versión del sistema operativo		Versiones del sistema operativo

También es posible modificar la información extendida de los recursos, empleado los siguientes métodos:

Actualizar información adicional de puestos de trabajo

El siguiente método permite actualizar la información adicional de un recurso de la familia "Hardware.Puesto de trabajo" utilizando su versión v2.0.

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #fca130;background: rgba(252,161,48,.1);">
<div><div style="border-color: #fca130;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #fca130;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">PUT</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/puestostrabajo/{uuidRecurso}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Actualiza la información extendida de un puesto de trabajo</div>
</div>
<div></div></div>

Advertencia

title	¡Importante!

Para realizar correctamente la modificación se debe enviar el objeto completo cada vez que se consuma este recurso.
En caso de no enviar alguno de los valores, el recurso borrará la información para los atributos no informados.

Requisitos funcionales

El recurso debe ser gestionable por el proveedor (visualizable en su listado)
Todos los campos son opcionales.
La memoria RAM admite un máximo de 15 caracteres.
La capacidad de disco admite un máximo de 15 caracteres.
El número de serie de la placa base admite un máximo de 50 caracteres.
El sistema operativo debe ser válido.
El tipo de procesador admite un máximo de 15 caracteres.
La velocidad del procesador admite un máximo de 15 caracteres.
La subnet admite un máximo de 50 caracteres.
La fecha de la BIOS admite un máximo de 15 caracteres.
El bloqueo de cambio de ubicación solo puede editarlo el perfil de Coordinador de Puesto de Usuario.
El modo kiosko indica que el equipo se encuentra dando servicio como equipo desatendido.

Actualizar información adicional de redes

El siguiente método permite actualizar la información adicional acerca de un recurso de las familias de "Redes".

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #fca130;background: rgba(252,161,48,.1);">
<div><div style="border-color: #fca130;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #fca130;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">PUT</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/redes/{uuidRecurso}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Actualiza la información extendida de una red</div>
</div>
<div></div></div>

Advertencia

title	¡Importante!

Para realizar correctamente la modificación se debe enviar el objeto completo cada vez que se consuma este recurso.
En caso de no enviar alguno de los valores, el recurso borrará la información para los atributos no informados.

Requisitos funcionales

El recurso debe ser gestionable por el proveedor (visualizable en su listado)
Todos los campos son opcionales.
El nombre de red admite un máximo de 50 caracteres.
La IP de gestión admite un máximo de 50 caracteres.
La máscara de subred admite un máximo de 50 caracteres.
La tecnología admite un máximo de 50 caracteres.
El protocolo admite un máximo de 15 caracteres.
El flujo admite un máximo de 50 caracteres.

Entidades asociadas

Contratos

El siguiente método permite obtener los contratos vinculados a un recurso de infraestructura.

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/{uuidRecurso}/contratos</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Obtener contratos (por recurso)</div>
</div>
</div>/div></div></div>

UI Expand

title	Desglose de atributos de contratos

Información sobre el contrato de mantenimiento (lectura)

Atributo	Descripción	Entidad / Tabla Maestra
Nombre
Fecha de inicio de contrato
Fecha de fin de contrato
Descripción
Proveedor de mantenimiento		Contactos

Información sobre el expediente de compra (lectura)

Atributo	Descripción	Entidad / Tabla Maestra
Nombre
Fecha de inicio de contrato
Fecha de fin de contrato
Descripción
Proveedor de garantía		Contactos

Entidades asociadas para provisión de datos

Relaciones entre líneas y routers

Se puede crear y eliminar vínculos entre líneas y routers mediante el uso de los siguientes métodos:

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div><div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/lineas/{uuidLinea}/routers</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Vincular líneas y routers (provisión de datos)</div>
</div>
</div>
<divdiv></div></div><div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #f93e3e;background: rgba(249,62,62,.1);">
<div><div style="border-color: #f93e3e;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #f93e3e;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">DELETE</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cgescms/recursos/infraestructura/lineas/{uuidLinea}/routers/{uuidRouter}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Desvincular líneas y routers (provisión de datos)</div>
</div>
<div></div></div>

Requisitos funcionales

La relación entre líneas y routers es única, no pudiendo existir más de un vinculo para una misma línea o router.
Sólo se pueden vincular recursos de estos tipos, sin ser posible realizar vinculaciones cruzadas entre elementos principales y de respaldo:
- "Linea Principal" con "Router Principal".
- "Linea Backup" con "Router Respaldo".

Subida y descarga de imágenes

La subida de imágenes está limitada a 20 MB y tiene los siguientes métodos para utilizar:

HTML

<div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #49cc90;background: rgba(73,204,144,.1);">
<div><div style="border-color: #49cc90;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #49cc90;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">POST</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/tablas/recursos/{uuidRecurso}/imagenes</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Subida de imágenes a un recurso</div>
</div>
</div>
<divdiv></div></div><div style="margin: 0 0 15px;margin-top: 0px;margin-right: 0px;margin-bottom: 15px;margin-left: 0px;border: 1px solid #000;border-radius: 4px;-webkit-box-shadow: 0 0 3px rgba(0,0,0,.19);box-shadow: 0 0 3px rgba(0,0,0,.19);border-color: #61affe;background: rgba(97,175,254,.1);">
<div><div style="border-color: #61affe;display: flex;-webkit-box-align: center;align-items: center;padding: 5px;">
<span><span style="background: #61affe;font-size: 14px;font-weight: 700;min-width: 80px;padding: 6px 15px;text-align: center;border-radius: 3px;text-shadow: 0 1px 0 rgba(0,0,0,.1);font-family: sans-serif;color: #fff;">GET</span>
<spanspan><span style="font-size: 16px;display: -webkit-box;display: -ms-flexbox;display: flex;-webkit-box-flex: 0;-ms-flex: 0 3 auto;flex: 0 3 auto;-webkit-box-align: center;-ms-flex-align: center;align-items: center;word-break: break-all;padding: 0 10px;font-family: monospace;font-weight: 600;color: #3b4151;">/cges/tablas/adjuntos/imagenes/{idImagen}</span>
<divspan><div style="font-size: 13px;-webkit-box-flex: 1;-ms-flex: 1;flex: 1;font-family: sans-serif;color: #3b4151;">Descarga de imagen</div>
</div>
<div></div></div>

En caso de la subida, el contenido del fichero debe suministrarse en base 64. Tipos de fichero permitidos: jpg, jpeg y png.

Accesos directos de espacio

Árbol de páginas

Versiones comparadas

Versión anterior 43

Nueva versión Actual

Clave

Modelo de entidad-relación a un nivel

Consulta

Consulta

Creación y edición

Información adicional

Información adicional por familias

Información adicional de puestos de trabajo

Información adicional de redes

Información adicional de máquinas virtuales

Información adicional de servidores

Actualizar información adicional de puestos de trabajo

Actualizar información adicional de redes

Entidades asociadas

Contratos

Entidades asociadas para provisión de datos

Relaciones entre líneas y routers

Subida y descarga de imágenes