Interazioni di base con l'host

Questo esempio illustra le interazioni di base seguenti:

Per impostazione predefinita, per tutte le macro sono disponibili gli oggetti seguenti:

// Creare una nuova funzione macro
var macro = createMacro(function*(){
	'use strict';
	
	// Per impostazione predefinita, per tutte le macro sono disponibili gli oggetti seguenti:
	// 1. session - Punto di ingresso principale per accedere all'host. Consente di connettersi, disconnettersi e fornisce accesso a PresentationSpace.
	//		L'oggetto PresentationSpace ottenuto da session rappresenta lo schermo e fornisce molte capacità comuni, ad esempio ottenimento e impostazione della
	//		posizione del cursore, invio di dati all'host e lettura dello schermo.
	// 2. wait - Fornisce un modo semplice per attendere che si verifichino i vari stati dell'host prima di continuare a inviare altri dati o a leggere dallo schermo.
	// 3. ui - Fornisce capacità di base di interazione con l'utente. Mostra i dati o richiede informazioni all'utente.
	
	// Dichiarare una variabile per la lettura e la visualizzazione di alcuni dati dello schermo.
	// La procedura consigliata è dichiarare tutte le variabili all'inizio di una funzione.
	var numberOfAccounts = 0;
	
	// Iniziare ottenendo l'oggetto PresentationSpace, che fornisce molte operazioni comuni dello schermo.
	var ps = session.getPresentationSpace();
	
	try {
		// Può impostare e ottenere la posizione del cursore
		ps.setCursorPosition(new Position(24, 2));
		
		// Utilizzare la funzione sendKeys per inviare caratteri all'host
		ps.sendKeys('cics');
		
		// SendKeys viene utilizzata anche per inviare all'host tasti quali PA e PF.
		// Vedere tutte le opzioni disponibili in "Tasti di controllo" nella documentazione
		ps.sendKeys(ControlKey.ENTER);
		
		// Attendere che il cursore si trovi nella posizione corretta.
		// L'oggetto wait fornisce numerose funzioni per attendere che si verifichino determinati stati
		// in modo che sia possibile inviare altri tasti o leggere i dati dello schermo.
		yield wait.forCursor(new Position(24, 2));
		
		// È possibile combinare caratteri e tasti di controllo in una chiamata sendKeys.
		ps.sendKeys('data' + ControlKey.TAB + ControlKey.TAB + 'more data' + ControlKey.ENTER);
		
		// La parola chiave "yield" deve essere utilizzata prima di tutte le chiamate alle funzioni "wait" e "ui".
		// Indica al browser di interrompere l'esecuzione della macro fino a quando la
		// funzione wait (asincrona) restituisce il risultato. Consultare la documentazione per informazioni sulle funzioni
		// che richiedono la parola chiave yield.
		yield wait.forCursor(new Position(10, 26));
		ps.sendKeys('accounts' + ControlKey.ENTER);
		
		// È possibile anche attendere che il testo venga visualizzato in aree specifiche dello schermo
		yield wait.forText('ACCOUNTS', new Position(3, 36)) ;
		ps.sendKeys('1' + ControlKey.ENTER);
		
		// Tutte le funzioni wait scadranno se i criteri non vengono soddisfatti entro il limite di tempo definito.
		// È possibile aumentare i timeout con un parametro aggiuntivo nelle funzioni wait (in millisecondi)
		// Tutti i timeout sono specificati in millisecondi e il valore predefinito è 10 secondi (10000ms).
		yield wait.forCursor(new Position(1, 1), 15000);
		ps.sendKeys('A' + ControlKey.ENTER);
		
		// PS fornisce la funzione getText per leggere il testo dalla schermata
		numberOfAccounts = ps.getText(new Position(12, 3), 5);
		
		// Utilizzare l'oggetto ui per visualizzare alcuni dati dalla schermata
		ui.message('Numero di account attivi: ' + numberOfAccounts);

		// try/catch consente di rilevare gli errori e segnalarli in un'ubicazione centrale
	} catch (error) {
		// Utilizzare di nuovo l'oggetto ui per visualizzare un messaggio che informa che si è verificato un errore
		yield ui.message('Error: ' + error.message);
	}
	//Fine della macro generata
});

// Eseguire la macro e restituire i risultati a Macro Runner
// L'istruzione return è necessaria poiché l'applicazione la utilizza
// per sapere se la macro è stata eseguita correttamente e se è terminata
return macro();