Interacción Básica con el Host

Este ejemplo muestra la interacción básica con el host, incluyendo:

Todas las macros tienen disponibles los siguientes objetos de forma predeterminada:

// Función Crear una nueva macro
var macro = createMacro(function*(){
	'use strict';
	
	// Todas las macros tienen disponibles los siguientes objetos de forma predeterminada:
	// 1. session - Punto de entrada principal para acceder al host. Puede conectar, desconectar y facilitar acceso al PresentationSpace.
	//    El objeto PresentationSpace obtenido de la sesión representa la pantalla y provee capacidades muy comunes como obtener y ajustar la
	//    posición del cursor, enviar datos al host y leer de la pantalla.
	// 2. wait - Facilita una forma sencilla de esperar a varios estados del host antes de seguir enviando más datos o leer de la pantalla.
	// 3. uiI - Provee capacidades básicas de interfaz de usuario. Mostrar datos al usuario o pedirle información.
	
	// Declarar una variable para leer y visualizar algunos datos de pantalla.
	// La mejor práctica es declarar todas las variables cerca de la parte superior de una función.
	var numberOfAccounts = 0;
	
	// Iniciar obteniendo el objeto PresentationSpace, que provee muchas operaciones de pantalla comunes.
	var ps = session.getPresentationSpace();
	
	try {
		// Puede ajustar y obtener la posición del cursor
		ps.setCursorPosition(new Position(24, 2));
		
		// Utilizar la función sendKeys para enviar caracteres al host
		ps.sendKeys('cics');
		
		// SendKeys se utiliza también para enviar teclas de host como teclas PA y PF.
		// Véase "Control Keys" en la documentación para todas las opciones disponibles
		ps.sendKeys(ControlKey.ENTER);
		
		// Esperar a que el cursor se encuentre en la posición correcta.
		// El objeto wait provee varias funciones para esperar a que ocurran determinados estados
		// de modo que usted pueda proceder o bien a enviar más teclas, o bien a leer datos de la pantalla.
		yield wait.forCursor(new Position(24, 2));
		
		// Puede mezclar caracteres y teclas de control en una llamada sendKeys.
		ps.sendKeys('data' + ControlKey.TAB + ControlKey.TAB + 'more data' + ControlKey.ENTER);
		
		// La palabra clave "yield" se debe utilizar enfrente de todas las llamadas de función "wait" y "ui".
		// Le dice al navegador que detenga la ejecución de la macro hasta que la
		// función wait (asíncrona) vuelva. Consulte la documentación para saber qué funciones
		// requieren la palabra clave yield.
		yield wait.forCursor(new Position(10, 26));
		ps.sendKeys('accounts' + ControlKey.ENTER);
		
		// Puede esperar también a que aparezca un texto en ciertas áreas de la pantalla
		yield wait.forText('ACCOUNTS', new Position(3, 36));
		ps.sendKeys('1' + ControlKey.ENTER);
		
		// Todas las funciones wait excederán el tiempo de espera si no se cumplen los criterios dentro de un límite de tiempo.
		// Puede incrementar tiempos de espera con un parámetro opcional en las funciones wait (en milisegundos)
		// Todos los tiempos de espera se especifican en milisegundos y el valor predeterminado es 10 segundos (10000 ms).
		yield wait.forCursor(new Position(1, 1), 15000);
		ps.sendKeys('A' + ControlKey.ENTER);
		
		// PS proporciona la función getText para leer texto de la pantalla
		numberOfAccounts = ps.getText(new Position(12, 3), 5);
		
		// Utilizar el objeto ui para visualizar algunos datos de la pantalla
		ui.message('Número de cuentas activas: ' + numberOfAccounts);
		
		// La try / catch permite capturar todos los errores y notificarlos a una ubicación central
	} catch (error) {
		// De nuevo, utilizamos el objeto ui para visualizar un mensaje que indica que se ha producido un error
		yield ui.message('Error: ' + error.message);
	}
	//Fin Macro Generada
});

// Ejecutar la macro y devolver los resultados al Ejecutor de macros
// La instrucción return es necesaria, ya que la aplicación aprovecha
// esto para saber si la macro se ha ejecutado correctamente y cuándo ha finalizado
return macro();