Primi passi con Jamio Composer. Dall idea applicativa alla soluzione in pochi minuti

Transcript

1 Primi passi con Jamio Composer Dall idea applicativa alla soluzione in pochi minuti

2 Comporre una nuova soluzione applicativa Jamio Composer è l ambiente di modellazione della piattaforma Jamio. Le soluzioni applicative modellate con Jamio Composer orchestrano tra loro dati eterogenei e complessi e sono compatibili con ogni tipo di piattaforma desktop e mobile. Familiarizzare con l interfaccia di Jamio Composer Avviate Jamio Composer e selezionate il tasto Crea. E conveniente predisporre una directory esclusiva per ciascuna soluzione che si modella con Jamio, cartella nella quale Jamio Composer salverà tutti i file relativi alla soluzione stessa. Create quindi una cartella con il nome più opportuno per la vostra prima soluzione. Dopo aver selezionato Crea, aver specificato il nome della soluzione e aver indicato la cartella di lavoro appena creata, Jamio Composer rende attiva la sua interfaccia. L area operativa si divide in: una sezione di progettazione principale che consente di modellare le diverse componenti della soluzione (etichetta 3 in Figura 1); un menu orizzontale a schede, che mostra le azioni possibili, divise per categorie funzionali, in modo contestuale alla pagina di progettazione mostrata nella finestra centrale (1); una barra laterale sinistra che consente di navigare velocemente all interno della soluzione e ne riporta la sua composizione, aggiornata in tempo reale (2). Figura 1 L interfaccia operativa di Jamio Composer Modellare le entità La realizzazione di una soluzione applicativa Jamio ha inizio con la modellazione della realtà applicativa da implementare. Consideriamo nel nostro esempio una soluzione per la gestione di clienti e dei relativi contratti stipulati. Inizieremo quindi la definizione delle entità Contratto e Cliente. Selezionate il tasto Aggiungi modello nel menu Soluzione, e scegliete la voce Dati nel menu Tipo. Così facendo aggiungerete alla soluzione il primo modello di entità Dati che definirà la Primi passi con Jamio Composer - v.1 2/12

3 struttura informativa, il comportamento e il layout delle risorse create a partire da questo modello. Il modello creato è stato aggiunto alla cartella Tipo, al cui fianco appare il numero 1 tra parentesi, nella sezione dell interfaccia denominata Modelli. Espandete la cartella Tipo, aprite la finestra di definizione del modello con un doppio click su Dati e rinominate Contratto il modello appena creato. La finestra di definizione si divide in sezioni: la sezione Definizione consente la descrizione della struttura delle informazioni. Definite per il Contratto i campi seguenti: Nome: Oggetto; Tipo: Testo breve Nome: Tipo; Tipo: Testo breve Nome: DataInizio; Tipo: Data e orario Nome: DataFine; Tipo: Data e orario Nome: Cliente; Tipo: Collegamento Al termine, il modello Contratto vi apparirà come in Figura 2. Oltre al tipo Dati, finalizzato alla gestione delle informazioni, Jamio Composer consente di creare modelli di Identità, utili per gestire anagrafiche che possano avere accesso al sistema, Documento, per trattare informazioni composite per le quali è necessario mantenere diverse versioni, Processo, Attività ed Evento per modellare flussi di orchestrazione di sistemi e persone. Figura 2 - Definizione del modello Contratto E possibile inoltre estendere i tipi di dati elementari a disposizione creando modelli di Dati strutturati, riutilizzabili all interno della soluzione. Selezionate nuovamente il menu Soluzione e, seguendo la medesima procedura descritta per il modello Contratto, create un nuovo modello di Dato strutturato e rinominatelo Indirizzo. L obiettivo è di creare un insieme di informazioni strutturate da utilizzare per definire un campo complesso. Per il modello Indirizzo definite la seguente struttura dati: Nome: Via; Tipo: Testo breve Nome: NumeroCivico; Tipo: Testo breve Nome: Cap; Tipo: Testo breve Nome: Città; Tipo: Testo breve Nome: Provincia; Tipo: Testo breve Primi passi con Jamio Composer - v.1 3/12

