Uwagi do wydania dla narzędzi WWW (edytora diagramów WWW, projektanta stron, projektanta serwisów WWW)

© Copyright International Business Machines Corporation 2006. Wszelkie prawa zastrzeżone. Ograniczone prawa na rzecz rządu Stanów Zjednoczonych - używanie produktów, tworzenie ich duplikatów oraz ujawnianie informacji o nich podlega zastrzeżeniom zawartym w umowie GSA ADP Schedule zawartej z firmą IBM® Corp.

Uwagi do wydania

1.0 Ograniczenia
   1.1 Ograniczenia renderowania właściwości CSS w Projektancie stron
   1.2 Znikają elementy menu trzeciego poziomu
   1.3 Wyjątek pustego wskaźnika podczas przeciągania i upuszczania z Eksploratora projektów do aspektu Nawigacja serwisu WWW
   1.4 Podczas tworzenia projektu nie można skopiować przykładowego szablonu jako szablonu dynamicznego
   1.5 Aspekt Nawigacja serwisu WWW nie odzwierciedla zmian wprowadzonych w pliku web.xml
   1.6 Obcięta nazwa przycisku w języku rosyjskim
   1.7 Niepoprawna kolejność elementu menu Cofnij Działanie
   1.8 Ścieżka nawigacji nie jest aktualizowana na stronie Projekt po zmianie serwisu
2.0 Znane problemy oraz sposoby ich obejścia
   2.1 Projektant stron nie współpracuje z systemem SCM (Software Configuration Management) po podzieleniu ramki
   2.2 Projektant stron nie wstawia tabeli o układzie dowolnym z menu głównego, jeśli karetka pojawia się poza tabelą o układzie dowolnym
   2.3 W widoku Właściwości układ zwija się
   2.4 W edytorze diagramów WWW w pomocy kontekstowej są informacje z pomocy ogólnej
   2.5 Sprawdzanie poprawności składni HTML niepoprawnie raportuje błędy "Brak znacznika początkowego" w przypadku występowania znaczników HTML i JSP
   2.6 Niektóre aspekty muszą być ręcznie aktualizowane podczas migrowania projektów za pomocą Kreatora migracji J2EE
   2.7 Projektant stron nie wyświetla poprawnego menu podręcznego po kliknięciu prawym przyciskiem myszy elementu w komórce tekstowej.
   2.8 Zmiana połączenia JDBC może nie spowodować aktualizacji aliasu uwierzytelniania użytkownika w pliku powiązań WWW.
   2.9 Występowanie błędu SWTError z sugestią zamknięcia środowiska roboczego
   2.10 Błąd sterownika sieciowego bazy danych Derby podczas korzystania z kreatorów Rekord relacyjny i Lista rekordów
   2.11 Podczas ponownego przełączenia na WebSphere Application Server 6.1 nie są wprowadzane odpowiednie zmiany ścieżki klasy, jeśli mediator jdbc 6.1 jest już włączony
   2.12 Odniesienie do zasobu źródła danych dla Mediatora JDBC może zostać usunięte podczas importowania pliku WAR/EAR
   2.13 Podczas importowania projektu WWW V512 mającego strony ze znacznikiem JSF "h:outputLink" może być zgłaszany błąd

1.0 Ograniczenia

1.1 Ograniczenia renderowania właściwości CSS w Projektancie stron

Projektant stron nie obsługuje typów właściwości CSS innych niż wizualne, na przykład mowy.

Projektant stron nie obsługuje następujących wizualnych typów właściwości CSS:
border-collapse,border-spacing,caption-side,clip,content,counter-increment,counter-reset,cursor,empty-cells,font-variant,letter-spacing,max-height,max-width,min-height,min-width,orphans,outline-color,outline-style,outline-width,outline,overflow,page-break-after,page-break-before,page-break-inside,quotes,table-layout,visibility,widows i word-spacing.

Projektant stron nie w pełni obsługuje następujące wizualne typy właściwości CSS:
- Ujemne wartości marginesu, właściwości margin-top, margin-bottom, margin-left i margin-right nie są obsługiwane.
- Względne i stałe wartości pozycji nie są obsługiwane.
- Wartości określane procentowo ani długość właściwości vertical-align nie są obsługiwane.
- Górne i dolne wartości właściwości vertical-align nie są obsługiwane.
- Wartości pre-wrap i pre-line właściwości white-space nie są obsługiwane.

1.2 Znikają elementy menu trzeciego poziomu

