Support Forum

La seguente guida mostra come creare la soluzione applicativa per la gestione delle schede di anagrafica delle persone sviluppata con Jamio openwork, qui scaricabile.
La soluzione sviluppata attraverso la guida vuole essere una soluzione di esempio da cui partire per la creazione di una soluzione di gestione anagrafiche di persone, per cui presta attenzione nel caso tu decida di apportare delle modifiche personali e nel pubblicarla all’interno della tua Area di accesso, poiché la soluzione, una volta pubblicata, diviene subito operativa su Jamio on Stage e visibile agli utenti che effettuano l’accesso alla tua stessa Area.

Obiettivi
Attraverso questa guida imparerai come:

• creare una nuova soluzione Jamio openwork;
• importare modelli utili nella tua soluzione Jamio openwork;
• creare e gestire nuovi modelli personalizzati;
• pubblicare su Jamio on Stage la soluzione applicativa da te creata.

Prerequisiti
Prima di iniziare a sviluppare la soluzione di esempio di gestione delle schede di anagrafica è necessario:

• essere registrati a Jamio Players;
• aver effettuato la Log in per poter scaricare da qui Jamio composer;
• aver installato Jamio Composer sul proprio computer e aver aperto il programma;
• aver scaricato i file di definizione contenuti nel file Gestione-anagrafiche-Persone.zip presente nella sezione di download della seguente pagina ed estratto i file della sotto-cartella Person;
• avere disponibile un’area Jamio openwork dove pubblicare la soluzione di esempio.

1. Creare una nuova soluzione Jamio openwork

1. Avvia l’applicazione Jamio Composer;
2. fai clic su Crea;
3. assegna un nome alla soluzione nel campo Nome della soluzione, ad esempio Person – Examples; sarà necessario predisporre una directory esclusiva per ciascuna soluzione creata con Jamio Composer nella cui cartella verranno salvati tutti i file relativi alla soluzione stessa;
4. crea, dunque, una cartella con il nome più opportuno per la soluzione e seleziona la Cartella di lavoro creata;
5. seleziona Crea la soluzione, Jamio Composer renderà attiva la propria interfaccia utente.

La tua soluzione Jamio openwork è così creata e Jamio Composer mostra la sua interfaccia utente.

2. Importare un modello in una soluzione

1. Fai clic su Importa modello | Importa da file presente nella sezione Importa del menù orizzontale;
2. seleziona, tra le risorse estratte dalla cartella Person, il file PersonalInfo; per farlo seleziona PersonalInfo | Apri; una nuova finestra propone di importare, oltre al modello PersonalInfo una lista di altri modelli utilizzati nella definizione di PersonalInfo (AddressReference e CityReference); fai clic su Aggiungi alla soluzione.
3. nello stesso modo, importa dalla cartella Person il file BasicContactInfo.

I modelli sono stati importati nella tua soluzione. La cartella Tipo riporta i quattro modelli importati.

3. Creare un modello e personalizzarlo

1. Dal menù orizzontale, sezione Inserisci modello, fai clic su Identità per aggiungere alla soluzione un modello di tipo Identità;
2. assegna al modello creato la denominazione di Person_Identity ;
3. fai doppio clic sul modello Person_Identity, nel menù centrale verrà mostrato il dettaglio del modello appena creato;
4. dal menù a schede TIPO fai clic su Composizione da struttura dati;
5. scegli dal menù a tendina l’elemento della soluzione PersonalInfo e fai clic su Seleziona; il modello Person_Identity riporta tutti i campi definiti nella struttura dati PersonalInfo, il comportamento (vedi sezione Comportamento) ed il layout (vedi sezione Layout) a loro assegnato;
6. nella sezione Definizione aggiungi un nuovo campo di tipo lista utile a inserire, per ogni anagrafica, uno o più contatti aggiuntivi di riferimento, quindi fai clic sul campo vuoto e specifica i campi delle colonne:
   – Nome: AdditionalContact; Tipo: BasicContactInfo;
7. per specificare che AdditionalContact sia di tipo lista, seleziona la rispettiva casella Lista;
8. aggiungi il campo appena creato nella sezione Layout del modello Person_Identity, quindi fai clic su Layout; fai clic dal menù DISEGNO | Controllo | DataGridView; il nuovo controllo è ora disponibile nel layout;
9. dopo aver selezionato il nuovo controllo, associa ad esso come Origine dati il campo AdditionalContact, annidato sotto il ramo Person_Identity;
10. personalizza l’etichetta (Item 33) e raffina il layout del controllo a piacimento;
11. inserisci una regola di comportamento per assegnare alla proprietà obbligatoria Name del modello Person_Identity un valore ovvero attribuisci alla proprietà Name la concatenazione dei valori contenuti nei campi FirstName e LastName della sezione Definizione, così facendo ogni scheda di anagrafica sarà denominata con il FirstName e LastName della persona che rappresenta: inserisci una regola di comportamento di tipo Assegnazione facendo clic sulla sezione Comportamento del modello | Nuova regola | Assegnazione; a seguito del clic, nell’elenco delle regole è presente una nuova regola di assegnazione;
12. seleziona la nuova regola di assegnazione e fai clic sul menù a tendina a fianco ad Assegna a e scegli come soggetto Person_Identity;
13. fai clic sulle parentesi angolari < > , presenti a fianco al campo il valore, e scegli Espressione per attivare la modalità espressione;
14. clicca sul tasto con i tre punti per attivare l’editor delle espressioni;
15. nell’editor delle espressioni attiva l’editor assistito utilizzando la combinazione di tasti della tastiera Ctrl + Space;
16. fai clic sul contesto data;
17. digita  .  con la tastiera per accedere ai campi del contesto dati;
18. scegli il campo FirstName;
19. per concatenare il campo LastName scrivi:
    + ‘ ‘ +
    Quindi accedi nuovamente al contesto data e scegli il campo LastName;
