Strumenti del portale - Note sul rilascio


1.0 Software supportato e specifiche
2.0 Limitazioni
   2.1 I portlet JSR 168 devono avere l'attributo ID
   2.2 Record relazionali e Portale V5.1
   2.3 Limitazioni dei portlet cooperativi
   2.4 Limitazione dei tag personali
   2.5 Limitazioni degli strumenti EIS
   2.6 Configurazione di SAP JCo su un server WebSphere Portal
   2.7 Messaggi di avviso relativi a collegamenti interrotti visualizzati nella vista Problemi
   2.8 Supporto per markup in Portal Designer
   2.9 Impossibile impostare l'URL interno
   2.10 Non selezionare temi Admin come predefiniti
3.0 Problemi noti
   3.1 (Installazione) Impossibile installare WebSphere Portal Test Environment
   3.2 (Creazione portlet) Errori di compilazione con l'ultimo WebSphere Portal
   3.3 (Creazione portlet) Icona portlet non prevista visualizzata dopo l'abilitazione del clic-per-azione
   3.4 (Creazione portlet) Errore di riferimento servlet non corretto durante la creazione di un portlet in un progetto portlet IBM API esistente
   3.5 (Portlet di debug e verifica) Impossibile avviare l'ambiente WebSphere Portal Test
   3.6 (Debug e verifica portlet) Impossibile installare i portlet utilizzando il portlet di amministrazione nell'ambiente di test
   3.7 (Debug e verifica portlet) Errore se un'applicazione portlet utilizza un database diverso da Cloudscape
   3.8 (Descrittore di distribuzione portlet) Modifica con l'editor descrittore di distribuzione portlet JSR 168
   3.9 (Esecuzione e debug) Il browser interno non mostra il progetto portale o portlet aggiornato
   3.10 Quando viene utilizzato <f:subview> invece di <f:view>, i portlet Faces non funzionano correttamente
   3.11 Clic-per-azione non funziona nei portlet Faces ingranditi al massimo
   3.12 (Migrazione portlet) La migrazione dei portlet di Portal V4.2 a V5.0 non riesce
   3.13 (Importazione, Esportazione & Distribuzione) Impossibile creare server di importazione, esportazione e distribuzione che hanno "localhost" come destinazione
   3.14 (Importazione portale) L'annullamento dell'operazione di importazione rende il nuovo progetto portale non disponibile
   3.15 (Importazione portale) Errori relativi a WSRP mostrati nella vista Problemi di un progetto portale importato
   3.16 (Personalizzazione dei portali) Impossibile aprire i file license.html e privacy.html in un progetto portale importato
   3.17 (Esecuzione e debug del progetto portale) Impossibile avviare WebSphere Portal 5.0 Test Environment con un progetto portale
   3.18 Newsgroup (forum) per Rational Software Architect

1.0 Software supportato e specifiche

I progetti portale supportano WebSphere Portal v5.0.2.2.

2.0 Limitazioni

2.1 I portlet JSR 168 devono avere l'attributo ID

Quando si creano portlet JSR 168 utilizzando la procedura guidata Nuovo portlet, Rational Developer assegna automaticamente un attributo ID. L'attributo ID deve essere incluso nell'elemento <portlet-app/> del file portlet.xml per identificare unicamente il portlet al server. Questo attributo corrisponde all'attributo UID utilizzato dai portlet API del portlet IBM.

Se si utilizzano portlet JSR 168 che non dispongono di un attributo ID nell'elemento <portlet-app/> del file portlet.xml, aggiungere l'attributo ID con il rispettivo valore univoco immediatamente dopo aver importato il portlet nello spazio di lavoro. Per aggiungere l'attributo ID, aprire il descrittore di distribuzione portlet e modificarlo utilizzando la vista Origine. Non modificare il valore ID dopo aver distribuito il portlet JSR 168 su un server portale o dopo aver utilizzato il progetto portlet JSR 168 in un progetto portale.

Quando si utilizza un portlet JSR 168 senza un attributo ID, si presentano alcune limitazioni:

