IBM FileNet P8, 버전 5.1.+            

컨텐츠 경로 재지정 특성

content_redir.properties 파일은 사용자가 Workplace XT 내에서 파일을 열려고 시도할 때 Workplace XT JSP(Java Server Pages)나 서블릿 또는 사용자 정의 또는 공급업체 애플리케이션으로의 경로 재지정을 구성합니다. 경로 재지정은 컨텐츠 MIME 유형을 기반으로 합니다. 이 주제에서는 경로 재지정을 사용자 정의하는 방법을 보여줍니다. 다음 섹션은 애플리케이션이 content_redir.properties를 사용하는 방법을 설명합니다. 경로 재지정을 사용자 정의하려면 경로 재지정 특성 파일 수정 섹션을 참조하십시오.

컨텐츠 경로 재지정의 개요

content_redir.properties는 키/값 쌍으로 구성되어 있으며 여기서 키는 MIME 유형이고, 값은 연관된 MIME 유형의 파일을 여는데 사용할 컴포넌트를 지정합니다. 아래 목록은 Image Viewer용이며 여기에서 예제로 사용됩니다. 예제는 다른 애플리케이션에 적용할 수 있습니다. 목록을 검사할 때에는 다음 사항을 참고하십시오.
  • 키/값 쌍의 첫 번째 그룹이 MIME 유형을 Image Viewer에 맵핑합니다. Image Viewer에서 어노테이션의 기능을 활용하기 위해서 이 파일을 편집하여 어떤 이미지 유형이 Image Viewer에서 열리는지를 지정할 수 있습니다. 목록은 /WcmJavaViewer.jsp?{QUERY_STRING} 값이 있으며 Image Viewer로 열리는 MIME 유형을 보여줍니다. Image Viewer에 대한 자세한 정보는 Image Viewer 관련 작업의 내용을 참조하십시오.
  • content_redir.properties의 키는 특정 Content Engine 클래스에 정의된 mimeType 특성을 기반으로 합니다. 자세한 정보는 MIME 유형 정보를 참조하십시오.
  • 값에 매크로를 포함할 수 있습니다(예: {QUERY_STRING}). 사용 가능한 매크로는 content_redir.properties에 문서화되어 있습니다.
  • MIME 유형이 content_redir.properties에 정의되지 않는 경우에는 getContent 서블릿이 호출되고 선택한 오브젝트 유형에 따라 응답합니다. 아래 getContent 서블릿의 기본 동작을 참조하십시오.
  • 문서 오브젝트 유형의 경우 경로 재지정 동작은 추가로 특정 설정에 의해 정의되며, content_redir.properties를 수정하는 경우 이를 고려해야 합니다. 아래 다른 설정과의 상호 작용을 참조하십시오.
# Comment the lines with MIME types to not be opened by the Image Viewer applet
image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/jpg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/jpeg=/WcmJavaViewer.jsp?{QUERY_STRING}
image/bmp=/WcmJavaViewer.jsp?{QUERY_STRING}
image/tiff=/WcmJavaViewer.jsp?{QUERY_STRING}
image/gif=/WcmJavaViewer.jsp?{QUERY_STRING}
application/x-cold=/WcmJavaViewer.jsp?{QUERY_STRING}
application/x-visio=/redirect/customAppRedirect.jsp?vsId={VERSION_SERIES_ID}&objectStoreName={OBJECT_STORE_NAME}&id={OBJECT_ID}&objectType=document

application/vnd.filenet.im-image=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-cold=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-form=/WcmJavaViewer.jsp?{QUERY_STRING}
application/vnd.filenet.im-other=/WcmJavaViewer.jsp?{QUERY_STRING}

folder=/WcmObjectBookmark.jsp
customobject=/integrationWebBasedCommand?_commandId=3010
showPropertiesCommand=/integrationWebBasedCommand?_commandId=3010
application/x-filenet-search=/WcmObjectBookmark.jsp
application/x-filenet-searchtemplate=/WcmObjectBookmark.jsp
application/x-filenet-workflowdefinition=/eprocess/WcmDesigner.jsp
application/x-filenet-scenariodefinition=/eprocess/WcmSimDesigner.jsp
...

getContent 서블릿의 기본 동작

MIME 유형이 content_redir.properties에 지정되지 않은 경우에는 애플리케이션은 getContent 서블릿을 호출합니다. 서블릿의 동작은 아래 나열된 것처럼 선택된 오브젝트 유형에 의해 판별됩니다.
폴더
클라이언트를 폴더를 표시하는 페이지로 경로 재지정합니다.
문서
문서에 컨텐츠가 있으면 컨텐츠가 브라우저로 리턴됩니다.
문서에 외부 참조가 있으면 서블릿은 클라이언트를 적절하게 경로 재지정합니다.
문서에 컨텐츠가 없으면 오류가 보고됩니다.
워크플로우 정의 문서
클라이언트를 워크플로우 디자이너로 경로 재지정합니다.
저장된 검색
클라이언트를 저장된 검색을 표시하는 페이지로 경로 재지정합니다.
검색 템플리트
클라이언트를 검색 템플리트를 표시하는 페이지로 경로 재지정합니다.
공개 템플리트
공개 템플리트의 컨텐츠는 XML로 리턴됩니다.

다른 설정과의 상호 작용

