IBM FileNet P8, Versie 5.2            

Eigenschappen contentomleiding

Het bestand content_redir.properties configureert omleidingen naar Java Server Pages (JSP) of servlets van Workplace XT, of naar aangepaste toepassingen of toepassingen van derden, wanneer een gebruiker een bestand probeert te openen vanuit Workplace XT. Omleidingen zijn gebaseerd op het MIME-type van de content. In dit onderwerp wordt afgebeeld hoe de omleidingen kunnen worden aangepast. In de volgende sectie wordt uitgelegd hoe de toepassing content_redir.properties gebruikt. Om omleidingen aan te passen, bekijkt u de sectie Het bestand voor omleidingseigenschappen wijzigen.

Overzicht van contentomleiding

Het bestand content_redir.properties bestaat uit sleutel/waarde-paren, waarbij de sleutel een MIME-type is en de waarde de component opgeeft die moet worden gebruikt om een bestand te openen van het gekoppelde MIME-type. De onderstaande lijst is voor Image Viewer en wordt hier gebruikt als voorbeeld. Het voorbeeld kan worden toegepast op andere toepassingen. Let bij het bekijken van de lijst op de volgende punten:
  • De eerste groep met sleutel/waarde-paren wijzen MIME-typen toe aan de Image Viewer. Om gebruik te maken van de functie toelichting in Image Viewer, kunt u dit bestand bewerken om aan te geven welke typen afbeeldingen kunnen worden geopend in Image Viewer. In de lijst worden de MIME-typen afgebeeld die worden geopend door de Image Viewer, die met de waarde /WcmJavaViewer.jsp?{QUERY_STRING}. Zie Werken met Image Viewer voor meer informatie over Image Viewer.
  • Sleutels in content_redir.properties zijn gebaseerd op de eigenschap mimeType die is gedefinieerd in bepaalde Content Engine-klassen. Zie Informatie over MIME-typen.
  • Een waarde kan macro's bevatten, zoals {QUERY_STRING}. De beschikbare macro's worden gedocumenteerd in content_redir.properties.
  • Als een MIME-type niet is gedefinieerd in content_redir.properties, wordt de servlet getContent opgeroepen en reageert deze volgens het geselecteerde objecttype. Zie Standaardgedrag van de servlet getContent hieronder.
  • Voor documentobjecttypen wordt de omleiding ook bepaald door bepaalde instellingen waar u rekening mee dient te houden als u content_redir.properties wijzigt. Zie Interactie met andere instellingen hieronder.
# Zet een commentaarteken voor de regels met MIME-typen die niet moeten worden geopend door de 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
...

Standaardgedrag van de servlet getContent

Als een MIME-type niet is opgegeven in content_redir.properties, roept de toepassing de servlet getContent op. Het gedrag van de servlet wordt bepaald door het type object dat wordt geselecteerd, zoals hieronder is afgebeeld.
Map
Hiermee wordt de client naar een pagina doorgestuurd waarop de map wordt afgebeeld.
Document
Als het document content heeft, wordt de content geretourneerd naar de browser.
Als het document een externe verwijzing heeft, stuurt de server de client juist door.
Als het document geen content heeft wordt een fout gemeld.
Document werkstroomdefinitie
Hiermee wordt de client doorgestuurd naar de werkstroomontwerper.
Opgeslagen zoekactie
Hiermee wordt de client naar een pagina doorgestuurd waarop de opgeslagen zoekactie wordt afgebeeld.
Zoeksjabloon
Hiermee wordt de client naar een pagina doorgestuurd waarop de zoeksjabloon wordt afgebeeld.
Sjabloon publiceren
De content van het publicatiesjabloonwordt geretourneerd als XML.

Interactie met andere instellingen

Naast de instellingen van het bestand content_redir.properties wordt het omleidingsgedrag beïnvloed door een verborgen eigenschap op documenttype-objecten, met inbegrip van afbeeldingen. Deze verborgen eigenschap, genaamd "IgnoreRedirect", wordt standaard niet ingesteld. Het kan alleen programmatisch of via Enterprise Manager worden ingesteld.

Bij het openen van documenttype-objecten kijkt de toepassing naar de eigenschap IgnoreRedirect en worden de volgende acties uitgevoerd:
  • Als IgnoreRedirect ingesteld op Waar, wordt het document doorgestuurd naar de browser.
  • Als IgnoreRedirect ingesteld op Onwaar, wordt het document doorgestuurd naar de component die is opgegeven in content_redir.properties.
  • Als IgnoreRedirect niet is ingesteld (NULL), wordt het document doorgestuurd naar de component die is opgegeven in content_redir.properties.

