DocumentazioneProgetto EEM con lavori EEM Timer
Funzionalità | Questo plugin è uno strumento di verifica specifico per i test end-to-end (E2E) basati su SikuliX e SmartBear TestComplete. Esegue un progetto su un host Windows remoto tramite il proprio WinAgent, attende il completamento dell'esecuzione, quindi recupera i file di log, gli screenshot o i video generati e li visualizza in una pagina di panoramica. |
|---|---|
Avvisi | Tempo di esecuzione, Codice di risposta, Codice di risultato (timer EEM), Errore noto (timer EEM) |
Informazioni generali sul progetto EEM
Il plugin del progetto EEM è concepito per essere utilizzato su un dispositivo di tipo PC (EEM Robot). I dispositivi EEM (Enduser Experience Monitoring) sono dispositivi robot che eseguono test end-to-end su software e servizi utilizzando SKOOR Robot, un prodotto basato sul progetto open source SikuliX, oppure gli strumenti di test TestComplete / TestExecute di SmartBear. Il plugin è stato sviluppato per semplificare la configurazione e la gestione delle esecuzioni di test end-to-end da un server SKOOR Engine. I test possono essere programmati per eseguire test funzionali end-to-end su 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 file binari di SikuliX o TestComplete / TestExecute e il recupero dei file di output generati. Inoltre, WinAgent deve essere in esecuzione come applicazione, non come servizio.
Il plugin EEM Project è costituito dalla configurazione di EEM Project stessa e da un numero illimitato di job EEM Timer associati che possono essere aggiunti al suo interno.
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 |
Codice di errore | Codice di errore generico del processo (vedere la sezione Codici di errore dei processi) |
Se un’attività di un progetto EEM è collegata a una pianificazione (che definisce gli orari di attività e di inattività per l’esecuzione dell’attività), il pulsante Verifica ora non funziona durante l’orario di inattività configurato nella pianificazione.
Dispositivo EEM Robot
Prima di creare un’attività di EEM Project, assicurarsi di configurare il dispositivo a cui appartiene l’attività come dispositivo di tipo PC (EEM Robot). Durante la creazione di tale dispositivo viene visualizzata la seguente schermata delle opzioni di configurazione:
La sezione "Informazioni su EEM Project" è fornita come riferimento per i valori predefiniti configurati delle proprietà utilizzate per l'esecuzione di un progetto EEM. A parte questo, un dispositivo PC (EEM Robot) è funzionalmente identico agli altri tipi di dispositivo. È possibile sovrascrivere 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 relativi a quel dispositivo. Se necessario, alcune di esse possono essere sovrascritte nei lavori di misurazione
Nome della proprietà | Descrizione |
|---|---|
Nome utente dell’agente | Deve essere impostato se sono stati configurati un nome utente e una password nelle impostazioni di WinAgent sull'host EEM |
Password dell’agente | Deve essere impostata se sono stati configurati nome utente e password nelle impostazioni di WinAgent sull'host EEM |
Connessione sicura dell'agente | Deve essere impostato se l'impostazione corrispondente (crittografia SSL per la connessione) è stata configurata nelle impostazioni di WinAgent sull'host EEM |
Percorso file binario EEM | Deve essere impostato se differisce dal valore predefinito. Deve essere impostato in base alla proprietà della modalità di esecuzione di EEM e, ovviamente, ai percorsi dei componenti software |
Modalità di esecuzione EEM | Per i dispositivi di runtime, utilizzati per eseguire le misurazioni, selezionare SikuliX o TestExecute Per i dispositivi utilizzati per lo sviluppo di progetti EEM, selezionare SikuliX Development o TestComplete |
Recupero dei log MHT di 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, specialmente se l'esecuzione del progetto ha generato molti errori. Disattivare questa opzione se lo spazio disponibile su SKOOR Engine per l’archiviazione dei log è insufficiente o se la larghezza di banda della rete tra SKOOR Engine e il robot EEM è troppo bassa per il trasferimento di file di grandi dimensioni |
Directory principale dei log EEM | Si tratta della directory principale in cui vengono memorizzati i log SikuliX o MHT sul robot EEM |
Directory principale del progetto EEM | Questa è la directory principale in cui sono archiviati i progetti SikuliX / TestComplete sul robot EEM |
Accesso remoto a EEM | Di norma, 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 si utilizzano VNC o altri strumenti quali TeamViewer. Tuttavia, ciò lascia visibile lo schermo della console del robot mentre i test sono in esecuzione. Se la sicurezza rappresenta un problema, i test possono essere configurati per essere eseguiti all’interno di una sessione di desktop remoto di 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 di Active Directory per l’accesso RDP |
Risoluzione RDP | Risoluzione dello schermo utilizzata per le misurazioni EEM. Ciò è particolarmente importante per le misurazioni basate su 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 del dispositivo |
Disconnessione da RDP | Per risparmiare tempo tra una misurazione e l’altra, le sessioni RDP non vengono chiuse automaticamente dopo l’esecuzione di un’attività del progetto. Se per qualche motivo è necessario effettuare il logout, questa proprietà può essere impostata di conseguenza |
Lavori del progetto EEM
Per la configurazione dei lavori del progetto EEM, consultare le sottopagine specifiche relative a SKOOR Robot e SmartBear.
Risultati del progetto EEM
I risultati delle misurazioni vengono presentati nei lavori del progetto EEM e nei lavori con timer, nonché nel browser dei risultati EEM.
Coda del progetto EEM
Il SKOOR Engine Collector pianifica automaticamente i processi del progetto EEM in base all’intervallo di esecuzione specificato. Ciò significa che ogni processo del progetto EEM può avere un proprio intervallo di esecuzione individuale e lo scheduler garantisce il rispetto di tale intervallo. Se su un dispositivo EEM sono presenti più job del progetto EEM e lo Scheduler decide che è il momento di eseguire un job del progetto EEM, questo viene messo in coda se al momento è già in esecuzione uno degli altri job del progetto EEM. Per visualizzare questa coda, devono essere soddisfatti i seguenti prerequisiti:
Il dispositivo EEM deve avere un collettore predefinito (Default collector) definito nella propria configurazione
Sul dispositivo EEM deve essere presente almeno un processo del progetto EEM
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 effettuato 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 a SKOOR Engine e la successiva distribuzione ai robot EEM. L’eseguibile di 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 invece che su tutti i dispositivi host dei robot EEM questa proprietà sia impostata su "TestExecute" o "SikuliX"
Sull’host di sviluppo, creare un nuovo progetto EEM o modificare uno esistente. Salvare il progetto e chiudere il rispettivo IDE.
Sotto il dispositivo di sviluppo nell’interfaccia utente di SKOOR Engine, nel 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:
Scegliendo «Esegui lavoro di misurazione» si eseguirebbe semplicemente il progetto EEM.
Fare clic su "OK" per salvare il job
Aprire il nuovo lavoro utilizzando la lente di ingrandimento e fare clic su Distribuisci
La sezione "Valori" dovrebbe ora mostrare "Suite distribuita con successo":
La directory compressa della suite di progetto verrà ora collocata 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, accedere al relativo processo EEM Project e selezionare il controllo “Auto update suite”. Quindi selezionare il repository “Test” dall’elenco visualizzato:
Eseguire «Verifica ora» sul processo del progetto EEM. In questo modo verrà innanzitutto verificato se nel repository di SKOOR Engine (all’interno della directory /opt/eranger/collector/eem_repository/to_execute/test) sono presenti file di progetto aggiornati. In caso affermativo, li trasferirà al robot EEM, sostituendo la vecchia directory della suite di progetto. Successivamente eseguirà il test e restituirà i risultati
Se il test risulta funzionare correttamente sull’host TestExecute abilitato per il repository di test, è possibile avviare la distribuzione del progetto al repository di produzione. È buona prassi disporre di un robot di test dedicato, sul quale tutti i test sviluppati vengano eseguiti prima di distribuirli ai robot di produzione
Possono essere necessari fino a 4 minuti prima che SKOOR Engine copi i progetti appena caricati (distribuiti) su tutti gli SKOOR Engine Agents; pertanto, potrebbero non essere immediatamente disponibili per l’aggiornamento automatico
Se i progetti non vengono distribuiti, verificare se lo SKOOR Engine, su cui sono configurati i lavori del progetto EEM, dispone di un accesso autenticato tramite chiave pubblica via SSH ai SKOOR Engine Collector su cui vengono eseguiti i lavori del progetto EEM. SKOOR Engine recupera tutti gli archivi di progetto compressi da tutti i SKOOR Engine Collector, quindi li distribuisce alle directory del repository di tutti i Collector.