3270 Campos

Descripción General #

El comando 3270 Campos pertenece a la categoría de automatización para terminales de tipo TN3270. Su función principal es relevar el mapa completo de campos detectables dentro de la pantalla emulada actual y almacenar este inventario estructurado dentro de un contenedor o categoría de STELA. Esto resulta indispensable para explorar el diseño de pantallas mainframe desconocidas, auditar propiedades de campos dinámicos o diagnosticar fallas de interacción en el flujo de automatización.

Ejemplo de Uso Rápido #

Imagina que el robot acaba de acceder a una nueva pantalla del sistema legacy y necesitas conocer la cantidad y la ubicación exacta de todos los campos interactivos presentes:

• Agregas el comando 3270 Campos especificando el nombre del contenedor CamposPantalla3270.
• Al ejecutarse este paso, STELA inspecciona la terminal TN3270 y genera automáticamente un inventario en memoria con el total de campos y sus atributos (como fila, columna, valor y si se encuentra protegido).
• Posteriormente, puedes consultar los elementos de esa categoría para validar la disponibilidad de un campo antes de escribir sobre él.

Parámetros y Opciones #

Para relevar los campos de la terminal, el comando utiliza el siguiente parámetro opcional:

• Categoría (requerido): Nombre del contenedor de STELA en el cual se guardará el inventario completo de los campos detectados en la pantalla.
  • Si se especifica un nombre (ej. CamposLogin), los datos se almacenan en dicho contenedor.
  • Si se omite este parámetro, STELA utiliza una categoría por defecto para guardar el relevamiento.

Estructura de Datos Generada #

Una vez ejecutado el comando, STELA guarda en la categoría elegida los siguientes elementos para su reutilización:

• Cantidad de campos: Número total de áreas o campos reconocidos en la grilla de la pantalla.
• Atributos por campo: Para cada campo detectado se extrae:
  • Identificador técnico o código interno del campo.
  • Texto o valor visible contenido en la pantalla.
  • Coordenada de fila inicial.
  • Coordenada de columna inicial.
  • Estado de protección (Protegido / Solo lectura o editable).
  • Clasificación o tipo de campo en la emulación TN3270.

Ejemplos de Uso Avanzado #

• Inspección completa de una pantalla transaccional: Releva todos los campos visibles en la pantalla principal para validar la carga dinámica de la interfaz.
  • Configuración: categoría: CamposPantalla3270
• Diagnóstico de campos editables antes de la carga: Almacena el inventario bajo el contenedor CamposFormulario para verificar mediante comandos condicionales cuántos campos no protegidos existen en la sesión.
  • Configuración: categoría: CamposFormulario
• Relevamiento usando el contenedor por defecto: Invoca la inspección de la pantalla activa sin indicar un contenedor explícito, guardando la información en la categoría estándar de la ejecución.
  • Configuración: categoría: (vacío)

Errores Comunes y Soluciones #

• Error: El inventario de campos se genera incompleto o con datos desactualizados.
  • Solución: Asegúrate de ejecutar un comando 3270 Espera antes de invocar 3270 Campos. Esto garantiza que la terminal haya terminado de procesar la respuesta del mainframe y haya renderizado la pantalla completa.
• Error: Falla la ejecución por falta de conexión activa con el mainframe.
  • Solución: Comprueba que la sesión TN3270 haya sido abierta previamente con el comando 3270 Conectar y que la conexión no se haya cerrado por inactividad.
• Error: No se pueden recuperar los valores del contenedor generado.
  • Solución: Verifica haber escrito correctamente el nombre asignado al parámetro categoría y recuerda que los sub-elementos generados por STELA se consultan mediante la sintaxis de variables o etiquetas asociadas a esa categoría.