Voor documenten die zijn opgeslagen in een externe bibliotheek, zoals Image Services, is er een sitevoorkeur voor externe services genaamd "Omleiding opnemen". Standaard wordt deze voorkeur ingesteld op "Ja". Als dit wordt ingesteld op "Ja", wordt aan de URL de instelling toegevoegd voor de eigenschap IgnoreRedirect voor de afbeelding. Zie Voorkeuren externe services voor meer informatie over deze voorkeur.

Bij het openen van afbeeldingen die zijn opgeslagen in Image Services, voert de toepassing de volgende acties uit:
  • Als "Include Redirect" = Ja, en de documenteigenschap IgnoreRedirect = waar, stuurt de toepassing de afbeelding naar de browser.
  • Als "Include Redirect" = Ja, en de documenteigenschap IgnoreRedirect = onwaar, stuurt de toepassing de afbeelding naar de bestemming die is opgegeven in content_redir.properties.
  • Als "Include Redirect" = Nee wordt de eigenschap IgnoreRedirect niet opgenomen in de URL en stuurt de toepassing de afbeelding naar de bestemming die is opgegeven in content_redir.properties.

Het bestand met omleidingseigenschappen wijzigen

U kunt de omleidingen aanpassen door content_redir.properties te wijzigen. Bijvoorbeeld, u kunt omleidingen toevoegen aan toepassingen van derden, of uw bestaande omleidingen uitschakelen met commentaartekens en toestaan dat de getContent-servlet objecten beheert van het uitgeschakelde MIME-type.

Opmerking: Controleer voor het wijzigen van content_redir.properties de eigenschap IgnoreRedirect en de sitevoorkeur "Include Redirect" voor de MIME-typen waarvoor u omleidingen wilt definiëren.

Het bestand met omleidingseigenschappen wijzigen

  1. Open content_redir.properties met een editor. Standaard wordt het bestand geïnstalleerd op de volgende locatie:
    Workplace XT: <locatie_installatie>/FileNet/Config/WebClient
  2. Wijzig de eigenschappen naar wens.
    • Om een bestaande toewijzing van een MIME-type te verwijderen, schakelt u het juiste sleutel- en waardepaar uit met een #-teken aan het begin van de regel; bijvoorbeeld #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • Om een toewijzing voor een MIME-type toe te voegen, voegt u een sleutel- en waardepaar in, met een sleutel die overeenkomt met een eigenschapswaarde van een mimeType die is gedefinieerd in een Content Engine-klasse. De waarde moet een pad opgeven naar een JSP-pagina of servlet in de toepassing, relatief aan de toepassingsdirectory.

      Met macro's kunt u de URL-queryreeks van het geselecteerde object doorgeven aan de component die is opgegeven in het sleutel- en waardepaar. Bijvoorbeeld, u kunt de macro {QUERY_STRING} opnemen om de gehele queryreeks door te geven. Of u kunt afzonderlijke parameters doorgeven vanaf de queryreeks met {OBJECT_TYPE}, {OBJECT_ID} en andere macro's. Bekijk het bestand content_redir.properties voor een volledige lijst met macro's.

    • Om een MIME-type toe te wijzen aan een toepassing van derden of een aangepaste toepassing, moet u een component opgeven binnen de toepassing die doorverwijst naar de externe toepassing. Bijvoorbeeld, in het volgende sleutel- en waardepaar voor Workplace, wordt Workplace doorgestuurd naar Workplace/redirect/customAppRedirect.jsp als een gebruiker een bestand selecteert met het MIME-type "text/x-speech".
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      Om naar een externe toepassing door te sturen, kan de JSP-omleiding zo eenvoudig zijn als de volgende regel.
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      Meestal is de doorverwijzing naar een exterme toepassing echter meer ingewikkeld, waarbij dezelfde basis-API' s als Workplace XT worden gebruikt om de URL, parameters, de beveiligingstoken en andere waarden die door de externe toepassing worden vereist te retourneren.

  3. Sla content_redir.properties op.
  4. Herstart de webserver zodat uw nieuwe instellingen van kracht worden.


Feedback

Laatst bijgewerkt: Maart 2013
aeadm_config_file_content_redir.htm

© Copyright IBM Corp. 2013.
Dit informatiecentrum maakt gebruik van Eclipse-technologie. (http://www.eclipse.org)