What's new di SitePainter Infinity

Transcript

1 What's new di SitePainter Infinity

2 COPYRIGHT by ZUCCHETTI S.p.A. Tutti i diritti riservati. Questa pubblicazione contiene informazioni protette da copyright. Nessuna parte di questa pubblicazione può essere riprodotta, trascritta o copiata senza il permesso dell'autore. TRADEMARKS Tutti i marchi di fabbrica sono di proprietà dei rispettivi detentori e vengono riconosciuti in questa pubblicazione. Ultima revisione Ottobre 2010 ZUCCHETTI S.p.A. Assistenza CodePainter: zz_supportocodepainter@zucchetti.it Assistenza SitePainter: zz_supportositepainter@zucchetti.it Indirizzi sito WEB:

3 Sommario What's New Confirm edit con condizione su bottoni, link e immagini Costrutto 'For each' nelle routine Eventi associati alle routine Generazione analisi multimodulo Implementazione dei warning negli oggetti check definition Messaggi di avviso e di conferma nelle routine Memory Cursor da query o definito direttamente?!? Multilingua: Expression e Calculated String Nuovi metodi per i Memory Cursor Oggetti Calculation condizionati Radio Button: conditional editing ed hiding sul singolo control Suggest: 10,20,...n record Variabili globali nellle opzioni di Menu Web Report: Colori per le expression e le label nel report Web Report: Merge misto Web Report: Nuovi formati di stampa: XSL-FO, Postscript e PCL Web Report: Report in lingua diversa Web Report: Xml con XSLT Report Library: nuovi metodi SPI PortalStudio: Generazione controls in modalità float SPI PortalStudio: Module Editor, un nuovo disegnatore SPI PortalStudio: onchange su item Variable e Textbox SOMMARIO I

4 1.23 SPI PortalStudio: DocType Transitional...18 II SOMMARIO

5 Capitolo 1 What's New Ecco l'elenco delle nuove implementazioni della build Confirm edit con condizione su bottoni, link e immagini Sia su bottoni, sia sulle label che sulle immagini sono stati aggiunti dei control che consentono di richiedere la conferma dell'operazione da eseguire. WHAT'S NEW 1

6 Figura 1 - Un esempio di confirm edit condizionata La richiesta può essere condizionata dalla valutazione di un'espressione booleana; se l'espressione è vera allora viene presentato il messaggio altrimenti la conferma non viene richiesta. 1.2 Costrutto 'For each' nelle routine Da questa versione del disegnatore di Routine è stato aggiunto il construtto "For each" che permette di iterare in strutture dati di tipo memory cursor, ma in futuro l'implementazione permetterà di iterare anche su risultati di query, tabelle e transitori di BusinessObject. A differenza del costrutto "While", in cui solitamente è necessario dichiarare la variabile di appoggio per iterare, o del costrutto "Select", che itera in un set di righe ma necessita di variabili per estrapolare dati di riga corrente, il costrutto "For each" si avvale del nuovo tipo di dato "Row" per accedere ai dati del singolo record su cui si sta ciclando. Il tipo di dato Row deve essere dello stesso tipo su cui è definito il MemoryCursor su cui si vuole iterare. Per agevolare la ricerca o lo scorrimento sono state implementate le opzioni per filtrare (espressione "where") ed ordinare (espressione "order by") il MemoryCursor. 2 WHAT'S NEW

7 Figura 2 - Un esempio di utilizzo 1.3 Eventi associati alle routine Figura 3 - Un esempio di notifica di un evento in una routine Nell'ottica di permettere lo sviluppo di una routine come estensione di un'altra routine a partire da questa release è stata aggiunta la possibilità di notificare eventi da una routine; all'item 'Exec' è stata aggiunta la tipologia event per lanciare un evento applicativo. In questo modo è possibile notificare al chiamante che una parte dell'elaborazione è terminata in modo da poter eseguire ulteriori controlli/calcoli. E' stata poi estesa la gestione degli eventi specificati nel design per consentire alle routine di ricevere eventi scatenati da altre routine. Il gestore degli eventi tramite variabili caller può accedere alle variabili caller i_entityname per ottenere il nome della routine e sapere se viene chiamato da una "routine" o "function" usando i_entitytype. WHAT'S NEW 3

