Table Of ContentMANUALE SPRIX
SPRIX
6 SPRIX/COLLAGE
05/08/2019
SPRIX / COLLAGE
AVVERTENZE IMPORTANTI SULLA DOCUMENTAZIONE
Questo documento è il Manuale didattico ed operativo relativo al linguaggio di programmazione dei componenti Sprix e Collage contenuti nella
piattaforma di sviluppo PassBuilder integrata nel Gestionale Passepartout.
La piattaforma è collocata nella voce 'App PassBuilder' del menu 'Servizi' ed è costituita da un aggregato di funzionalità e strumenti nativi per
realizzare personalizzazioni e sofisticate procedure verticali.
Fra questi strumenti di sviluppo ci sono quelli chiamati Sprix e Collage. E' sufficiente realizzare anche un singolo programma con uno di questi
due strumenti a rappresentare un'Applicazione Passepartout realizzata con PassBuilder, pertanto, il presente manuale integra il “Manuale
PassBuilder”.
Il manuale Sprix/Collage è una componente del manuale PassBuilder in quanto contiene informazioni propedeutiche per sviluppare Applicazioni
Passepartout. Per ragioni tecniche il manuale Sprix/Collage è mantenuto separato dal manuale PassBuilder, in quanto possiede funzionalità
specifiche come i collegamenti all'Editor di programmazione Sprix/Collage (cioè può richiamare i dettagli di singole istruzioni, funzioni e variabili)
e link interni agli esempi ed a sezioni di raggruppamenti per argomento.
Entrambi i manuali, infatti, sono disponibili on-line sia nell'Area Riservata del sito Edupass.it sia nell'Area Sviluppatori presente nell'Area
Riservata del sito Passepartout.net (accessibile con credenziali user/password oppure dallo stesso Gestionale). Sebbene siano accessibili da
punti diversi, questi documenti sono identici.
SPRIX
Si consiglia di scaricare il Manuale Sprix in formato PDF, dato che questo consente:
la conservazione di questo documento per ciascuna versione del Gestionale, considerando che è anche suscettibile di modifiche in
"tempo reale" per eventuali necessità contingenti; la complessità del contesto ambientale in cui si diffonde la natura tecnica di questo
documento può richiedere utili e/o necessari interventi tempestivi ad ampia diffusione, al fine di aggiungere correzioni, chirarimenti,
esempi, aggiornamenti d'appendice, ecc; le nuove informazioni, quindi, sono immediatamente fruibili e non passano necessariamente
attraverso i periodici leggimi e le relative circolari, poichè questi ultimi due tipi di documenti riportano gli aggiornamenti di particolare
rilevanza e correzioni di anomalie, pertanto si consiglia di riferirsi sempre ai leggimi elencati nell'Appendice in calce al manuale (v.
figura). L'aggiornamento del manuale Sprix è indipendente dalle release del Gestionale, pertanto la data di pubblicazione è riportata
nel titolo di questo documento, spesso equivalente alla data di ultima modifica del file PDF; la possibilità di scaricare in PDF consente
quindi all'utente di collezionare e conservare tutte le versioni d'interesse e le cui differenze può confrontare con appositi programmi di
comparazione; si consiglia di attendere qualche giorno dal rilascio dell'ultima release del Gestionale, in modo da conoscere anche le
eventuali "ultime notizie";
la consultazione off-line e con un comodo “segnalibro”;
le ricerche più efficienti in base a parole "chiave"; il linguaggio Sprix è fatto di parole "chiavi" e a meno che non sia ancora previsto
l'argomento è impossibile non trovare l'informazione desiderata;
la visualizzazione di commenti e note a piè di pagina, spesso utili per informazioni ridondanti oppure storiche; una visualizzazione dei
testi più utile per un manuale tecnico e più vicina alle esigenze dei Partner Sviluppatori;
l'utilizzo di link “clicca qui” che collegano le singole voci ai paragrafi dei comandi raggruppati per argomento d'appartenenza;
Per tutti gli argomenti generali relativi alla piattaforma PassBuilder e che non sono menzionati (ripetuti) in questo manuale Sprix/Collage, si
rimanda al manuale PassBuilder, di cui riportiamo due link:
PassBuilder in Area Pubblica (vedere il capitolo PassBuilder del menu Servizi nel manuale Passepartout).
PassBuilder in Area Riservata (il documento è il capitolo estratto dal manuale Passepartout).
Sebbene una singola Applicazione Passepartout possa essere realizzata in PassBuilder anche con uno solo fra i due strumenti di sviluppo Sprix
e Collage, si ricorda che la piattaforma è composta anche da altri elementi e funzionalità (v. figura), pertanto anche i loro manuali (es. 'MyDB'),
potrebbero essere mantenuti separati e collocati in altri contesti più idonei, ma ugualmente raggiungibili (ad esempio la 'Modulistica di Stampa' è
utilizzata anche dalla procedura standard, pertanto il suo manuale è collocato nel manuale generale).
3050 SPRIX/COLLAGE
05/08/2019
SPRIX
Inoltre, alcuni di questi elementi sfruttano anche specifiche funzionalità descritte in questo manuale Sprix/Collage (v. figura), ma che sono da
integrare con le informazioni e gli esempi contenuti nei rispettivi manuali di ciascuno strumento (es. Mobile, Datatrek, ecc) oppure il medesimo
PassBuilder o il Web Market PassStore; per la medesima motivazione, in Sprix/Collage si rimanda l'approfondimento di alcune funzionalità agli
specifici manuali che le trattano (Xml, Web Service, Sql, ecc.).
I programmi Sprix e Collage sono capaci di leggere e scrivere dati, possono interagire a video e stampare in vari modi, si relazionano ad archivi
e device esterni, ecc... Con Sprix e Collage è facile programmare, ma presuppone la conoscenza del contesto ambientale per ottenere i migliori
risultati, pertanto le informazioni contenute nel Manuale Utente sono indispensabili per conoscere l’ambiente in cui questi strumenti operano:
caratteristiche del Sistema; configurazioni dei componenti Client e Server; remotizzazioni LAN (Locale) e WAN (Live Server Farm); accessi;
restrizioni; funzionalità; regole; automatismi; controlli; semaforiche dati.
Ignorare il manuale utente comporta rischi di inefficacia oppure di inefficienza dell'Applicazione, per esempio, la replica di funzioni già esistenti
oppure l'incontro di vincoli o di limiti strutturali non considerati in sede di analisi.
La voce Allegati e Documenti dell'Area Sviluppatori presente nell'Area Riservata del sito Passepartout.net, contiene:
1. guida alla documentazione, le condizioni di utilizzo del servizio di supporto EasyPass, l'utilizzo del Forum;
2. template per la realizzazione della documentazione di una Applicazione (come realizzare il manuale di una App);
3. liberatoria per l'autorizzazione al Reverse Engineering di Applicazioni (in caso di perdita dei Sorgenti);
4. archivio storico di esempi e documenti non più aggiornati (tracciati, tabelle, relazioni, diagrammi, mirroring);
Considerare, infine, anche la Composizione Prodotti della sezione Commerciale nell'Area Riservata, in quanto riporta dei vincoli commerciali,
ad esempio: i livelli di prodotto che non sono contabili hanno, ovviamente, dei limiti di gestione della primanota.
SPRIX/COLLAGE3 051
05/08/2019
SPRIX
Se sei un nuovo collaboratore puoi ignorare la seguente tabella commerciale, che conclude queste avvertenze relative alla documentazione:
POLITICHE STRUMENTI DI SVILUPPO
Il presente paragrafo è soggetto ad aggiornamenti e sostituisce le seguenti obsolete politiche relative agli strumenti di sviluppo:
Politica Sprix Lite, Sprix Full, MDS, SDK – versione di riferimento 2003G, ex chiarimento 18916 supporto online (obsoleto)
Politica Sprix Pubblico, Sprix Privato – versione di riferimento 2011C, ex chiarimento 26612 supporto online (obsoleto)
MDS / PASSBUILDER (versione di riferimento 2016H)
MDS Pass Funz.tà Sprix Modalità Stampe MyDB MexalDB Shaker Esecuz. Sviluppo Sprix Data
(liv. 4)
Builder dalla Collage Pers.zzate App App Mobile Trek
(liv. 5)
2016H
N N N S Pubblica S S N N N N N N
S N N S Privata S S S S N N N N
N S S S Pubblica S S N N S S S S
S S S S Privata S S S S S S S S
Il livello di licenza di sviluppo disponibile si verifica premendo i tas t[iF1+F1+F2] nel Gestionale; valutare ciascun caso (configurazione) in base alle vigenti condizioni commerciali, comunicate
attraverso appositi canali di comunicazione e circolari di Area Riservata (es: circolari del 1 luglio e del 1 agosto 2016 ).
MDS (Mexal Developer Suite): la personalizzazione consente di non collocare il sorgente nell’installazione .Attenzione: i vecchi eseguibili
compilati prima del rilascio di MDS (versione 2003G), se ricompilati richiedono il sorgente oppure licenza di sviluppo MDS; atal proposito, si
ricorda che è assolutamente vietato il reverse engineering non espressamente autorizzato con dichiarazione scritta del titolare di tutti i riservati
diritti. Nelle installazioni Live nella Server Farm Passepartout, lo Shaker è disponibile con il solo componente “.Net”; in ambiente Live l’utilizzo
dei restanti componenti Shaker, MexalDB, RDBMS oppure software diversi dal Gestionale che richiedono configurazioni particolari (es:
operazioni SQL su file Xls/Mdb via ODBC) non è disponibile.
PASSBUILDER: è la piattaforma di sviluppo e gestione di personalizzazioni cosiddette “App”; l’attivazione di PassBuilder non pregiudica la
configurazione di personalizzazioni preesistenti alla politica PassBuilder, per le quali, restano in vigore le politiche preecdenti alla versione
2016H. Le personalizzazioni preesistenti possono coesistere con la possibilità di generare “App” e sono convertibili in “App”. (*)
Modalità “Pubblica” significa che l’applicazione funziona solo se il sorgente ed il relativo eseguibile sono entrambi collocati nell’installazione.
Modalità “Privata” significa che l’applicazione funziona anche con il solo eseguibile, ma richiede attivazione del livello MDS. Attenzione:
l'utilizzo della funzione "elimina sorgenti sprix collage app" presente nell'ambiente PassBuilder senza disporre del necessario livello MDS
invalida l'Applicazione e la rende non utilizzabile.
Se il cliente non dispone di MDS, nell'eventualità che avvenga un cambio di Dealer (ad esempio per cambio di Partner oppure di Ragione
Sociale e p.Iva) è necessario che l'App sia ricompilata dall'installazione con il nuovo Dealer.
Per sviluppare la cosiddetta App Utente è necessario che l’installazione attivi sia MDS che PassBuilder.
Per installare ed eseguire la App Utente è necessario che l’installazione attivi PassBuilder; se Cliente non ha MDS attivo:
Il Cliente può eseguire la App Utente realizzata dal suo Partner.
Il Partner autore della App Utente può pubblicarla nella vetrina PassStore come PassApp; indipendentemente dall’autore il Cliente
può eseguire qualsiasi PassApp.
MDS consente il trasferimento di App fra Partner tramite marcatura del Partner che la riceve.
La pubblicazione nel PassStore è un’opportunità e non un obbligo; la distribuzione di una medesima PassApp a più di un'installazione
comporta, comunque, il conteggio per singola installazione.
(*) chiarimenti sul passaggio di Sprix e MyDB in PassApp sono descritti nella circolare “CC_SG-PAC_PassaggioInPassApp_170529”
e nella circolare “CC_SG-PAC_NovitaMeeting_170517”.
3052 SPRIX/COLLAGE
05/08/2019
SPRIX/COLLAGE
05/08/2019
SPRIX/COLLAGE
05/08/2019 1
SPRIX
STRUTTURA DEL MANUALE
1. INTRODUZIONE (Ambiente di Sviluppo e Gestione dei Programmi)
Questa prima parte è dedicata ai nuovi collaboratori che desiderano sviluppare Applicazioni Passepartout attraverso gli elementi di
programmazione Sprix e Collage persenti fra quelli disponibili nella piattaforma PassBuilder integrata nel Gestionale Passepartout. Si
tratta di un capitolo dedicato ad un esempio dimostrativo per descrivere l’ambiente di sviluppo Sprix/Collage integrato nel Gestionale
Passepartout. Il capitolo riporta, infine, delle indicazioni sulla gestione dei programmi ed in cui la cui nomenclatura dei file è differente
dalla gestione precedente solo a livello terminologico. Le suddette informazioni possono essere utili anche agli utenti esperti.
2. COMANDI PER ARGOMENTO (Linguaggio, Sintesi dei comandi con Regole, Esempi e Casi)
Questa seconda parte aggrega i comandi del linguaggio Sprix/Collage in tabelle per categoria di argomento. Ciascuna tabella elenca i
comandi in modo sintetico e, finchè possibile, di rispettarne l'ordine logico di utilizzo. Le tabelle riportano piccoli esempi, anche tramite
link e casi d’uso.
Notare: alcuni esempi potrebbero non essere più riproducibili in quanto non più allineati all'evoluzione grafica e/o funzionale del Gestionale, oppure, sebbene ancora funzionanti
potrebbero non essere più efficienti e superati da nuove funzioni più avanzate di Sprix/Collage e/o del Gestionale. Alcuni di questi esempi e casi d'uso provengono dall'attività di
assistenza on-line (Supporto EasyPass) e restano documentati, ma non modificati, sia per ragioni di "evoluzione storica" sia perchè i programmi Sprix/Collage sono portabili nel
tempo e nelle versioni, fino a quanto è più possibile. Le correzioni posso avvenire, ma solo in caso di evidenti errori. Gli esempi possono avere font e formattazioni differenti: il
"copia e incolla" del testo potrebbe interpretare e riportare dei caratteri speciali che potrebbero "sporcare" il sorgente ed impedirne la compilazione e/o il funzionamento (per
esempio i doppi apici di taluni font non vengono riconosciuti e si "tramutano" in altro); in tali casi è opportuno fare transitare il codice copiato in un editor ASCII puro ed
eventualmente apportare delle modifiche massive a tali caratteri in modo da uniformarli a quanto richiesto dall'Editor Sprix.
3. COMANDI IN ORDINE ALFABETICO (Dettaglio dei comandi con relativi Parametri)
Questa terza parte contiene la libreria di tutti i comandi elencati in ordine alfabetico, con il dettaglio dei parametri per ciascuna voce e
le particolarità delle condizioni di utilizzo.
4. Shaker
La quarta parte riguarda Shaker. Consiste in una suite di componenti di sviluppo che consente di sviluppare personalizzazioni del
Gestionale che sfruttano il motore SPRIX ma senza usarne il linguaggio, ovvero, tramite i linguaggi di altri ambienti di sviluppo (OCX,
.NET, JAVA). Richiede apposita Licenza MDS (Mexal Development suite).
5. Appendice: implementazioni per versione di rilascio
La quinta e ultima parte è un’appendice sulle implementazioni delle versioni di rilascio più recenti; è una sintesi degli ultimi leggimi.
2 MANUALE SPRIX/COLLAGE
SPRIX
INTRODUZIONE: AMBIENTE DI SVILUPPO
ACCENNI SULLA PIATTAFORMA
L'ambiente di sviluppo PassBuilder ti consente di realizzare Applicazioni Passepartout: accedi alla voce "App PassBuilder" collocato nella voce
di menu "Servizi", quindi seleziona "Nuova App".
Inserisci i dati identificativi dell'Applicazione.
SPRIX/COLLAGE
05/08/2019 3
SPRIX
Successivamente puoi scegliere gli elementi di sviluppo che servono per generare i contenuti dell'Applicazione: sono elencati e selezionabili,
hanno diversa natura e funzione in base a quello che l'Applicazione deve fare.
Questo manuale tratta principalmente tre elementi: "Sprix", "Collage" e "Libreria Sprix"; ciascuno di questi consente di generare files sorgenti
contenenti codice scritto in linguaggio Sprix tramite un apposito Editor. Il linguaggio Sprix è di tipo sequenziale e procedurale, elaborato riga per
riga, e dispone di un vasto insieme di comandi, funzioni, istruzioni e variabili per interagire con il Gestionale; alcuni comandi riguardano altri
elementi dell'Applicazione, quindi anche questi componenti usano lo stesso Editor, per esempio "Sprix mobile" e "Collage Server Remoto". (v.
immagine).
Elementi come la "Anagrafica MyDB" e la "Modulistica stampa", invece, sebbene il linguaggio Sprix abbia specifici comandi per utilizzarli non si
costruiscono con lo stesso Editor, ma tramite appositi moduli. Esempio, un programma Sprix che scrive dati su tracciati personalizzati di una
"Anagrafica MyDB" dispone di chiamate alla base dati MyDB ed istruzioni per scrivere nei suoi record, ma la natura e la struttura dei record non
si costruisce con l'Editor, poichè si crea con appositi moduli e tabelle.
Un'Applicazione può essere costitutita da un insieme di vari programmi "Sprix" e "Collage" fra essi combinati e relazionati, ma può essere anche
costituita da uno solo di questi. L'esempio introduttivo che seguirà è composto da tre elementi: un programma che opera ad "eventi" (Collage)
contenente un codice sorgente "riutilizzabile" (Libreria) impostato con un comando di tipo shell per lanciare ed eseguire un ulteriore programma
(Sprix) come se questo fosse un modulo o una funzione di servizio.
Il Collage è un programma contestualizzato nei moduli standard del Gestionale e viene eseguito quando si verificano determinati eventi; quando
questi eventi accadono, il modulo standard del Gestionale cede il controllo al programma Collage, ma poi lo riprende quando il Collage ha finito
il suo compito. Collage, quindi, non può "corrompere" la struttura originaria del Gestionale, poichè semplicemente nasce e ci muore "sopra", per
gestire l'Input (per controllare, bloccare, aggiungere, automatizzare l'operatività utente), l'Output (per leggere i dati a video, mascherare il client,
modificare le stampe e la modulistica dei documenti) per eseguire dei processi e per dialogare con database, applicativi e device esterni.
Un programma Sprix, invece, rispetto a Collage può essere eseguito in modo autonomo e indipendente come modulo aggiuntivo del Gestionale
e consente di accedere alla sua base dati in lettura diretta e/o con cicli tabellari, ma anche in modifica. Essendo indipendente, anche Sprix non
è in grado di "corrompere" l'impianto standard del Gestionale.
Entrambi i programmi Sprix e Collage possono sfruttare porzioni di codice in comune (Libreria) e possono lanciare ulteriori programmi Sprix
come processi aggiuntivi e separati, ma un programma Collage non può intervenire su un programma Sprix, poichè non esistono "eventi" Sprix.
4 MANUALE SPRIX/COLLAGE