4 Il modello di Dato strutturato appena introdotto è un tipo che non può essere utilizzato in modo indipendente da un altro: esso è sempre parte integrante un altro modello. Per tale motivo è indicato da un icona di colore grigio. Aggiungete poi alla soluzione un modello di tipo Identità, rinominatelo Cliente, e definite i seguenti campi: Nome: Nome; Tipo: Testo breve Nome: Cognome; Tipo: Testo breve Nome: Attività; Tipo: Testo breve Nome: RecapitoTelefonico; Tipo: Testo breve Nome: DettaglioIndirizzo; Tipo: Indirizzo Figura 3 - Definizione del modello Cliente Al termine della definizione, questo modello appare come mostrato in Figura 3. Definite adesso un modello di catalogo al fine di istruire Jamio sulle modalità di visualizzazione in elenco delle risorse che verranno create a partire dai modelli di Contratto e Cliente. Con Jamio Composer è possibile definire differenti modalità di consultazione, attraverso cataloghi configurabili in termini di informazioni visualizzate e di criteri di ricerca. Selezionate dunque dall elenco dei modelli la voce Catalogo e aprite il modello di catalogo creato nella finestra centrale dell interfaccia. Rinominate il catalogo Clienti e selezionate dal menu a schede la procedura di Composizione automatica. Si attiva una finestra che contiene un controllo di tipo combobox dal quale si può selezionare il modello da usare per la creazione del catalogo. Selezionate il modello Cliente; la procedura riporterà in elenco, come colonne del catalogo, i campi della sua definizione. Figura 4 - Definizione del modello Clienti Eliminate dall elenco i campi non desiderati mediante il tasto Rimuovi posto ai piedi dell elenco sino a raggiungere la situazione mostrata in Figura 4. Primi passi con Jamio Composer - v.1 4/12

5 Durante l esecuzione dell applicazione, il catalogo Clienti conterrà tutte le risorse generate a partire dal modello Cliente, e di ciascuna istanza riporterà la valorizzazione dei campi contenuti nelle colonne del catalogo. Create con lo stesso procedimento un modello di catalogo Contratti attivando la funzione di Composizione automatica in riferimento al modello Contratto. Definire il comportamento La definizione del comportamento consente di stabilire le business rules che governano le modalità di elaborazione delle informazioni. Il comportamento viene espresso sotto forma di regole, in una modalità molto vicina al linguaggio naturale; si possono introdurre: regole semplici, costituite cioè da un solo fatto; esso può essere di tipo Asserzione, che associa una caratteristica ad uno o più soggetti (es.: Oggetto di Contratto è modificabile ); di tipo Validazione, che consiste nella valutazione booleana di una affermazione (es.: Cognome di Cliente è non nullo ); di tipo Assegnazione, che associa un valore ad una proprietà del soggetto scelto (es.: Assegna a DataFine di Contratto il valore di DataInizio di Contratto ); regola binaria: basata su una struttura quando-allora, è costituita da una premessa, formulata attraverso una o più regole semplici, che, se verificata, rende applicabile un insieme di regole; regola ternaria: basata sulla struttura quando-allora-altrimenti, è costituita da una premessa e da due insiemi di regole semplici, se la premessa è vera allora è applicabile il primo insieme di regole, se non è vera è applicabile il secondo insieme di regole; Inserite ora alcune regole nel comportamento del modello Contratto. Visualizzate il modello Contratto e aprite la sezione Comportamento: verrà visualizzato il Jamio Notation Editor che consente la definizione delle regole di comportamento. Aggiungete una regola di Validazione attraverso il relativo comando posto in basso a sinistra dell editor. Tutte le regole sono espresse nella forma Soggetto-Predicato o nella forma Soggetto-Predicato-Complemento; nella sezione di input posta nella parte alta selezionate i campi Oggetto, Tipo e Cliente come soggetto della regola, e mantenete il predicato predefinito è non nullo. La regola di validazione così costruita verificherà, in fase di esecuzione, che sia stata effettuata la valorizzazione dei campi Oggetto, Tipo e Cliente prima del salvataggio di ogni risorsa creata a partire dal modello Contratto. Viene inserita nell elenco delle regole nella forma Oggetto di Figura 5 - Definizione del comportamento Contratto, Tipo di Contratto, Cliente di Contratto deve essere non nullo Primi passi con Jamio Composer - v.1 5/12

