Magic Link Tester

Sommario
Nel presente articolo sono descritti la struttura, gli scopi e le modalità di utilizzo dello strumento Magic Link Tester, applicazione che permette di testare l'interazione con le risorse gestionali di Perfetto.

Che cos'è Magic Link Tester?
Magic Link Tester è un'applicazione esterna, scritta in linguaggio C#, che consente di connettere un utente a Perfetto, di leggere, inserire, modificare i dati dei documenti e di leggere i dati dei report.

Struttura strumento
La struttura dello strumento Magic Link Tester è suddivisa in tre parti:

1. Toolbar principale
2. Toolbar documenti e report
3. Spazio dedicato alle operazioni di interazione con il gestionale

Toolbar principale
La toolbar principale consente di gestire l'autenticazione al prodotto, le istanze del TbLoader e alcuni parametri dell'applicazione.

I pulsanti della toolbar principali sono:

1. Change Login, apre la finestra che gestisce l'autenticazione
   
   
2. Manage Logins, mostra una finestra contenente tutti gli utenti connessi via Magic Link nell'istanza selezionata
   
   
3. Create TbLoaders, istanzia un processo TbLoader.exe e se l'operazione ha avuto successo mostra il seguente messaggio
    
4. Manage TbLoaders, consente di gestire le istanze TbLoader sul server cui si è connessi
   
   
5. Refresh TbLoader, permette di svuotare la cache del TbLoader
6. Change Parameters, apre una finestra che consente di impostare la data di applicazione, il parametro "Timeout" e l'uso dell'approssimazione
   
   
7. Change Font for XML, mostra una finestra che permette di selezionare il font per il testo
8. Change BackColor, apre una finestra che consente di impostare il colore di sfondo

Toolbar documenti e report
La toolbar documenti e report permette di selezionare il documento o il report da testare. 

La toolbar documenti e report è composta dalle seguenti parti:

1. tipologia di profilo di esportazione o report, Standard o AllUsers o User
2. tipologia risorsa gestionale, Document o Report
3. elenco risorse gestionali utilizzate recentemente
4. applicazione, ERP o ImpiantiNET
5. modulo
6. risorsa gestionale
7. profilo di esportazione per i documenti

Spazio dedicato alle operazioni di interazione con il gestionale
La terza parte della struttura consente di effettuare il test delle operazioni di lettura e invio dei dati delle risorse gestionali.

Modalità di utilizzo
Al lancio dello strumento viene mostrata una finestra che consente di connettere Magic Link Tester ad un'istanza del prodotto e di effettuare la login al sistema di un utente.

Dopo l'autenticazione si deve procedere con i passi necessari per impostare la risorsa gestionale che si deve testare: 

• selezionare tipologia di profilo di esportazione o report
• scegliere risorsa gestionale, Document o Report
• selezionare l'applicazione, ERP o ImpiantiNET
• scegliere il modulo
• selezionare la risorsa gestionale
• scegliere il profilo di esportazione per i documenti

La scheda "GetData" consente di verificare le operazioni di lettura dati, mediante l'utilizzo dei seguenti oggetti:

• il pulsante "Return parameters for find", mostra i parametri del documento o del report con i valori di default
• il pulsante "GetData", invia una richiesta di lettura dati in base ai valori impostati nell'xml dei parametri
• il pulsante "Clear Input", pulisce l'xml dei parametri
• il checkbox "Get Pdf", attivo solo per i report e se selezionato mostra il report in formato pdf
• il pulsante "Copy to Set Data", copia l'xml del documento selezionato nella scheda "SetData"
• il pulsante "Clear Output", elimina l'elenco dei documenti estratti
• il pulsante "Go", seleziona il documento specificato nella casella "Go to page"
• i pulsanti frecce, consentono di navigare tra i documenti estratti
• casella "Find", permette di ricercare una parola all'interno del testo xml
  

La scheda "SetData" consente di inviare i dati all'applicazione per l'inserimento, la modifica e la cancellazione del documento. Gli oggetti presenti nella scheda sono:

• il pulsante "Extract first document", prende l'xml del primo documento estratto dal pulsante "GetData"
• la tendina "Action", mostra l'operazione che l'applicazione deve eseguire, "Insert or Update", "Insert", "Update" e  "Delete"
• il pulsante "Set Data", invia al gestionale l'xml presente nel lato sinistro della scheda 
• il pulsante "Clear Input", pulisce l'xml che deve essere inviato
• il pulsante "Clear Output", pulisce l'xml risultato dell'esecuzione dell'operazione
  

La scheda "Automatic Tests" consente di eseguire in modo automatico le operazioni di lettura, inserimento, modifica e cancellazione di documenti. 

Gli oggetti presenti nella scheda permettono di selezionare e lanciare i test automatici:

• la tendina "Test to perform", mostra l'elenco delle cartelle, presenti nella cartella "Tests", che contengono i file xml dei test
• pulsante "Explore", visualizza il contenuto della cartella selezionata
• pulsante "Select All", seleziona tutti i test
• pulsante "Deselect All", deseleziona tutti i test
• pulsante "Start Tests", avvia il lancio dei test selezionati
• elenco dei test automatici
  

La scheda "Stress Test" permette di inviare i dati di uno o due documenti all'applicazione in modalità "Insert or Update" in modo ripetitivo. Nel campo "Number of iterations" è necessario inserire il numero di invii che devono essere effettuati.

La scheda "Log" visualizza tutte le operazioni effettuate nella sessione corrente. Le operazioni sono colorate di verde se hanno avuto esito positivo, di colore arancione se hanno rilevato errori e di colore bianco se non hanno ottenuto una risposta. E' possibile visualizzare i dettagli dell'operazione facendo doppio click sulla riga dell'operazione.