Progetti SmartBear

Configurazione del dispositivo

Per la configurazione generale del dispositivo, visitare Progetto EEM con lavori EEM Timer

Esempio di configurazione di un dispositivo SmartBear

Nell'esempio seguente, i parametri per un dispositivo sono stati impostati per i test SmartBear come descritto nella sezione Informazioni sul progetto EEM:

Dettagli del lavoro del progetto EEM

Impostazioni del progetto SmartBear:

Parametri del progetto EEM

Parametro

Descrizione

Nome della suite

Un progetto TestComplete è costituito da almeno una suite di progetti e un progetto all'interno di tale suite. Se è presente un solo progetto, è necessario inserire solo il nome della suite di progetti. In caso contrario, specificare sia il nome della suite che quello del progetto. Una volta compilato questo campo, il campo Argomenti viene compilato automaticamente con gli argomenti della riga di comando predefiniti da allegare al comando TestComplete o TestExecute.

Nome del progetto

Nome del progetto TestComplete. Questo campo deve essere compilato solo se la suite di progetti contiene più di un progetto.

Modalità di test VPN

Selezionare questa casella solo nel caso particolare in cui il progetto da eseguire avvii autonomamente connessioni VPN a un gateway VPN durante l'esecuzione del progetto. Ciò comporterebbe una temporanea perdita di connessione tra SKOOR Engine e l'host del robot. Ovviamente, il progetto stesso dovrebbe includere la chiusura di queste connessioni VPN, altrimenti SKOOR Engine non sarà mai in grado di recuperare i risultati. Se selezionato, SKOOR Engine non attenderà lo stato di uscita dell'esecuzione del progetto e proverà a recuperare i risultati dall'esecuzione del progetto solo dopo aver atteso il tempo specificato in Limite di tempo di esecuzione.

Limite di tempo di esecuzione

Specificare il tempo consentito per l'esecuzione del progetto. Questo dipende da ciò che fa il progetto. Questo parametro è facoltativo, tranne se è selezionata anche la modalità di test VPN. Se questo tempo è trascorso e il processo di test è ancora in esecuzione sul robot, verrà terminato. In questo caso, non verranno generati e recuperati log MHT (il che comporterà un Warning).

Timeout robot

Parametro di timeout interno facoltativo (impostare su 0 s per disabilitarlo). Questo parametro è utile solo se il valore è inferiore al parametro Limite di tempo di esecuzione

Acquisizione video

Se l'acquisizione video è abilitata, l'intera esecuzione del test può essere visualizzata dalla pagina dei risultati di SKOOR Engine in caso di esecuzioni di test non riuscite. Ciò può essere molto utile per individuare e correggere gli errori nel progetto. Le esecuzioni di test che terminano con uno stato OK non vengono trasferite al server per evitare un carico di rete e un consumo di spazio di archiviazione non necessari.

Aggiornamento automatico della suite

Selezionare questa opzione se si desidera recuperare i file di progetto più recenti dal repository di SKOOR Engine.

Repository

Selezionare uno dei due repository di progetto Produzione o Test da cui estrarre i file di progetto. Questo parametro è visibile solo se la proprietà del dispositivo EEM Modalità di esecuzione EEM è impostata su TestExecute e l'opzione Aggiornamento automatico suite è selezionata.

Ordina i lavori del timer

Scegliere tra Per nome, Per stato, Per tempo di esecuzione o Per ora di inizio per ordinare automaticamente i lavori timer oppure Manualmente per ordinarli utilizzando i pulsanti su o giù nella sezione Lavori timer EEM collegati

Si noti che l'acquisizione video può causare un carico elevato della CPU sul sistema SKOOR Engine

La sezione Linked EEM Timer Jobs (Processi timer EEM collegati) mostra quali timer EEM sono stati aggiunti a questo processo EEM Project. Nella figura sopra non sono stati ancora aggiunti processi timer.

Impostazioni del protocollo RDP (Remote Desktop Protocol) per le misurazioni

RDP deve essere configurato sul dispositivo che contiene il lavoro del progetto EEM per evitare impostazioni ridondanti su ogni singolo lavoro. Tuttavia, se un lavoro richiede impostazioni dei parametri diverse, i parametri del dispositivo possono essere sovrascritti dai parametri configurati sul lavoro:

Parametro

Descrizione

Dominio

Dominio a cui appartiene l'utente. Se l'utente è un utente Windows locale, il nome host dei PC EEM deve essere configurato come dominio

Nome utente

Il nome dell'utente che effettua il login

Password

La password dell'utente

Risoluzione dello schermo

In caso di test basati su immagini, la risoluzione dello schermo è importante. È necessario configurare la stessa risoluzione utilizzata sul sistema in cui è stato sviluppato il progetto. La risoluzione predefinita è 1920x1200

Opzionale

Se necessario, è possibile configurare qui ulteriori parametri dell'utilità rdesktop o FreeRDP

Disconnettersi dalla sessione

Esci dalla sessione RDP dopo l'esecuzione del progetto

Si prega di notare che l'acquisizione video può causare un elevato carico della CPU sul sistema SKOOR Engine

Valori del progetto EEM e limiti di allarme

Valore / Limite di allarme

Descrizione

Tempo di esecuzione

Il tempo di esecuzione dell'intero progetto EEM

Codice di risposta

  0 =
 OK-1 = Errore generale
 1 = I risultati del test includono Warning
 2 = I risultati del test includono errori
 3 = Il test non può essere eseguito
18 = Impossibile avviare TestComplete/TestExecute
11 = Parametro mancante
12 = Parametro errato
13 = Progetto non trovato
14 = Eseguibile non trovato
15 = Nessuna autorizzazione
16 = Timeout di esecuzione
20 = Esecuzione interrotta
17 = Test fallito
19 = Risposta sconosciuta

Codice di errore

Codice di errore generico del processo (vedere la sezione Codici di errore dei processi)