6 Inserite adesso una regola di validazione per verificare che il valore attribuito al campo Tipo sia uno tra Manutenzione, Licenza o Servizi professionali e condizionate la visualizzazione dei campi Data Inizio e Data Fine al valore assegnato al campo Tipo. Aggiungete una nuova regola di Validazione e selezionate il campo Tipo come soggetto, il predicato appartiene alla lista e, come complemento, la lista di valori così formulata: { Manutenzione, Licenza, Servizi professionali }. Aggiungete una Asserzione, selezionate i campi DataInizio e DataFine e scegliete la proprietà Nascosto. L asserzione verrà aggiunta nella forma DataInizio di Contratto, DataFine di Contratto è nascosto Aggiungete poi una espressione condizionale del tipo Quando... Allora. Selezionate la riga Quando e aggiungete una condizione strutturata così formulata Tipo di Contratto è uguale a Manutenzione. Selezionate la riga Allora e aggiungete una Asserzione così formulata DataInizio di Contratto, DataFine di Contratto è visibile. Il comportamento sin qui definito apparirà come in Figura 5. Ciascuna risorsa è identificata da un campo Name predefinito nella sua struttura. Questo campo deve essere necessariamente valorizzato. Inserite dunque delle regole di assegnazione nel comportamento dei modelli Cliente e Contratto per far sì che tale campo abbia sempre un valore. Ad esempio, nel comportamento del modello Cliente aggiungete una Assegnazione. Selezionate il campo Name di Cliente e assegnate a questo campo il valore Cognome di Cliente scegliendo la modalità Seleziona dal menu che appare facendo click sul simbolo f(x) e poi scegliendo questo campo tra quelli inclusi sotto il nodo Cliente all interno della finestra di selezione. Aggiungete poi una regola analoga per valorizzare il campo Name nel comportamento del modello Contratto. Risorse e alias Jamio è una piattaforma Resource Oriented. Questo vuol dire che qualunque istanza generata a partire da un modello viene considerata una risorsa all interno della piattaforma e, in quanto tale, ha un indirizzo univoco permanente utilizzabile per referenziarla. Il tipo base Collegamento è destinato a questo scopo: memorizzare un riferimento ad una qualunque risorsa. E di questo tipo, ad esempio, il campo Cliente definito nel modello Contratto: esso è destinato ad essere valorizzato con un riferimento alla risorsa di tipo Cliente cui la risorsa Contratto si riferisce. Pur essendo valorizzabile con l indirizzo di una risorsa di qualsiasi tipo, è possibile indicare da quale tipo di elenco e da quale archivio tale risorsa debba essere selezionata. Inserite a tale scopo una regola per indicare l elenco da cui selezionare il riferimento al Cliente. Aggiungete una nuova Validazione, selezionate il campo Cliente e, facendo click sul predicato predefinito è non nullo, selezionate dal menu la voce..., poi la voce Resource e infine il predicato è selezionabile da un catalogo di tipo. Per formulare correttamente questa regola, il complemento deve essere selezionato scegliendo la modalità Risorsa, attivabile dal menu che compare facendo click sul simbolo f(x) a destra della casella di input del complemento stesso. Cliccando poi sul tasto con il simbolo... viene visualizzata una finestra di scelta dei modelli inclusi nella soluzione dalla quale scegliere il modello di catalogo prescelto, nel nostro caso Clienti. Primi passi con Jamio Composer - v.1 6/12

