Modifica mediante il pulsante Modifica in elenco

Questo articolo contiene i seguenti argomenti:
casm173
Questo articolo contiene i seguenti argomenti:
Alcuni moduli di elenco, ad esempio gli elenchi delle Richieste e delle Issue, includono un pulsante Modifica in elenco. Se questo pulsante è disponibile e viene visualizzato un set di risultati, l'utente può fare clic sul pulsante per sostituire il filtro di ricerca con un piccolo modulo di modifica. Il modulo di modifica consente all'utente di aggiornare i record direttamente nel modulo di elenco. Inoltre, l'utente può aggiornare tutti gli elementi selezionati nell'elenco inserendo i nuovi dati nel modulo di modifica e facendo clic su Modifica tutto.
Durante la modifica dei dati dell'elenco la comunicazione con il server viene disattivata fino a quando l'utente fa clic su Salva. Quanto l'utente fa clic su Salva, tutti gli aggiornamenti (evidenziati in giallo nel modulo) vengono inviati al server che applica tutte le modifiche in un'unica operazione, restituendo un messaggio di stato e visualizzando di nuovo l'elenco.
È possibile modificare questa funzionalità controllando se il pulsante Modifica in elenco è disponibile in un particolare modulo e controllando i campi riportati nel modulo di modifica visualizzato quando l'utente fa clic su Modifica in elenco.
Per inserire un pulsante Modifica in elenco in un modulo di elenco, includere l'istruzione seguente in un punto qualsiasi della sezione <HEAD> del modulo:
<SCRIPT LANGUAGE="JavaScript" SRC=$CAisd/CAisd/list_edit.js></SCRIPT>
L'aggiunta di questa istruzione è sufficiente a inserire il pulsante nel modulo. Tuttavia, il pulsante è disattivato a meno che nel modulo non siano incluse anche le istruzioni JavaScript che specificano il contenuto del modulo di modifica. Queste istruzioni devono essere inserite subito prima della specifica del set di risultati e devono avere il formato seguente:
Istruzioni
Commenti
startListEdit(_search_filter);
Specificarla esattamente come indicato
listEditStartRow();
Specificarla esattamente come indicato
listEditField("attr"[, "hdr"]);
Specificare zero o un numero maggiore
listEditReadonly("attr[", "hdr"]);
Specificare zero o un numero maggiore
endListEdit();
Specificarla esattamente come indicato
L'istruzione endListEdit() deve essere seguita dall'istruzione ResultSet() che inizia il set di risultati. Specificare i campi e la relativa sequenza nel modulo di modifica scrivendo una o più istruzioni listEditReadonly() o listEditField().
startListEdit( _search_filter )
Questa istruzione inizia il modulo di modifica dell'elenco. È necessario codificarlo esattamente come
startListEdit( _search_filter);
.
listEditStartRow()
Questa istruzione inizia una nuova riga di campi sul modulo di modifica dell'elenco. Deve essere scritta esattamente come
listEditStartRow();
. È necessario inserire un'istruzione listEditStartRow() subito dopo l'istruzione startListEdit(). È possibile includere altre istruzioni listEditStartRow() tra le istruzioni listEditField() e listEditReadonly() che specificano i campi nel modulo.
listEditField(attr_name ,hdr )
Questa istruzione specifica un attributo da includere nel modulo di modifica dell'elenco.
  • attr_name
    Consente di specificare il nome dell'attributo da includere nel modulo di modifica (punti compresi, se appropriato). Tutti gli attributi specificati per un modulo di modifica dell'elenco devono essere presenti anche nel set di risultati. L'argomento
    attr_name
    specificato deve essere identico a quello specificato nelle macro IsWrite o IsCol per l'aggiunta dell'attributo al set di risultati.
    L'attributo viene visualizzato sul modulo di modifica nello stesso formato in cui è visualizzato nel filtro di ricerca. Se l'attributo non è presente nel filtro di ricerca, viene modificato in una casella di testo a 20 caratteri.
    attr_name
    è un argomento obbligatorio.
  • hdr
    Consente di specificare il testo dell'intestazione nel campo del modulo di modifica. Questo argomento è opzionale; se omesso, il testo dell'intestazione viene preso dal filtro di ricerca. Se hdr viene omesso e l'attributo non è presente nella voce del filtro di ricerca per attr_name, per impostazione predefinita come testo dell'intestazione viene utilizzato il nome dell'attributo compreso tra punti interrogativi.
listEditReadonly(attr_name ,hdr )
Questa istruzione specifica un attributo non modificabile da includere nel modulo di modifica dell'elenco. Gli argomenti hanno lo stesso significato di quelli di listEditField().
endListEdit()
Questa istruzione termina il modulo di modifica dell'elenco. Deve essere scritta esattamente come
endListEdit();
.