İçerik yeniden yönlendirme özellikleri

Workplace XT JSP'lerine (Java™ Server Pages) ya da sunucu uygulamacıklarına ya da özel uygulamalara ya da üretici firma uygulamalarına yeniden yönlendirmeleri content_redir.properties dosyası yapılandırır. Yeniden yönlendirmeler içeriğin MIME tipine dayalıdır. Bu konuda, yeniden yönlendirmeleri nasıl uyarlayacağınız ele alınmıştır. Aşağıdaki kısım, uygulamanın content_redir.properties dosyasını nasıl kullandığını açıklamaktadır. Yeniden yönlendirmeleri uyarlamak için Yeniden yönlendirme özellikleri dosyasının değiştirilmesi kısmına bakın.

İçerik yeniden yönlendirmeye genel bakış

content_redir.properties dosyası anahtar/değer çiftlerinden oluşur; anahtar bir MIME tipidir; değer, ilişkilendirilmiş MIME tipindeki bir dosyayı açmak için kullanılacak bileşeni belirtir. Aşağıdaki listeleme Image Viewer içindir ve burada örnek olarak kullanılmıştır. Bu örnek diğer uygulamalara uygulanabilir. Listelemeyi incelerken aşağıdaki noktaları dikkate alın:

# Image Viewer ile açılmayacak MIME tiplerini içeren satırları açıklama satırı yapın
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
...

getContent sunucu uygulamacığının varsayılan davranışı

Bir MIME tipi content_redir.properties dosyasında belirtilmediyse, uygulama getContent sunucu uygulamacığını çağırır. Sunucu uygulamacığının davranışını, aşağıda listelendiği gibi, seçilen nesnenin tipi belirler.

Diğer ayarlarla etkileşim

Yeniden yönlendirme davranışını, content_redir.properties dosyası ayarlarına ek olarak, belge tipi nesnelerine ilişkin gizlenmiş bir özellik de etkiler; bu özellik, görüntüleri içerir. "IgnoreRedirect" adlı bu gizlenmiş özellik, varsayılan olarak ayarlı değildir. Yalnızca programsal olarak ya da Enterprise Manager ile ayarlanabilir.

Belge tipi nesneleri açılırken, uygulama IgnoreRedirect özelliğine bakar ve aşağıdaki işlemleri gerçekleştirir:

Image Services gibi bir dış kitaplıkta saklanan belgeler için, "Yeniden Yönlendirmeyi İçer" adlı bir dış hizmet site tercihi vardır. Varsayılan olarak bu tercih "Evet" değerine ayarlıdır. "Evet" değerine ayarlı olduğunda, URL adresinin sonuna görüntüye ilişkin IgnoreRedirect özelliği ayarı eklenir. Bu tercihle ilgili ek bilgi için Dış site tercihleri başlıklı konuya bakın.

Image Services olanağında saklanan görüntüler açılırken, uygulama aşağıdaki işlemleri gerçekleştirir:

Yeniden yönlendirme özellikleri dosyasının değiştirilmesi

Yeniden yönlendirmeleri, content_redir.properties dosyasında değişiklik yaparak uyarlayabilirsiniz. Örneğin, yeniden yönlendirmeleri üretici firma uygulamalarına ekleyebilirsiniz ya da var olan yeniden yönlendirmeleri açıklama satırı yapabilir ve açıklama satırı yapılan MIME tipindeki nesneleri getContent sunucu uygulamacığının işlemesine izin verebilirsiniz.

NOT  content_redir.properties dosyasını değiştirmeden önce, yeniden yönlendirme tanımlamak istediğiniz MIME tipleri için IgnoreRedirect özelliğini ve "Yeniden Yönlendirmeyi İçer" site tercihini denetleyin.

Yeniden yönlendirme özellikleri dosyasını değiştirmek için

  1. Bir metin düzenleyicisiyle content_redir.properties dosyasını açın. Varsayılan olarak, bu dosya aşağıdaki yerde kuruludur:
    Workplace XT: <install_location>/FileNet/Config/WebClient
  2. özellikleri istediğiniz gibi değiştirin.
    • Var olan bir MIME tipi eşlemesini kaldırmak için, ilgili anahtar ve değer çiftini başına # simgesi koyarak açıklama satırı yapın; örneğin, #image/pjpeg=/WcmJavaViewer.jsp?{QUERY_STRING}.
    • MIME tipi eşlemesi eklemek için, bir Content Engine sınıfında tanımlı bir mimeType özelliği değerinin karşılığı olan bir anahtarı kullanarak, bir anahtar ve değer çifti girin. Değer, uygulama diziniyle göreli olarak, uygulamadaki bir JSP sayfasının ya da sunucu uygulamacığının yolunu belirtmelidir.

      Makroları kullanarak, seçilen nesnenin URL sorgusu dizgisini anahtar ve değer çiftinde belirtilen bileşene geçirebilirsiniz. Örneğin, tüm sorgu dizgisini geçirmek için {QUERY_STRING} makrosunu ekleyebilirsiniz. Ya da {OBJECT_TYPE}, {OBJECT_ID} ve diğer makroları kullanarak, sorgu dizgisindeki her bir değiştirgeyi geçirebilirsiniz. Makroların tam listesi için content_redir.properties dosyasına bakın.

    • Bir MIME tipini bir üretici firma uygulaması ya özel uygulama ile eşlemek için, uygulama içinde dış uygulamaya yönlendiren bir bileşeni belirtmelisiniz. Örneğin, aşağıdaki Workplace anahtar ve değer çiftinde, bir kullanıcı MIME tipi "text/x-speech" olan bir dosya seçerse, Workplace Workplace/redirect/customAppRedirect.jsp'ye yönlendirir.

      text/x-speech =/redirect/customAppRedirect.jsp?{QUERY_STRING}

      Bir dış uygulamaya yeniden yönlendirmek için, JSP yeniden yönlendirme kodu aşağıdaki satır kadar basit olabilir:

      <%response.sendRedirect("http://hostServer:8080/customWebApp"+request.getParameter("vsId"));%>

      Ancak genellikle, bir dış uygulamaya yeniden yönlendirme mantığı daha karmaşıktır; URL adresini, değiştirgerleri, güvenlik simgesini ve dış uygulamanın gerektirdiği diğer değerleri döndürmek için Workplace XT ile aynı temel API'lar kullanılır.

  3. content_redir.properties dosyasını saklayın.
  4. Yeni ayarlarınızın yürürlüğe girmesi için web sunucunuzu yeniden başlatın.