포털 프로젝트는 WebSphere Portal v5.0.2.2를 지원합니다.
새 포틀렛 마법사를 사용하여 JSR 168 포틀렛을 작성할 때, Rational Developer는 자동으로 ID 속성을 지정합니다. 서버에 대해 포틀렛을 고유하게 식별하려면, portlet.xml 파일의 <portlet-app/> 요소에 ID 속성을 포함해야 합니다. (이 속성은 IBM 포틀렛 API 포틀렛에서 사용되는 UID 속성에 해당합니다.)
portlet.xml의 <portlet-app/> 요소에 ID 속성이 없는 JSR 168 포틀렛을 가지고 있을 경우, 작업공간으로 포틀렛을 가져온 후 즉시 고유한 값을 사용하여 ID 속성을 추가하십시오. ID 속성을 추가하려면 포틀렛 전개 설명자를 열고 소스 보기를 사용하여 편집하십시오. JSR 168 포틀렛을 포털 서버에 전개한 후, 또는 포털 프로젝트에서 JSR 168 포틀렛 프로젝트를 사용한 후에는 ID 값을 변경하지 마십시오.
ID 속성이 없는 JSR 168 포틀렛에는 다음과 같은 제한사항이 있습니다.
- 포털 프로젝트에 ID 속성이 없는 JSR 168 포틀렛을 사용할 경우, 이 포털 프로젝트를 테스트 환경에서 실행할 수 없습니다.
- 두 개 이상의 JSR 168 포틀렛을 ID 속성 없이 WebSphere Portal 5.1 테스트 환경에 연관시킬 경우, 테스트 환경을 시작할 수 없습니다.
- JSR 168 포틀렛을 포털 서버에 전개한 후, 또는 포털 프로젝트에서 JSR 168 포틀렛 프로젝트를 사용한 후에는 프로젝트 이름을 변경할 수 없습니다.
관계형 레코드 목록이나 관계형 레코드(SDO)를 포함하는 포틀렛을 실행할 경우, 서버 로그에서 다음과 같은 오류를 볼 수 있습니다.
[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: org/eclipse/emf/ecore/EClass 클래스가 로더 제한사항을 위반함: 상위 및 하위 로더 사이의 정의 불일치이 오류는 무시해도 됩니다.
협력 소스 포틀렛을 작성할 때 actionNameParameter와 name 속성을 직접 WSDL 파일에 추가해야 합니다. 예를 들면, 다음과 같습니다.
<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>이 릴리즈에서는, 포털 도구가 WSDL 파일에 caption 속성을 생성하지 않습니다. WebSphere Portal v5.1에서 배선을 사용할 경우, WSDL 파일에 caption 속성을, 자원 파일에 caption 값을 직접 지정해야 합니다. 예를 들면, 다음과 같습니다.
<portlet:param name="orderId" partname="order_id" caption="order.id" />자세한 정보는 WebSphere Portal Information Center에서 "협력 포틀렛 개발" 주제를 참조하십시오.
WebSphere Portal v5.1의 IBM API 기본 포틀렛에서 person 태그를 사용할 경우, 다음 구문을 사용하여 지정해야 합니다.
<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />WebSphere Portal v5.1의 IBM API Faces 포틀렛에서 person 태그를 사용할 경우, 다음 구문을 사용하여 지정해야 합니다.
<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>
person 태그는 JSR 168 포틀렛에 대해 지원되지 않습니다.
SAP BAPI 및 RFM SDO 마법사 제한사항: "기본 및 사전/사후 기능 선택" 페이지를 지나 계속 진행하는데 다른 기본 기능을 선택한 후 이 페이지로 돌아가려고 할 경우, 사전/사후 맵핑 페이지가 올바르게 작동하지 않습니다.
솔루션: 새로운 사전 및 사후 기능 맵핑을 설정해야 할 경우, 마법사를 다시 시작해야 합니다.
Portal 서버에서 SAP SDO를 포함하는 포틀렛을 테스트하기 전에 WebSphere Portal 5.1 서버에서 SAP JCo 어댑터를 구성해야 합니다.
- SAP Service Marketplace의 SAP 사이트에서 SAP의 JCo 어댑터 디렉토리를 다운로드하십시오.
- Download Software > Download > SAP Connectors > SAP Java Connector를 누르십시오. 운영 체제에 따라 다운로드할 적절한 파일을 선택하십시오. ZIP 파일의 컨텐츠를 로컬 디렉토리에 푸십시오.
- 운영 체제에 따라 다음 단계를 완료하십시오. 참고: <wps_51>은 WebSphere Portal 5.1 서버의 설치 디렉토리를 가리킵니다(예: C:\WebSphere\PortalServer51TE).
Windows:
- sapjco.jar 및 sapjcorfc.dll을 <wps_51>\shared\app로 복사하십시오.
- librfc32.dll을 C:\windows\system32\로 복사하십시오.
- WebSphere Portal 5.1 서버를 다시 시작하십시오.
Linux:
- sapjco.jar 및 libsapjcorfc.so를 <wps_51>\shared\app로 복사하십시오.
- librfccm.so 파일을 포함하는 폴더를 환경 변수 LD_LIBRARY_PATH에 추가하십시오.
- WebSphere Portal 5.1 서버를 다시 시작하십시오.
협력 포틀렛은 RedHat Enterprise Linux 3.0용 Rational Developer 내부 브라우저에서 지원되지 않습니다. RedHat Enterprise Linux 3.0에서 협력 포틀렛을 사용해야 할 경우 Netscape Communicator를 사용하십시오.
Netscape Communicator를 기본 브라우저로 사용하려면 Rational Developer가 외부 브라우저를 사용하도록 구성하십시오. 이를 수행하려면 메뉴 표시줄에서 창 > 환경 설정을 선택하십시오. 왼쪽에서 인터넷 노드를 펼치고 웹 브라우저를 선택하십시오. 기본 섹션에서 내부 웹 브라우저를 제외한 모든 브라우저가 선택 가능합니다.
자세한 정보는 WebSphere Portal Information Center에서 "협력 포틀렛에 대한 알려진 문제점 및 제한사항" 주제를 참조하십시오.
새 포털 프로젝트 마법사를 사용하거나 샘플 갤러리에서 샘플 포털 프로젝트를 가져와서 포털 프로젝트를 작성할 경우, 문제점 보기에 끊어진 링크 경고 메시지가 표시됩니다.
이 버전의 Rational Developer에서는 Portal Designer가 지원되는 마크업으로 HTML, cHTML 및 WML만 표시합니다. 가져올 프로젝트에서 페이지나 레이블에 대해 지원되는 다른 마크업을 지정한 경우, 이 마크업은 Rational Developer에서 유지보수되지만 변경할 수 없으므로 특성 보기에 표시되지 않습니다.
이 버전의 Rational Developer에서는 Portal Designer에서 외부 URL만 설정할 수 있습니다. 포털 서버에 내부 URL이 있는 경우, 가져온 프로젝트에서 URL을 유지보수하지만 변경할 수는 없습니다. 내부 URL을 다시 기존의 포털 서버로 전개하는 것만 가능합니다.
Portal Designer의 이 릴리즈에서는, Admin 및 AdminLeftNavigation 주제가 아웃라인 보기에 표시됩니다. 그러나 이 주제는 포털 관리 목적을 위한 것이므로 포털 프로젝트의 기본 주제로 선택하면 안됩니다.
문제점: 기존 IBM API 포틀렛 프로젝트에서 새 포틀렛을 작성할 때, 이벤트 처리 페이지에서 Click-to-Action 송신자 포틀렛 샘플 추가 또는 메시지 송신자 포틀렛 샘플 추가 옵션을 선택할 경우 다음 오류 메시지가 표시됩니다.
- IWAL0008E 포틀렛에 대해 올바르지 않은 Servlet 참조. (portlet.xml)
- CHKJ4014W: 유형 Servlet 이름의 빈 항목. (web.xml)
솔루션: 다음 방법으로 포틀렛 프로젝트를 다시 열어야 합니다.
- 포틀렛 프로젝트를 마우스 오른쪽 단추로 누르고 팝업 메뉴에서 프로젝트 닫기를 선택하십시오.
- 포틀렛 프로젝트를 마우스 오른쪽 단추로 누르고 팝업 메뉴에서 프로젝트 열기를 선택하십시오.
- 포틀렛 프로젝트를 마우스 오른쪽 단추로 누르고 팝업 메뉴에서 유효성 검증 실행을 선택하십시오.
문제점: WebSphere Portal 테스트 환경을 시작할 수 없습니다.
솔루션:
- 성공적 설치 확인: 이 문제는 설치 중 장애로 인해 발생했을 수 있습니다. WebSphere Portal 테스트 환경 설치 중의 문제를 확인하고 필요에 따라 해결하도록 하십시오.
- 너무 긴 파일 이름 생략: 포틀렛 프로젝트에 파일 이름이 너무 긴 파일이 있어서 서버를 시작할 수 없습니다. 이 문제를 해결하려면, 프로젝트 이름, 패키지 접두부 및/또는 클래스 접두부를 짧게 줄여서 생성된 파일 이름 길이를 승인 가능하게 하십시오. 또는 개별 파일 이름 자체를 승인 가능한 길이로 줄일 수 있습니다. 또한 기본 디렉토리를 작업공간으로 사용하는 경우, 디렉토리 길이가 더 짧은 다른 작업공간을 사용하는 것도 효과적입니다. Rational Developer를 시작하여 작업영역 디렉토리를 지정하고 제공된 대화 상자에서 이름을 변경할 수 있습니다. 작업공간을 지정하기 위한 대화 상자가 표시되지 않으면, 명령 프롬프트로 이동하여 Rational Developer 실행 명령을 입력한 후 -data [workspace_name]을 입력하십시오.
문제점: JSR 168 포틀렛 전개 설명자에서는 포틀렛 콜렉션 영역의 포틀렛 이름을 편집할 수 없습니다.
솔루션: 소스 페이지에서 포틀렛 이름을 편집하십시오.
문제점: 마법사에서 생성된 Faces JSP 파일에서 <f:view> 태그를 삭제하고 Faces 구성요소를 파일에 삽입할 경우, <f:subview> 태그가 <f:view> 태그 대신 사용됩니다. 이러한 유형의 JSP 파일에서, Faces 포틀렛이 올바르게 실행되지 않습니다. 브라우저에서 입력한 사항은 서버측 처리 시 유실됩니다.
솔루션: 이 문제를 해결하려면, JSP 파일에서 <f:subview> 태그를 <f:view> 태그로 바꾸십시오.
Click-to-Action 태그를 포함하는 Faces 포틀렛을 최대화할 경우 포틀렛 컨텐츠가 표시되지 않습니다.
문제점: Portal UTE를 설치하지 않은 경우, "localhost" 또는 "127.0.0.1"을 대상으로 하는 포털 가져오기, 내보내기 및 전개 서버는 작성할 수 없습니다.
솔루션: 이러한 서버를 작성해야 하는 경우, "localhost" 대신 시스템의 완전한 이름을 사용하십시오(예: myhost.mydomain).
문제점: 새 포털 프로젝트의 가져오기를 완료하기 전에 취소할 경우, 완료되지 않은 포털 프로젝트는 제거되지 않아 사용 불가능하게 됩니다.
솔루션: 포털 가져오기 마법사에서 겹쳐쓰기 시 삭제 옵션을 사용하여 포털 구성 및 파일을 다시 가져와야 합니다.
문제점: WebSphere Portal에서 Rational Developer로 기존 포털 사이트를 가져올 때, 가져온 포털 프로젝트에 대한 문제점 보기에 WSRP에 관련된 유효성 검증 오류가 표시됩니다.
솔루션: Rational Developer를 가져오기 전에 APAR PQ95638을 WebSphere Portal에 적용하십시오.
문제점: 올바르지 않은 인코딩으로 인해, Page Designer를 사용하여 가져온 포털 프로젝트에서 license.html 또는 privacy.html 파일을 열 수 없습니다.
솔루션: APAR PQ93681을 Portal 서버에 적용한 후 Portal 서버에서 프로젝트를 다시 가져오십시오.
"SDO 런타임 추가"는 Rational Software Architect 뉴스그룹을 참조합니다. Rational Software Architect 지원 사이트( www.ibm.com/software/awdtools/developer/application/support)는 뉴스그룹에 대한 링크를 포함하도록 갱신됩니다.