IBM FileNet P8, Wersja 5.1.+            

Właściwości przekierowań treści

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.

Aby zmodyfikować plik właściwości przekierowania

  1. Otwórz plik content_redir.properties w edytorze tekstu. Domyślnie plik jest instalowany w następującej lokalizacji:
    Workplace XT: <lokalizacja_instalacji>/FileNet/Config/WebClient
  2. Zmodyfikuj właściwości odpowiednio do potrzeb.
    • Aby usunąć istniejące odwzorowanie typu MIME, przekształć w komentarz odpowiednią parę klucz/wartość, korzystając z umieszczanego przed odwzorowaniem symbolu #; na przykład #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • Aby dodać odwzorowanie typu MIME, wprowadź parę klucz/wartość, w której klucz odpowiada wartości właściwości mimeType zdefiniowanej w klasie silnika treści. Wartość musi określać ścieżkę do strony JSP lub serwletu w aplikacji, względną wobec katalogu aplikacji.

      Korzystając z makr, można przekazać łańcuch zapytań URL wybranego obiektu do komponentu określonego w parze klucz/wartość. Można na przykład uwzględnić makro {QUERY_STRING} w celu przekazania całego łańcucha zapytania. Lub można przekazać poszczególne parametry z łańcucha zapytania wraz z makrem {OBJECT_TYPE}, {OBJECT_ID} i innymi. Pełną listę makr zawiera plik content_redir.properties.

    • Aby odwzorować typ MIME na aplikację dostawcy lub aplikację niestandardową, należy określić komponent w ramach aplikacji, przekierowujący do aplikacji zewnętrznej. Na przykład, w poniższej parze klucz/wartość aplikacji Workplace nastąpi przekierowanie do pliku Workplace/redirect/customAppRedirect.jsp, o ile użytkownik wybrał plik o typie MIME „text/x-speech”.
      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}
      Aby możliwe było wykonanie przekierowania do aplikacji zewnętrznej, kod przekierowania JSP może być niezwykle prosty, zgodnie z przykładem w poniższym wierszu.
      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      Zwykle jednak logika przekierowania do aplikacji zewnętrznej jest bardziej skomplikowana i wykorzystuje te same podstawowe interfejsy API co aplikacja Workplace XT, w celu zwrócenia adresu URL, parametrów, znacznika bezpieczeństwa oraz wszelkich innych wartości wymaganych przez aplikację zewnętrzną.

  3. Zapisz plik content_redir.properties.
  4. Zrestartuj serwer WWW, aby nowe ustawienia odniosły skutek.


Opinia

Data ostatniej aktualizacji: Lipiec 2011


© Copyright IBM Corp. 2011.
To centrum informacyjne jest oparte na technologii Eclipse. (http://www.eclipse.org)