Получение доступа к объектам с использованием URL

Функция адресации 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 на основе пути требуется ID хранилища объектов и имя пути контейнера. Можно указать необязательный параметр mode=download. Например:

http://сервер/веб_приложение/getContent/ID_хранилища_объектов/имя_пути?mode=download

где:
  • сервер - имя сервера механизма приложений или Workplace XT, на котором находится приложение-клиент FileNet P8.
  • веб_приложение - имя приложения-клиента FileNet P8, например, Workplace XT.
  • ID_хранилища_объектов - ID хранилища объектов, который может представлять собой GUID или имя хранилища объектов. Имя хранилища объектов является уникальным в данном домене, но может быть не уникальным в Active Directory. Если для ссылки на хранилище документов используется имя, будет возвращено первое подходящее хранилище объектов в Active Directory. Если в Active Directory могут оказаться хранилища объектов с одинаковыми именами, вы должны квалифицировать имя хранилища объектов, указав имя домена с использованием символа "@"; например, objectStoreName@domainName.
  • имя_пути - это имя пути контейнера.
  • Параметр 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

Правила синтаксиса 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, встроенных в содержимое документа.