20. Completata la scrittura dell’espressione, fai clic su Ok; l‘assegnazione della proprietà Name è completa e presente nelle tue regole;
21. La proprietà Name è obbligatoria, occorre quindi fare in modo che venga sempre assegnata, rendendo i campi FirstName e LastName obbligatori: inserisci una regola di comportamento ora di tipo validazione per i campi FirstName e LastName ovvero fai clic su Nuova regola|Validazione; a seguito del clic, nell’elenco delle regole è presente una nuova regola di validazione;
22. fai clic sul menù a tendina Seleziona soggetto e scegli come soggetto sia la proprietà FirstName che LastName di Person_Identity; la validazione delle proprietà FirstName e LastName di Person_Identity a campi obbligatori è già completa e presente nelle tue regole in quanto la regola è già predisposta in modo da avere “…è non nullo deve essere vera”;
23. dalla sezione Definizione fai clic su Proprietà tipo;
24. assegna un nome ed una categoria di destinazione che saranno visualizzati come voce di menù in Jamio on stage:  come Nome di destinazione inserisci Person e come Categoria di destinazione scrivi Person – Examples;

La creazione e personalizzazione del modello di scheda di anagrafica è completa.

4. Creare il catalogo delle schede di anagrafica

1. Da Inserisci modello del menù orizzontale fai clic su Catalogo e rinominalo People;
2. fai doppio clic sul modello People, nel menù centrale viene mostrato il dettaglio del modello appena creato;
3. dal menù a schede CATALOGO fai clic su Composizione automatica;
4. scegli dal menù a tendina l’elemento della soluzione Person_Identity e fai clic su Seleziona; la creazione del catalogo è terminata: le colonne riportate nel catalogo corrispondono a tutti i campi della risorsa Person_Identity;
5. personalizza le colonne del catalogo attraverso le azioni Rimuovi, Sposta su e Sposta giù;
6. per visualizzare l’anteprima dell’immagine contenuta nel campo Immagine di Person_Identity, rinomina la colonna Picture in IMG;
7. rimuovi alcuni campi presenti nel modello importato, in modo da personalizzare il catalogo People nel seguente modo:
   – Nome: IMG;  Origine: Picture di Person_Identity;
   – Nome: Title ;  Origine: Title di Person_Identity;  Etichetta: Title;
   – Nome: FirstName;  Origine: FirstName di Person_Identity;  Etichetta: First name;
   – Nome: LastName;  Origine: LastName di Person_Identity;  Etichetta: Last name;
   – Nome: Gender;  Origine: Gender di Person_Identity;  Etichetta: Gender;
   – Nome: BirthDate;  Origine: BirthDate di Person_Identity;  Etichetta: Birth date;
   – Nome: Email;  Origine: Email di Person_Identity;  Etichetta: Email;
   – Nome: Phone;  Origine: Phone di Person_Identity;  Etichetta: Phone;
   – Nome: LegalMail;  Origine: LegalMail di Person_Identity;  Etichetta: Legal mail;
   – Nome: MobilePhone;  Origine: MobilePhone di Person_Identity;  Etichetta: Mobile phone;
   – Nome: Fax;  Origine: Fax di Person_Identity;  Etichetta: Fax;
8. dalla sezione Definizione fai clic su Proprietà tipo;
9. assegna un nome e una categoria di destinazione che saranno visualizzati come voci di menù in Jamio on stage, in questo caso assegna: a Nome destinazione la voce Person e a Categoria di destinazione la voce Person – Examples.

La creazione e personalizzazione del catalogo delle schede di anagrafica è completa.

5. Pubblicare la soluzione

1. Dopo aver salvato i dati cliccando sull’icona Salva, imposta la connessione al dominio;
2. fai clic sul menù a schede FILE; se hai impostato correttamente la connessione, visualizzerai l’icona Pubblica per la pubblicazione;
3. fai clic su Pubblica; la pubblicazione della soluzione Jamio openwork viene avviata. Al termine un messaggio notifica l’esito dell’operazione.

La tua soluzione è ora disponibile su Jamio on stage.

6. Accedere alla soluzione pubblicata

1. Per utilizzare la soluzione da te creata, accedi a Jamio on Stage inserendo le credenziali di accesso e visualizzerai l’interfaccia utente di Jamio on Stage; nella Barra di navigazione è presente l’azione Consulta che contiene i cataloghi modellati fra cui quello da te appena creato;
2. seleziona il catalogo People disponibile sotto la voce Person – Examples e fai clic su Crea; una nuova scheda di menù mostra la scheda di anagrafica così come personalizzata in fase di modellazione;
3. compila la scheda con dei dati di esempio;
4. per inserire l’immagine del contatto, fai clic con il tasto destro del mouse sul controllo di tipo immagine e scegli Carica immagine;
5. seleziona un file di tipo immagine attraverso il tasto Browse e fai clic su Invia;
6. terminata la compilazione della scheda di anagrafica, fai clic su Salva;
7. per consultare il catalogo delle schede di anagrafica, fai clic su Consulta, quindi sulla voce di menù People disponibile sotto la voce Person – Examples.

La guida per la creazione di una soluzione di gestione delle anagrafiche di persone è terminata.

E’ disponibile inoltre una ulteriore guida per la gestione delle anagrafiche di organizzazioni.