content_redir.properties 파일 설정에 추가로 이미지를 포함하는 문서 유형 오브젝트에서 숨겨진 특성이 경로 재지정 동작에 영향을 미칩니다. "IgnoreRedirect"라고 불리는 이 숨겨진 특성은 기본적으로 설정되지 않습니다. 이는 프로그래밍 방식으로 또는 엔터프라이즈 관리자를 통해서만 설정할 수 있습니다.

문서 유형 오브젝트를 열면 애플리케이션은 IgnoreRedirect 특성을 보고 다음 조치를 수행합니다.
  • IgnoreRedirect가 True로 설정되면 이는 문서를 브라우저로 전송합니다.
  • IgnoreRedirect가 False로 설정되면 이는 문서를 content_redir.properties에 지정된 컴포넌트로 전송합니다.
  • IgnoreRedirect가 설정되지 않으면(NULL) 이는 문서를 content_redir.properties에 지정된 컴포넌트로 전송합니다.

Image Services 등과 같이 외부 라이브러리에 저장된 문서의 경우 "Include Redirect"라는 외부 서비스 사이트 환경 설정이 있습니다. 기본적으로 이 환경 설정은 "Yes"로 설정되어 있습니다. "Yes"로 설정되지 않은 경우에는 URL에는 이미지의 IgnoreRedirect 특성 설정이 추가됩니다. 이 환경 설정에 대한 자세한 정보는 외부 서비스 환경 설정의 내용을 참조하십시오.

Image Services에 저장된 이미지를 열면 애플리케이션이 다음 조치를 수행합니다.
  • "Include Redirect" = Yes이고 문서 특성 IgnoreRedirect = true이면 애플리케이션은 이미지를 브라우저로 보냅니다.
  • "Include Redirect" = Yes이고 문서 특성 IgnoreRedirect = false이면 애플리케이션은 이미지를 content_redir.properties에 지정된 대상으로 보냅니다.
  • "Include Redirect" = No이고 IgnoreRedirect 특성 설정이 URL에 포함되지 않으면 애플리케이션은 이미지를 content_redir.properties에 지정된 대상으로 보냅니다.

경로 재지정 특성 파일 수정

content_redir.properties를 수정하여 경로 재지정을 사용자 정의할 수 있습니다. 예를 들어, 공급업체 애플리케이션에 경로 재지정을 추가하거나 기존 경로 재지정을 주석 처리하거나 getContent 서블릿이 주석 처리된 MIME 유형의 오브젝트를 처리하도록 허용할 수 있습니다.

주: content_redir.properties를 수정하기 전에 경로 재지정을 정의하고 싶은 IgnoreRedirect 특성 및 "Include Redirect" 사이트 환경 설정을 확인하십시오.

경로 재지정 특성 파일을 수정하려면

  1. content_redir.properties를 텍스트 편집기로 여십시오. 기본적으로 파일은 다음 위치에 설치됩니다.
    Workplace XT: <install_location>/FileNet/Config/WebClient
  2. 특성을 필요에 따라 수정하십시오.
    • 기존 MIME 유형 맵핑을 제거하려면 적용 가능한 키 및 값 쌍 앞에 # 기호를 추가하여 주석 처리하십시오(예: #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}).
    • MIME 유형 맵핑을 추가하려면 Content Engine 클래스에 정의된 mimeType 특성 값에 해당하는 키로 키 및 값 쌍을 입력하십시오. 값은 애플리케이션에서 애플리케이션 디렉토리에 상대적인 JSP 페이지 또는 서블릿 경로를 지정해야 합니다.

      매크로를 사용하면 선택한 오브젝트의 URL 쿼리 문자열을 키 및 값 쌍에 지정된 컴포넌트로 전달할 수 있습니다. 예를 들어, 전체 쿼리 문자열을 전달하기 위해 {QUERY_STRING} 매크로를 포함할 수 있습니다. 또는 {OBJECT_TYPE}, {OBJECT_ID} 및 기타 매크로를 사용하여 쿼리 문자열로부터 개별 매개변수를 전달할 수 있습니다. 전체 매크로 목록은 content_redir.properties 파일을 참조하십시오.

    • MIME 유형을 공급업체 또는 사용자 정의 애플리케이션으로 맵핑하려면 애플리케이션 내에서 외부 애플리케이션으로 경로 재지정하는 컴포넌트를 지정해야 합니다. 예를 들어, 다음 Workplace 키 및 값 쌍에서 Workplace는 사용자가 MIME 유형이 "text/x-speech"인 파일을 선택한 경우 Workplace/redirect/customAppRedirect.jsp로 경로 재지정됩니다.
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      외부 애플리케이션으로 경로 재지정하려면 JSP 경로 재지정 코드는 다음 행과 같이 단순할 수 있습니다.
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      그러나 일반적으로 외부 애플리케이션에 대한 경로 재지정 논리는 외부 애플리케이션에 의해 필요한 URL, 매개변수, 보안 토큰 및 기타 값을 리턴하기 위해 Workplace XT와 같은 기본 API를 활용하는 작업이 더 많습니다.

  3. content_redir.properties를 저장하십시오.
  4. 새 설정을 적용하려면 웹 서버를 다시 시작하십시오.


피드백

마지막 업데이트 날짜: 2011년 7월


© Copyright IBM Corp. 2011.
이 Information Center는 Eclipse 기술로 구현됩니다. (http://www.eclipse.org 웹 사이트 참조)