Propriedades de redirecionamento de conteúdo

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.

Procedimento

Para modificar o arquivo de propriedades de redirecionamento

  1. Abra content_redir.properties com um editor de texto. Por padrão, o arquivo está instalado no seguinte local:
    Workplace XT: <install_location>/FileNet/Config/WebClient
  2. Modifique as propriedades, conforme desejado.
    • Para remover um mapeamento do tipo MIME existente, comente a linha do par de chave e valor aplicável com um símbolo # inicial; por exemplo, #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • Para incluir um mapeamento de tipo MIME, insira um par de chave e valor com uma chave que correspondo a um valor de propriedade mimeType definido em uma classe do Content Engine. O valor deve especificar um caminho para uma página ou um servlet JSP no aplicativo, em relação ao diretório de aplicativo.

      Usando macros, é possível passar a sequência de consultas URL do objeto selecionado para o componente especificado no par de valor e chave. Por exemplo, é possível incluir a macro {QUERY_STRING} para passar a sequência de consultas inteira. Ou é possível passar parâmetros individuais da sequência de consultas com {OBJECT_TYPE}, {OBJECT_ID} e outras macros. Consulte o arquivo content_redir.properties para obter uma lista completa de macros.

    • Para mapear um tipo MIME para um aplicativo customizado ou do fornecedor, você deve especificar um componente no aplicativo que redirecione para o aplicativo externo. Por exemplo, no seguinte par de chave e valor do Workplace, o Workplace seria redirecionado para Workplace/redirect/customAppRedirect.jsp se um usuário selecionasse um arquivo com um tipo MIME de "text/x-speech".
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      Para redirecionar para um aplicativo externo, o código de redirecionamento JSP pode ser tão simples quando a linha a seguir.
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      Geralmente, no entanto, a lógica de redirecionamento para um aplicativo externo é mais envolvida, usando as mesmas APIs de base que o Workplace XT, para retornar a URL, os parâmetros, o token de segurança e qualquer outro valor requerido pelo aplicativo externo.

  3. Salve content_redir.properties.
  4. Reinicie o servidor da Web para que suas configurações sejam efetivadas.