Se un processo del progetto EEM è collegato a una pianificazione (che definisce i tempi attivi e inattivi per l'esecuzione del processo), il pulsante Controlla ora non funziona durante il tempo inattivo configurato nella pianificazione.

Aggiunta di lavori timer

I lavori timer rappresentano le misurazioni da visualizzare nell'SKOOR Engine o nella SKOOR Dashboard. Un progetto può avere più lavori timer, come il tempo totale di tutte le misurazioni, l'accesso a un'applicazione e altri casi d'uso. I timer devono essere configurati/programmati nel progetto. Se il progetto di test è disponibile in uno dei repository SKOOR Engine o sul robot EEM nella directory degli script configurati, SKOOR Engine tenterà di estrarre i timer dal progetto e di configurarli automaticamente.

Nella finestra di modifica di un lavoro di progetto EEM, fare clic su Aggiungi lavori timer:

Viene visualizzata la seguente schermata che documenta i timer trovati e le azioni eseguite:

I timer sono stati configurati sotto il lavoro del progetto EEM:

Con i tasti su e giù, ora è possibile ordinarli come richiesto.

Aggiunta manuale di lavori timer

Se i lavori timer devono essere creati prima che il progetto EEM sia disponibile su SKOOR Engine e sui PC dei robot, è possibile aggiungerli anche manualmente. Fare clic sul nome dei lavori del progetto EEM per visualizzare il lavoro del progetto e aggiungere il timer utilizzando il menu delle funzioni o l'icona a forma di ingranaggio:

Successivamente, il nome del timer deve essere configurato esattamente come definito nel progetto. La schermata seguente mostra un timer chiamato totalTime:

Parametri del timer EEM

Parametro

Descrizione

Nome del timer

Su un lavoro EEM Timer è possibile configurare solo il nome del lavoro e il nome del timer. Il nome del lavoro può essere diverso dal nome del timer, ma il nome del timer deve corrispondere al nome del timer come scritto nel file del timer.

Valori del timer EEM e limiti di allarme

Valore / Limite di allarme

Descrizione

Tempo di esecuzione

Il tempo di esecuzione di questo particolare timer EEM

Codice risultato

 0 =
OK-1 = Non
eseguito-2 =
Fallito-3 = Errore di progetto
 1 = Errore noto

Errore noto

Il limite di allarme Errore noto è disponibile solo sui lavori del timer EEM e verifica se nel file del timer è stata restituita una stringa diversa dalle solite stringhe OK, FAILED o NOTRUN. L'allarme è possibile al rilevamento di una stringa, non al suo contenuto.

Codice di errore

Codice di errore generico del lavoro (vedere la sezione Codici di errore del lavoro)

Dettagli timer EEM

I timer vengono introdotti all'interno di un progetto per misurare il risultato (OK/Failed/NotRun) e il tempo impiegato per una sezione specifica di un test. Durante l'esecuzione, i timer vengono scritti in un file di testo all'interno della directory del progetto. Il file è strutturato nel modo seguente:

========== 2017.11.30-12.43 =================
Name;Status;Time
----------------
Calc_Open;OK;6.26
Calc_Calculate;OK;1.69
Total;OK;8.47

Per ogni timer vengono stampati il nome del lavoro SKOOR Engine EEM Timer, il nome effettivo del timer, il suo stato attuale e il tempo in secondi impiegato per eseguire il timer corrispondente durante l'ultima esecuzione.

Esiste anche la possibilità di fare in modo che il progetto scriva una stringa di errore specifica nel file del timer, che verrà poi analizzata come valore stringa. Ciò è utile quando un progetto incontra errori che si verificano frequentemente e sono noti, ma che non possono essere corretti nell'applicazione o nel sito web testato. In tal caso, il riconoscimento dell'errore deve essere programmato nella sequenza del progetto e dovrebbe scrivere una stringa di errore specifica nel file del timer per il timer specifico. Di seguito è riportato un esempio di tale file timer:

========== 2017.11.30-12.43 =================
Name;Status;Time
----------------
Calc_Open;OK;6.26
Calc_Calculate;Known error encountered in Calculate sub-step;1.69
Total;OK;8.47

La seconda colonna della riga Calc_Calculate viene interpretata come un errore noto a livello di attività timer EEM.

Questi errori noti possono quindi essere utilizzati nelle configurazioni dei limiti di allarme. Un esempio di errore noto riscontrato è mostrato nella figura seguente:

E nella sezione dei valori sul corrispondente timer EEM:

Il file timer, in questo caso calc.txt (il cui nome deve essere identico al nome del progetto), viene recuperato tramite WinAgent e analizzato per gli stati e i valori di ciascun timer. Ma questo avviene solo se sono configurati timer con i nomi corrispondenti. 

Risultati del progetto EEM

Dopo l'esecuzione del progetto sul robot EEM, la sezione dei valori del lavoro del progetto EEM appare come segue (differisce dai progetti SikuliX):

o, in caso di errore durante l'esecuzione del progetto:

Cliccando sul link File timer, è possibile visualizzare direttamente il file timer recuperato (vedere il file di esempio sopra).

Cliccando sul link accanto al file di log MHT, è possibile scaricare o visualizzare direttamente il log di riepilogo MHT. La visualizzazione diretta è possibile solo se si clicca sul link da un browser Internet Explorer. Di seguito è riportato un esempio di log MHT:

Facendo clic sul collegamento File dei risultati nella sezione Valori, verrà visualizzata la seguente nuova finestra o scheda del browser:

Questa pagina fornisce una panoramica dei test eseguiti sul robot EEM. Per ogni esecuzione in cui SKOOR Engine ha raccolto i log, è presente una riga con un timestamp e un link al file MHT corrispondente. Se durante un'esecuzione si sono verificati degli errori, il link viene inserito nella colonna Test falliti, insieme a una piccola icona su cui è possibile cliccare per aprire una nuova finestra del browser con uno screenshot del primo errore riscontrato durante l'esecuzione. Questo fornisce un'idea chiara del motivo per cui un test non è andato a buon fine. Se l'esecuzione più recente non è andata a buon fine, come in questo esempio, lo screenshot viene visualizzato ingrandito anche nella sezione Ultimo risultato di questa panoramica. Facendo clic sul link Screenshot nella sezione Valore del lavoro, si apre direttamente l'immagine dello screenshot.

Esempio di progetto EEM

Eseguire un semplice progetto EEM con 3 timer EEM

La seguente configurazione presuppone che l'host remoto disponga di una suite di progetti TestComplete denominata Calc con un progetto denominato Calc al suo interno. L'output del progetto contiene 3 timer e viene eseguito tramite WinAgent installato sull'host remoto. WinAgent deve essere configurato per consentire l'esecuzione del file binario testexecute.exe. I timer vengono aggiunti come singoli lavori EEM Timer sotto il lavoro del progetto EEM.

Output