Supporto Tecnico Online
Questa pagina è un primo aiuto per le situazioni e difficoltà tecniche che più frequentemente vengono segnalate dagli utenti di repSL al team di supporto tecnico.
Per ogni altra questione non ancora documentata, o per richiedere suggerimenti e aiuto sul come realizzare nuovi report nel modo più appropriato, potete inviare una e-mail a:
support@repSL.com
indicando la vostra problematica e/o allegando (se possibile) lo script .rsl, il template utilizzato ed eventuali dati di esempio;
è importante indicare anche la configurazione del vostro sistema operativo e la versione di Office utilizzata.
|
Firewall di sistema e applicazioni repSL
In sistemi in cui è installato e operativo un Firewall, al primo avvio di repSL Engine RunTime o repSL Developer viene richiesto all'utente se consentire la normale esecuzione dell'applicazione.
| Causa |
Il comportamento è assolutamente normale. Per il loro funzionamento infatti, gli applicativi repSL sfruttano una delle porte di sistema del computer su cui cono installati (localmente, senza scambiare alcuna informazioni con il resto della rete); il Firewall interviene correttamente chiedendo all'utente se gli applicativi repSL che voglio accedere a tale porta sono ritenuti sicuri.
|
| Soluzione |
Accettare lo sblocco definitivo delle applicazioni; l'avviso del Firewall non verrà più visualizzato ai successivi avvii. |
Impostazioni Internazioni per i formati di numeri e date
repSL Engine e repSL Developer gestiscono numeri e date utilizzando gli stessi formati definiti per l'utente corrente nelle Impostazioni Internazionali (Regional Settings) del Pannello di Controllo.
Se le informazioni numeriche o temporali elaborate in uno script sono estratte da database o vengono definite internamente allo script stesso, qualsiasi modifica alle Impostazioni Internazionali non impatterà sulla corretta esecuzione dello script.
Ma, se dati numerici o riferimenti temporali vengono importati da file di testo (ad esempio con istruzioni Connect_Text o Data_GetTextFile) bisogna assicurarsi che i formati utilizzati nel file siano gli stessi impostati nel sistema; in caso contrario si possono creare delle ambiguità:
Contenuto del File di Testo
formato date: mese/giorno/anno |
Impostazioni Internazionali
formato date: giorno/mese/anno |
| 03/05/2004 (5 Marzo 2004) |
03/05/2004 (3 Maggio 2004) |
| 11/22/2004 (22 Novembre 2004) |
11/22/2004 (ERRORE!) |
Esempio di ambiguità tra numeri
Contenuto del File di Testo
separatore decimale: ,
separatore migliaia: . |
Impostazioni Internazionali
separatore decimale: .
separatore migliaia: , |
| 1,823 (numero decimale minore di 2) |
1,823 (numero intero maggiore di 1800) |
E' importante valutare anche il formato delle ore oltre che della data: il carattere separatore tra ore, minuti e secondi può essere il punto (es. 03/05/05 10.31.00) o i due punti (es. 03/05/05 10:31:00).
Nell'importazione di file di testo con la action Data_GetTextFile (immediata è molto pratica) il formato delle date deve essere coerente con quelle di sistema; nella action Connect_Text al contrario è possibile impostarlo valorizzando il parametro DateTimeFormat. A questo riguardo si consulti la documentazione di reference della action.
Per evitare a priori ogni ambiguità si consiglia (quando possibile) di utilizzare nel file di testo il formato standard ISO per date e ore (formato YYYY-MM-DD hh:mm:ss), universalmente riconosciuto con qualsiasi impostazione internazionale.
Errore di esecuzione salvando/accedendo a file in cartelle condivise in rete
Quando con le opportune action si cerca di leggere, modificare o salvare un file in una cartella di rete (es. \\HOST\CartellaCondivisa\), viene generato uno dei seguenti errori:
• Error in Object Management
• Permission Denied
• Path/File access error.
Il problema non si verifica se nel nome del file viene specificato un percorso locale (es. C:\Cartella\).
| Causa |
L'utente, pur potendo accedere localmente a tutte le cartelle del file system, non ha sufficienti permessi di accesso/lettura/scrittura alla condivisione in rete della cartella. Tali permessi vanno esplicitati nelle finestra delle proprietà della condivisione.
Alcune action di linguaggio richiedono permessi in scrittura sulla cartella anche se solamente per accedere in lettura ai file in essa contenuti (es. Connect_Text).
|
| Soluzione |
Nella finestra delle proprietà della cartella condivisa assegnare a tutti gli utenti che eseguiranno lo script i diritti di accesso necessari; a questo riguardo si consulti la documentazione di reference delle action utilizzate. |
Fallimenti nelle esecuzioni schedulate di script: repSL Engine non può essere avviato
Si supponga di aver schedulato l'esecuzione automatica di uno script ogni 30 minuti. Se durante una delle esecuzioni si verificasse un errore, la relativa sessione dell'Engine rimarrebbe attiva (in stand-by) visualizzando soltanto il pop-up di tale errore.
In questa eventualità, con una cadenza di 30 minuti fallirebbero tutte le esecuzioni successive in quanto non è possibile avviare contemporaneamente più sessioni dell'Engine su uno stesso PC. Solo l'utente potrebbe sbloccare questa situazione chiudendo la finestra relativa all'errore o al messaggio.
| Causa |
Una nuova sessione di repSL Engine non può essere avviata fintanto che è attiva una precedente sessione. |
| Soluzione |
Impostando a Yes il parametro AutoHideMessage della action Settings :
Settings { AutoHideMessage = Yes }
si indica all'Engine di chiudere automaticamente (dopo 3 secondi) ogni pop-up di errore o di messaggio visualizzato durante l'esecuzione di uno script, senza l'intervento dell'utente. In questo modo in alcun modo il verificarsi di un errore in una esecuzione potrà impedire i successivi avvii schedulati dell'Engine.
Se si desidera tenere traccia di tali fallimenti è possibile attivare la compilazione di un log file e/o una notifica via mail dell'evento. |
| SUGGERIMENTI PER LO SVILUPPO DI SCRIPT |
Come editare e testare query SQL in repSL Developer
In accordo con la roadmap del progetto, la release 2.1.4 di repSL Developer non dispone ancora di editor interni proprietari per la realizzazione e il testing di query SQL, ma si appoggia ai numerosi e efficienti editor disponibili nel mercato, già completi di interfacce grafiche user-friendly.
La tabella riporta alcune di queste soluzioni, commerciali o scaricabili gratuitamente dall'Area Download o dai rispettivi siti ufficiali:
| Database |
Tool di editing SQL |
| MS Access |
L'editor di query è integrato nell'applicazione, e mette a disposizione dell'utente anche numerose e pratiche procedure guidate |
| MS SQL Server |
MS Query Analyzer e MS SQL Server Enterprise Manager sono disponibili con l'installazione standard di ogni client di SQL Server.
Inoltre Quest Software ha recentemente prodotto una versione freeware di TOAD per SQL Server.
|
| Oracle |
|
| MySQL |
Quest Software fornisce TOAD per MySQL Freeware |
| File di testo e database connessi via ODBC |
Sfruttando una connessione ODBC è possibile linkare tabelle e viste di moltissimi database direttamente in MS Access; anche i file di testo possono essere facilmente collegati. In questo modo l'utente ha a disposizione l'interfaccia grafica di Access per interrogare le fonti più disparate. |
Questi editor sono largamente conosciuti ed utilizzati nell'ambito della gestione e dell'interrogazione di database aziendali, e per questo le loro interfacce sono già familiari a molti utenti.
Inserimento rapido di parentesi graffe
Quando il proprio comupter non dispone di keyboard con i tasti relativi, l'inserimento rapido delle parentesi graffe nell'editor di repSL Developer è possibile premendo i tasti...
• CTRL + ( per la parentesi graffa aperta
• CTRL + ) per la parentesi graffa chiusa.
Attivazione rapida dell'Assistente di Codice
L'Assistente di Codice di repSL Developer viene attivato rapidamente premendo i tasti...
• CTRL + Spazio
in qualsiasi parte dell'editor.
Utilizzo dell'utility Code Picker per non riscrivere codice già scritto
Molti script di report sono simili tra loro in termini di formattazione del template, interazione con l'utente, post-processing locale, etc... Spesso a cambiare sono soltanto le sorgenti dati a cui connettersi o le interrogazioni SQL.
L'utility
Code Picker, disponibile in repSL Developer alla voce di menù
• File -> Code Picker
consente proprio di aprire un secondo file di script .rsl da cui copiare blocchi di codice (già scritti in precedenza o da qualche altro utente) da incollare direttamente nell'editor adattando eventualemente pochi dettagli.
L'apertura del secondo file avviene in sola lettura, perciò senza possibiltà di modificare anche accidentalmente tale file.
| ERRORI LEGATI A MS OFFICE |
Date erroneamente gestite nella Current Data Matrix (Office XP SP1)
Importando o modificando dei campi data/data ora nella Current Data Matrix, il formato delle date non viene correttamente gestito o interpretato da repSL Engine. Il problema si può manifestare se è installato MS Office XP, non se si utilizzano le altre versioni (Office 2000 o Office 2003).
| Causa |
L'errore sembra essere legato alla Service Pack 1 (SP1) di MS Office XP; su installazioni di Office XP non aggiornate o aggiornate con Service Pack differenti dalla SP1 il problema non si presenta. Verificare la versione installata (ad esempio in Excel dal menù Informazioni su Microsoft Excel) |
| Soluzione |
Aggiornare Office XP con Service Pack successive alla SP1 |
Errore durante la modifica del template o l'inserimento dei dati (Office XP/2003)
Cliccando con il mouse su elementi di un template Excel o PowerPoint mentre l'Engine sta inserendo informazioni nel template stesso, a volte viene generato l'errore Error in Object Management.
L'errore può manifestarsi se è installato MS Office XP o 2003, non se si utilizza Office 2000.
| Causa |
Il problema è legato alle modifiche apportate da Microsoft ai server di automazione delle ultime versioni di Office.
Se l'utente interagisce con il documento mentre il server di automazione Microsoft sta modificando lo stesso file si provoca un ritardo nella gestione dei processi di automazione e un conseguente errore.
Ad oggi e con le attuali Service Pack, Microsoft non fornisce una risposta al problema. |
| Soluzione |
Il team di sviluppo di repSL stà predisponendo un aggiornamento che consentirà di evitare la notifica dell'errore, fintanto che Microsoft non fornirà un proprio aggiornamento al processo di automazione responsabile del problema.
Nel frattempo l'utente dovrebbe osservare la compilazione del template evitando, con il click del mouse, di interagire con gli oggetti in esso contenuti: click su celle Excel, attivazione di diversi sheet o slide, editing di celle o caselle di testo, etc..
Molte funzionalità dell'interfaccia di Excel continuano comunque ad essere utilizzabili con il mouse (ad esempio le barre di scorrimento verticale e orizzontale e le voci di menù) oppure con le opportune combinazioni di tasti (ad esempio premendo CTRL+PageDown o CTRL+PageUp l'utente può attivare in sequenza tutti i fogli contenuti nella cartella).
Vengono infine riportati alcuni suggerimenti:
Durante la fase di testing di uno script
- Affiancare tra loro le finestre di sviluppo e quella del template (premendo F11 o F12) per poter valutare in tempo reale gli effetti sul template evitando allo stesso tempo di cliccare sulla finestra relativa per attivarla in primo piano
- Eventualmente procedere con la modalità di esecuzione passo-passo (F6)
Durante l'esecuzione normale
- Si consiglia di mantenere ridotta a icona la finestra del template, o anche di non renderla visibile.
|
Errore dopo numerose esecuzioni della action Sheet_Copy (Office XP/2003)
Eseguendo molteplici volte la action Sheet_Copy su di un template Excel, lo script viene interrotto con il messaggio di errore Error in Object Management.
Il problema si manifesta se è installato MS Office XP o 2003.
| Causa |
L'errore è generato da MS Excel e legato a limiti interni all'applicativo. Il numero di copie di uno sheet che è possibile effettuare prima del verificarsi del problema è inversamente legato alla complessità degli elementi in esso contenuti. Fogli molto complessi (numerosi grafici, shapes, immagini, ...) possono essere clonati per 15-20 volte, mentre si possono effettuare anche centinaia di copie di fogli contenenti soltanto celle e formule.
L'utente può riprodurre/sperimentare il problema anche manualmente. |
| Soluzione |
L'errore è riconosciuto da Microsoft:
http://support.microsoft.com/default.aspx?scid=kb;en-us;210684&Product=xlw
ma non ci sono indicazioni sulla possibile risoluzione in eventuali Service Pack future.
Al presentarsi del problema, va considerata l'ipotesi di modificare il layout del report distribuendo le informazioni in un numero di sheet inferiore, ad esempio su più pagine affiancate e separate da interruzioni di riga e/o colonna. |
Ridimensionamento anomalo dei grafici in PowerPoint con Sheet_SetChartSource
Quando, con la action Sheet_SetDataSource, viene modificata l'origine dei dati di un grafico all'interno di una slide di PowerPoint, l'area del tracciato, il titolo e la legenda del grafico vengono ridimensionati in maniera anomala modificando radicalmente le loro proporzioni reciproche.
Il problema è legato a problemi di gestione - da parte dell'Automation Server di Microsoft - dell'oggetto OLE di Excel nella slide di PowerPoint.
| Causa |
La visualizzazione delle slide nella finestra di PowerPoint ha un fattore di zoom differente dal 100% o è attivato lo zoom automatico ("Adatta" o "Fit"). |
| Soluzione |
Fissando nel template il fattore di zoom della visualizzazione delle slide a 100% e salvando il file con questa impostazione, il problema non si presenta. |
| BUG SEGNALATI NELLE APPLICAZIONI repSL |
Hanging valorizzando il parametro Append nella action Data_GetSQL
Se viene eseguita la action Data_GetSQL o Data_GetSQLProcedure con il parametro Append = Yes l'esecuzione rimane ferma alla riga della action pur senza generare errori.
Il problema è stato risolto con la release 3.0.9 di repSL Engine.
| Causa |
Anche se non viene notificato alcun errore, il numero di colonne che si vogliono aggiungere alla Current Data Matrix non coincide con quello dei dati già presente (es. accodare dati con 3 o 5 colonne quando la Current Data Matrix contiene già dati su 4 colonne). Il problema della mancata notifica dell'errore è legato alla versione 3.0.8 dell'Engine. |
| Soluzione |
Controllare (in fase di debug) la coerenza nel numero di colonne da aggiungere alla Current data Matrix. Aggiornando repSL a versioni successive alla 3.0.8 tale situazione di errore verrà correttamente notificata in fase di esecuzione. |
Errore generato dalla funzione FindExcelAddress
Richiamando la funzione FindExcelAddress viene generato un errore Data Type Mismatch anche se i parametri passati sono corretti.
Il problema è stato risolto con la release 3.0.9 di repSL Engine.
| Causa |
Il problema è legato all'interprete di linguaggio nella versione 3.0.8 |
| Soluzione |
Aggiornando repSL a versioni successive alla 3.0.8 il problema non si presenta.
In alternativa, è sufficiente annidare la funzione FindExcelAddress immediatamente all'interno di una funzione ToString.
Esempio: ToString( FindExcelAddress (Sheet, Range, Filtro)) |
Errore generato dalla action Data_ExportTextFile
Eseguendo la action Data_ExportTextFile quando la Current Data Matrix contiene valori nulli (NULL) viene generato un errore.
Il problema è stato risolto con la release 3.0.9 di repSL Engine.
| Causa |
Il problema è legato alla versione 3.0.8 dell'Engine. |
| Soluzione |
Aggiornando repSL a versioni successive alla 3.0.8 il problema non si presenta.
In alternativa è sufficiente, prima dell'esportazione, eseguire la action
Data_ReplaceNull { Value = "" }
per sostituire tutti i valori nulli con stringhe di lunghezza nulla. Tale sostituzione non altera il alcun modo il contenuto esportato in quanto i valori NULL nel file di testo sarebbero comunque rappresentati come stringhe di lunghezza nulla. |
Errore ignorato dalle action ExecuteSQL e ExecuteSQLProcedure
L'Engine non notifica alcun errore se l'esecuzione della action ExecuteSQL o ExecuteSQLProcedure fallisce a causa di comandi SQL non corretti o consentiti.
Il problema è stato risolto con l'aggiornamento Refresh 1 di repSL Engine 3.0.9
| Causa |
L'anomalia è legata alle versioni 3.0.8 e 3.0.9 dell'Engine. |
| Soluzione |
Applicare l'aggiornamento Refresh 1 di repSL Engine 3.0.9. |
|
