Estás viendo una versión antigua de esta página. Ve a la versión actual.

Comparar con el actual Ver el historial de la página

« Anterior Versión 14 Siguiente »

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:

GET /cgescms/aplicaciones
Obtener aplicaciones


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:

GET /cgescms/aplicaciones/{uuidAplicacion}
Obtener aplicación

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).

GET /cgescms/aplicaciones/plataforma
Obtener aplicaciones por plataforma

Creación y edición

Es posible crear aplicaciones mediante el método disponible para tal fin:


POST /cgescms/aplicaciones
Crear aplicación


La aplicación se creará en estado temporal hasta que se relacione con una área funcional.


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:


PUT /cgescms/aplicaciones/{uuidAplicacion}
Modificar aplicación


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.


GET /cgescms/suiteaplicaciones
Obtener suites de aplicaciones


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.


GET /cgescms/versiones
Obtener versiones por aplicación

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:


POST /cgescms/versiones
Alta de versiones en CMS
POST /cgescms/versiones/{idVersion}/relgrplogentplats
Relacionar versión en CMS

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:


DELETE /cgescms/versiones/{idVersion}/relgrplogentplats/{idRelGrpLogEntPlat}
Eliminar versión


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.


GET /cgescms/versiones/relgrplogentplats
Obtener versiones y grupos lógicos activos (por 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.


GET /cgescms/areasfuncionales
Obtener áreas funcionales

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:


POST /cgescms/aplicaciones/{uuidAplicacion}/areasfuncionales
Obtención de token

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:


DELETE /cgescms/aplicaciones/{uuidAplicacion}/areasfuncionales/{uuidAreaFuncional}
Eliminar relación de aplicación y área funcional

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


GET /cges/links/contactos/{idContacto}
Obtener contacto según la clave recibida

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.


GET /cgescms/contratos
Obtener contratos

Ejemplo /cgescms/contratos?uuidAplicacion=DEF95790523001FA875F000C29B08512

  • Sin etiquetas