Lineamientos para la

documentación de Habilitar y
Mantener Soluciones

1
 HABILITAR Y MANTENER SOLUCIONES
Recordemos que la documentación que se debe tener desde Habilitar y Mantener Soluciones es
la siguiente:

Documentos a identificar para aplicaciones nuevas ( solo para aplicaciones On premise con
despliegue manual. )

 Diseños detallados de preparación de nuevos ambientes y configuración de la aplicación.

Documentos a tener en cuenta siempre:

 Diseño de Arquitectura de la Solución.  
 Diseño Técnico detallado (Manual técnico de la solución).
 Diseño técnico de infraestructura(On-premise y/o Componentes Nube).
 Diseño de estrategia de migración (Si aplica).
 Diseño de seguridad (Si aplica)
 Manuales de Usuario.
 Hoja de datos técnicos.
 Formato Runbook de la solución (Aplica On-premise y Nube)
 Formato GIOTI Monitoreo
2
 HABILITAR Y MANTENER SOLUCIONES
La documentación que es creada por el equipo y los diferentes roles que apoyan la
construcción de la solución debe ser almacenada en el repositorio oficial definido por el
proceso el cual es la WiKi de Azure DevOps, la cual tendrá la siguiente estructura:

Dirección de Transformación y Soporte

Componente Mayor

Código de la Aplicación_Nombre
del Servicio
3
 HABILITAR Y MANTENER SOLUCIONES
Se debe poner la información en las carpetas o paginas que corresponda a la dirección de
transformación y soporte (Transformación y soporte para el Negocio y 
Transformación y soporte para Funciones Corporativas - luego se desprenden las subpáginas que
corresponden al componente mayor (en caso de que no este creada, se debe crear) y finalmente se debe
crear la subpágina del servicio, su nombre debe ir compuesto por el código único de la aplicación
(AWXXX, NUXXX) y conectado con un guion bajo (_)  el nombre del servicio como aparece en el inventario
de servicios.
**Recordar que el nombre como aparece en el inventario de servicios se puede validar con el Analista de
Servicios asignado al componente.
 
*Servicios por Componentes o módulos: Si existe un servicio que está compuesto por varios
componentes, se debe tener una subpágina por debajo de la subpágina del servicio y los componentes
deben ir allí anidados con el nombre y código único de la aplicación (AWXXX, NUXXX).

4
 HABILITAR Y MANTENER SOLUCIONES
En la siguiente imagen, se muestra las subpáginas que deben ser creadas para cada tipo de documentación,
por cada aplicación:

Dirección de Transformación y Soporte

Componente Mayor

Código de la Aplicación_Nombre
del Servicio

5
 HABILITAR Y MANTENER SOLUCIONES
Diseños de Arquitectura: Cuando una iniciativa impacte la aplicación se debe adjuntar el diseño de la
Arquitectura de la solución, relacionando el PMO correspondiente

6
 HABILITAR Y MANTENER SOLUCIONES
Los demás diseños como: Estrategias de migración (Si aplica), Diseño de seguridad (si aplica), Diseño de
Infraestructura, también debes manejarlo al igual que el diseño de arquitectura, si una iniciativa impacta tu
aplicación, estos diseños, se deben adjuntar asociándolos al PMO respectivo.

7
 HABILITAR Y MANTENER SOLUCIONES
Para el Runbook de la solución se debe seguir el lineamiento dado por Cloud aquí

8
 HABILITAR Y MANTENER SOLUCIONES
Para el Formato GIOTI Monitoreo seguir el lineamiento dado por Cloud y Operaciones aquí

9
Para los manuales de usuario, hojas de datos, manuales técnicos, puedes adjuntar los documentos o también pueden hacer uso
del editor de contenido de la WIKI de Azure DevOps y plasmar la información como contenido directo sin adjuntos, queda a criterio
del equipo.
Ejemplo para el documento “Hojas
de Datos”.

Adjuntando documentos.

Usando el
Editor de
contenido de
la Wiki.

10
 HABILITAR Y MANTENER SOLUCIONES
Para la creación de las subpáginas, debemos pararnos en la
pagina padre, allí se ven tres puntos de forma vertical y
damos click allí, nos aparece un menú y escogemos la opción
"+ add sub-page"

Por ultimo nos aparece una pagina de edición, para ingresar el nombre:

11
 IMPORTANTE A TENER EN CUENTA
 Se debe garantizar que cada aplicación tenga siempre obligatoriamente las subpáginas descritas en este
lineamiento.

 En el caso que el equipo requiera crear nuevas subpáginas hijas a la aplicación, que sean diferentes al
tipo de documento de los cuales se encuentran en la estructura actual, lo pueden hacer sin ningún
problema para administrar la documentación relacionada con su aplicación.

12
 IMPORTANTE A TENER EN CUENTA
 El equipo podrá si lo requiere crear subpáginas hijas solo a algunas paginas de la estructura actual(Diseños
técnicos, manuales de usuario, Hojas de datos), con el fin de ser mas claro en la documentación de su
aplicación:

Ejemplo para el documento

“Manuales de Usuario”,

13
 IMPORTANTE A TENER EN CUENTA
 En el caso de tener un diagrama base de arquitectura de la aplicación, si el equipo lo requiere, podrá copiar el
diagrama sin afectar la estructura de la documentación , y garantizando los nuevos diseños que se generen desde
una iniciativa. (lo mismo aplica para los diseños de Infraestructura – componentes nube y diseño de seguridad
cuando aplique.)

14
Muchas Gracias

15