Download
Controlla la JAVA_HOME
Su MS Windows, da linea di comando esegui:
echo %JAVA_HOME%
Su Linux, dalla shell esegui:
echo $JAVA_HOME
Su Mac OS, dalla shell esegui:
java -version
Assicurati di avere installata una JDK 1.6 Sun/Oracle o superiore.
Download da SourceForge
Scarica l'utima versione da SourceForge:
Download
Estrai l'archivio
Estrai l'archivio in una cartella a tua scelta.
(Opzionale) Installa ulteriori driver JDBC
Se vuoi connetterti a database commerciali (ad esempio Oracle, MS SQL Server o IBM DB2), devi installare il driver JDBC appropriato. Per installare un driver, copia l'opportuno file jar nella cartella:
portofino-4.x.x\apache-tomcat-7.x.x\lib
Avvia Tomcat
Su Windows, trova il file:
portofino-4.x.x\apache-tomcat-7.x.x\bin\startup.bat
Fai doppio click sul file o eseguilo da linea di comando.
Su Linux/Mac OS, il file si chiama startup.sh.
Questo avvia il server Apache Tomcat.
Avvia il tuo browser
Apri con il tuo browser il seguente url: http://localhost:8080/
Fai click sul link Wizard
Fai click sul link del Wizard nella homepage.
Log in
Esegui il log in con le credenziali.
Login: admin
Password: admin
Wizard passo 1
Inserisci i seguenti dati:
- connection type: lascia selezionato JDBC
- un nome a tua scelta per il database
- il driver jdbc (selezionalo dalla lista)
- URL di connessione
- Il nome utente per la connessione
- la password per la connessione
Fai click su "Next".
Se c'è un errore è mostrato un messaggio esplicativo che ti permette di correggerlo.
Se la connessione ha successo, Portofino inizia a leggere i metadati del tuo database.
Wizard passo 2
Seleziona lo schema che contiene le tabelle che vuoi importare.
Fai click su "Next".
Wizard passo 3
Se il tuo database ha tabelle da utilizzare per l'autenticazione, e vuoi che Portofino le usi inserisci:
- la tabella che contiene gli utenti
- la tabella che contiene i gruppi utente
- la tabella di "join" che contiene le associazioni fra utenti e gruppi.
Fai click su "Next".
Se non sei sicuro sulle tabelle da utilizzare, non compilare nessun campo e fai click su "Next".
Wizard passo 3a
Se hai selezionato le tabelle per gli utenti nel passo precedente, ti viene mostrato il passo 3a. Qui devi fornire dettagli sulla tabella degli utenti:
- la proprietà id, la chiave primaria della tabella
- la proprietà per il nome utente (sarà la login dell'utente)
- la proprietà per la password
- l'algoritmo di cifratura. Specifica se le password sono memorizzate in chiaro o cifrate (ad esempio md5/sha1)
- la proprietà per la mail
- la proprietà per il token di identificazione dell'utente
Fai click su "Next".
Wizard passo 4
Seleziona "Automatic" per lasciare che Portofino analizzi le relazioni padre-figlio nel tuo database e decida quali pagine generare. Questa opzione è raccomandata se sei un principiante.
Seleziona "Manual" per scegliere le pagine da generare da una lista.
Seleziona "Don't generate anything" se sei un utente esperto e vuoi creare le pagine da solo.
Fai click su "Next".
Conclusione Wizard
L'ultimo passo è una pagina di conferma. Fai click su "Finish" quando sei pronto per costruire la tua applicazione.
Congratulazioni! Portofino ha costruito la tua applicazione web basata sul database richiesto.
Esplora la tua nuova applicazione
A sinistra della pagina trovi la barra di navigazione. Puoi riconoscere il nome delle tabelle principali del tuo database.
Non preoccuparti se non vedi alcune tabelle nella lista. Probabilmente sono presenti come pagine di secondo livello nella struttura master-details. Per esempio "product" si trova come oggetto di secondo livello sotto "category".
Esplora il calendario
Nel menù di sinistra fai click su "Calendar (generated)". Portofino ha creato una vista come calendario per mostrare i dati nel tuo database. Ogni colonna di tipo "data" è gestita come evento e mostrata nel calendario.
Hai bisogno di aiuto?
Poni le tue domande nel forum della comunità italiana:
https://groups.google.com/forum/?fromgroups#!forum/manydesigns-portofino-italian
Il manuale di riferimento, dei tutorial e i Javadoc sono disponibili nel Centro Documentazione.