Gdy tworzone jest menu poziome lub pionowe o głębokości większej niż 3, a wartość właściwości keepSelection to true, ustawienie kursora myszy nad elementami menu powinno umożliwić rozwinięcie elementów podmenu, ale elementy menu trzeciego poziomu nie są rozwijane.

1.3 Wyjątek pustego wskaźnika podczas przeciągania i upuszczania z Eksploratora projektów do aspektu Nawigacja serwisu WWW

Podczas przeciągania i upuszczania strony z folderu WebContent Eksploratora projektów na stronę Nawigacja aspektu Nawigacja serwisu WWW zgłaszany jest wyjątek pustego wskaźnika.

1.4 Podczas tworzenia projektu nie można skopiować przykładowego szablonu jako szablonu dynamicznego

Jeśli podczas tworzenia projektu WWW zostanie wybrany aspekt projektu Nawigacja serwisu WWW, na stronie Wybierz szablon strony dla serwisu WWW kreatora można zaznaczyć pole wyboru Użyj domyślnego szablonu strony dla serwisu WWW i wybrać przykładowy szablon, ale może to być tylko szablon w fazie projektowej. Nie można wybrać szablonu strony dynamicznej.

1.5 Aspekt Nawigacja serwisu WWW nie odzwierciedla zmian wprowadzonych w pliku web.xml

Po wprowadzeniu zmian w pliku web.xml, aspekt Nawigacja serwisu WWW nie odzwierciedla zmian.  Na przykład jeśli w pliku web.xml zostanie zmienione odwzorowanie serwletu, aspekt Nawigacja serwisu WWW nie będzie odzwierciedlał tej zmiany na stronie Szczegóły ani natychmiast ani po zapisaniu pliku web.xml.

1.6 Obcięta nazwa przycisku w języku rosyjskim

 Zawsze, gdy nazwa przycisku jest tłumaczona z języka angielskiego na rosyjski (lub inny język), długość przetłumaczonego łańcucha może być większa niż długość łańcucha w języku angielskim. Jeśli wielkość przycisku pozostanie taka sama, wtedy nazwa przycisku pojawi się obcięta.

1.7 Niepoprawna kolejność elementu menu Cofnij Działanie

W języku angielskim oraz w innych językach, ten element menu pojawi się jako Cofnij <Działanie>, , na przykład: Cofnij  Dodawanie stron WWW, ale w języku koreańskim ten element menu powinien pojawić się w kolejności <Działanie> Cofnij  (na przykład: Cofnij Dodawanie stron WWW). Aktualnie te elementy menu wyświetlane są jako Cofnij <Działanie>.

1.8 Po zmianie serwisu ścieżka nawigacji nie jest aktualizowana na stronie Projekt

Jeśli na jednej ze stron serwisu użytkownik wstawia ścieżkę nawigacji, zmiana serwisu nie powoduje odzwierciedlenia zmian na stronie Projekt Projektanta stron. Aby zobaczyć zmiany, należy odświeżyć ekran, na przykład przełączając się na stronę Podgląd, a następnie z powrotem wracając na stronę Projekt.

2.0 Znane problemy oraz sposoby ich obejścia

2.1 Projektant stron nie współpracuje z systemem SCM (Software Configuration Management) po podzieleniu ramki

Edytowanie pliku w Projektancie stron może nie być możliwe, jeśli plik został nowo utworzony przez podzielenie ramki w tym samym Projektancie stron, który jest zarządzany przez system SCM.

Sposób obejścia: Należy zamknąć Projektant stron i ponownie otworzyć plik.

2.2 Projektant stron nie wstawia tabeli o układzie dowolnym z menu głównego, jeśli karetka pojawia się poza tabelą o układzie dowolnym

Jeśli karetka pojawia się poza tabelą o układzie dowolnym na stronie Projekt Projektanta stron, z menu głównego nie można wstawić tabeli o układzie dowolnym.

Sposób obejścia: W takim przypadku tabelę o układzie dowolnym można wstawić z palety.

2.3 W widoku Właściwości układ zwija się

W przypadku korzystania z Projektanta stron z rezydentnym oprogramowaniem lektora ekranowego, układ widoku Właściwości może się zwinąć.

Sposób obejścia:
Nie należy używać widoku Właściwości z tego typu oprogramowaniem. Należy skorzystać z trybu Wszystkie atrybuty z menu "Wyświetl wszystkie atrybuty" lokalnego paska narzędzi widoku Właściwości.

