Sobre Esta Tarefa
O arquivo content_redir.properties configura redirecionamentos para Java Server Pages (JSP) ou
servlets do Workplace XT ou para aplicativos customizados ou do fornecedor, quando um usuário tenta abrir um arquivo a partir do Workplace XT. Os redirecionamentos baseiam-se no tipo MIME de conteúdo. Este tópico mostra como customizar os redirecionamentos.
A seção a seguir explica como o aplicativo usa o content_redir.properties. Para customizar os redirecionamentos, consulte a seção Modificando o arquivo de propriedades de redirecionamento.
Visão Geral do Redirecionamento de Conteúdo
O
content_redir.properties consiste em pares de chave/valor, em que a chave é um tipo MIME e o valor especifica o componente a ser usado para abrir um arquivo do tipo MIME associado. A listagem a seguir é para o Image Viewer e é usada aqui como exemplo. O exemplo pode ser aplicado a outros aplicativos. Ao examinar a listagem, observe os seguintes pontos:
- O primeiro grupo de pares de chave/valor mapeiam tipos MIME para o Image Viewer. Para aproveitar o recurso de anotações no Image Viewer, é possível editar esse arquivo para especificar quais tipos de imagem são abertas no Image Viewer. A listagem mostra os tipos MIME que são abertos pelo Image Viewer, aqueles com um valor de /WcmJavaViewer.jsp?{QUERY_STRING}. Consulte Trabalhar com o Image Viewer para obter informações adicionais sobre o Image Viewer.
- As chaves no content_redir.properties baseiam-se na propriedade mimeType definida em determinadas classes do Content Engine.
Consulte Sobre os Tipos MIME para obter mais informações.
- Um valor pode incluir macros, como {QUERY_STRING}. As macros disponíveis são documentadas em content_redir.properties.
- Se um tipo MIME não estiver definido em content_redir.properties, o servlet getContent será chamado e responderá de acordo com o tipo de objeto selecionado. Consulte Comportamento Padrão do Servlet getContent, a seguir.
- Para tipos de objetos de documento, o comportamento de redirecionamento é definido adicionalmente por determinadas configurações, que devem ser consideradas se você modificar content_redir.properties. Consulte Interação com outras Configurações, a seguir.
# Coloque como comentário as linhas com tipos MIME para que não sejam abertas pelo applet 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
...
Comportamento Padrão do Servlet getContent
Se um tipo MIME não estiver especificado em
content_redir.properties, o aplicativo chamará o servlet getContent. O comportamento do servlet é determinado pelo tipo de objeto selecionado, conforme listado a seguir.
- Pasta
- Redireciona o cliente para uma página que exibe a pasta.
- Documento
- Se o documento tiver conteúdo, o conteúdo será retornado para o navegador.
- Se o documento tiver uma referência externa, o servlet redirecionará o cliente adequadamente.
- Se o documento não tiver conteúdo, será relatado um erro.
- Documento de Definição de Fluxo de Trabalho
- Redireciona o cliente para o Workflow Designer.
- Procura armazenada
- Redireciona o cliente para uma página que exibe a procura armazenada.
- Modelo de procura
- Redireciona o cliente para uma página que exibe o modelo de procura.
- Modelo de Publicação
- O conteúdo do modelo de publicação é retornado como XML.
Interação com outras Configurações
Além das configurações do arquivo content_redir.properties, uma propriedade oculta em objetos de tipo de documento, que inclui imagens, afeta o comportamento do redirecionamento. Essa propriedade oculta, chamada "IgnoreRedirect" não é configurada por padrão. Ela só pode ser configurada programaticamente ou por meio do Enterprise Manager.
Ao abrir objetos de tipo de documento, o aplicativo examina a propriedade IgnoreRedirect e executa as seguintes ações:
- Se IgnoreRedirect estiver configurado como True, ele envia o documento para o navegador.
- Se IgnoreRedirect estiver configurado como False, ele envia o documento para o componente especificado em content_redir.properties.
- Se IgnoreRedirect não estiver configurado (NULL), ele envia o documento para o componente especificado em content_redir.properties.
Para documentos armazenados em uma biblioteca externa, como a Image Services, há uma preferência do site de serviço externo chamada "Incluir Redirecionamento". Por padrão, essa preferência é configurada como "Yes".
Se for configurada como "Yes", a URL será anexada com a configuração de propriedade IgnoreRedirect na imagem. Consulte Preferências de serviços externos para obter informações adicionais sobre esta preferência.
Ao abrir imagens armazenadas em Image Services, o aplicativo executa as seguintes ações:
- Se "Incluir Redirecionamento" = Yes e a propriedade de documento IgnoreRedirect = true, o aplicativo enviará a imagem para o navegador.
- Se "Incluir Redirecionamento" = Yes e a propriedade de documento IgnoreRedirect
= false, o aplicativo enviará a imagem para o destino especificado em
content_redir.properties.
- Se "Incluir Redirecionamento" = No, a configuração da propriedade IgnoreRedirect
não será incluída na URL e o aplicativo enviará a imagem para o destino especificado em
content_redir.properties.
Modificando o Arquivo de Propriedades de Redirecionamento
É possível customizar os redirecionamentos modificando content_redir.properties. Por exemplo, é possível incluir redirecionamentos em aplicativos do fornecedor, ou comentar a linha de redirecionamentos existentes e permitir que o servlet getContent trate de objetos do tipo MIME comentado.
Nota: Antes de modificar content_redir.properties,
verifique a propriedade IgnoreRedirect e a preferência do site "Incluir Redirecionamento" para os tipos
MIME para os quais você deseja definir redirecionamentos.