7 Non sempre però è possibile determinare il complemento di una regola al momento della progettazione. L indicazione dell archivio dal quale selezionare la risorsa Cliente ne è un esempio. L archivio è un informazione che dipende dall ambiente di runtime nel quale la soluzione applicativa prenderà vita e potrà essere determinato solo all atto della pubblicazione della soluzione. In fase di modellazione è possibile identificare concettualmente questo archivio mediante un alias, un segnaposto che viene definito come elemento di modellazione alla stregua dei modelli. Attivate dunque la finestra di definizione degli Alias mediante il relativo tasto nel menu Soluzione e inserite una nuova risorsa. Rinominatela Archivio Clienti e selezionate il tipo Archivio identità per rappresentare l archivio dal quale verranno selezionate le risorse di tipo Cliente al momento dell esecuzione (Figura 6). Definite inoltre una risorsa di tipo Archivio Dati, che sarà utile nel prosieguo della modellazione, e rinominatela Archivio Contratti. Adesso potete aggiungere l ultima regola di validazione nel comportamento del modello Contratto per definire l appartenenza della risorsa selezionata all archivio di identità. La regola è così formulata: Cliente di Contratto appartiene all archivio Archivio Clienti. Anche in questo caso il complemento deve essere Figura 6 - Definizione Alias selezionato con la modalità Risorsa come nel caso della regola precedente. Definire il layout Il passo successivo è la definizione dell aspetto che si intende dare alle informazioni modellate, in altre parole il modo in cui esse debbano essere visualizzate. Questo è possibile tramite la definizione del Layout che rappresenta la disposizione e la rappresentazione grafica di tutti i campi informativi per i quali è prevista un interazione da parte dell utente. Visualizzate il modello Contratto e create un nuovo Layout agendo sul tasto omonimo in alto a destra: verrà visualizzato l editor grafico del layout. Nel menu Disegno selezionare l opzione Creazione automatica per lanciare la procedura che automaticamente associa un controllo grafico ad ogni campo informativo del modello. E possibile modificare poi manualmente il layout generato, sia nella scelta dei controlli che nella loro disposizione. Disponete ad esempio i controlli relativi ai campi DataInizio e DataFine in modo che siano affiancati. Modificate poi le loro etichette in modo da inserire uno spazio dopo la parola Data. Modificate poi il controllo associato al Figura 7 - Definizione di layout alternativi campo Tipo selezionando il campo stesso Primi passi con Jamio Composer - v.1 7/12

8 e scegliendo il tipo di controllo Combobox dal tasto Cambia del menu Selezione. Effettuate la stessa operazione sul controllo associato al campo Cliente scegliendo il controllo di tipo Reference. Ad ogni modello è possibile associare più di un Layout (Figura 7), ed a ciascuno di essi è possibile associare un etichetta (tag): per esempio un Layout etichettato con phone oppure tablet sarà visualizzato quando la form viene richiesta da un dispositivo mobile. In questo modo è possibile ottimizzare il disegno per dispositivi in cui vi è un livello di interazione limitato per motivi di spazio. Con le stesse modalità utilizzate per il layout del modello Contratto, definite ora il layout del modello Cliente. Definire le relazioni Nella definizione di un modello di Tipo, è possibile indicare quali informazioni correlate devono essere visualizzate in corrispondenza di ciascuna risorsa. Ad esempio, in corrispondenza di ciascun Cliente è possibile visualizzare l elenco di tutti i Contratti ad esso relativi. In termini di modellazione questa relazione si traduce nella definizione di un catalogo correlato. Visualizzate il modello Cliente, attivate la sezione Cataloghi che elenca tutti i cataloghi correlati alle risorse di tipo Cliente e aggiungete un nuovo catalogo mediante il tasto in basso a Figura 8 - Definizione dei cataloghi correlati sinistra dell editor. Denominatelo I contratti e scegliete come Modello di catalogo il modello Contratti precedentemente introdotto nella soluzione. Impostate poi l Archivio Contratti, Alias già introdotto in precedenza, come archivio dal quale le risorse verranno prelevate ed infine impostate il filtro che determina in che modo ciascun Cliente deve essere messo in relazione con i Contratti. A questo scopo selezionate il tasto con il simbolo... (etichetta 1 in Figura 8 ) e utilizzate il Jamio Notation Editor per impostare la seguente regola: Cliente di Contratto referenzia Cliente. Tale regola istruisce Jamio a prendere in considerazione nell elenco solo le risorse Contratto il cui campo collegamento Cliente contiene un riferimento al Cliente visualizzato. Impostare la connessione al dominio Salvate i file della soluzione premendo il tasto Salva tutti i file nel menu Soluzione. Primi passi con Jamio Composer - v.1 8/12

