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.