IBM FileNet P8, 버전 5.2            

URL을 통해 오브젝트에 액세스

URL 주소 지정 가능성 기능은 사용자에게 IBM® FileNet® P8 클라이언트 사용자 인터페이스 전체를 탐색하지 않고도 오브젝트에 대한 직접 액세스를 제공합니다. Workplace XT와 같은 FileNet P8 클라이언트에 사인온한 후에 사용자는 브라우저의 주소 표시줄에 오브젝트의 URL을 입력하기만 하면 됩니다. (관리자는 폴더 또는 버전화 가능 오브젝트를 검색하기 위해 책갈피 또는 즐겨찾기를 작성할 수 있습니다.)

URL 주소 지정 가능성을 사용하면 다음을 수행할 수 있습니다.
  • 문서, 폴더, 저장된 검색, 검색 템플리트, 워크플로우 정의 및 공개 템플리트를 검색합니다.
  • 문서, 저장된 검색, 검색 템플리트, 공개 템플리트 및 워크플로우 정의 등의 오브젝트 유형을 다운로드하고 이를 로컬 PC에 저장하십시오.
  • 아래 표시된 대로 경로 기반 또는 ID 기반 URL을 입력하십시오.
경로 기반 URL은 포함 경로를 사용하여 오브젝트 저장소에 오브젝트의 위치를 지정합니다. 예를 들어, Transportation 오브젝트 저장소의 Projects 폴더에 상주하는 이름이 Current® Works인 문서를 검색하려면 사용자는 다음 예제와 유사한 URL을 입력하면 됩니다.

http://P8_client_server_name/application_name:port/getContent/Transportation/Projects/Current+Works

경로 기반 URL을 사용하여 오브젝트를 검색하려면 경로 기반 URL 사용 사이트 환경 설정을 설정해야 합니다.

ID 기반 URL은 GUID를 사용하여 오브젝트 저장소에 오브젝트의 위치를 지정하십시오. 문서의 위치는 문서가 상주하는 오브젝트 저장소의 GUID뿐만 아니라 문서의 GUID로 지정됩니다. 예를 들어, 문서를 검색하기 위해 사용자는 다음 예제와 유사한 URL을 입력합니다.

http://P8_client_server_name/application_name:port/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}

ID 기반 주소는 일반적으로 경로 기반 주소보다 빠릅니다. 그러나 경로 기반 URL만이 문서 내에서 관련 참조를 해석합니다. 예를 들어, 경로 기반 URL이 있는 "example.html" 파일을 요청하면 파일이 검색되고 브라우저는 example.html(예: <script>, <img>, and <link> 태그) 내에서 필요한 추가적인 모든 URL을 해석합니다. 모든 링크(<a href=...>)는 사용자가 링크를 클릭할 때 브라우저에 의해 해석됩니다.

다음 표는 URL에 지정할 수 있는 다른 오브젝트 유형에 대한 기본 응답을 나열합니다.
오브젝트 유형 응답
폴더 폴더 이름을 표시하는 페이지를 리턴합니다.
문서 문서에 컨텐츠가 있으면 컨텐츠가 리턴됩니다. 문서에 외부 참조가 있으면 FileNet P8 클라이언트는 필요에 따라 클라이언트를 경로 재지정합니다. 문서에 컨텐츠가 없으면 FileNet P8 클라이언트가 오류를 보고합니다.
워크플로우 정의 프로세스 디자이너 애플릿을 엽니다.
저장된 검색 저장된 검색 이름을 표시하는 페이지를 리턴합니다.
검색 템플리트 검색 템플리트를 표시하는 페이지를 리턴합니다.
공개 템플리트 공개 템플리트의 컨텐츠를 XML로 리턴합니다.

경로 기반 URL 구문 규칙

경로 기반 URL에는 오브젝트 저장소 ID 및 포함 경로 이름이 필요합니다. mode=download 매개변수는 선택사항입니다. 예를 들어, 다음과 같습니다.

http://server/web_application/getContent/objectStoreID/pathName?mode=download

