Documentaciones

La pantalla Documentaciones es un repositorio jerárquico de documentos/manuales internos. Los documentos se organizan en un árbol (TreeList) con relación padre-hijo, y cada nodo tiene asociado un texto en formato RTF que se edita directamente desde la pantalla. Sirve para mantener manuales, instructivos, procedimientos y notas internas dentro del sistema.

Toda la estructura se guarda en la tabla Documentaciones, donde cada fila tiene Id, Id_Parent (nodo padre), Nombre y TextoRTF. El sistema crea automáticamente un nodo raíz "ROOT" la primera vez que no existe ningún documento.

Se accede desde el módulo de Documentos. Al abrir, se muestra una pantalla de espera (WaitForm), se carga el árbol completo (DataSourceDocumentaciones) y se expanden todos los nodos.

La ventana se divide en dos paneles (splitContainerControl1):

• Panel izquierdo: árbol de documentos (treeList1) con un cuadro de filtro (tx_ValueFilter) en la parte superior.
• Panel derecho: editor de texto RTF (rtb_DocumentoDoc) dentro de una pestaña, con su barra/ribbon de edición y el botón Guardar RTF (bb_GuardarRTF).

Sobre el árbol hay una barra de herramientas con: Refrescar, Agregar, Modificar y Eliminar, además de un menú contextual con Agregar, Modificar, Eliminar y Editar Nombre (Ctrl+E).

Al seleccionar un nodo se carga su texto RTF en el editor de la derecha.

El cuadro Filtro (tx_ValueFilter) filtra el árbol en vivo: al escribir (o presionar Enter) se ejecuta Filter(), que recorre los nodos y muestra solo los que contienen el texto buscado (en cualquiera de sus columnas), manteniendo visibles los nodos padre para conservar la jerarquía.

El árbol muestra los documentos jerárquicamente. La columna visible principal es Nombre (colNombre). Al enfocar un nodo:

• Se muestra su nombre en la etiqueta lb_Documento.
• Se carga su TextoRTF en el editor.
• Se habilita la barra de administración del nodo.

El botón Guardar RTF se habilita solo cuando el texto del editor difiere del estado inicial (hubo cambios); mientras hay cambios sin guardar, el panel del árbol queda deshabilitado para evitar perder la edición.

1. Abrir Documentaciones.
2. En el árbol, enfocar el nodo bajo el cual se quiere crear el documento.
3. Presionar Agregar y cargar el nuevo documento (hijo del nodo enfocado).
4. Seleccionar el nuevo nodo: el editor RTF de la derecha queda listo.
5. Escribir el contenido y presionar Guardar RTF; confirmar.
6. Para renombrar, clic derecho → Editar Nombre (o Ctrl+E), escribir el nuevo nombre y confirmar.

• Usá el filtro del panel izquierdo para ubicar rápido un documento dentro de un árbol grande; los padres se mantienen visibles.
• Antes de cambiar de nodo, guardá el RTF: mientras haya cambios sin guardar el árbol queda bloqueado.
• Al eliminar un nodo con hijos, el sistema avisa y los borra en cascada: revisá el contenido antes de confirmar.
• Ctrl+E edita el nombre inline; Esc cancela la edición del nombre.

El formulario FormDocumentaciones y su manager DocumentacionesManager no realizan llamadas a IsAllowedObject(...) ni KeyLicences...Access(...). El control de acceso se aplica a nivel del menú/módulo que invoca la pantalla, no dentro del formulario.

Basada en el análisis del formulario real de la v14

Formularios principales

Permisos reales

Tablas de base de datos principales

Relación con otros módulos / manuales

Notas para soporte

• El formulario está en VPNET_WinForms\ManualDocumentos; el manager DocumentacionesManager en VPNET_DataModel\Manager\Gestion\ManualDocumentos (EF Core sobre VisualPlenarioNetContext).
• El listado del árbol se carga con un SqlQuery que trae TextoRTF vacío por performance; el RTF real se lee on-demand al enfocar el nodo (TextRTF(id)).
• Existe campo Id_Seguridad_Grupo en la tabla, pero el formulario no aplica filtrado por grupo de seguridad en el código analizado: verificar contra el binario instalado si se requiere seguridad por documento.