8 Figura 4 - Un esempio di notifica di un evento Run end Sono inoltre stati creati due eventi di sistema sia per le routine che per le funzioni: "Run start" ed "Run end", scatenate all'inizio e alla fine della routine. 1.4 Generazione analisi multimodulo Figura 5 - Un esempio di generazione multimodulo Analogamente a quanto fatto per la generazione multimodulo del codice, a partire da questa release è possibile generare i piani di design del modulo principale dei singoli moduli in un click. 4 WHAT'S NEW

9 1.5 Implementazione dei warning negli oggetti check definition Figura 6 - Un esempio di check con warning In ogni singola riga di un oggetto check è possibile selezionare il flag di Warning. Questa scelta genera il check solo lato client, ponendo una richiesta di conferma (Ok - Annulla); in caso di risposta positiva dell'utente ("Ok") il check continua ad eseguirsi. Se si preme "Annulla" il check genera un errore e ferma l'esecuzione dell'espressione associata. 1.6 Messaggi di avviso e di conferma nelle routine Da questa nuova Build di SITEPAINTER INFINITY è possibile lanciare messaggi di conferma (che influiscono sull'esecuzione della routine) o di avviso per l'utente all'interno delle routine client-side. Esempio Supponiamo di volere che, quando un cliente sta per effettuare un ordine nel nostro sito, venga effettuato un controllo che la quantità degli articoli ordinati sia effettivamente presente nel magazzino prescelto e che, in caso contrario, avverta il cliente. Il cliente potrà scegliere se procedere comunque con l'ordine oppure se modificarlo. A questo punto, nella routine che si occupa di gestire il controllo delle quantità presenti in magazzino, sarà sufficiente aggiungere un item di tipo 'Messagge', scegliendo il Type 'Confirm' contenente la seguente espressione: Esempio di codice 'Quantità %1 richiesta dell'articolo %2 non disponibile nel magazzin o %3. Continuare?' Nella sezione 'Parameters' sarà sufficiente specificare le variabili nel seguente ordine nqtaart, ccodart, ccodmag. WHAT'S NEW 5

10 Figura 7 - Messaggio di conferma 1.7 Memory Cursor da query o definito direttamente?!? Figura 8 - Un esempio di creazione da definizione A partire da questa release l'oggetto memory cursor può essere definito direttamente e la sua definizione può essere salvata in un file che verrà utilizzato per presentare le proprietà dell'oggetto stesso. Il file di definizione ha estensione MCRDef. Questo tipo di implementazione consente di evitare per forza l'utilizzo di una query da cui recuperare la struttura da trattare. 6 WHAT'S NEW

11 1.8 Multilingua: Expression e Calculated String Con la Build 57 di SITEPAINTER INFINITY è possibile abilitare la funzionalità di traduzione (multilingua) automatica di due tipologie di elementi dei disegnatori : le Expression, presenti nelle entità Master, Detail, Master/Detail, ecc.. le String definite come Expression (tipicamente le stringhe di descrizione calcolate tramite espressioni). a patto che vengano definite utilizzando la funzione standard FormatMsg. Esempio L'espressione: Esempio di codice "Codice cliente:" + Trim(w_CODCLI ) va sostituita con: Esempio di codice FormatMsg("Codice cliente: %1", Trim(w_CODCLI )) o, in alternativa: Esempio di codice FormatMsg("Codice cliente:") + " " + Trim(w_CODCLI ) WHAT'S NEW 7

12 Figura 9 - Il nostro esempio In caso di espressioni calcolate: Esempio di codice iif(w_tipcli="for", "Codice cliente:" + Trim(w_CODCLI ), "Codice for nitore:" + Trim(w_CODFOR )) sostituire con: Esempio di codice iif(w_tipcli="for", FormatMsg("Codice cliente: %1", Trim(w_CODCLI )), FormatMsg("Codice fornitore:", Trim(w_CODFOR ))) 8 WHAT'S NEW

