Utilizzo di Field e FieldList

Questa macro di esempio illustra come utilizzare funzioni comuni per interagire con i campi nell'API Macro. Ad esempio, come ottenere il testo dei campi, visualizzare informazioni sui campi e come utilizzare field.setText come alternativa a sendKeys per interagire con l'host.

var macro = createMacro(function*() {
	'use strict';
	
	// Ottenere PresentationSpace per interagire con l'host
	var ps = session.getPresentationSpace();
	
	// Dichiarare variabili da utilizzare successivamente use
	var fields;
	var field;
	var searchString = 'z/VM';
	
	// Impostare il valore di timeout predefinito per le funzioni "wait"
	wait.setDefaultTimeout(10000);
	
	// Macro di esempio per operazioni con FieldList e Field
	try {
		yield wait.forCursor(new Position(24, 2));
		
		// Ottenere l'elenco di campi.
		fields = ps.getFields();
		
		// Scorrere l'intero elenco di campi e visualizzare le informazioni sul campo.
		for(var index = 0; index < fields.size(); index++) {
			field = fields.get(index);
			
			yield ui.message("Field " + index + " info: " + field.toString());
		}
		
		yield ui.message("Now, find a field containing the text '" + searchString + "'");
		field = fields.findField(new Position(1, 1), searchString);
		
		if(field !== null) {
			yield ui.message("Found field info: " + field.toString());
			yield ui.message("Found field foreground is green? " + (Color.GREEN === field.getForegroundColor()));
			yield ui.message("Found field background is default? " + (Color.BLANK_UNSPECIFIED === field.getBackgroundColor()));
		}
		
		// Cercare ora un campo comando e modificarlo.
		field = fields.findField(new Position(23, 80));
		if(field !== null) {
			field.setText("cics");
		}
		
		yield ui.message("Click to send 'cics' to host.");
		ps.sendKeys(ControlKey.ENTER);
		
		// Attendere il nuovo schermo; ottenere nuovi campi.
		yield wait.forCursor(new Position(10, 26));
		fields = ps.getFields();
		
		// Trovare il campo utente e impostarlo.
		field = fields.findField(new Position(10, 24));
		if(field !== null) {
			field.setText("myusername");
		}
		
		// Trovare il campo della password e impostarlo.		
		field = fields.findField(new Position(11, 24));
		if(field !== null) {
			field.setText("mypassword");
		}
		
		yield ui.message("Click to send login to host.");
		ps.sendKeys(ControlKey.ENTER);
		
		// Attendere il nuovo schermo; ottenere nuovi campi.
		yield wait.forCursor(new Position(1, 1));
		fields = ps.getFields();

		// Trovare il campo comando e impostare il comando di disconnessione.
		field = fields.findField(new Position(24, 45));
		if(field !== null) {
			field.setText("cesf logoff");
		}
		
		yield ui.message("Click to send logoff to host.");
		ps.sendKeys(ControlKey.ENTER);
	
	} catch (error) {
		yield ui.message(error);
	}
	//Fine della macro generata
});

// Eseguire la macro
return macro();