Funzione	Questo plugin è un controllo specifico per i test end-to-end (E2E) basati su SikuliX e SmartBear TestComplete. Esegue un progetto su un host Windows remoto tramite il suo WinAgent, attende il termine dell'esecuzione, quindi recupera i file di log, gli screenshot o i video generati e li visualizza in una pagina di panoramica.
Allarme	Tempo di esecuzione, codice di risposta, codice di risultato (timer EEM), errore noto (timer EEM)

Informazioni generali sul progetto EEM

Il plugin EEM Project è stato ideato per essere utilizzato su un dispositivo di tipo PC (EEM Robot). I dispositivi EEM (Enduser Experience Monitoring) sono dispositivi robotici che eseguono test end-to-end su software e servizi utilizzando SKOOR Robot, un prodotto basato sul progetto open source SikuliX, o gli strumenti di test TestComplete / TestExecute di SmartBear. Il plugin è stato sviluppato per semplificare la configurazione e la gestione dell'esecuzione di test end-to-end da un server SKOOR Engine. I test possono essere programmati per eseguire test funzionali end-to-end di siti web, servizi web, applicazioni UI o app mobili.

La comunicazione tra il robot EEM e SKOOR Engine avviene tramite l'applicazione SKOOR Engine WinAgent. WinAgent deve essere configurato per consentire l'esecuzione dei binari SikuliX o TestComplete / TestExecute e il recupero dei file di output generati. Inoltre, WinAgent deve essere eseguito come applicazione, non come servizio.

Il plugin EEM Project è costituito dalla configurazione EEM Project stessa e da un numero qualsiasi di lavori EEM Timer allegati che possono essere aggiunti al di sotto di essa.

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 di 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.

Dispositivo EEM Robot

Prima di creare un processo EEM Project, assicurarsi di configurare il dispositivo a cui appartiene il processo come dispositivo di tipo PC (EEM Robot). Quando si crea un dispositivo di questo tipo, viene visualizzata la seguente schermata di opzioni di configurazione:

La sezione Informazioni sul progetto EEM viene fornita come riferimento per le impostazioni predefinite configurate delle proprietà utilizzate per eseguire un progetto EEM. A parte questo, un dispositivo PC (EEM Robot) è funzionalmente identico ad altri tipi di dispositivi. Sovrascrivi le proprietà impostando manualmente una o più proprietà nella sezione Proprietà.

Proprietà del dispositivo

Le proprietà configurate a livello di dispositivo hanno effetto su tutti i lavori del progetto EEM di quel dispositivo. Se necessario, alcune di esse possono essere sovrascritte nei lavori di misurazione

Nome della proprietà	Descrizione
Nome utente agente	Deve essere impostato se un nome utente e una password sono stati configurati nelle impostazioni WinAgent sull'host EEM
Password agente	Deve essere impostata se è stato configurato un nome utente e una password nelle impostazioni WinAgent sull'host EEM
Connessione sicura dell'agente	Deve essere impostato se l'impostazione corrispondente (crittografia SSL per la connessione) è stata configurata nelle impostazioni WinAgent sull'host EEM
Percorso binario EEM	Deve essere impostato se diverso da quello predefinito. Deve essere impostato in base alla proprietà della modalità di esecuzione EEM e, ovviamente, ai percorsi dei componenti software
Modalità di esecuzione EEM	Per i dispositivi di runtime, utilizzati per eseguire misurazioni, scegliere SikuliX o TestExecute Per i dispositivi utilizzati per sviluppare progetti EEM, scegliere SikuliX Development o TestComplete
Recupero log MHT EEM (solo TestExecute)	Se abilitato (impostazione predefinita), SKOOR Engine tenterà di trasferire i log di riepilogo dell'esecuzione del progetto generati sul robot EEM. Questi vengono generati per ogni esecuzione in formato MHT (MHTML) e possono essere visualizzati solo con Internet Explorer. I file di log MHT possono essere piuttosto grandi, a volte diversi MB, soprattutto se l'esecuzione del progetto ha generato molti errori. Disattivare questa opzione se lo spazio disponibile sul SKOOR Engine per memorizzare i log è insufficiente o se la larghezza di banda della rete tra il SKOOR Engine e il robot EEM è troppo bassa per il trasferimento di file di grandi dimensioni
Directory principale dei log EEM	Questa è la directory principale in cui sono memorizzati i log SikuliX o MHT sul robot EEM.
Directory principale del progetto EEM	Questa è la directory principale in cui sono memorizzati i progetti SikuliX / TestComplete sul robot EEM.
Accesso remoto EEM	Di solito l'esecuzione dei progetti avviene sulla console del robot EEM (lo schermo che si vedrebbe se fosse collegato un monitor fisico). In questo caso, come metodo di accesso remoto vengono utilizzati VNC o altri strumenti come Teamviewer. Tuttavia, questo lascia visibile lo schermo della console del robot mentre i test sono in esecuzione. Se la sicurezza è un problema, i test possono essere configurati per essere eseguiti all'interno di una sessione di desktop remoto Windows (RDP). Ciò consente di bloccare lo schermo della console. Gli utenti verranno disconnessi durante l'esecuzione dei test. Se è richiesta l'autenticazione a livello di rete, il dispositivo deve essere configurato con FreeRDP
Dominio RDP	Dominio Active Directory utilizzato per l'accesso RDP
Nome utente/password RDP	Nome utente e password Active Directory per l'accesso RDP
Risoluzione RDP	Risoluzione dello schermo utilizzata per le misurazioni EEM. Ciò è particolarmente importante per le misurazioni basate sulle immagini (SKOOR Robot)
Opzioni RDP	È possibile configurare alcune opzioni per la sessione RDP. Per ulteriori dettagli, consultare la sezione Informazioni sul progetto EEM nell'oggetto dispositivo
Logout RDP	Per risparmiare tempo tra una misurazione e l'altra, le sessioni RDP non vengono disconnesse dopo l'esecuzione di un lavoro di progetto. Se per qualche motivo è necessario effettuare il logout, è possibile impostare questa proprietà di conseguenza

