Utilizzo del workbench di estendibilità del framework dell'IU Web per modificare un widget

È possibile modificare un widget utilizzando il workbench di estendibilità della struttura dell'IU Web.

Procedura

Nell'applicazione, aprire la schermata che si desidera cambiare.
Fare clic su Maiusc + barra spaziatrice.
Esaminare e accettare i termini e condizioni di utilizzo del workbench Extensibility.
Il workbench Estensibilità viene avviato, a condizione che sia stata completata anche la mappatura da directory a URL e che sia stato associato un file per lo schermo. Qualsiasi utilizzo successivo del tasto di scelta rapida Maiusc + barra spaziatrice nasconde e quindi riavvia il workbench finché il browser non viene aggiornato o non si apre una nuova schermata, nel qual caso viene nuovamente visualizzata la finestra Termini e condizioni.

Se si rifiutano i termini e le condizioni, il workbench non viene avviato.

Gli strumenti del workbench Estensibilità vengono visualizzati in viste differenti. Potrebbe essere necessario fare clic sul pulsante del segno più nella barra degli strumenti del workbench Estensibilità per visualizzare tutte le viste.
Fare clic sul pulsante con il segno più per visualizzare tutte le viste o sul pulsante meno per ridurre a icona tutte le viste. Quando tutte le viste sono ridotte a icona, è possibile fare clic sulla scheda di una vista per visualizzare solo quella vista. Quando viene visualizzata una vista, è possibile ridurre la vista facendo clic sul segno meno nell'angolo in alto a destra della vista.
Prima di poter utilizzare un widget su una schermata, è necessario selezionare o associare il file di estensione per la schermata. Il file di estensione memorizza le estensioni (modifiche) sullo schermo. La finestra di dialogo Aggiungi file di estensione per schermata viene visualizzata quando si tenta per la prima volta di lavorare su un widget.
Il file di estensione contiene metadati relativi alle modifiche. I file di estensione vengono salvati nella directory di lavoro corrente. Possono essere visualizzati nella scheda File della vista Tavolozza & File.

Quando il workbench Estensibilità viene avviato per la prima volta, la directory di lavoro corrente viene impostata per impostazione predefinita sulla directory immessa durante l'associazione. Successivamente, è possibile modificarlo nella scheda File.
1. Nella finestra di dialogo Aggiungi file di estensione per la schermata , specificare il file di estensione utilizzando il pulsante Sfoglia per selezionare un file esistente o immettendo il nome del file nel campo File di estensione .
  Immettere il nome del file se si desidera associare / creare un nuovo file. Se hai già esteso la schermata e hai un file di estensione per la schermata, puoi cercare il file.
2. Fare clic su OK .
  Se viene visualizzata una finestra di dialogo che include il messaggio Il file selezionato contiene un'origine che non corrisponde alla schermata corrente., fare clic su OK per sovrascrivere il file o su Annulla per scegliere un altro file. Questo messaggio di solito significa che è stato scelto il file di metadati errato.
Una volta salvate le estensioni in una schermata e distribuite tali modifiche nell'applicazione, non è necessario aggiungere il file di estensione per apportare ulteriori modifiche alla schermata. Il file di estensione verrà caricato automaticamente con lo schermo.
Dopo aver selezionato questo file di estensione, si verificano le seguenti azioni di visualizzazione:
- La vista Struttura viene popolata con informazioni relative ai widget sullo schermo.
- La vista Dettagli schermo viene popolata con informazioni sul file di estensione.
  Il campo Nome classe estensione visualizza il nome della classe di estensione generata. È possibile modificare questo nome.
- La vista Proprietà visualizza le proprietà originali del widget.
Per aggiungere un widget allo schermo, selezionare il widget nella scheda Tavolozza. Fare clic con il tasto destro del mouse o con il tasto sinistro del mouse sul punto della schermata in cui si desidera visualizzare il widget.
Quando si aggiunge un nuovo widget, la proprietà sciId del widget deve includere il prefisso extn_ predefinito. Ciò differenzia un componente esteso da un componente pronto all'uso.
Per modificare un widget, selezionarlo sulla schermata o nella vista Struttura.
Per modificare o creare una proprietà del widget, effettuare le seguenti operazioni. Per ulteriori informazioni sulle proprietà del widget, fare riferimento alla documentazione del framework Ext JS per Versione 2.2.1 o Versione 3.0.2.
- Se si desidera modificare le proprietà di un elemento, fare clic sul pulsante Aggiorna istanze nella vista Dettagli schermo per rendere attive tali modifiche di proprietà.
  Se si desidera modificare le proprietà di un elemento esistente, viene visualizzata una griglia separata denominata "Proprietà originali" che visualizza i valori delle proprietà originali di tale elemento.
  
  La griglia "Proprietà originali" non viene visualizzata per i nuovi componenti aggiunti tramite l'estendibilità. Tutte le nuove proprietà aggiunte tramite l'estendibilità vengono elencate in una griglia separata sopra la griglia "Proprietà originali" (se il componente è presente nella schermata di base).
  
  Non è possibile modificare una proprietà elencata in "Proprietà originali". Tuttavia, è possibile sovrascrivere una proprietà esistente o aggiungere nuove proprietà a un componente pronto all'uso.
- Per creare una nuova proprietà per un elemento, fare clic su Aggiungi nella vista Proprietà. Prima di fare clic sul pulsante Aggiungi , è necessario selezionare la proprietà desiderata dall'elenco a discesa delle proprietà disponibili.
Per salvare le modifiche nella directory del progetto (ma non distribuirle), fare clic sul pulsante Salva nella vista Dettagli schermata.
Per lavorare su un'altra schermata, passare all'altra schermata e riattivare il workbench Estensibilità facendo clic su Maiusc + barra spaziatrice.
Dopo aver salvato tutte le estensioni della schermata, è necessario distribuire le modifiche per renderle effettive nell'applicazione.