각 항목에 대한 설명은 다음과 같습니다.
  • server는 FileNet P8 클라이언트 애플리케이션이 상주하는 Application Engine 또는 Workplace XT 서버의 이름입니다.
  • web_application은 FileNet P8 클라이언트 애플리케이션의 이름입니다(예: Workplace XT).
  • objectStoreID는 오브젝트 저장소 ID이며 GUID이거나 오브젝트 저장소의 이름일 수 있습니다. 오브젝트 저장소 이름은 단일 도메인 내에서 고유하지만 Active Directory에서는 고유할 필요가 없습니다. 이름이 오브젝트 저장소를 참조하는 데 사용된 경우에는 Active Directory 내에서 첫 번째 일치하는 오브젝트 저장소가 리턴됩니다. Active Directory 내에 동일한 이름의 오브젝트 저장소가 있는 경우에는 "@" 문자를 사용하여 오브젝트 저장소 이름을 도메인 이름으로 규정해야 합니다(예: objectStoreName@domainName).
  • pathName은 포함 경로 이름입니다.
  • mode=download 매개변수(선택사항)를 사용하면 컨텐츠를 로컬에 저장할 수 있습니다.
    참고: 문서의 경로 기반 URL, 저장된 검색, 검색 템플리트 및 공개 템플리트 오브젝트는 항상 가장 최신 버전을 참조합니다.

예제 경로 기반 URL

이 URL을 사용하면 지정된 검색 템플리트가 있는 Workplace XT 페이지가 표시됩니다. 오브젝트 저장소는 이름(Forms)으로 식별됩니다.

http://server1/WorkplaceXT/getContent/Forms/Claims/Home?mode=download

이 URL을 사용하여 오브젝트 저장소인 Forms은 해당 도메인 이름(Midwest)에 의해 규정됩니다.

http://server1/WorkplaceXT/getContent/Forms@midwest/Claims/Home?mode=download

ID 기반 URL 구문 규칙

ID 기반 URL은 폴더 오브젝트에 objectStoreName, objectType 및 ID의 세 개의 필수 쿼리 문자열 매개변수를 사용합니다. 예를 들어, 다음과 같습니다.

http://server/web application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}

문서, 저장된 검색, 검색 템플리트, 공개 템플리트 및 워크플로우 정의 오브젝트의 경우 URL은 objectStoreName, objectType, ID 및 fsld 매개변수를 사용합니다. mode=download 매개변수는 선택사항입니다. 예제는 다음과 같습니다.

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&mode=download

또는

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&vsId={versionSeriesGUID}

또는

http://server/web_application/getContent?objectStoreName={objectStoreGUID}&objectType=type&id={objectGUID}&vsId={versionSeriesGUID}&mode=download

각 항목에 대한 설명은 다음과 같습니다.
  • server는 FileNet P8 클라이언트 애플리케이션이 실행되고 있는 Application Engine 또는 Workplace XT 서버의 이름입니다.
  • web_application은 FileNet P8 클라이언트 애플리케이션의 이름입니다.
  • objectStoreName=objectStoreGUID는 오브젝트가 상주하는 오브젝트 저장소의 GUID입니다. 중괄호를 포함하십시오.
  • objectType=type은 검색할 오브젝트 유형입니다. 적용 가능한 objectType 값을 입력하십시오.
    예제 objectType=
    문서 document
    폴더 folder
    저장된 검색 storedsearch
    검색 템플리트 searchtemplate
    워크플로우 정의 document
    공개 템플리트 publishtemplate
  • id=objectGUID는 오브젝트 저장소에서 오브젝트를 식별하는 GUID입니다. 이는 폴더 오브젝트의 필수 매개변수입니다. 문서, 저장된 검색, 검색 템플리트, 워크플로우 정의 및 공개 템플리트 오브젝트의 경우 ID는 선택사항이며 특정 버전을 검색하는 데 사용됩니다. 중괄호를 포함하십시오.
  • vsId=versionSeriesGUID는 버전 시리즈 내에서 문서, 저장된 검색, 검색 템플리트, 워크플로우 다음 오브젝트에 대해 가장 최신 버전을 검색하기 위한 GUID입니다.
    참고:  ID와 vsld 둘 모두가 URL에 있는 경우에는 FileNet P8 클라이언트 애플리케이션은 ID를 사용하여 지정된 버전을 검색합니다. 지정된 버전을 찾을 수 없는 경우에는 FileNet P8 클라이언트 애플리케이션이 오류를 보고하고 사용자에게 vsld 매개변수가 지정한 대로 가장 최신 버전을 검색하는 옵션을 제공합니다.
  • mode=download 매개변수는 선택사항이며 이를 사용하면 항상 컨텐츠를 로컬에 저장할 수 있습니다.
    참고: 문서 요청에 경로 기반 URL을 사용하도록 FileNet P8 클라이언트 애플리케이션을 구성할 수 있습니다. 그러므로 ID 기반 URL을 입력하면 FileNet P8 클라이언트 애플리케이션은 가능한 경우 문서 컨텐츠 내에 임베디드된 상대 URL 참조의 무결성을 유지하기 위해서 ID 기반 URL을 경로 기반 URL로 변환합니다.


피드백

마지막 업데이트 날짜: 2013년 3월
aeadm_access_objects_via_url.htm

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