Lavori del progetto EEM

Per la configurazione dei lavori del progetto EEM, consultare le sottopagine specifiche per SKOOR Robot e SmartBear.

Risultati del progetto EEM

I risultati delle misurazioni vengono presentati nei lavori di progetto EEM e timer, nonché nel browser dei risultati EEM.

Coda del progetto EEM

Il SKOOR Engine Collector pianifica automaticamente i lavori del progetto EEM in base all'intervallo di esecuzione specificato. Ciò significa che ogni lavoro del progetto EEM può avere un proprio intervallo di esecuzione individuale e lo scheduler si assicura che tale intervallo venga rispettato. Se su un dispositivo EEM sono presenti più lavori del progetto EEM e lo scheduler decide che è il momento di eseguire un lavoro del progetto EEM, questo viene messo in coda se uno degli altri lavori del progetto EEM è già in esecuzione. Per visualizzare questa coda, devono essere soddisfatti i seguenti prerequisiti:

Il dispositivo EEM deve avere un collettore predefinito definito nella sua configurazione
Sul dispositivo EEM deve essere presente almeno un processo EEM Project

Se i criteri sopra indicati sono soddisfatti, è possibile visualizzare la coda e lo stato del progetto attualmente in esecuzione selezionando Mostra dettagli sul dispositivo EEM:

Distribuzione del progetto EEM

Lo sviluppo di progetti di test richiede l'installazione del software TestComplete o SikuliX. Lo sviluppo viene solitamente eseguito su host diversi da quelli su cui vengono effettivamente eseguiti i test. Dove vengono eseguiti i test, è necessario installare solo il software di runtime TestExecute (solo SmartBear). Per distribuire i test sviluppati, SKOOR Engine offre un meccanismo che prevede la creazione di un file zip della directory del progetto corrente sull'host di sviluppo, il suo trasferimento su SKOOR Engine e la sua distribuzione ai robot EEM. L'eseguibile SikuliX viene trasferito allo stesso modo. Per ottenere questo risultato, seguire le linee guida riportate di seguito:

Impostare la proprietà della modalità di esecuzione EEM su SikuliX Development o TestComplete sul dispositivo host di sviluppo
Assicurarsi che tutti i dispositivi host dei robot EEM abbiano invece questa proprietà impostata su TestExecute o SikuliX
Sull'host di sviluppo, sviluppare un nuovo progetto EEM o modificarne uno esistente. Salvare il progetto e chiudere il rispettivo IDE.
Sotto il dispositivo di sviluppo nell'interfaccia utente di SKOOR Engine, sul progetto EEM che deve essere distribuito agli host dei robot EEM, selezionare Distribuisci al repository di test dall'elenco a discesa Esegui/Distribuisci nella sezione Esecuzione del lavoro del lavoro:
Selezionando Esegui lavoro di misurazione si eseguirà semplicemente il progetto EEM.

Fare clic su OK per salvare il lavoro
Aprire il nuovo lavoro utilizzando la lente di ingrandimento e fare clic su Distribuisci
La sezione Valori dovrebbe ora mostrare Distribuzione suite riuscita:
La directory della suite di progetti compressa verrà ora inserita nella directory /opt/eranger/collector/eem_repository/from_development/test del SKOOR Collector su cui è configurato il lavoro del progetto EEM
L'archivio verrà sincronizzato nella directory /opt/eranger/collector/eem_repository/to_execute/test, rendendolo così disponibile per l'aggiornamento automatico.
Sul dispositivo robot EEM, andare al lavoro EEM Project corrispondente e selezionare il controllo Auto update suite (Aggiorna automaticamente la suite). Quindi selezionare Test repository (Repository di prova) dall'elenco che appare:

Esegui Controlla ora sul lavoro del progetto EEM. Questo controllerà innanzitutto se ci sono file di progetto aggiornati nel repository SKOOR Engine (sotto la directory /opt/eranger/collector/eem_repository/to_execute/test). Se sì, li trasferirà al robot EEM, sostituendo la vecchia directory della suite di progetti. Quindi eseguirà il test e restituirà i risultati
Se il test viene eseguito correttamente sull'host TestExecute abilitato per il repository di test, è possibile iniziare a distribuire il progetto al repository di produzione. È buona norma disporre di un robot di test dedicato, sul quale eseguire tutti i test sviluppati prima di distribuirli ai robot di produzione
SKOOR Engine può impiegare fino a 4 minuti per copiare i progetti appena caricati (distribuiti) su tutti gli SKOOR Engine Agents, quindi potrebbero non essere immediatamente disponibili per l'aggiornamento automatico
Se i progetti non vengono distribuiti, verificare se SKOOR Engine, dove sono configurati i lavori del progetto EEM, dispone di un accesso autenticato con chiave pubblica tramite ssh ai collettori SKOOR Engine su cui vengono eseguiti i lavori del progetto EEM. SKOOR Engine recupera tutti gli archivi di progetto compressi da tutti i collettori SKOOR Engine, quindi li distribuisce alle directory del repository di tutti i collettori.

Documentazione

Progetto EEM con lavori EEM Timer