1.0 Introduzione
2.0 Differenze con il rilascio precedente
3.0 Limitazioni
3.1 Casi in cui un modello di pagina non
verrà applicato a una pagina We
4.0 Problemi noti
4.1 Ridenominazione di un progetto Web dinamico
4.2 Il validator JSP non si compila automaticamente in caso di modifiche Java dipendenti
4.3 Suggerimento relativo alle prestazioni: chiusura dei progetti non attivi
4.4 Suggerimento relativo
alle prestazioni: disabilitazione della convalida automatica
4.5 Disabilitazione per
errore delle selezioni Copia o Incolla all'interno della vista Selezione progetti
4.6 Tipi di documenti HTML 4.01
4.7 Chiusura dei file di Page Designer quando si eliminano le risorse di progetto correlate
4.8 Attivazione e disattivazione di Page Designer Classic
4.9 Limitazione della personalizzazione del menu della barra degli strumenti di Page Designer
4.10 Anteprima dei file JSP in Page Designer
4.11 Avvertenza di collegamenti interrotti nelle applet
4.12 Inserimento di applet nei file HTML e JSP utilizzando Page Designer
4.13 Problemi di visualizzazione di alcuni caratteri GB18030 in Windows 2000/XP
4.14 Problemi BiDi per WebArt Designer, Animated GIF Designer e PageDesigner classic
4.15 I file JSP devono utilizzare istruzioni di importazioni esplicite
4.16
Supporto linguistico bidirezionale per Page Designer Classic
4.17
Migrazione dei dati relazionali in progetti Web 4.0.3
4.18 I JSP e i Servlet Java progettati in ambiente DBCS per un livello J2EE 1.3 sul server WebSphere 5 necessitano di un ulteriore frammento di codice
4.19 Collegamenti all'associazione immagini in Netscape Navigator
4.20 Trascinamento elementi nella vista Modifica rapida
4.21 Utilizzo degli elementi della vista Frammenti con azioni semplici nella vista Modifica rapida
4.22 Impossibile aprire i file di classe da un progetto Web
4.23 Supporto per linguaggio mobile in Page Designer
4.24 Supporto per i modelli di pagina in Page Designer
4.25 Note sull'utilizzo delle
parti del sito con Web Site Designer
4.26 Modifica delle impostazioni di sistema per i colori e i tipi di carattere
4.27 Ricerca di annotazioni
in file non salvati negli editor
L'ambiente di sviluppo Web in WebSphere Studio fornisce gli strumenti necessari allo sviluppo di applicazioni Web. Per applicazioni Web si intendono le pagine Web statiche, le pagine JSP (JavaServer Pages), i servlet Java, un descrittore di distribuzione XML (web.xml) e altre risorse Web. In questo file Readme vengono descritti i problemi noti, le limitazioni e le soluzioni associate agli strumenti utilizzati nell'ambiente di sviluppo Web.
I nomi delle cartelle Web Content e Java Source dei progetti Web sono adesso configurabili. I nomi predefiniti sono WebContent e JavaSource; tuttavia i nomi predefiniti dei nuovi progetti Web possono essere modificati scegliendo Strumenti Web->Nuovo progetto nella pagina Preferenze. Le cartelle dei progetti esistenti possono essere ridenominate attraverso la vista Selezione.
NOTA: i nomi di cartella diversi dai nomi predefiniti non sono compatibili con WebSphere Studio Versione 5.0.0. Non modificare i nomi predefiniti se si desidera preservare la compatibilità dello spazio di lavoro con la versione 5.0.0.La vista Modifica rapida consente agli utenti di aggiungere/modificare script e script di eventi tag in Page Designer. Per ulteriori dettagli, fare riferimento alla Guida.
Esistono diverse circostanze in cui un modello di pagina potrebbe non essere applicato a una pagina Web quando si utilizza una delle procedure guidata per i modelli di pagina.
- Non viene applicato a una pagina Web che ha una codifica diversa dal modello selezionato.
- Non viene applicato quando il modello selezionato o la pagina selezionata sono descritti da JSP stile XML.
- Non viene applicato a una pagina Web a cui è già associato un modello.
Se si ridenomina un progetto Web J2EE in una vista differente dalle viste Selezione J2EE o Gerarchia J2EE, non sarà possibile eseguire il progetto Web o una delle corrispondenti risorse distribuibili nell'ambiente di test dell'unità finché non vengono effettuate le seguenti operazioni:
- Aprire il file application.xml del progetto Enterprise Application in cui si fa riferimento al progetto Web.
- Rimuovere il modulo Web del progetto Web con il nome originale.
- Aggiungere un nuovo modulo Web nel progetto Web ridenominato.
Il validator JSP non esegue la convalida automatica di un file JSP quando viene modificata una classe Java cui il file fa riferimento. Il validator può essere eseguito di nuovo sul file selezionandolo in Selezione progetti e scegliendo Esegui convalida nel menu di scelta rapida.
Per migliorare le prestazioni, si consiglia di chiudere i progetti attualmente non utilizzati. Quando si sceglie Ricrea tutto vengono ricreati soltanto i progetti aperti.
Per impostazione predefinita, i validator vengono avviati automaticamente quando si salvano le risorse in un progetto Web. Se non si desidera avviare automaticamente i validator al salvataggio delle risorse, aprire la finestra di dialogo Proprietà del progetto Web dal menu di scelta rapida nella vista Selezione J2EE. Selezionare l'opzione Ignora preferenze di convalida e disattivare l'opzione Esegui la convalida automaticamente quando si salvano le modifiche alle risorse dalla pagina Convalida. È inoltre possibile disattivare la convalida automatica (e le generazioni) per tutti i progetti selezionando Finestra > Preferenze e disattivando la selezione Esegui automaticamente generazione alla modifica delle risorse dalla pagina Workbench. Se si disabilitano le generazioni automatiche, è possibile eseguire manualmente una generazione (e la convalida) selezionando Progetto > Nuova generazione del progetto.
All'interno della vista Selezione J2EE, se le selezioni del menu di scelta rapida Copia o Incolla di una risorsa specifica vengono disabilitate per errore, eseguire Copia o Incolla dalla vista Selezione. Se la vista Selezione progetti non è già aperta in una prospettiva, è possibile aggiungerla selezionando Finestra > Mostra vista > Altro, scegliendo Selezione progetti, quindi OK.
HTML 4.01 è specificato in quattro varianti di tipo di documenti, HTML 4.01 (noto anche come 4.01 Strict), HTML 4.01 Transitional, HTML 4.01 Frameset e cHTML 4.01. Un file HTML può presentare una di queste varianti come tipo di documento. Pertanto, la maggior parte delle funzioni di modifica (assistente ai contenuti, convalida di sintassi HTML, vista Proprietà e così via) non le distingue. Ad esempio, anche se in un file HTML è specificato HTML 4.01 Strict, il file viene considerato sempre HTML 4.01 Transitional.
E, se un file HTML è effettivamente un file XHTML (ad esempio una dichiarazione DOCTYPE con un DTD XHTML), la specifica del tipo di documenti viene rispettata dalle funzioni di modifica.
Prima di eliminare un progetto, una cartella o un file, chiudere tutti i file correlati che sono stati aperti in Page Designer.
WebSphere Studio V4 di Page Designer (ora chiamato Page Designer Classic) è stato riprogettato per la Versione 5. Il nuovo Page Designer (chiamato Page Designer all'interno della documentazione sul prodotto e l'interfaccia utente) è la versione consigliata ed è anche la versione predefinita. Page Designer Classic non è disponibile come funzione installabile, ma può essere attivato utilizzando le istruzioni riportate di seguito.
Page Designer fornisce funzioni avanzate, ad esempio la modifica di attributi basati su viste e il supporto della libreria di tag semplificate.
Alcune funzioni non sono supportate in Page Designer Classic. In particolare:
- Supporto BiDi (Bidirectional)
- Elementi dinamici (incluse le tabelle dinamiche)
- Controllo accessibilità
A meno che non sia necessario utilizzare un supporto specifico per le funzioni incluse in Page Designer Classic, utilizzare Page Designer predefinito. Per abilitare Page Designer Classic, procedere come segue:
Installazione di Page Designer Classic:
- Chiudere WebSphere Studio prima di iniziare l'installazione.
- In Windows Explorer, aprire la directory WSAD INSTALL DIR/bin e fare doppio clic su pdclassic.exe.
- Quando si riavvia WebSphere Studio, viene visualizzata la finestra di dialogo Aggiornamenti. Scegliere Sì.
Nota: in caso di primo utilizzo del workbench, non è necessario eseguire le seguenti operazioni.- Nella finestra di dialogo Modifiche della configurazione. Selezionare la casella di controllo all'interno dell'area Modifiche rilevate. Quindi fare clic sul pulsante Fine.
- Nella finestra Installa/Aggiorna fare clic sul pulsante Sì. Il workbench verrà riavviato per applicare le modifiche.
Associazione di Page Designer Classic come editor Web predefinito:
Una volta installato Page Designer Classic, per impostazione predefinita le associazioni di file tra questo editor e i vari tipi di file HTML e JSP (inclusi *.htm, *.html, *.jsp, *.jhtml, *.shtml, *.shtm e *.html-ss) vengono effettuate in modo da utilizzare Apri con > Page Designer Classic nel menu di scelta rapida della vista Selezione J2EE per aprire un file selezionato in Page Designer Classic. Pertanto, per rendere Page Designer Classic l'editor predefinito per i tipi di file HTML e JSP, procedere come segue:
- Selezionare Finestra > Preferenze.
- Espandere le impostazioni del Workbench e aprire la pagina Associazioni file.
- Selezionare i tipi di file validi (uno per volta) dalla casella di elenco Tipi di file.
- Selezionare Page Designer Classic dalla finestra di dialogo Selezione editor e fare clic sul pulsante Valore predefinito.
- Ripetere i passi 3 e 4 per ogni tipo di file valido.
Nota: se si disabilita e poi si riabilita Page Designer Classic, anche le associazioni dei file verranno istanziate di nuovo. Tuttavia, l'editor predefinito per il tipo di file associato verrà convertito nel nuovo Page Designer.
Inoltre è anche possibile effettuare aggiornamenti a Page Designer Classic modificando le preferenze. Selezionare Finestra > Preferenze ed espandere le impostazioni Strumenti Web. Espandere Page Design (Classic) per apportare le modifiche desiderate.
Disattivazione di Page Designer Classic
Per disattivare questa funzione (inclusa la guida) e riattivarla utilizzando Page Designer predefinito, procedere come segue:
- Selezionare Guida > Aggiornamenti software > Update Manager.
- Nella vista Configurazione installazione, espandere Configurazione corrente e selezionare Page Designer Classic 5.1.0.
- Fare clic sul pulsante Disabilita, posto nell'angolo inferiore destro del pannello Anteprima.
- Nella finestra di dialogo Installazione funzione, scegliere Fine.
- Nella finestra Installa/Aggiorna, scegliere Sì. Il workbench verrà riavviato per applicare le modifiche.
Attivazione di Page Designer Classic (dopo la disattivazione)
Per abilitare di nuovo Page Designer Classic, non rieseguire pdclassic.exe, ma procedere come segue:
- Selezionare Guida > Aggiornamenti software > Update Manager.
- Nella vista Installa configurazione, scegliere Mostra funzioni disabilitate nella barra degli strumenti.
- Espandere Configurazione corrente e selezionare Page Designer Classic 5.1.0.
- Fare clic sul pulsante Abilita posto nell'angolo inferiore destro del riquadro Anteprima.
- Nella finestra di dialogo Installazione funzione, scegliere Fine.
- Nella finestra Installa/Aggiorna, scegliere Sì. Il workbench verrà riavviato per applicare le modifiche.
Dopo aver personalizzato la barra degli strumenti utilizzando la finestra Personalizza prospettiva (disponibile selezionando Finestra > Personalizza prospettiva), il menu Barra degli strumenti di Page Designer non può essere utilizzato per ulteriori personalizzazioni della barra. In questo caso, è necessario utilizzare la finestra Personalizza prospettiva per personalizzare le voci della barra degli strumenti visualizzate.
I tag JSP non vengono visualizzati correttamente nella pagina Anteprima. È possibile controllare un file JSP utilizzando l'opzione Esegui sul server.
LinksBuilder può contrassegnare erroneamente il valore dell'attributo del codice applet come collegamento non valido se viene utilizzato un nome di classe Java completo:
<applet code="aaa.bbb.AnApplet" codebase="MyApplets">Questa avvertenza può essere ignorata e non influisce sul comportamento dell'applet durante l'esecuzione sul server.Questa avvertenza può essere evitata utilizzando un separatore di percorso ('/') invece del separatore ('.') e verificando che l'estensione .class sia stata dichiarata in modo esplicito. Ad esempio:
<applet code="aaa/bbb/AnApplet.class" codebase="MyApplets">
La cartella di origine Java (per impostazione predefinita JavaSource) di un progetto Web è riservata alle classi del server, quindi il codice di origine applet non può essere contenuto in questa cartella. Di conseguenza, si consiglia di rispettare la seguente procedura quando si sviluppano le applet:
- Creare un progetto Java per le applet e le classi applet nel progetto.
- Copiare i file di classe applet nella cartella del contenuto Web (per impostazione predefinita WebContent) di un progetto Web. Non copiarli nella cartella WEB-INF, perché questa cartella è riservata solo alle classi del server. Per visualizzare i file di classe, modificare i filtri della vista Selezione progetti selezionando Filtri dal menu a discesa.
- Inserire un'applet in una pagina Web selezionando Inserisci > Altre > Applet Java in Page Designer. Quindi, impostare gli attributi e il codice appropriato.
Ad esempio, se la classe dell'applet è aaa.bbb.AnApplet, la struttura del file sarà:
WebContent/index.htmlil codice è "aaa.bbb.AnApplet"
WebContent/MyApplets/aaa/bbb/AnApplet.classquindi, il tag applet in index.html deve contenere:
codebase is "MyApplets"
GB18030 è una serie di caratteri standard della Repubblica popolare cinese che specifica una codepage estesa e una tabella per le associazioni a Unicode. Se la lingua impostata nel sistema è il cinese semplificato e se viene installato Microsoft GB18030 Support Package, non sarà possibile visualizzare correttamente i caratteri GB18030 dell'intervallo 0xA840 - 0xA9A0 in WebArt Designer e in Animated GIF Designer.
Per WebArt Designer, questo problema si verifica nei campi di testo nella vista Galleria WebArt, nei campi di testo della finestra di dialogo della procedura guidata dei logo (Specifica test 1/4), nei campi di testo della finestra di dialogo Modifica segnalibri e nelle voci del menu Segnalibro.
In Animated GIF Designer il problema si verifica nel campo del commento della finestra di dialogo Proprietà frame (frame di commento), nel frame Commento della vista Anteprima frame e nei campi di testo della finestra di dialogo per la creazione di un'intestazione animata.
Ad esempio, immettendo il carattere GB18030 '0xA877' (in Unicode, simbolo grafico U+2573), verrà visualizzato il carattere GB18030 '0xA876' (in Unicode, simbolo grafico U+2572).
Può accadere che WebArt Designer e Page Designer Classic non riescano a creare l'immagine del Logo delle lingue bidirezionali su Windows XP. Se si specifica la spaziatura caratteri durante la creazione di un'immagine Logo nei caratteri visualizzati da destra a sinistra, tali caratteri nel Logo non verranno riordinati. È necessario specificare zero come spaziatura dei caratteri per avere un'immagine del Logo corretta di caratteri bidirezionali in Windows XP.
La stessa limitazione si verifica per le intestazioni animate in AnimatedGif Designer.
I file JSP devono utilizzare l'attributo 'import' della direttiva di pagina per descrivere i tipi disponibili per l'ambiente di esecuzione degli script in tale pagina. Alcuni tipi possono essere stati importati implicitamente nei file JSP contenuti nei progetti J2EE1.2, ma visualizzeranno messaggi di errore se utilizzati in un progetto J2EE1.3. Per evitare questo problema, i tipi devono essere importati sempre in modo esplicito nella pagina JSP (a meno che il tipo non sia inserito nell'elenco di importazione predefinito: java.lang.*, javax.servlet.*, javax.servlet.jsp.* e javax.servlet.http.*).
È possibile attivare il supporto bidirezionale per Page Designer Classic impostando le impostazioni internazionali predefinite del sistema e le impostazioni internazionali predefinite dell'utente su Arabo o Ebraico in Windows.
Per migrare i dati relazionali da progetti WebSphere Studio 4.0.3, è necessario procedere come segue:
- Da uno spazio di lavoro 4.0.3, generare file DDL per ogni database disponibile.
- Rimuovere il database dalla cartella database/origine del progetto Web (tramite la vista Definizione dati)
- Aprire lo spazio di lavoro 4.0.3 con WebSphere Studio Versione 5.
- Migrare i progetti Web per i quali si desidera ripristinare i dati relazionali.
- Scegliere File > Importa > File system e specificare i file DDL dallo spazio di lavoro 4.0.3.
- Nella vista Definizione dati della prospettiva Dati, selezionare Esegui a fronte del locale e specificare il progetto Web di destinazione.
Le risorse dei dati relazionali verranno ripristinate.
Le indicazioni riportate di seguito si riferiscono ai JSP e ai Servlet Java progettati in ambiente DBCS per un livello J2EE 1.3 sul server WebSphere 5. Inserire il seguente frammento nel codice di origine prima di accedere ai parametri o agli attributi richiesti:
if(request.getCharacterEncoding() == null){
request.setCharacterEncoding(<encoding>); // generalmente è la codifica del JSP o del servlet
}
//...codice del jsp/servlet normale che accede agli oggetti richiesti come
// <%=request.getParameter("message")%>
Se non viene eseguita l'operazione appena indicata e la richiesta non include le informazioni di codifica, tutti i parametri richiesti verranno analizzati in ISO-8859-1 e quindi i caratteri DBCS eventualmente inclusi in uno dei parametri verrebbero visualizzati in modo non corretto.
I collegamenti ad altri file dalle associazioni immagine non funzioneranno se il browser esterno viene avviato utilizzando il menu di Page Designer Strumenti > Avvia browser Web esterno.
Tuttavia, se viene attivato Internet Explorer o viene utilizzata la pagina Anteprima, i collegamenti funzioneranno.
Prima di trascinare gli elementi o il testo dalle viste Frammenti o Tavolozza nella vista Modifica rapida, assicurarsi che quest'ultima non contenga l'istruzione "Inserire un'azione/frammento di codice".
Per ciascun elemento della vista Frammenti JavaScript, nella vista Modifica sarà disponibile un'azione semplice. Non utilizzare le azioni semplici con gli elementi nella vista Modifica rapida, con elementi della vista Frammenti nello stesso script di eventi. Se è necessario combinare gli elementi, prestare la dovuta attenzione alla posizione dell'elemento nel frammento. Trascinando gli elementi dalla vista Frammenti nella vista Modifica rapida quando l'editor già contiene azioni semplici, l'elemento di frammento potrebbe essere inserito in una posizione non corretta. In questo caso, eliminare e reinserire l'azione semplice.
Attualmente non è possibile aprire i file di classe da un progetti Web. Quando si crea una classe Java o un servlet in un progetto Web, i file di classe vengono memorizzati in WebContent/WEB-INF/classes. Se si tenta di aprire un file di classe dalla vista Selezione progetti, verrà visualizzato il seguente errore:
Problemi durante l'apertura dell'editor. Impossibile aprire l'editor per <className>.class. Il file di classi non si trova nel percorso classi.
Gli attributi non supportati in linguaggi mobili, quali cHTML o WML, possono essere inseriti dalla finestra Inserisci o dalla vista Attributi.
Tuttavia, è possibile controllare la validità del codice utilizzando Strumenti > Convalida sintassi HTML per un documento cHTML o Strumenti > Convalida sintassi WML per un documento WML.
I modelli di pagina sono supportati solo da Page Designer e non da Page Designer Classic. È possibile utilizzare Page Designer per modificare una pagina HTML/JSP utilizzando la funzione di modello pagina.
- In alcune parti del sito non è possibile inserire nelle pagine determinati tipi di documento. Dopo aver scelto OK nella finestra di inserimento, verrà visualizzato il messaggio di errore "Impossibile utilizzare questa parte del sito." Questo significa che verrà generata un'origine non valida se il file di specifica della parte del sito selezionata viene utilizzata nel tipo di documento per la pagina di destinazione. Ad esempio, se il tipo di documenti di una pagina è cHTML o WML, quasi tutte le parti del sito conterranno tag non validi per quei linguaggi di markup.
- La barra di navigazione potrebbe contenere un'origine non valida a causa del file di specifica ad essa associato. Se nella vista Attività vengono visualizzati molti errori e avvisi, molto probabilmente la causa è il file di specifica della barra di navigazione. Per correggere gli errori, modificare il file di specifica.
- Una barra di navigazione di una pagina potrebbe contenere caratteri danneggiati. Questo succede se l'etichetta di navigazione contiene caratteri che non possono essere codificati in base alla regola di codifica specificata nella pagina. Per evitare questo problema, limitare il tipo di caratteri utilizzati nelle etichette di navigazione alla codifica utilizzata nella pagina oppure utilizzare una regola di codifica più completa nella pagina.
- Tutti i file di specifica di esempio contenuti nella finestra Inserimento mappa del sito possono gestire le pagine comprese tra il livello-1 ed il livello-5 nella struttura del sito. Anche se viene impostato un livello finale superiore a 5 nella vista attributi per il tag siteedit:sitemap, i collegamenti alle pagine superiori al livello-5 non verranno inclusi nella mappa del sito.
Quando si modificano le impostazioni del sistema relative ai colori e ai tipi di carattere, affinché le nuove impostazioni vengano applicate alla pagina Progettazione di Page Designer e alla vista Tavolozza, sarà necessario riavviare WebSphere Studio .
Nell'editor Origine e nella pagina Origine degli editor a più pagine, ad esempio l'editor XML, la funzione di ricerca deve essere utilizzata dalla risorsa salvata sul file system piuttosto che dal contenuto dell'editor. Le annotazioni di ricerca contenute in editor in cui non è stato eseguito il salvataggio non sono affidabili. Per evitare questo problema, prima di effettuare una ricerca, salvare il file.
Visualizza il file Readme principale
(C) Copyright IBM Corporation 2000, 2003. Tutti i diritti riservati.