9 La soluzione così modellata deve essere ora pubblicata sul dominio applicativo Jamio affinché i servizi vengano opportunamente configurati secondo le direttive definite. Primo passo da affrontare è la configurazione della connessione al gateway del dominio, la porta di ingresso ai servizi applicativi. L ambiente pre-configurato a disposizione per l esecuzione delle soluzioni applicative è raggiungibile attraverso un URL o indirizzo web Figura 9 - Attivazione pannello Elementi online presentando opportune credenziali. L insieme di queste informazioni viene fornito all atto della richiesta di un ambiente di esecuzione dedicato. Figura 10 - Definizione della connessione Attivate il pannello Elementi online attraverso il tasto presente nel menu Soluzione in Jamio Composer (Figura 9). Verrà visualizzata una finestra dalla quale è possibile impostare la connessione e navigare all interno dell ambiente di esecuzione. Scegliete la voce Gestione connessioni dal menu Settings e premete il tasto Aggiungi (etichetta 1 in Figura 10). Inserite poi le seguenti informazioni: il nome della connessione, scelto a piacere, che identificherà la connessione in tutte le finestre di Jamio Composer ove questa è richiesta; l URL del dominio (fornito all atto della richiesta di un ambiente di esecuzione dedicato); Il repository di autenticazione da utilizzare per effettuare l accesso al dominio (fornito assieme all URL); Il nome utente con cui accedere (fornito assieme all URL); la colonna status dà indicazione dello stato di accesso, online oppure offline. Chiudete la finestra di gestione delle connessioni, tornate al pannello degli Elementi online e selezionate Aggiorna dal menù Settings. Se le operazioni sono andate a buon fine, il pannello visualizza la connessione appena definita. La connessione potrà essere rimossa in caso di errore utilizzando il tasto Rimuovi (2) Attivate ora il pannello Proprietà della soluzione accessibile dal menu File e aggiungete un piano di pubblicazione con il tasto + dopo aver selezionato nella lista la connessione creata al passo precedente (etichetta 1 in Figura 11). Il piano di pubblicazione comparirà nell elenco. Un segno di spunta ne indicherà l attivazione (2). Selezionate ora il menu Soluzione e aggiungete una configurazione dal menu che compare Figura 11 - Definizione del piano di pubblicazione Primi passi con Jamio Composer - v.1 9/12

