Функция адресации URL обеспечивает пользователям возможность непосредственно получать доступ к объектам, не перемещаясь по пользовательскому интерфейсу клиента IBM® FileNet P8.
Войдя в систему на таком клиенте FileNet P8, как Workplace XT, пользователь просто вводит URL объекта в строке адреса в браузере.
(Администратор может создать закладки или избранное, чтобы получать доступ к папке или объекту с несколькими версиями.)
Используя функцию адресации URL, можно:
- Получать документы, папки, сохраненные поиски, шаблоны поиска, определения рабочих потоков, и шаблоны публикации.
- Загружать перечисленные ниже типы объектов и сохранять их на локальном компьютере: документы, сохраненные поиски, шаблоны поиска, шаблоны публикации и определения рабочих потоков.
- Вводить URL на основе пути или на основе ID, как показано ниже.
В URL на основе пути используется путь контейнеров для указания расположение объекта в хранилище объектов.
Например, чтобы получить документ с именем Current Works (Текущие работы), который находится в папке Projects (Проекты) в хранилище объектов Transportation (Транспорт), пользователь должен ввести URL, аналогичный показанному в следующем примере:
http://имя_сервера_клиента_P8/имя_приложения:порт/getContent/Transportation/Projects/Current+Works
Чтобы получить объекты, используя URL на основе пути, нужно задать предпочтение сайта Использовать URL на основе пути.
В URL на основе ID для указания расположение объекта в хранилище объектов используются значения
GUID.
Расположение документа указывается с использованием GUID хранилища объектов, в котором находится документ, а также GUID документа. Например, чтобы получить документ, пользователь должен ввести URL, аналогичный показанному в следующем примере:
http://имя_сервера_клиента_P8/имя_приложения:порт/getContent?objectStoreName={84A4A727-37E2-4994-B060-8531FAF75612}&objectType=document&id={559946a8-2007-4096-AC67-773A8540AE6}
Обычно при использовании адреса на основе ID ответ удается получить быстрее, чем при использовании адреса на основе пути; однако относительные ссылки в документе разрешаются только при использовании URL на основе пути.
Например, если вы затребуете файл "example.html", используя URL на основе пути, этот файл будет получен, и браузер разрешит все необходимые дополнительные URL в example.html (например, теги <script>, <img> и <link>). Когда пользователь щелкнет по любой ссылке (<a href=...>), она разрешится в браузере.
В следующей таблицы приведены ответы по умолчанию для различных типов объектов, которые можно указать в URL.
Тип объекта |
Ответ |
Папка |
Будет возвращена страница с именем папки. |
Документ |
Если в документе есть содержимое, будет возвращено содержимое. Если в документе есть внешняя ссылка, клиент FileNet P8 перенаправит клиент нужным образом. Если в документе нет содержимого, клиент FileNet P8 сообщит об ошибке. |
Определение рабочего потока |
Будет открыт апплет Дизайнер процессов. |
Сохраненный поиск |
Будет возвращена страница с именем сохраненного поиска. |
Шаблон поиска |
Будет возвращена страница с шаблоном поиска. |
Шаблон публикации |
Будет возвращено содержимое шаблона публикации в виде XML. |
Пример 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
Правила синтаксиса URL на основе ID
В случае объектов типа Папка URL на основе ID принимает три обязательных строчных параметра запроса: objectStoreName, objectType и id. Например:
http://сервер/веб_приложение/getContent?objectStoreName={GUID_хранилища_объектов}&objectType=type&id={GUID_объекта}
В случае документов, сохраненных поисков, шаблонов поиска, шаблонов публикации и определений рабочих потоков URL принимает параметры objectStoreName, objectType, id и fsld. Можно указать необязательный параметр
mode=download. Ниже приводится пример:
http://сервер/веб_приложение/getContent?objectStoreName={GUID_хранилища_объектов}&objectType=type&id={GUID_объекта}&mode=download
или
http://сервер/веб_приложение/getContent?objectStoreName={GUID_хранилища_объектов}&objectType=type&vsId={GUID_серии_версий}
или
http://сервер/веб_приложение/getContent?objectStoreName={GUID_хранилища_объектов}&objectType=type&id={GUID_объекта}&vsId={GUID_серии_версий}&mode=download
где:
- сервер - имя сервера механизма приложений или Workplace XT, на котором работает приложение-клиент FileNet P8.
- веб_приложение - имя приложения-клиента FileNet P8.
- objectStoreName=GUID_хранилища_объектов - это GUID хранилища объектов, где находится объект.
Используйте фигурные скобки.
- objectType=тип - это тип получаемого объекта.
Введите применимое значение objectType:
Тип объекта: |
objectType= |
Документ |
document |
Папка |
folder |
Сохраненный поиск |
storedsearch |
Шаблон поиска |
searchtemplate |
Определение рабочего потока |
document |
Шаблон публикации |
publishtemplate |
- id=GUID_объекта - это GUID, идентифицирующий объект в хранилище объектов.
Это обязательный параметр для объекта типа Папка.
В случае документов, сохраненных поисков, шаблонов поиска, определений рабочих потоков и шаблонов публикации параметр id является необязательным и используется для получения конкретной версии.
Используйте фигурные скобки.
- vsId=GUID_серии_версий - это GUID для получения самой последней версии в серии версий для следующих объектов: документ, сохраненный поиск, шаблон поиска, определение рабочего потока и шаблон публикации.
Прим.: Если в URL указан и ID, и vsld, приложение-клиент FileNet P8 будет использовать ID для получения указанной версии.
Если найти указанную версию не удастся, приложение-клиент FileNet P8 сообщит об ошибке и предоставит пользователю возможность получить самую последнюю версию, заданную параметром vsld.
- Параметр mode=download является необязательным и позволяет сохранить содержимое на локальном компьютере.
Прим.: Вы можете сконфигурировать приложение-клиент FileNet P8 для использования URL на основе пути для требований, касающихся документов.
Поэтому, если вы введете URL на основе ID, приложение-клиент FileNet P8 преобразует URL на основе ID в URL на основе пути (если это возможно), чтобы обеспечить целостность всех относительных ссылок на URL, встроенных в содержимое документа.