<< Fare clic per visualizzazione il sommario >> Percorso:  Jamio Composer > Modellare una nuova entità > La sezione Layout > Il controllo Reference

Il controllo Reference rappresenta il collegamento o il collegamento esteso. Permette di:

•selezionare una risorsa da un catalogo di Jamio openwork;

•creare una nuova risorsa in un catalogo ed inserire il riferimento nel campo;

•caricare un file;

•salvare il riferimento di un link.

 

Tipi di campo a cui associare il controllo

Un controllo Reference inserito in un layout di un modello di entità può avere come origine dati campi di tipo:

- Collegamento;

- Collegamento esteso.

 

Proprietà

Dalla sezione Proprietà del controllo è possibile impostare quali azioni può svolgere l’utente rispetto al collegamento riportato nel campo.

 

 

 

Sono disponibili le opzioni:

- Disattiva seleziona risorsa: permette di disattivare la selezione di una risorsa da catalogo;

- Disattiva creazione nuova risorsa: permette di disattivare la creazione di una nuova risorsa da catalogo;

- Disattiva seleziona file: permette di disattivare il caricamento di un file;

oRimuovi il file allegato alla cancellazione o sostituzione. Questa opzione è attiva se selezionata l'opzione "Disattiva seleziona file" e imposta la rimozione automatica del file dalla sezione allegati alla cancellazione o sostituzione del contenuto del campo collegamento;

- Disattiva inserisci link: permette di disattivare il salvataggio di un link;

- Disattiva rinomina collegamento: permette di disattivare la modifica del testo riportato nel campo Reference;

- Disattiva seleziona da allegati: permette di disattivare la selezione di un file dalla sezione allegati;

- Disattiva navigazione: nega all'utente interattivo la possibilità di aprire la risorsa referenziata;

- Disattiva aggiunta a preferiti: nasconde all’utente l’azione Aggiungi a preferiti;

- Disattiva anteprima: nasconde all'utente l'azione Visualizza anteprima.

- Copia modifiche alla risorsa: se pari a true, al clic dell'utente interattivo sul campo, viene aperta la risorsa collegata e le eventuali modifiche apportate alla proprietà Name della risorsa vengono riportate in automatico anche nel controllo. Il valore di default del flag Copia modifiche alla risorsa è false.

 

E’ possibile applicare al testo contenuto in un controllo Reference le proprietà di stile ed impostare la larghezza e l’altezza del controllo.

 

Jamio on stage

Un controllo di tipo Reference, visualizzato in Jamio on Stage, riporta in automatico tutte le azioni utili per popolare il campo collegamento. Nel dettaglio le azioni possibili sono:

•Elimina: permette di cancellare il contenuto del campo collegamento. Se il contenuto del collegamento è il riferimento ad un file allegato, il progettista può impostare il comportamento per cui alla richiesta di cancellazione del contenuto del campo viene richiesto all’utente interattivo se desidera cancellare anche il file riportato nel riquadro allegati oltre che il collegamento allo stesso;

•Crea: permette di valorizzare il campo collegamento creando una nuova risorsa personalizzata con il tipo del catalogo associato al controllo attraverso una regola di validazione. Si abilita solo se al controllo è associato un catalogo;

•Rinomina collegamento: permette di modificare il nome assegnato al collegamento;

•Seleziona risorsa: permette di scegliere da un catalogo di Jamio openwork il nuovo valore del campo collegamento;

•Seleziona da allegati: permette di riportare nel campo collegamento un file caricato su Jamio openwork attraverso la sezione allegati di una risorsa;

•Seleziona file: permette di popolare il campo collegamento caricando (upload) su Jamio openwork un file scelto tra le risorse del file system. Il file caricato è poi consultabile, oltre che nel campo collegamento, anche nella sezione allegati della risorsa. Alla eliminazione del file dal campo collegamento è possibile eliminare in automatico il file dalla sezione allegati oppure rimuovere il solo riferimento nel campo collegamento lasciando una copia del file nella sezione allegati;

•Inserisci link: permette di popolare il campo collegamento specificando il nome e l’indirizzo di un link. Il link può essere l'indirizzo di un sito o servizio esterno a Jamio (ad esempio https://www.google.com/) o il link ad una risorsa Jamio openwork. Se il link inserito nel campo collegamento è il link di una risorsa Jamio Openwork esso sarà riconosciuto come tale e l'indirizzo riporterà il valore della proprietà URL del collegamento. In tal modo, al CTRL+clic sul campo collegamento sarà aperta la Risorsa Jamio openwork nella sessione corrente. Se il link della Risorsa Jamio openwork è stato copiato da Jamio on stage Web attraverso la funzione di Link | Copia, oltre all'indirizzo, in automatico il nome del link riporterà il valore della proprietà Name del collegamento;

•Aggiungi a preferiti: permette di segnare il collegamento nella sezione Preferiti;

•Visualizza anteprima: permette di visualizzare l'anteprima del file; si abilita solo se il campo collegamento riporta come valore un file.

 

Le azioni suddette sono visualizzate rispetto alle regole di validazione definite per il campo di tipo collegamento nella sezione comportamento e alle Proprietà impostate attraverso la sezione layout.

Ad esempio, se ad un controllo di tipo collegamento è associata una regola di validazione “collegamento deve essere selezionabile da un catalogo di tipo oggetto” in automatico in Jamio on Stage sono nascoste le azioni Valorizza da file e Valorizza con link e visualizzata l’azione Valorizza con nuova risorsa.

La tabella che segue riporta per ogni azione prevista dal controllo Reference le condizioni per cui in automatico l’azione viene nascosta in Jamio on Stage. Le condizioni descritte nelle colonne sono esclusive tra loro. Ad esempio l’azione Apri risorsa collegata non è visualizzata quando il valore del campo è vuoto oppure è selezionata la proprietà grafica Disattiva navigazione.

 

 

In Jamio on stage, tale controllo è visualizzato come nell'immagine seguente; mentre, le azioni che possono essere effettuate, sono qui riportate. Se nel controllo Reference è riportato un Collegamento con le proprietà Name, Type ed Url valorizzate, il testo riportato nel controllo sarà sottolineato ed il clic sul controllo aprirà la risorsa collegata. Se nel controllo Reference è riportato un Collegamento con solo la proprietà Name valorizzata, il testo riportato nel controllo non sarà sottolineato ed il clic sul controllo non aprirà risorse.

 

Esempio controllo Reference