Incluye información sobre la entidad Versión y su tratamiento en CMS
Consulta
Para obtener el listado de aplicaciones de CMS la API dispone del método:
Encontramos dos versiones disponibles, existiendo filtros comunes para ambas versiones y filtros que sólo pueden aplicarse en un caso u otro; la respuesta obtenida también varía según la versión.
- Ejecutando la v1.0, el listado de aplicaciones mostrará los atributos uuid, nombre y codigoAplicacion.
- La respuesta que encontramos en la definición del método en la API, se corresponde con la versión v1.1.
Para ambas versiones encontramos el filtro codigo , siendo este el código asociado a la consulta a ejecutar en función de las necesidades definidas en cada contrato. Los diferentes filtros por versión se encuentran listados en la descripción del método en la definición de la API.
Podemos consultar el detalle de una aplicación mediante el método disponible:
Además de los atributos propios de la entidad, en la respuesta visualizaremos la sección de enlaces que nos permite el acceso directo a información extendida sobre la aplicación:
Otro listado que es posible consultar es el de aplicaciones por plataforma, donde será requerido filtrar por el identificador de la plataforma (uuidPlataforma), el código de la plataforma (codigoPlataforma) o el identificador de la relación grupo lógico-entorno-plataforma (idRelGrpLogEntPlat).
Creación y edición
Es posible crear aplicaciones mediante el método disponible para tal fin:
Requisitos funcionales
- El nombre no puede superar los 100 caracteres ni puede existir otra aplicación con el mismo nombre.
- La descripción no puede superar los 255 caracteres.
- El código de la aplicación debe cumplirá los siguientes requisitos
- 9 caracteres como máximo.
- Alfanumérico.
- Todo en mayúscula.
- No puede comenzar por número.
- No puede contener espacios en blanco.
- El nombre corto de la aplicación no debe existir para otra.
- Los responsables asociados deben ser válidos.
- El proveedor sin expediente debe ser válido.
- El horario de uso no deberá superar los 250 caracteres.
- La disponibilidad debe contener un valor válido.
- El tipo de gestión debe ser válido.
- La suite aplicaciones deberá ser válida y estar en estado VIGENTE.
- El nivel de recepción CSU debe ser válido.
- El atributo número de usuarios potenciales no puede superar los 250 caracteres.
- El contrato indicado debe ser válido.
- La categoría de la aplicación debe ser válida.
También podremos modificar diferentes atributos de una aplicación mediante el método:
Requisitos funcionales
- La aplicación a modificar debe ser válida.
- Mismos requisitos a nivel de campos que en la creación.
No se permite dar de baja una aplicación si existe una relación grupo lógico-entorno-plataforma con alguna versión activa.
¡Importante!
Para realizar correctamente la modificación se debe enviar el recurso 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.
Entidades asociadas
Suite de aplicaciones
Podrá consultar la suite filtrando por el identificador de la aplicación que estamos consultando (uuidAplicacion) y con la versión v1.0.
Ejemplo /cgescms/suiteaplicaciones?uuidAplicacion=DEF95790523001FA875F000C29B08512
Se suministra un enlace en la consulta del listado y detalle de la aplicación.
La vinculación entre una aplicación y su suite se realiza a través de la actualización de la propia aplicación.
Versiones
Filtrando por el identificador de la aplicación que estamos consultando (uuidAplicacion) en la versión v1.0 podremos obtener las versiones de una aplicación.
En caso de querer distinguir entre versiones activas y versiones inactivas, puede utilizar el filtro estado.
Ejemplo /cgescms/versiones?uuidAplicacion=DEF95790523001FA875F000C29B08512
Se suministra un enlace en la consulta del listado y detalle de la aplicación.
Asociar versiones
Estas operaciones están limitadas a funcionalidades internas de las aplicaciones de Servicios Horizontales y casos excepcionales.
La asociación de nuevas versiones sobre una aplicación y la desactivación de versiones previas se realiza a través de la gestión de entrega a través de los siguientes métodos de la API:
El primer método se utiliza para la creación de la versión y su vinculación a su correspondiente aplicación mientras que el segundo método se emplea para la instalación en una plataforma, entorno y grupo lógico determinado.
Requisitos funcionales
- La aplicación debe ser válida y estar en estado VIGENTE.
- La versión a relacionar debe ser válida.
- La relación grupo lógico-entorno-plataforma debe ser válida y estar en estado VIGENTE.
Para lanzar un proceso de rollback para una versión relacionada, se puede hacer uso del método siguiente:
Requisitos funcionales
- La relación entre la versión y la relación grupo lógico-entorno-plataforma debe estar activa.
- La versión a relacionar debe ser válida.
- La relación grupo lógico-entorno-plataforma debe ser válida y estar en estado VIGENTE.
- La versión a enviar será aquella a la que se le quiere hacer el rollback, no la versión anterior a la que se quiere volver.
Relaciones grupo lógico-entorno-plataforma
Para obtener las plataformas en las que está desplegada la aplicación, se puede usar el siguiente método filtrando por el identificador de la aplicación que estamos consultando (uuidAplicacion) y el atributo estado con la versión v1.0.
Se obtiene así la relación de todas las versiones y las plataformas en las que están instaladas para una misma aplicación.
Ejemplo /cgescms/versiones/relgrplogentplats?uuidAplicacion=DEF95790523001FA875F000C29B08512&estado=0
Se suministra un enlace en la consulta del listado y detalle de la aplicación.
Áreas funcionales
Podemos comprobar el listado de áreas funcionales a las que se encuentra asociada una aplicación, filtrando por el identificador uuidAplicacion y el atributo estado con la versión v1.0.
Ejemplo /cgescms/areasfuncionales?uuidAplicacion=DEF95790523001FA875F000C29B08512&estado=0
Se suministra un enlace en la consulta del listado y detalle de la aplicación.
Asociar y quitar áreas funcionales
La aplicación se creará en estado inactivo hasta que se realice la asociación de al menos un área funcional; por lo tanto, al crear la aplicación será necesaria la ejecución del siguiente método:
Requisitos funcionales
- La aplicación debe ser válida.
- El área funcional debe ser válida y pertenecer al conjunto de datos obtenido de la consulta anterior.
- La relación no debe existir previamente.
Para eliminar relaciones entre aplicación y área funcional, existe el método:
Requisitos funcionales
- La aplicación debe ser válida.
- El área funcional debe ser válida.
- La relación debe existir previamente para poder ser eliminada.
Otras consultas relacionadas con aplicaciones
Información extendida de contactos
Se puede consultar información extendida sobre algunos contactos asociados a la aplicación a través de los enlaces correspondientes con la versión v1.0:
- Responsable de producto
- Responsable funcional
- Responsable de sistemas
Ejemplo /cges/links/contactos/D7FBBA7FEC7601F3BF97001CC47AFDA8
Expediente asociado
Además, se puede consultar el expediente asociado a la aplicación filtrando por el identificador uuidAplicacion y con la versión v1.0.
Ejemplo /cgescms/contratos?uuidAplicacion=DEF95790523001FA875F000C29B08512