13 Figura 10 - Il nostro esempio 1.9 Nuovi metodi per i Memory Cursor Sono stati implementare nuovi metodi sul memory cursor: InsertBlank Inserisce alla riga corrente una nuova riga vuota. SetKey Imposta la chiave della riga corrente. GetKey Restituisce il valore della chiave corrente trasformato in stringa, null se la riga non ha una chiave associata. RemoveKey Rimuove la chiave della riga corrente se esiste. RemoveAllKeys Rimuove tutte le chiavi definite nel memory cursor. InsertWithKey Inserisce alla riga corrente una riga vuota con associata una chiave. SaveRow Salva la riga senza spostarsi dalla corrente. AppendRow Aggiunge la riga passata come parametro. AppendRowWithKey Aggiunge la riga passata come parametro associando la chiave. InsertRow Inserisce alla riga corrente la riga passata come parametro. WHAT'S NEW 9

14 InsertRowWithKey Inserisce alla riga corrente la riga passata come parametro associando la chiave Oggetti Calculation condizionati Figura 11 - Un esempio di calculation condizionato L'oggetto Calculation è stato potenziato inserendo una condizione per l'esecuzione del singolo calcolo o una condizione globale. Se la condizione globale è vera vengono valutate quelle del singolo elemento e se la singola condizione risulta verificata viene scatenato il calcolo associato Radio Button: conditional editing ed hiding sul singolo control Per gli elementi di tipo Radio Button sia verticali che orizzontali è stata data la possibilità di editare e/o nascondere sotto condizione il singolo bottone. 10 WHAT'S NEW

15 Figura 12 - Un esempio di condizione di editing Nella zona di expression è possibile dichiarare un'espressione booleana semplice o la chiamata a una funzione che restituisce un valore booleano in base al quale verrà condizionata la visualizzazione o l'editing del singolo controllo Suggest: 10,20,...n record Figura 13 - Un esempio di suggest L'opzione sul numero dei record estratti dal suggest è stata ora resa parametrica. E' possibile parametrizzare il numero di record presentati specificando il valore desiderato nell'apposita zona. WHAT'S NEW 11

16 1.13 Variabili globali nellle opzioni di Menu Figura 14 - Un esempio di utilizzo di variabili globali nel menu E' stata implementata la possibilità di usare le variabili globali nelle voci di menu. La sintassi scelta è quella delle VQR, ovvero [GLOBALVAR(nome_var)]. Mettendo questa espressione dentro a qualsiasi voce di menu, la variabile globale verrà caricata al suo posto. La sostituzione della variabile globale avviene dopo la traduzione della voce di menu, per cui bisogna tradurre le caption che contengono una globalvar mantenendo la funziona anche nella stringa tradotta Web Report: Colori per le expression e le label nel report Da questa versione nel disegnatore di report è possibile selezionare i colori di foreground anche per le label e le expression. 12 WHAT'S NEW

17 Figura 15 - Un esempio di colore per una label 1.15 Web Report: Merge misto Per il formato di stampa Xml strutturato è possibile utilizzare più moduli per lo stesso report. Tale stampa solitamente è composta dalla stampa sequenziale di tutte le istanze del primo modulo, seguita da quelle del secondo e così via. Ora, selezionando l'apposito check nella dialog di stampa, è possibile alternare le istanze dei moduli nel pdf risultante. Esempio Se si ha un report che utilizza due moduli e ha tre istanze, la stampa utilizzando il MixMerge dovrebbe risultare così: Esempio di codice modulo1-istanza1, modulo2-istanza1, modulo1-istanza2, modulo2- istanza2, modulo1-istanza3, modulo2-istanza3 invece di WHAT'S NEW 13

18 Esempio di codice modulo1-istanza1, modulo1-istanza2, modulo1-istanza3, modulo2- istanza1, modulo2-istanza2, modulo2-istanza Web Report: Nuovi formati di stampa: XSL-FO, Postscript e PCL Figura 16 - L'elenco dei formati di stampa A partire dal presente rilascio sono stati inseriti questi nuovi formati di ouput. XSL-FO è un particolare metodo di rappresentare dei dati XML da utilizzare come output su schermo, carta o altri supporti. Attraverso l'utilizzo di una trasformata XSLT è possibile ottenere output in HTML, PDF e stampe di qualità. Il formato PostScript consente di rendere indipendente la qualità del documento dal supporto su cui viene visualizzato e/o stampato. Il formato PCL o Printer Control Language consente di inviare alla stampante comandi per produrre la pagina da stampare. 14 WHAT'S NEW

