이 항목에서는 일부 기본 문제 해결 전략을 제공하고 맵 지원 보고서를 PDF/Excel 형식으로 보기와 관련된 가장 일반적인 몇 개의 문제를 설명합니다.
기본 문제 해결
보고서를 PDF 또는 Excel 형식으로 보면 맵 이미지가 EM4C 서버로 업로드됩니다. 이미지 파일이 <em4c_location>\webapps\em4c\WEB-INF\web.xml의 .IMAGE_TEMP_FOLDER 등록정보에서 지정한 위치의 디스크에 임시로 작성됩니다. 기본 설정에 따라 임시 이미지 폴더의 위치는 <em4c_location>\webapps\em4c\temp\images입니다.
PDF 또는 Excel 형식으로 맵을 보면서 문제를 해결할 때 먼저 맵 이미지가 EM4C 서버의 임시 이미지 폴더에 업로드되었는지 여부를 확인해야 합니다. 이미지가 업로드되지 않은 경우 EM4C 서버가 실행 중인지와 임시 이미지 폴더를 작성 가능한지를 확인합니다.
맵 이미지가 EM4C 서버에 정상적으로 업로드되었으나 맵이 PDF/Excel 형식의 보고서로 나타나지 않은 경우 이는 구성 문제(IBM Cognos 또는 Esri Maps for IBM Cognos.)일 수 있습니다. 정적 이미지만 사용해 보고서를 생성하고 테스트하여 문제의 원인이 IBM Cognos 구성 또는 Esri Maps for IBM Cognos 구성인지 여부를 확인할 수 있습니다. 이미지는 IBM Cognos 게이트웨이(예: <cognos_gateway_machine>\ibmcognos\em4c\images\move_down.gif)에 있어야 하며 상대 URL(예: ..\em4c\images\move_down.gif)을 사용하여 참조해야 합니다. PDF/Excel 형식의 보고서를 볼 때 이미지가 나타나지 않으면 IBM Cognos 구성에 문제가 있는 것입니다.
이미지가 테스트 보고서에 나타나지 않은 경우 Esri Maps for IBM Cognos 구성에 문제가 있을 수 있습니다. 문제 해결을 시작하려면 다음 요구 사항을 충족하는지 확인하세요.
- EM4C 게이트웨이 URI(서버 이름, 포트, IBM Cognos 가상 디렉터리)와 IBM Cognos 게이트웨이 URI는 같아야 합니다.
- SSL(Secure Sockets Layer) 보안 프로토콜을 포함한 구성에서 IBM Cognos 디스패처가 IBM Cognos 게이트웨이를 통해 맵 이미지를 다운로드합니다. 이는 다음 사항이 true여야 함을 의미합니다.
- 웹 서버는 디스패처가 HTTP 또는 HTTPS를 \<ibmcognos>\em4c\cgi-bin\em4c.cgi에 요청하는 프로세스를 허용해야 합니다.
- IBM Cognos 디스패처가 SSL 인증을 신뢰할 수 있어야 합니다. IBM Cognos 설명서 및 PDF로 보고서를 실행할 때 보이지 않는 이미지를 검토하여 이 구성 문제에 대해 자세히 알아보세요. 자세한 내용은 기술 Knowledge Base article 000012432를 참고하세요.
- IBM Cognos 게이트웨이와 IBM Cognos 디스패처 간에 방화벽이 있는 경우 디스패처가 \<ibmcognos>\em4c\cgi-bin\em4c.cgi에 접근하도록 허용된 방화벽 규칙을 생성해야 합니다.
글꼴이 올바르게 보이지 않습니다.
맵을 Internet Explorer에서 보거나 인쇄할 경우 맵에 보이는 문자를 지원하는 트루타입 글꼴이 EM4C 서버에 설치되어 있지 않으면 일부 문자가 맵 이미지에서 누락될 수 있습니다. 이 경우에는 해당 문자를 지원하는 트루타입 글꼴을 찾아 시스템 글꼴로 설치하거나 해당 글꼴의 복사본을 EM4C 서버의 \fonts\fallback 폴더에 넣습니다. 새 글꼴을 설치하거나 배치한 후 변경 사항이 반영되려면 EM4C 서비스를 다시 시작해야 합니다.
다음 단계에는 트루타입 글꼴의 복사본을 EM4C 서버에 배치하는 방법이 나와 있습니다. 이러한 단계는 관리자가 작업 환경의 각 EM4C 서버에서 수행해야 합니다.
- 필요한 문자를 지원하는 트루타입 글꼴의 복사본을 다음 위치에 배치합니다.
<em4c_location>\bin\jre-server\lib\fonts\fallback
- EM4C 서버 컴퓨터에서 서비스를 엽니다.
- EM4C 서비스를 찾습니다. Windows 서비스의 기본 이름은 EM4C<portnumber>입니다.
- 서비스를 마우스 오른쪽 버튼으로 클릭한 다음 다시 시작을 클릭합니다.
여러 페이지로 된 보고서와 맵을 하나의 맵으로 보여 줍니다.
PDF 또는 Excel 형식으로 맵을 렌더링하는 경우, Esri Maps for IBM Cognos는 HTML에 나타나는 것과 같은 맵의 이미지를 생성합니다. PDF 또는 Excel 형식을 선택했을 때 Esri Maps for IBM Cognos에서는 맵을 렌더링하도록 합니다.
그렇기 때문에 여러 페이지에 맵이 있는 보고서의 경우 현재 HTML 페이지 화면에 있는 맵만 PDF 또는 Excel 출력 문서로 렌더링됩니다. 모든 맵을 보고서에 여러 페이지에 걸쳐 인쇄하려면 각 페이지를 개별적으로 인쇄해야 맵 각각의 이미지 스냅샷이 제대로 나타나도록 인쇄할 수 있습니다. 맵을 포함하고 있는 각 페이지에서 인쇄할 HTML 페이지를 찾아 원하는 출력 형식을 선택한 다음 출력 문서에서 페이지를 찾아 인쇄합니다.
맵 위치에 흰색 상자가 나타납니다.
PDF/Excel 2007 형식으로 볼 수 있는 보고서의 맵 위치에 흰색 상자가 나타나면 다음과 같은 원인 중 하나일 수 있습니다.
- EM4C 게이트웨이 URI(서버 이름, 포트 등)가 IBM Cognos 게이트웨이 URI와 같지 않거나 EM4C 게이트웨이를 구성할 때 다른 오류가 발생하여 맵이 보이지 않습니다. EM4C 게이트웨이와 IBM Cognos 게이트웨이 둘 다의 URI 호스트 이름 부분이 localhost에서 IP 주소 또는 네트워크 호스트 이름으로 변경되었는지 확인합니다. 자세한 내용은 EM4C 게이트웨이 구성을 참고하세요.
- 맵 지원 보고서를 PDF/Excel 2007 형식으로 보면 맵의 이미지가 생성되고 EM4C 서버에 저장됩니다. 맵 이미지가 저장된 위치가 상대 URL을 사용하여 지정되어 보고서가 다른 IBM Cognos 가상 디렉터리로 구성된 환경으로 이동한 경우에 콘텐츠를 저장하고 이에 접근할 수 있습니다. 일부 버전의 IBM Cognos에 HTTP 요청을 통해 상대 URL을 사용하여 이미지 불러오기를 차단하는 알려진 결함이 있습니다. 이 문제는 결함 수정을 포함한 IBM Cognos 버전으로 업그레이드하여 해결할 수 있습니다. 또는 영향을 받은 보고서를 수동으로 편집하여 맵 이미지 URL에 대한 절대 경로를 사용할 수 있습니다. 자세한 내용은 Knowledge Base article 000013621을 참고하세요.
- SSL(Secure Sockets Layer) 보안 프로토콜을 포함한 구성에서 IBM Cognos Keystore 내의 SSL 신뢰 체인이 불완전하거나 누락되어 이 문제가 발생했을 수 있습니다. 이 시나리오에서는 맵 지원 보고서를 PDF/Excel 2007 형식으로 볼 때 IBM Cognos 게이트웨이가 웹 서버상의 맵 이미지로 접근할 수 없습니다. 이는 SSL 신뢰 체인이 웹 서버와 IBM Cognos 응용프로그램 티어 컴포넌트 간에 설정되지 않았기 때문입니다.
웹 서버와 IBM Cognos 간에 신뢰를 설정하려면 IBM Cognos 관리자가 SSL 인증 신뢰 체인을 IBM Cognos CA keystore로 가져와야 합니다. 자세한 내용은 Knowledge Base article 000012432를 참고하세요.
보고서 형식을 선택하면 보고서가 생성되지 않습니다.
맵 지원 보고서를 HTML 형식으로 보는 중에 보고서 형식을 선택하면 보고서 생성을 기다리는 동안 회전하는 마우스 포인터가 맵에 나타날 수 있습니다. 이 문제는 IIS(Internet Information Services)가 EM4C 게이트웨이의 웹 서버로 사용되는 시스템 환경에서 Mozilla Firefox 또는 Google Chrome을 사용할 때 발생할 수 있습니다. 이 문제에 대한 해결 단계와 자세한 내용은 Knowledge Base article 000012227을 참고하세요.