10 premendo il tasto Piani di configurazione. Il server elenca le configurazioni disponibili in relazione alla connessione definita. E sempre presente la configurazione denominata Default. Selezionate quest ultima. Pubblicare la soluzione applicativa Come ultimo passo prima dell esecuzione della soluzione applicativa, la pubblicazione necessita di alcune semplici impostazioni preliminari. Visualizzate l editor del piano di configurazione Default selezionando il piano dalla lista dei Piani di configurazione. L editor si compone di una serie di sezioni (Modellazione Esecuzione Dati Alias Navigazione Autorizzazioni) nelle quali indicare le informazioni necessarie alla pubblicazione di ciascun modello e di ciascuna risorsa della soluzione sul dominio scelto; in particolare, è necessario indicare gli archivi di destinazione per tutti gli elementi modellati nella soluzione. Attivate la sezione Modellazione e poi visualizzate il pannello degli Elementi online attraverso l apposito tasto nel menu Soluzione. Navigate all interno della connessione definita in precedenza, individuate l archivio Modelli, il cui nome è della forma <nome_ambiente_esecuzione> - Model, e trascinatelo nel campo Repository di default collocato in alto nella sezione Modellazione dell editor della configurazione (Figura 12). Tutti i modelli verranno così salvati nell archivio Figura 12 - Definizione del Piano di configurazione - Modellazione indicato. Attivate poi la sezione Esecuzione nella quale sono riportati tutti i modelli istanziabili della soluzione; in corrispondenza di ciascuno di essi è necessario indicare quale archivio dovrà essere utilizzato per memorizzare le risorse che verranno create a partire da ciascun modello. Questa scelta è vincolata dal tipo di modello: un modello di tipo Dati, ad esempio, può generare risorse solo in un archivio di Dati, un modello di tipo Identità può generarle solo in un archivio di Identità, e così via. Individuate quindi nel pannello Elementi online l archivio Dati, il cui nome è nella forma <nome_ambiente_esecuzione> - Data, e trascinatelo sulle righe della tabella riguardanti i modelli Contratto e Contratti. Effettuate la stessa operazione con l archivio Identità, il cui nome è uguale al nome del vostro ambiente di esecuzione, sulle righe che si riferiscono ai modelli Cliente e Clienti. Figura 13 - Definizione opzioni di Navigazione Nella sezione Alias indicate a quali archivi si riferiscono gli Alias definiti in precedenza: trascinate l archivio Dati sull alias Archivio Contratti e l archivio Identità sull alias Archivio Clienti. Primi passi con Jamio Composer - v.1 10/12

11 Infine, nella sezione Navigazione, definite con quali nomi visualizzare le risorse nell ambiente di esecuzione e in quale raggruppamento (Categoria) disporle nel sistema di navigazione (Figura 13). Siete ora pronti ad inviare la vostra prima soluzione al server applicativo Jamio. Selezionate il tasto Esegui nel menu Azioni. Al termine dell operazione un messaggio segnalerà l esito della pubblicazione. Utilizzare la soluzione con Jamio On Stage Jamio On Stage è il front-end universale mediante il quale operare immediatamente con la soluzione applicativa modellata in Jamio Composer. Attraverso un qualunque browser web collegatevi all indirizzo che vi è stato fornito assieme alle credenziali di accesso ed inserite quelle stesse credenziali nella pagina di login che vi si presenterà. Il front-end presenta Figura 14 - Il Front-End universale Jamio On Stage un interfaccia di navigazione standard nella quale vengono visualizzati i cataloghi definiti nella soluzione, raggruppati nella sezione corrispondente alla Categoria indicata in Jamio Composer (Figura 14). A partire da un catalogo è possibile creare nuove risorse che verranno poi visualizzate nei rispettivi elenchi. Inserite una risorsa di tipo Cliente selezionando il primo tasto in alto a sinistra nella toolbar visualizzata in cima al catalogo Clienti. Inserite Carlo Verdi come Nome e Cognome del nuovo cliente. Al termine dell immissione salvate la risorsa, selezionate il catalogo Contratti e, allo stesso modo, create una risorsa di tipo Contratto, associandolo al cliente appena creato. Salvate e selezionate nuovamente il catalogo Clienti. Aprite ora la scheda del cliente Carlo Verdi. I suoi dati verranno visualizzati nel layout precedentemente disegnato in Jamio Composer e le Figura 15 - La scheda Cliente e i Contratti correlati Primi passi con Jamio Composer - v.1 11/12

12 informazioni relative ai contratti a lui relativi verranno visualizzati in un elenco in calce alla scheda (Figura 15). La vostra prima soluzione è dunque realizzata ed immediatamente operativa. Primi passi con Jamio Composer - v.1 12/12