2.2 Record relazionali e portale V5.1

Durante l'esecuzione di un portlet che contiene un elenco di record relazionali o un record relazionale (SDO), è possibile che nel log del server venga visualizzato il seguente errore:

[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: Class org/eclipse/emf/ecore/EClass violates loader constraints: definition mismatch between parent and child loaders
E' possibile ignorare questo errore.

2.3 Limitazioni dei portlet cooperativi

Quando si crea un portlet di origine cooperativo, è necessario aggiungere actionNameParameter e gli attributi di nome al file WSDL manualmente. Ad esempio:

<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>

In questo release, gli strumenti del portale non generano l'attributo di didascalia nel file WSDL. Quando si utilizza la rete con WebSphere Portal v5.1, è necessario specificare l'attributo di didascalia nel file WSDL e il valore di didascalia nel file di risorse manualmente. Ad esempio:

<portlet:param name="orderId" partname="order_id" caption="order.id" />
Per ulteriori informazioni, fare riferimento all'argomento "Sviluppo dei portlet per la cooperazione" nel Centro informazioni di WebSphere Portal.

2.4 Limitazione dei tag personali

Quando si utilizzano i tag personali nel portlet di base IBM API WebSphere Portal v5.1, specificarli utilizzando la seguente sintassi:

<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />

Quando si utilizzano i tag personali nel portlet Faces IBM API WebSphere Portal v5.1, specificarli utilizzando la seguente sintassi:

<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>

I tag personali no sono supportati per i portlet JSR 168.

2.5 Limitazioni degli strumenti EIS

Limitazioni della procedura guidata SAP BAPI e RFM SDO: se si passa oltre la pagina delle funzioni principali e pre/post e si tenta di ritornarvi dopo aver scelto una funzione principale diversa, la pagina Mappatura pre/post non funzionerà correttamente.

Soluzione: se si desidera impostare nuove associazioni di funzioni pre- e post-, sarà necessario riavviare la procedura guidata.

2.6 Configurazioni di SAP JCo su un server WebSphere Portal

Prima di verificare i portlet che contengono SAP SDO su un server portale, configurare l'adattatore SAP JCo sul server WebSphere Portal 5.1:

  1. Scaricare la directory dell'adattatore SAP JCo da SAP in SAP Service Marketplace.
  2. Scegliere Scarica software > Scarica > Connettori SAP > Connettori Java SAP. In base al sistema operativo utilizzato, selezionare il file appropriato da scaricare. Estrarre il contenuto del file ZIP in una directory locale.
  3. Procedere come segue, in base al sistema operativo utilizzato: Nota: <wps_51> indica la directory di installazione del server WebSphere Portal 5.1; ad esempio, C:\WebSphere\PortalServer51TE.
      Per Windows:
    1. Copiare sapjco.jar e sapjcorfc.dll in <wps_51>\shared\app.
    2. Copiare librfc32.dll in c:\windows\system32\.
    3. Riavviare il server WebSphere Portal 5.1.

      Per Linux:
    1. Copiare sapjco.jar e libsapjcorfc.so in <wps_51>\shared\app.
    2. Aggiungere la cartella che contiene il file librfccm.so nella variabile di ambiente LD_LIBRARY_PATH.
    3. Riavviare il server WebSphere Portal 5.1.

2.7 Messaggi di avviso relativi a collegamenti interrotti visualizzati nella vista Problemi

Durante la creazione di un progetto portale utilizzando la procedura guidata Nuovo progetto portale, o l'importazione di un progetto portale di esempio dalla Galleria di esempi, nella vista Problemi vengono visualizzati messaggi di avviso relativi a collegamenti interrotti.

2.8 Supporto per markup in Portal Designer

In questa versione di Rational Developer, Portal Designer visualizza solo HTML, cHTML e WML come markup supportate. Se sono state specificate altre markup supportate per una pagina o un'etichetta in un progetto che si desidera importare, queste verranno conservate in Rational Developer; tuttavia, non è possibile modificare tali markup e non verranno visualizzate nella vista Proprietà.

2.9 Impossibile impostare l'URL interno

In questa versione di Rational Developer, è possibile impostare gli URL esterni solo in Portal Designer. Se si dispone di URL interni nel server portale, verranno conservati nel progetto importato, ma non sarà possibile modificarli. Sarà solo possibile distribuire gli URL interni sul server portale originale.

2.10 Non selezionare temi Admin come predefiniti

In questo release di Portal Designer, i temi Admin e AdminLeftNavigation verranno visualizzati nella vista Struttura. Tuttavia, questi temi sono presenti solo a scopo amministrativo e non dovrebbero essere selezionati come tema predefinito per un progetto portale.

3.0 Problemi noti

3.1 (Installazione) Impossibile installare WebSphere Portal Test Environment

Problema: il programma di installazione di Rational Developer non riesce ad installare WebSphere Portal Test Environment.

Soluzione: controllare le informazioni contenute nel log di installazione e correggere il problema.

WebSphere Portal 5.0 Test Environment RD_installdir\runtimes\portal_v50\log\wpsinstalllog.txt dove RD_installdir è la directory in cui è stato installato Rational Developer.

WebSphere Portal 5.1 Test Environment WP51TE_installdir\PortalServer\log\wpsinstalllog.txt dove WP51TE_installdir è la directory in cui è stato installato WebSphere Portal v5.1 Test Environment.

Se non si riesce ad identificare il problema nei file di log, disinstallare WebSphere Portal Test Environment manualmente, quindi reinstallarlo. Per informazioni sulla disinstallazione manuale, fare riferimento alla Guida all'installazione di Rational Developer.

3.2 (Creazione portlet) Errori di compilazione con l'ultimo WebSphere Portal

Problema: è possibile generare portlet per WebSphere Portal V5.0 utilizzando Rational Developer. Se viene applicato un servizio di WebSphere Portal al proprio portal server, è possibile che si verifichino errori di compilazione durante la generazione dei portlet. In questi casi, sarà necessario aggiornare manualmente i file richiesti dalla compilazione.

Soluzione: per compilare correttamente i portlet, procedere come segue:

WebSphere Portal v5.0.2.x

Nota: per disinstallare WebSphere Portal Test Environment, sarà necessario ripristinare la versione originale di questi file. In caso contrario, la cartella "portal_v50_stub" potrebbe non essere eliminata e dovrà essere eliminata manualmente.

WebSphere Portal v5.1

Nota: per disinstallare WebSphere Portal Test Environment, sarà necessario ripristinare la versione originale di questi file. In caso contrario, la cartella "portal_v51_stub" non potrà essere eliminata e dovrà essere eliminata manualmente.

3.3 (Creazione portlet) Icona portlet non prevista visualizzata dopo l'abilitazione del clic-per-azione

L'editor del descrittore di distribuzione del portlet e la vista Esplora progetti, contengono le icone dei portlet e i rispettivi nomi. Tali icone indicano lo stato dei portlet. Gli stati del portlet sono normale, origine abilitata, destinazione abilitata o origine e destinazione entrambe abilitate.

Problema: quando si converte un portlet in un portlet di origine clic-per-azione, dovrebbe cambiare solo l'icona del portlet convertito. Tuttavia, in alcuni casi, vengono modificate più icone, come quando più portlet vengono associati a un singolo servlet. In questi casi, le icone per i portlet diverse dal portlet clic-su-azione specificato, verranno visualizzate in modo non corretto. La stessa situazione si verifica quando si converte un portlet in + un portlet di destinazione clic-per-azione.

Soluzione: vengono modificate più icone di portlet, ma in realtà viene modificato un solo portlet. La conversione avviene correttamente e il progetto portlet non risulta danneggiato in alcun modo.

3.4 (Creazione portlet) Errore di riferimento servlet non corretto durante la creazione di un portlet in un progetto portlet IBM API esistente

Problema: Durate la creazione di un nuovo portlet in un progetto portlet IBM API, verranno visualizzati i seguenti messaggi di errore se si selezionano le opzioni Aggiungi esempio portlet di invio clic-per-azione o Aggiungi esempio portlet di invio messaggi nella pagina Gestione eventi:

Soluzione: riaprire il progetto portlet attenendosi alle seguenti istruzioni:

  1. Selezionare il progetto portlet con il tasto destro del mouse e scegliere Chiudi progetto dal menu a comparsa.
  2. Selezionare il progetto portlet con il tasto destro del mouse e scegliere Apri progetto dal menu a comparsa.
  3. Selezionare il progetto portlet con il tasto destro del mouse e scegliere Esegui convalida dal menu a comparsa.

3.5 (Portlet di debug e verifica) Impossibile avviare l'ambiente WebSphere Portal Test

Problema: Impossibile avviare WebSphere Portal Test Environment

Soluzione:

3.6 (Debug e verifica portlet) Impossibile installare i portlet utilizzando il portlet di amministrazione nell'ambiente di test

Problema: Nel server WebSphere Portal Test Environment, l'installazione dei portlet mediante il portlet di amministrazione, avrà esito negativo.

Soluzione: nel server WebSphere Portal Test Environment, l'installazione dei portlet mediante il portlet di amministrazione non è supportata. Per distribuire i portlet in WebSphere Portal Test Environment, è necessario utilizzare la funzione "Pubblica" di Rational Developer. Per utilizzare la funzione "Pubblica", selezionare l'applicazione portlet con il tasto destro del mouse e scegliere Esegui > Esegui su server oppure, nella vista server, fare clic con il tastino destro del mouse su Pubblica.

3.7 (Debug e verifica portlet) Errore se un'applicazione portlet utilizza un database diverso da Cloudscape

Problema: se l'applicazione portlet utilizza un database diverso da Cloudscape, potrebbe verificarsi un errore.

Soluzione: È necessario aggiungere il driver JDBC ai percorsi classe specifici di WebSphere dell'ambiente WebSphere Portal Test. Procedere come segue:

  1. Nella vista Server, fare doppio clic sul server WebSphere Portal Test Environment. Viene aperto l'editor server.
  2. Nella parte inferiore dell'editor, scegliere la scheda Ambiente.
  3. Nella sezione ws.ext.dirs, aggiungere il driver JDBC. Ad esempio, aggiungere il file SQLLIB\java12\db2java.zip per DB2®, dove SQLLIB è la directory in cui è stato installato DB2.
  4. Premere Ctrl+S per salvare le modifiche.

3.8 (Descrittore di distribuzione portlet) Modifica con l'editor descrittore di distribuzione portlet JSR 168

Problema: nel descrittore di distribuzione portlet JSR 168, non è possibile modificare il nome del portlet nell'area Raccolte di portlet.

Soluzione: modificare il nome del portlet nella pagina di Origine.

3.9 (Esecuzione e debug) Il browser interno non mostra il progetto portale o portlet aggiornato

Problema: in alcune configurazioni che utilizzano WebSphere Portal v5.0, le modifiche apportate a un progetto portale o portlet non vengono visualizzate automaticamente nel browser durante l'esecuzione o il debug del progetto utilizzando un Server Attach remoto.

Soluzione: è possibile gestire questo problema in due modi:

  1. Scollegarsi da WebSphere Portal utilizzando il browser e collegarsi nuovamente. Dopo il collegamento, le modifiche verranno visualizzate. Tenere presente che chiudendo la finestra del browser non funzionerà ugualmente, e sarà necessario ripetere l'operazione ogni qual volta viene pubblicato un progetto portale aggiornato.
  2. In alternativa, configurare Rational Developer affinché utilizzi un browser esterno. Per effettuare questa impostazione, selezionare Preferenze... dal menu Finestra. Espandere il nodo Internet a sinistra e selezionare Browser Web. Nella sezione principale, selezionare qualsiasi browser tranne Browser Web interno.
    Quindi, prima di eseguire i comandi Esegui o Debug su server, chiudere il browser esterno.

3.10 Quando viene utilizzato <f:subview> invece di <f:view>, i portlet Faces non funzionano correttamente

Problema: se si elimina il tag <f:view> da un file Faces JSP generato mediante procedura guidata e si inseriscono componenti Faces nel file, viene inserito un tag <f:subview> invece del tag <f:view>. Con questo tipo di file JSP, il portlet Faces non verrà eseguito correttamente. Gli input nel the browser vengono persi durante l'elaborazione sul server.

Problema: per risolvere questo problema, sostituire il tag <f:subview> con il tag <f:view> nel file JSP.

3.11 Clic-per-azione non funziona nei portlet Faces ingranditi al massimo

Se si ingrandisce un portlet Faces che contiene tag clic-per-azione, il contenuto del portlet non viene visualizzato.

3.12 (Migrazione portlet) La migrazione dei portlet di Portal V4.2 a V5.0 non riesce

Problema: la modifica dei livelli API del portlet ha esito negativo se il percorso classi è troppo lungo.

Soluzione: correggere il percorso di generazione Java dei progetti portlet migrati. Per il percorso di generazione Java obbligatorio, è possibile fare riferimento a un progetto portlet di base che viene generato dalla procedura guidata Nuovo progetto portlet. Aggiungere i file JAR richiesti mancanti al percorso di generazione Java del progetto portlet migrato.

3.13 (Importazione, esportazione e distribuzione) Impossibile creare server di importazione, esportazione e distribuzione che hanno "localhost" come destinazione

Problema: se l'UTE del portale non è installato, non è possibile creare un server di importazione, esportazione o distribuzione del portale che indica "localhost" o "127.0.0.1" come destinazione.

Soluzione: se si desidera creare tale server, utilizzare il nome completo della macchina, invece di "localhost" (ad esempio, myhost.mydomain).

3.14 (Importazione portale) L'annullamento dell'operazione di importazione rende il nuovo progetto portale non disponibile

Problema: se si annulla l'importazione di un nuovo progetto portale prima del completamento, il progetto portale incompleto non viene rimosso e non sarà disponibile.

Soluzione: è necessario importare nuovamente la configurazione del portale e i file utilizzando l'opzione Elimina su sovrascrittura nella procedura guidata Importazione portale.

3.15 (Importazione portale) Errori relativi a WSRP mostrati nella vista Problemi di un progetto portale importato

Problema: durante l'importazione di un sito portale esistente da WebSphere Portal a Rational Developer, vengono visualizzati errori di convalida relativi a WSRP nella vista Problemi per il progetto portale importato.

Soluzione: applicare l'APAR PQ95638 a WebSphere Portal prima di eseguire l'importazione in Rational Developer.

3.16 (Personalizzazione dei portali) Impossibile aprire i file license.html e privacy.html in un progetto portale importato

Problema: impossibile aprire i file license.html o privacy.html in un progetto portale importato utilizzando Designer a causa di codifica non corretta.

Soluzione: applicare l'APAR PQ93681 al server portale, quindi importare nuovamente il progetto dal server portale.

3.17 (Esecuzione e debug del progetto portale) Impossibile avviare WebSphere Portal 5.0 Test Environment con un progetto portale

Problema: Impossibile avviare WebSphere Portal Test Environment 5.0 nelle seguenti situazioni:

Soluzione: riconfigurare WebSphere Portal 5.0 Test Environment.

  1. Nella vista Server, selezionare il server con il tasto destro del mouse e scegliere "Aggiungi e rimuovi progetti...".
  2. Rimuovere il progetto "wps" dai "Progetti configurati".
  3. Selezionare il progetto portale con il tasto destro del mouse e selezionare Esegui > Esegui su server.
Adesso dovrebbe essere possibile eseguire il progetto portale e i progetti portlet appena associati nell'ambiente di test.

3.18 Newsgroup (forum) per Rational Software Architect

L'opzione "Aggiungi runtime SDO" fa riferimento ai newsgroup di Rational Software Architect. Il sito di supporto di Rational Software Architect (www.ibm.com/software/awdtools/developer/application/support) viene aggiornato con il collegamento ai newsgroup.

Visualizza il file Readme principale