В файле 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, для которых вы хотите задать перенаправления.