2.4 W edytorze diagramów WWW w pomocy kontekstowej są informacje z pomocy ogólnej

Podczas edytowania diagramu WWW pomoc kontekstowa jest dostępna w dynamicznym widoku pomocy, ale nie jako pomoc kontekstowa. Aby ustawić preferencje wyświetlania pomocy kontekstowej w dynamicznym widoku pomocy, należy kliknąć Okno > Preferencje > Pomoc i w sekcji Otwórz pomoc kontekstową okna kliknąć przełącznik w widoku pomocy dynamicznej. Jeśli zostanie zaznaczony przełącznik w informacji wywoływanej, podczas edytowania diagramu WWW dostępna jest tylko pomoc ogólna.

2.5 Sprawdzanie poprawności składni HTML niepoprawnie raportuje błędy "Brak znacznika początkowego" w przypadku występowania znaczników HTML i JSP

Mieszanie znaczników HTML i JSP (w tym znaczników niestandardowych) może spowodować, że analizator poprawności składni HTML będzie niepoprawnie raportować błędy braku znacznika początkowego i końcowego.  Na przykład w następującym kodzie:

<c:when test="${status.first}">
<div class="topNavRight"><ul>
</c:when>
...
<c:if test="${status.last}">
</ul></div>
</c:if>

Znaczniki początkowe <div> i <ul> znajdują się wewnątrz znaczników <c:when>, a znaczniki </ul></div> wewnątrz znaczników <c:if>. Jest to poprawny kod, jednak analizator poprawności składni HTML zgłosi, że znaczniki </ul> i </div> nie mają znaczników początkowych.

Sposób obejścia nr 1: Jeśli to możliwe, należy unikać nakładania się znaczników HTML i JSP.  W powyższym przykładzie sposobem obejścia jest następująca zmiana kodu:

<div class="topNavRight"><ul>
<c:when test="${status.first}">
</c:when>
...
<c:if test="${status.last}">
</c:if>
</ul></div>

Sposób obejścia nr 2: Jeśli nakładanie znaczników jest wymagane, sposobem obejścia jest wyłączenie opcji sprawdzania poprawności składni HTML. Aby wyłączyć opcję sprawdzania poprawności składni HTML dla projektu, należy wywołać okno dialogowe Właściwości dla tego projektu, wybrać stronę Właściwość sprawdzania poprawności, zaznaczyć opcję "Przesłoń preferencje sprawdzania poprawności" i usunąć zaznaczenie opcji "Analizator poprawności składni kodu HTML".

2.6 Podczas migracji projektów za pomocą kreatora migracji J2EE niektóre aspekty muszą być aktualizowane ręcznie

W przypadku migrowania aplikacji za pomocą Kreatora migracji J2EE (dostępnego z menu kontekstowego projektu w obszarze Migruj) niektóre aspekty mające zależności dla konkretnej wersji dynamicznej sieci WWW mogą nie zostać poprawnie zaktualizowane. 

Sposób obejścia:  Po zakończeniu migracji należy przejść do strony Właściwości projektu (wybrać opcję Właściwości z menu kontekstowego Projekt), a następnie przejść do strony właściwości Aspekty projektu. Następnie należy kliknąć opcję Dodawanie/usuwanie aspektów projektu. Mogą zostać wyświetlone komunikaty o błędach wskazujące, że niektóre aspekty wymagają określonej wersji dynamicznego modułu WWW, takiego jak JSTL, mediator JDBC lub WebSphere® Web (Co-existence) i (Extended). Dla większości aspektów z menu rozwijanego można po prostu wybrać odpowiednią wymaganą wersję i kliknąć przycisk Zakończ. W przypadku aspektu Mediatora JDBC konieczne będzie ręczne usunięcie zaznaczenia poprzedniego aspektu i kliknięcie przycisku Zakończ, a następnie ponowne otwarcie strony aspektu i wybranie odpowiedniej jego wersji. Wtedy do ścieżki klasy zostaną dodane odpowiednie pliki jar Mediatora JDBC.

2.7 Projektant stron nie wyświetla poprawnego menu podręcznego po kliknięciu prawym przyciskiem myszy elementu w komórce tekstowej.

Jeśli w komórce tekstowej znajduje się tylko jeden element, nie można wyświetlić menu podręcznego dla tego elementu przez kliknięcie go prawym przyciskiem myszy.