19 Tutti e tre i nuovi formati hanno il loro corrispondente valore da associare alla variabile outputformat ("XSLFO", "POSTSCRIPT","PCL') per pilotare la tipologia di output in modo programmatico Web Report: Report in lingua diversa... Figura 17 - Un esempio Dalla Build 57 di SITEPAINTER INFINITY è possibile stampare il report in una lingua diversa da quella dell'utente corrente. A tale scopo, il report deve essere costruito utilizzando la funzione di sistema FormatMSg() negli elementi di tipo Expression e String (definite come Expression) come indicato in Multilingua: Expression e Calculated String. Una volta costruito il report, basterà passare al report il parametro 'language' con la stringa indicante la lingua desiderata. WHAT'S NEW 15

20 1.18 Web Report: Xml con XSLT Figura 18 - Un esempio di stampa con trasformata xslt Per il formato Xml è ora possibile abbinare una trasformata Xslt in modo da poter usare questa tipologia di output anche per parti di presentazione Utilizzando la modalità IMMEDIATA o DOWNLOAD, è stata implementata una nuova classe di libreria (RPXsltTransform) che esegue la trasformazione dell'xml con il file xsl in html, che viene direttamente presentato sul browser. il percorso relativo del file di trasformata (xsl o xslt) fa riferimento alla root dell'applicativo (ovvero al valore restituito dalla SPLib.GetWebRootPath()). Nella modalità FILE, la trasformazione non viene eseguita server-side, ma il file xml viene generato con nell'header il riferimento al file xsl; viene riportato il percorso così come specificato in fase di selezione Report Library: nuovi metodi Sono stati aggiunti due nuovi metodi nella ReportLibrary: makereportbinderpdf() Permette di fare il 'bind' di pdf, ovvero di allegare al primo Pdf tutti i Pdf successivi. makereportmergingpdf() Permette di fare il merge di una lista di report in un unico pdf, ovvero di creare un unico Pdf o Pdf/A in cui le stampe dei report sono sequenziali SPI PortalStudio: Generazione controls in modalità float Dalla Build 57 di SITEPAINTER INFINITY, è disponibile la modalità float (proprietà 'Positioning mode') di posizionamento dei controls dentro ai portlet. Con questa nuova modalità, ogni elemento html non sarà più posizionato in 'absolute' ma in 'float', così che il 16 WHAT'S NEW

21 render del portlet avvienga senza calcolare ridimensionamenti e quindi molto più rapido senza dare luogo ad effetti visivi poco graditi. Inoltre questa generazione consente ai Box di diventare un contenitore espandibile nel caso in cui in uno di essi vi siano contenuti elementi espandibili SPI PortalStudio: Module Editor, un nuovo disegnatore Figura 19 - Il Module Editor Da questa versione è stato introdotto un nuovo disegnatore per PortalStudio: il Module Editor. Il Module Editor permette all'utente di creare un modulo per effettuare il merge del report con un pdf, senza dover creare un nuovo form utilizzando strumenti esterni a SITEPAINTER INFINITY. Sarà sufficiente caricare un file pdf, scegliere il report da cui estrarre i campi e posizionarli nel modulo. Inoltre, effettuando il merge del report con i file costruiti in questa nuova modalità, le prestazioni sono migliorate. WHAT'S NEW 17

22 1.22 SPI PortalStudio: onchange su item Variable e Textbox Come per altri componenti, nelle componenti Variable e Textbox, è stata aggiunto l'evento 'onchange'. Implementando questo evento nell'action Code del portlet, sarà possibile gestire il cambiamento di valore di un componente Variable e/o Textbox SPI PortalStudio: DocType Transitional Il DocType (abbreviazione di 'Document type declaration' ovvero 'Dichiarazione del tipo del documento') indica la versione di (X)Html utilizzata dalla pagina web che si sta cercando di aprire. Per lo standard Html si tratta di un componente chiave nelle pagine Web. Inoltre, sono essenziali per una compatibilità assicurata tra tutti i principali browser. Introdotto in tutte le pagine prodotte da SITEPAINTER PortalStudio, il DocType Transitional, aiuta nella transizione dal HTMLal XHTML, ma potrebbe causare delle incompatibilità con le jsp create con le versioni precedenti di SITEPAINTER PortalStudio. 18 WHAT'S NEW