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

Il controllo ReferenceList, permette di inserire e visualizzare in una risorsa una tabella di controlli Reference.

 

Tipi di campo a cui associare il controllo

Un controllo ReferenceList inserito in un layout di un modello di entità può avere come origine dati campi lista di tipo Collegamento.

 

Proprietà

Il controllo ReferenceList riporta su ogni riga una risorsa della lista di collegamenti o collegamenti estesi ed una sola colonna.

Così come descritto per le proprietà del controllo Reference, è possibile attraverso la sezione proprietà impostare quali azioni l’utente può svolgere rispetto al campo collegamento riportato nella riga della tabella.

 

Nel dettaglio l’opzione:

- 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 ReferenceList le proprietà di stile ed impostare la larghezza e l’altezza del controllo.

 

Jamio on stage

Un controllo di tipo ReferenceList, visualizzato in Jamio on Stage, riporta in automatico tutte le azioni utili per popolare il campo collegamento ed aggiungere/eliminare delle righe dalla lista. 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;

•Aggiungi: permette di valorizzare il campo collegamento con un indirizzo di Google Places, si abilita solo se il campo collegamento è vincolato a riportare come valore un file un indirizzo di Google Places;

•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 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;

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

•Duplica: permette di inserire una nuova riga, identica ad un'altra selezionata nel controllo.

•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.

La tabella che segue riporta per ogni azione prevista dal controllo ReferenceList 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 Valorizza da catalogo non è visualizzata quando è definita una regola di asserzione per cui il campo è bloccato oppure è definita una regola di validazione sul campo collegamento con predicato è un indirizzo di Google Places oppure è selezionata la proprietà grafica Disattiva valorizza da catalogo.

 

 

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 singolo appartenente alla lista, è 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 singolo appartenente alla lista, è 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 lista di collegamenti