Sposób obejścia: Aby wyświetlić poprawne menu podręczne dla elementu komórki tekstowej, należy nacisnąć klawisze Shift+F10, a nie klikać prawym przyciskiem myszy.

2.8 Zmiana połączenia JDBC może nie spowodować aktualizacji aliasu uwierzytelniania użytkownika w pliku powiązań WWW.

Podczas aktualizacji szczegółów środowiska wykonawczego dla połączenia JDBC (z właściwości projektu) zostanie utworzone nowe połączenie w rozszerzonym pliku EAR i zaktualizowane odwołanie do zasobów, tak aby wskazywało na nową nazwę JNDI dla nowego źródła danych. Jednak alias uwierzytelniania nie zostanie zaktualizowany. 
Sposób obejścia: Wybierz odniesienie do zasobu w pliku web.xml o takiej samej nazwie, jak połączenie JDBC. Nazwa odniesienia do zasobu jest oparta na początkowym połączeniu wybranym do aktualizacji (z listy rozwijanej Nazwa), a nie na nazwie połączenia określonego w aktualizacji. Ustaw alias uwierzytelniania na właśnie utworzony (nowy alias uwierzytelniania będzie zawierał nazwę połączenia określonego w ramach aktualizacji), który znajduje się w sekcji Wdrażanie deskryptora wdrażania EAR lub w konfiguracji serwera - w przypadku używania serwera środowiska testowego WebSphere Application Server 5.1.

2.9 Występowanie błędu SWTError z sugestią zamknięcia środowiska roboczego

Podczas pracy z Projektantem stron może pojawić się panel z błędem SWTError sugerującym zamknięcie środowiska roboczego. Ten błąd występuje zwykle w trakcie otwierania strony WWW lub podczas próby otwarcia menu podręcznego w Projektancie stron. Wystąpienie tego problemu może wskazywać na duże obciążenie systemu z powodu uruchomienia zbyt wielu aplikacji.

Sposób obejścia:

  1. Otwórz Menedżer zadań systemu Windows®.
  2. Przejdź na kartę Procesy.
  3. Odszukaj procesy, które mają duże wartości w kolumnach Uchwyty, Obiekty użytkownika i Obiekty GDI.
    • Jeśli te kolumny nie są widoczne, z menu należy wybrać pozycje: Widok > Wybierz kolumny. Zaznacz kolumny Licznik uchwytów, Obiekty użytkownika i Obiekty GDI w oknie Wybieranie kolumn.

  4. Te procesy zużywają wiele obiektów systemowych i produkt nie może działać razem z tymi aplikacjami. Spróbuj zamknąć niektóre z tych aplikacji i ponownie uruchomić środowisko robocze.

2.10 Błąd sterownika sieciowego bazy danych Derby podczas korzystania z kreatorów Rekord relacyjny i Lista rekordów

 Podczas łączenia się z sieciową bazą danych Derby mogą wystąpić problemy w przypadku używania kreatorów rekordów relacyjnych i listy rekordów. Taka sytuacja może wystąpić, gdy w bazie danych znajduje się tabela z kluczem obcym powiązanym z tabelą, która ma wielokolumnowy klucz podstawowy, a użytkownik próbuje dodać relację z poprzedniej tabeli do nowszej.


Sposób obejścia: Przed uruchomieniem kreatora rekordów relacyjnych lub kreatora listy rekordów relacyjnych należy otworzyć widok Eksplorator baz danych, rozwinąć wszystkie używane tabele i upewnić się, że ograniczenia klucza podstawowego zostały poprawnie załadowane.

2.11 Ponowne wskazywanie na serwer WebSphere Application Server, wersja 6.1, nie powoduje odpowiednich zmian ścieżki klasy, jeśli mediator jdbc 6.1 jest już włączony

Podczas tworzenia projektu dynamicznej strony WWW z aspektem Mediatora JDBC pliki JAR środowiska wykonawczego zostaną skonfigurowane w oparciu o serwer docelowy, bez względu na wybraną wersję aspektu. Na przykład jeśli wskazany zostanie serwer WebSphere Application  Server, wersja 5.1, po wybraniu wersji 6.1 aspektu mediatora JDBC do projektu są dodawane odpowiednie pliki JAR w wersji 5.1. Jeśli następnie docelowe środowisko wykonawcze projektu WWW zostanie skonfigurowane pod kątem serwera WebSphere Application Server, wersja 6.1, środowisko wykonawcze Mediatora JDBC nie zostanie zaktualizowane.

