ADesigner Studio

🧩 Descripción General

ADesigner Studio es una extensión para Visual Studio Code que se integra con Altura Designer's Suite, permitiendo la gestión, edición y ejecución eficiente de Nodos y Servicios directamente desde el editor.

⚙️ Funciones Principales

🔐 Gestión de Sesión

• Iniciar sesión: Accede con tus credenciales de Altura Designer's Suite para visualizar y administrar Nodos y Servicios según tus permisos.
  • Soporte para autenticación en dos pasos.
• Cerrar sesión: Finaliza la sesión de forma segura y limpia las carpetas locales.
  ⚠️ La información editada o duplicada sin sincronizar se perderá.

🧱 Gestión de Nodos y Servicios

• Actualizar: Sincroniza toda la información de los ambientes. Se advierte si hay cambios locales sin guardar.
• Buscar: Encuentra elementos dentro de ambientes o aplicaciones desplegadas.
• Crear Grupo: Organiza elementos dentro de contenedores lógicos.
• Crear Elemento (Nodo/Servicio): Agrega nuevos elementos a grupos existentes.
• Abrir: Visualiza y edita contenido XML en el editor.
• Duplicar: Crea una copia exacta de un elemento con nuevo ID.
• Sincronizar: Guarda los cambios con un comentario descriptivo obligatorio.
• Historial de versiones: Consulta y compara versiones, restaura versiones anteriores.

⏺️ Iconos de Nodos y Servicios

• Circulo lleno: Elemento estado sincronizado y además Activo
• Circulo vacío: Elemento estado Inactivo
• Nube azul: Elemento nuevo agregado(solo existe de manera local, no ha sido sincronizado)
• Nube naranja: Elemento editado(no han sido sincronizado)

🚀 Funcionalidades Avanzadas

▶️ Ejecución de Elementos

• Ejecuta Nodos y Servicios directamente desde la extensión.
• Solicita parámetros necesarios (wait, id_operacion, etc.).
• Muestra los resultados (tiempo, estado y respuesta JSON) en un canal de salida dedicado por consola(opcional puedes ver una vista web acerca de estos detalles). Esto generá en un ruta de logs de ejecuciones.

🔄 Gestión del Ciclo de Vida

• Activar/Desactivar: Alterna entre 'Activo' e 'Inactivo'.
• Cambiar a Grupo: Reorganiza elementos entre grupos.

⚠️ Estas acciones descartan cambios locales no sincronizados y requieren confirmación.

🔎 Validaciones Clave para el Usuario

Conoce las validaciones automáticas incorporadas para evitar errores y trabajar con mayor eficiencia.

🧾 Validaciones al Crear o Duplicar

• Longitud de ID:
  • Grupo: 3–25 caracteres.
  • Nodo/Servicio: 6–30 caracteres.
• Caracteres no permitidos: < > : " / \ | ? * # .
• Sin espacios en el ID.
• Nombres reservados prohibidos:

  AUX, NUL, CON, PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM0,
  LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, LPT0
  

  Nota: En macOS, aunque no existen las mismas restricciones que en Windows, es recomendable evitar caracteres especiales en los nombres de nodos y grupos.

💾 Validaciones al Sincronizar (Guardar)

Al guardar un Nodo o Servicio se validan:

• Comentario obligatorio: Mínimo 30 caracteres.
• Sintaxis XML válida: El XML debe estar bien formado.
• Encapsulado con CDATA: Caracteres como <, >, &, {, } deben ir dentro de <![CDATA[...]]>.
• Coherencia de identificadores: <nombre_servicio> debe coincidir con el ID del servicio.
• Etiquetas únicas: No deben existir duplicados como <estado> o <url>.
• Campos obligatorios: Por ejemplo, <url> no debe estar vacío.
• Atributo isNew="true": Requerido para nuevos sub-elementos (<header>, <operation>, <collection>).

⚠️ Validaciones de Acciones Críticas

• Advertencia por cambios no sincronizados: Antes de acciones como Actualizar, Cambiar Estado o Cambiar de Grupo, se detectan ediciones sin guardar y se solicita confirmación.

🧪 Pre-validación al Ejecutar

• URL de ejecución: Debe estar configurada correctamente en el ambiente.
• Elemento no sincronizado: No se puede ejecutar un elemento recién creado o duplicado hasta que sea sincronizado.

📑 Validaciones XML para Servicios

🏗️ Estructura y Sintaxis

• XML bien formado (sin etiquetas mal cerradas ni caracteres inválidos).
• Única etiqueta raíz <service>.
• Secciones <headers> y <operations> no deben duplicarse.
• Las etiquetas hijas deben ser correctas (<header>, <operation>).

📋 Validaciones de Contenido

• Obligatorios: <url>, <tipo_ws>, <metodo>, <tipo_autenticacion>.
• Valores válidos:
  • <estado>: 'A' o 'I'
  • <metodo>: 'GET' o 'POST'
• Para servicios SOAP, se requiere <xml_envio>.

🧠 Validaciones de Contexto

• Sub-elementos nuevos deben llevar isNew="true".
• El valor de <nombre_servicio> debe coincidir con el ID editado.

✅ Recomendaciones Finales

• Usa nombres únicos para Nodos, Servicios y Grupos.
• Desactiva AutoSave en VS Code para evitar conflictos.
• Elimina manualmente mensajes de error XML persistentes tras corregirlos.
• Guarda frecuentemente para evitar la pérdida de cambios locales.