Свойства перенаправления содержимого

Об этой задаче

В файле content_redir.properties сконфигурированы перенаправления на страницы Java Server Pages (JSP) или в сервлеты Workplace XT либо в приложения заказчика или поставщика, когда пользователь пытается открыть файл из Workplace XT. Перенаправления основаны на типах MIME содержимого. В этом разделе показано, как настроить перенаправления. В следующем разделе рассказывается, как приложение использует файл content_redir.properties. Чтобы узнать, как настроить перенаправления, смотрите раздел Изменение файла свойств перенаправления.

Обзор перенаправления содержимого

Файл content_redir.properties содержит пары ключ-значение, где ключ представляет собой тип MIME, а значение задает компонент, который следует использовать для открытия файла со связанным типом MIME. Представленный ниже список предназначен для компонента Image Viewer и используется здесь в качестве примера. Этот пример можно распространить на другие приложения. При изучении этого списка обратите внимание на следующее:
  • Первая группа пар ключ-значение отображает типы MIME в Image Viewer. Чтобы воспользоваться преимуществами функции аннотаций в Image Viewer, вы можете изменить этот файл, указав, какие типы изображений открываются в Image Viewer. Для показанных в списке типы MIME, которые открываются в Image Viewer, задано значение /WcmJavaViewer.jsp?{QUERY_STRING}. Более подробную информацию об апплете Image Viewer смотрите в разделе Работа с Image Viewer.
  • Ключи в файле content_redir.properties основаны на свойстве mimeType, заданном в некоторых классах Content Engine. Дополнительную информацию смотрите в разделе Типы MIME.
  • Значение может включать в себя макросы, например, {QUERY_STRING}. Доступные макросы документированы в файле content_redir.properties.
  • Если тип MIME не задан в файле content_redir.properties, будет вызван сервлет getContent, который отреагирует в соответствии с типом выбранного объекта. Смотрите ниже раздел Поведение по умолчанию для сервлета getContent.
  • В случае типов объектов документов порядок перенаправления дополнительно обусловлен некоторыми параметрами, которые следует иметь в виду, если вы будете изменять файл content_redir.properties. Смотрите ниже раздел Взаимодействие с другими параметрами.
# Закомментируйте строки с типами MIME, которые не должен открывать апплет Image Viewer
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", не используется по умолчанию. Его можно задать только программным образом или через Enterprise Manager.

При открытии объектов типа Документ приложение ищет свойство IgnoreRedirect и выполняет следующие действия:
  • Если для свойства IgnoreRedirect задано значение True, отправляет документ в браузер.
  • Если для свойства IgnoreRedirect задано значение False, отправляет документ в компонент, указанный в файле content_redir.properties.
  • Если свойствоIgnoreRedirect не задано (NULL), отправляет документ в компонент, указанный в файле content_redir.properties.

В случае документов, хранящихся во внешней библиотеке, например, Image Services, существует предпочтение сайта внешней службы "Включить перенаправление". По умолчанию, для этого предпочтения задано значение "Да". Если для него задано значение "Да", URL присоединяется к значению свойства IgnoreRedirect для изображения. Более подробную информацию об этом предпочтении смотрите в разделе Предпочтения сайта для внешних служб.

При открытии изображений, хранящихся в Image Services, приложение выполняет следующие действия:
  • Если для опции "Включить перенаправление" задано значение Да, а для свойства документа IgnoreRedirect задано значение true, приложение отправит изображение в браузер.
  • Если для опции "Включить перенаправление" задано значение Да, а для свойства документа IgnoreRedirect задано значение false, приложение отправит изображение в пункт назначения, указанный в файле content_redir.properties.
  • Если для опции "Включить перенаправление" задано значение Нет, значение свойства IgnoreRedirect не будет включено в URL, и приложение отправит изображение в пункт назначения, указанный в файле content_redir.properties.

Внесение изменений в файл свойств перенаправления:

Вы можете настроить перенаправления, внеся изменения в файл content_redir.properties. Например, вы можете добавить перенаправления в приложения поставщика или закомментировать существующие перенаправления, разрешив сервлету getContent обрабатывать объекты с закомментированным типом MIME.

Прим.: Прежде чем вносить изменения в файл content_redir.properties, проверьте значение свойства IgnoreRedirect и предпочтение сайта "Включить перенаправление" для типов MIME, для которых вы хотите задать перенаправления.

Процедура

Чтобы изменить свойства перенаправления:

  1. Откройте файл content_redir.properties в текстовом редакторе. По умолчанию, этот файл установлен в следующем каталоге:
    Workplace XT: <каталог_установки>/FileNet/Config/WebClient
  2. Измените свойства нужным вам образом.
    • Чтобы удалить существующее отображение типа MIME, закомментируйте применимую пару ключ-значение, добавив символ # в начало строки; например, #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • Чтобы добавить отображение типа MIME, введите пару ключ-значение, в которой ключ будет соответствовать значению свойства mimeType, заданному в классе Content Engine. Значение должно задавать путь страницы JSP или сервлета в приложении относительно каталога приложения.

      Используя макросы, вы можете передать строку запроса URL для выбранного объекта компоненту, указанному в пате ключ-значение. Например, вы можете включить макрос {QUERY_STRING}, чтобы передать всю строку запроса. Либо вы можете передавать отдельные параметры из строки запроса, используя макросы {OBJECT_TYPE}, {OBJECT_ID} и т.д. Полный список макросов смотрите в описании файла content_redir.properties.

    • Чтобы отобразить тип MIME в приложение поставщика или заказчика, нужно указать компонент в приложении, который осуществляет перенаправление во внешнее приложение. Например, в приведенной ниже паре ключ-значение для Workplace компонент Workplace выполнит перенаправление на страницу Workplace/redirect/customAppRedirect.jsp, если пользователь выберет файл с типом MIME "text/x-speech".
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      Для перенаправления во внешнее приложение код перенаправления JSP может быть таким простым, как в следующей строке:
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      Однако, как правило, алгоритм перенаправления во внешнее приложение более сложен; в нем используются те же базовые API, что и в Workplace XT, чтобы возвратить URL, параметры, маркер защиты и любые другие значения, необходимые внешнему приложению.

  3. Сохраните файл content_redir.properties.
  4. Перезапустите веб-сервер, чтобы новые значения вступили в силу.