Plik content_redir.properties zapewnia konfigurację przekierowań na strony serwera Workplace XT Java™
(JSP, ang. Workplace XT Java Server Pages) lub serwlety, lub do aplikacji niestandardowych lub aplikacji dostawcy, z chwilą, gdy
użytkownik podejmuje próbę otwarcia pliku z poziomu aplikacji Workplace XT. Przekierowania bazują na typie treści MIME. W tym temacie zaprezentowano sposób dostosowywania przekierowań.
W poniższej sekcji wyjaśniono sposób wykorzystania przez aplikację pliku content_redir.properties.
Więcej informacji dotyczących dostosowywania przekierowań zawiera sekcja Modyfikowanie pliku właściwości przekierowań.
Przegląd przekierowań
treści
Plik
content_redir.properties składa się z par klucz/wartość, gdzie klucz jest typu MIME, zaś wartość określa komponent
służący do otwierania pliku o powiązanym typie MIME.
Poniższy listing dotyczy przeglądarki obrazów i służy tutaj jako przykład.
Przykład można zastosować do pozostałych aplikacji. Podczas badania listingu należy zwrócić uwagę na następujące punkty:
- Pierwsza grupa par klucz/wartość odwzorowuje typy MIME na przeglądarkę obrazów. Aby skorzystać z funkcji adnotacji w przeglądarce obrazów, można dokonać edycji tego
pliku w celu określenia, które typy obrazów mogą być otwierane w przeglądarce obrazów. Listing przedstawia typy MIME otwierane za pośrednictwem przeglądarki obrazów,
te, których wartość to /WcmJavaViewer.jsp?{QUERY_STRING}.
Więcej informacji na temat przeglądarki obrazów zawiera sekcja Praca z przeglądarką obrazów.
- Klucze w pliku content_redir.properties bazują na właściwości mimeType zdefiniowanej w określonych klasach silnika treści.
Więcej informacji zawiera sekcja Informacje o typach MIME.
- Wartość może uwzględniać makra, takie jak {QUERY_STRING}.
Dostępne makra są dokumentowane w pliku content_redir.properties.
- Jeśli typu MIME nie zdefiniowano w pliku content_redir.properties, wówczas wywoływany jest serwlet getContent, który odpowiada odpowiednio do
wybranego typu obiektu. Więcej informacji zawiera sekcja Domyślne działanie serwletu getContent poniżej.
- W przypadku obiektów typu dokument działanie przekierowania jest dodatkowo definiowane przez określone ustawienia, które muszą zostać uwzględnione z chwilą
modyfikacji pliku content_redir.properties. Więcej informacji zawiera sekcja
Interakcje z pozostałymi ustawieniami poniżej.
# Comment the lines with MIME types to not be opened by the Image Viewer applet
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
...
Domyślne działanie serwletu getContent
Jeśli dla
content_redir.properties nie podano typu MIME,
wówczas aplikacja wywołuje serwlet getContent. Działanie serwletu jest zdeterminowane przez typ wybranego obiektu, zgodnie z poniższą listą.
- Folder
- Przekierowuje klienta na stronę, na której wyświetlany jest folder.
- Dokument
- Jeśli dokument zawiera treść, jest ona zwracana w przeglądarce.
- Jeśli dokument zawiera odniesienie do dokumentu zewnętrznego, serwlet przekierowuje klienta odpowiednio do potrzeb.
- Jeśli dokument nie zawiera treści, zgłaszany jest błąd.
- Dokument definicji przepływu pracy
- Przekierowuje klienta do Projektanta przepływu pracy.
- Zapisane wyszukiwanie
- Przekierowuje klienta na stronę, na której wyświetlane jest zapisane wyszukiwanie.
- Szablon wyszukiwania
- Przekierowuje klienta na stronę, na której wyświetlany jest szablon wyszukiwania.
- Szablon publikowania
- Zwraca szablon publikowania w formacie XML.
Interakcja z pozostałymi ustawieniami
Poza ustawieniami w pliku
content_redir.properties ukryta właściwość w obiektach typu dokument zawierających obrazy, wpływa na działanie przekierowywania. Ta ukryta
właściwość, zwana „IgnoreRedirect”, nie jest ustawiana domyślnie. Może być ona ustawiana wyłącznie programowo lub za pośrednictwem menedżera Enterprise Manager.
Podczas otwierania obiektów typu dokument aplikacja wyszukuje właściwość IgnoreRedirect i wykonuje następujące działania:
- Jeśli właściwość IgnoreRedirect ma wartość True, dokument jest wysyłany do przeglądarki.
- Jeśli właściwość IgnoreRedirect ma wartość False, dokument jest wysyłany do komponentu określonego w pliku content_redir.properties.
- Jeśli właściwość IgnoreRedirect nie jest ustawiona (NULL), dokument jest wysyłany do komponentu określonego w pliku content_redir.properties.
W przypadku dokumentów zapisanych w bibliotece zewnętrznej, np. Image Services, istnieje preferencja serwisu usług zewnętrznych o nazwie „Uwzględnij przekierowanie”. Domyślnie
ta preferencja ma wartość „Tak”. W przypadku ustawienia wartości „Tak” adres URL jest dopisywany do ustawienia właściwości IgnoreRedirect dla obrazu. Więcej
informacji na temat tej preferencji zawiera sekcja Preferencje usług zewnętrznych.
Podczas otwierania obrazów zapisanych w Image Services aplikacja wykonuje następujące
działania:
- Jeśli „Uwzględnij przekierowanie” = Tak, zaś właściwość dokumentu IgnoreRedirect = True, aplikacja wysyła obraz do przeglądarki.
- Jeśli „Uwzględnij przekierowanie” = Tak, zaś właściwość dokumentu IgnoreRedirect = False, aplikacja wysyła obraz do miejsca docelowego określonego w pliku
content_redir.properties.
- Jeśli „Uwzględnij przekierowanie” = Nie, właściwość dokumentu IgnoreRedirect nie jest uwzględniona w adresie URL, zaś aplikacja wysyła obraz miejsca docelowego
określonego w pliku content_redir.properties.
Modyfikowanie pliku właściwości przekierowania
Istnieje
możliwość dostosowania przekierowań przez modyfikację pliku content_redir.properties.
Można na przykład dodać przekierowania do aplikacji dostawcy lub przekształcić w komentarz istniejące przekierowania i zezwolić serwletowi getContent na obsługę obiektów
przekształconych w komentarz typu MIME.
Uwaga: Przed przystąpieniem do modyfikowania pliku content_redir.properties należy sprawdzić właściwość
IgnoreRedirect oraz preferencję „Uwzględnij przekierowanie” dla typów MIME, dla których mają zostać zdefiniowane przekierowania.