OZFlashViewer Guide 2010.05.14 작성자 : 류지연(OZ Consulting)
목차 1. 웹호환성 이란? 2. Adobe Flash Player 를 지원하는 운영 체제 및 브라우저 (버전별) 3. OS 별 / 브라우저별 OZFlashViewer(Report viewer) 호환성 4. 오즈 리포트 플래시 뷰어 파일 구조 5. 설치 및 구동 방법 6. 기타 7. 장애처리
1. 웹호환성 이란? 웹호환성이란? 운영체제, 브라우저등 어떠한 환경에 구별 없이 웹의 내용을 동일하게 출력하고 기능을 구현하는 것이다. 웹호환성 = 상호운용성 상호운용성 = 상위운용성 + 하위운용성 웹접근성이란? 웹 컨텐츠가 제공하는 내용과 기능을 어떤 환경에서도 모든 사용자가 인지하고 이용할 수 있는 것. 모든 사용자란 노인, 어린이, 일반인 또는 시작, 청각, 지각, 인지 장애자를 뜻 함.
2. Adobe Flash Player 를 지원하는 운영 체제 및 브라우저 플랫폼 브라우저 Microsoft® Windows® Vista Microsoft Internet Explorer 7, Firefox 2.0, AOL 9, Safari 3.x 이상 Microsoft Windows XP Microsoft Internet Explorer 6.0 이상, Firefox 1.x, Firefox 2.x, Mozilla 1.x 이상, Netscape 7.x 이상, AOL 9, Opera 7.11 이상, Safari 3.x 이상 Windows Server® 2003 Microsoft Internet Explorer 6.0 이상, Firefox 1.x, Firefox 2.x Windows 2000 Microsoft Internet Explorer 5.x, Firefox 1.x, Firefox 2.x, Mozilla 1.x, Netscape 7.x 이상, AOL 9, Opera 7.11 이상 Windows Me Microsoft Internet Explorer 5.5, Firefox 1.x, Mozilla 1.x, Netscape 7.x 이상, AOL 9, Opera 7.11 이상 Windows 98 Microsoft Internet Explorer 6.0 이상, Firefox 1.x, Mozilla 1.x, Netscape 7.x 이상, Opera 7.11 이상 Flash Player 10은 다음과 같은 최소 운영 체제 및 브라우저에서 지원됩니다. 플랫폼 브라우저 Microsoft® Windows Vista® Microsoft Internet Explorer 7.0 이상, Firefox 2.x, Firefox 3.x, AOL 9, Opera 9.5 이상, Safari 3.x, Chrome 2.0 이상 Microsoft Windows XP Microsoft Internet Explorer 6.0 이상, Microsoft Windows Server® 2003 Firefox 2.x, Firefox 3.x Microsoft Windows Server 2008 Microsoft Internet Explorer 7.0 이상, Firefox 3.x Microsoft Windows 2000 Microsoft Internet Explorer 6.0, Firefox 2.x, Firefox 3.x, AOL 9, Opera 9.5 Microsoft Windows 7 Microsoft Internet Explorer 8.0 이상, Firefox 3.x 이상
3. OS 별 / 브라우저별 OZFlashViewer(Report viewer) 호환성 OZFlashViewer 가 구동되는 시스템에는 Adobe Flash Player이 설치되어 있어야 합니다. (아래는 Adobe Flash Player 10 기준 입니다.) 브라우저 명 Window XP / vista / Window 7 OSX(Mac) Linux Internet Explorer 7.0 / 8.0(MS) O X Fire Fox (Netscape) Safari (Apple) Crome(Google) Opera (Opera SW)
4. 오즈 리포트 플래시 뷰어 파일 구조 디렉토리 파일명 설명 %HOME% AC_OETags.js 오즈 뷰어 구동 유틸리티 스크립트 파일 ozutil.js 이미지 다운로드 유틸리티 스크립트 파일 OZPdfWriter.swf (삭제) PDF 저장 모듈 (OZCMainFrame.swf에 포함) OZXLSWriter.swf (삭제) 엑셀 저장 모듈 (OZCMainFrame.swf에 포함) ozjscript.js OZCMainFrame.swf 오즈 뷰어 메인 화면 플래시 파일 OZViewer9.swf Adobe Flash Player 9.0용 뷰어 플래시 파일 OZViewer10.swf Adobe Flash Player 10.0용 뷰어 플래시 파일 playerProductInstall.swf Adobe Flash Player 버전 업데이트 플래시 파일 res chartres_언어명_국가명.xml 차트 실행 모듈 선택 리소스 파일 ex) chartres_ko_KR.xml viewer_error_msg_언어명_국가명.xml 오즈 뷰어 에러 메시지 리소스 파일 ex) viewer_error_msg_ko_kr.xml viewer_server_error_msg_언어명_국가명.xml 오즈 서버 에러 메시지 리소스 파일 ex) viewer_server_error_msg_ko_KR.xml viewer_string_resource_언어명_국가명.xml 프로그레스바 메시지 리소스 파일 ex) viewer_string_resource_ko_kr.xml
5. 설치 및 구동 방법(1) 오즈 리포트 플래시 뷰어 설치 웹 애플리케이션 서버(이하 WAS)의 특정 폴더에 오즈 리포트 플래시 뷰어 파일을 복사하면 설치가 완료됩니다. ※ 참고사항 : 오즈 리포트 플래시 뷰어는 별도의 설치 과정이 필요하지 않고 단순히 파일 복사로 설치 완료되며, 클라이언트에서 오즈 리포트 플래시 뷰어를 호출하는 웹 페이지가 실행될 때 웹 브라우저에서 인터넷 임시 폴더로 다운로드 합니다. 예를 들어, oz51/OZFlashViewer 폴더에 오즈 리포트 플래시 뷰어 파일 설치할 경우에는 다음과 같이 파일 목록이 표시됩니다.
5. 설치 및 구동 방법(1) FlashPlayer 가 설치되어 있지 않을 경우 아래와 같은 화면이 보임. Get Flash 를 클릭하여 설치 페이지로 이동 후 설치 해야 함. (http://get.adobe.com/kr/flashplayer/)
6. 기타(1) :: Flash Player Debuger Flash Player Debuger 설치 후 메시지 : debuger를 설치하면 에러메세지를 상세히 볼수 있음. Error #2044: 처리되지 않은 securityError입니다. text=Error #2048: 보안 샌드박스 문제가 발생했습니다. http://10.100.5.129:8080/oz51/OZFlashViewer/OZCMainFrame.swf은(는) http://127.0.0.1:8080/oz51/server에서 데이터를 로드할 수 없습니다. at oz.framework.cp::OZServerCPFile/sendMessage() at oz.framework.cp::OZServerCPFile/StartLoad() at oz.client.repository::OZRepositoryServerFile/StartLoad() at oz.viewer.report::OZCViewerReportLoader/GetFromRemote_() at oz.viewer.report::OZCViewerReportLoader/GetFromRemote() at oz.viewer.report::OZCViewerReportLoader/GetData() at oz.viewer.report::OZCViewerReportLoader/LoadReport() at oz.viewer.doc::OZCViewerReportDoc/CreateManager() at oz.viewer.doc::OZCViewerReportDoc/Preview() at OZCMainFrame/LoadWebFonts_End()
6. 기타(2) :: crossdomain.xml FlashPlayer 7.late 이후에 적용된 강화된 cross-domain sandbox 보안 정책에 의해 FlashPlayer에서는 임베드될 컨텐츠가 swf 일 경우 해당 swf 파일이 동일한 도메인상에 존재할 때 로드가 가능합니다. 타 도메인의 컨텐츠를 로드 할 경우 아래와 같이 crossdomain.xml을 웹서버에 ROOT에 설정 해야 합니다. <?xml version="1.0"?> <!DOCTYPE cross-domain-policy SYSTEM "http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd"> <cross-domain-policy> <allow-http-request-headers-from domain="*" headers="*" /> <allow-access-from domain="*" /> <allow-access-from domain="www.forcs.com" /> <allow-access-from domain="*.oztn.com" /> <allow-access-from domain=“10.100.5.129" /> <!-- 와일드카드는 IP 도메인 형식에 사용할 수 없습니다. --> </cross-domain-policy>
6. 기타(3) :: 참고 사항 [조회툴바] 뷰어 파라미터에 값이 없을 경우 ActivexViewer는 콤보박스에 선택이 안되나, FlashViewer는 첫번째 항목으로 선택되어짐. "connection.servlet","http://127.0.0.1:8080/oz51/server", "viewer.isframe","true", "connection.reportname","/northwind/Categories.ozr", "odi.odinames","Categories", "information.debug", "true", "odi.Categories.pcount","1", "odi.Categories.args1","input_Discontinued="
6. 기타(3) :: 참고 사항 [조회툴바] <뷰어 파라미터에 값이 있을 경우 – 영문일경우 대소문자 구분 함> "connection.servlet","http://127.0.0.1:8080/oz51/server", "viewer.isframe","true", "connection.reportname","/northwind/Categories.ozr", "odi.odinames","Categories", "information.debug", "true", "odi.Categories.pcount","1", "odi.Categories.args1","input_Discontinued=TRUE"
6. 기타(3) :: 기본 제약 사항 1. 바인딩 시간이 60초 이상 소요되는 보고서는 바인딩할 수 없음. (60초 이상 소요될 경우 에러 메시지가 나타남.) IE 타임 아웃 시간과 비교하여 짧은 시간으로 적용. 2. gif, jpg, png 형태의 이미지만 지원됨. (svg 형태 지원 안됨) 3. 초기엔 ozd, pdf, xls 형식만 지원 가능 했으나 현재는 Activex와 동일하게 지원됨.
7. 장애처리 1. windows vista 에서 report export 시 파일 선택창이 보이지 않고 저장이 완료 되었다는 메시지 창이 보임. 실제론 report export가 되지 않았음. 이는 windows vista 에서만 발생하는 FlashPlayer 의 보안 관련 버그로 FlashPlayer 를 10.0.32.18 이후 버전으로 패치 해야 함. ozFlashViewer 호출 소스에서 아래와 같이 수정하여 FlashPlayer 버전이 자동 패치 되도록 해야 함. var requiredMajorVersion = 10; var requiredMinorVersion = 0; var requiredRevision = 32; 2. 보고서 조회시 데이터는 정상적으로 보여지나 저장, 인쇄, 버전정보창 등을 띄웠을때 위치가 Center/Middle가 아닐 경우 창을 띄우다 에러가 발생한 경우 임. FlashViewer로 개발실에 상황 재현하여 전달 해야 함.