Sposób obejścia:  Zdeinstaluj aspekt mediatora JDBC z projektu i ponownie go zainstaluj. W tym celu kliknij prawym przyciskiem myszy projekt WWW, a następnie kliknij opcję Właściwości. Kliknij opcję Aspekty projektu, a następnie kliknij przycisk Dodawanie/usuwanie aspektów projektu. Usuń zaznaczenie pola wyboru Mediator JDBC, a następnie kliknij przycisk Zakończ. Ponownie kliknij przycisk Dodawanie/usuwanie aspektów projektu, zaznacz pole wyboru Mediator JDBC, a następnie kliknij przycisk Zakończ.. Na koniec należy kliknąć przycisk OK.


2.12 Odniesienie do zasobu źródła danych dla Mediatora JDBC może zostać usunięte podczas importowania pliku WAR/EAR

Podczas uzyskiwania dostępu do rekordów relacyjnych lub list rekordów relacyjnych za pomocą mediatora JDBC odwołanie zasobu dla źródła danych zostanie utworzone w pliku web.xml projektu. Jeśli projekt zostanie wyeksportowany do pliku WAR lub EAR, a następnie ponownie zaimportowany, odniesienie do zasobu może zostać usunięte, co spowoduje niepowodzenie dostępu do danych w czasie wykonywania. Jeśli odniesienie do zasobu zostanie usunięte podczas importowania, można wykonać jedną z dwóch następujących czynności w celu rozwiązania tego problemu. Można użyć narzędzi dostępu do danych, aby ponownie utworzyć połączenie ze źródłem danych. Jest to również konieczne, jeśli należy zmodyfikować jakiekolwiek rekordy lub listy relacyjne na utworzonych stronach WWW. Alternatywnie można rozpakować plik WAR do katalogu i skopiować odniesienie do zasobu z pliku web.xml do pliku web.xml w zaimportowanym projekcie w obszarze roboczym. W tym przypadku należy także usunąć opis odniesienia do zasobu; w przeciwnym razie odniesienie do zasobu zostanie usunięte ponownie podczas budowania projektu. Opis odniesienia do zasobu będzie następujący: "Automatycznie wygenerowane - Połączenie źródła danych SDO z XXXX".

2.13 Podczas importowania projektu WWW V512 mającego strony ze znacznikiem JSF "h:outputLink" może być zgłaszany błąd

Podczas importowania dynamicznego projektu WWW - utworzonego w produkcie WebSphere Studio Application Developer lub WebSphere Studio Site Developer, wersja 5.1.2 - zawierającego przykładowe sterowanie nawigacją serwisu WWW (na przykład zakładka pionowa lub pozioma), w widoku Problemy pojawi się następujący błąd dotyczący przykładowego pliku JSP, który został dodany do projektu użytkownika:

Niepoprawny identyfikator "${siteid.id}".

Przyczyna:

W wersji 512 przy każdym użyciu znacznika JSF "h:outputLink"  na paskach nawigacyjnych serwisu jest generowany i używany jego atrybut "id". W wersji 7 atrybut "id" nie jest ani generowany, ani wykorzystywany, dlatego analizator poprawności aspektów nie rozumie wyrażeń wprowadzonych w Nawigacji serwisu WWW, ale wymaga oznaczenia podwójnych identyfikatorów jako błędy (w przeciwnym razie środowisko wykonawcze zgłosi błąd).

Sposób obejścia:

Należy ręcznie usunąć atrybut "id" (tzn. usunąć tekst id="${siteid.id}") ze znacznika JSF "h:outputLink" występującego na paskach nawigacyjnych w kodzie strony JSP.

Jeśli na przykład plik .jsp w projekcie w wersji 512 zawiera następujący wiersz powodujący powyższy błąd:
<td nowrap valign="middle" style="background-image: url('${sitenav.navtabSelImg[4]}')"><h:outputLink id="${siteid.id}" style="${sitenav.navstyle}" styleClass="${sitenav.navclass}" value="${item.href}"><h:outputText value="${item.label}"></h:outputText></h:outputLink></td>

należy go zmodyfikować w następujący sposób:

<td nowrap valign="middle" style="background-image: url('${sitenav.navtabSelImg[4]}')"><h:outputLink  style="${sitenav.navstyle}" styleClass="${sitenav.navclass}" value="${item.href}"><h:outputText value="${item.label}"></h:outputText></h:outputLink></td>