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
예제 경로 기반 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로 변환합니다.