IBM FileNet P8, Sürüm 5.2            

İç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:
  • İlk anahtar/değer çiftleri MIME tiplerini Image Viewer ile eşler. Image Viewer uyugulamacığındaki ek açıklamalar özelliğinden yararlanmak için, bu dosyayı düzenleyerek, Image Viewer'da hangi görüntü tiplerinin açılacağını belirtebilirsiniz. Bu listeleme, Image Viewer ile açılan MIME tiplerini (/WcmJavaViewer.jsp?{QUERY_STRING} değeri) göstermektedir. Image Viewer ile ilgili ek bilgi için bkz. Image Viewer ile çalışma.
  • content_redir.properties dosyasındaki anahtarlar, bazı Content Engine sınıflarında tanımlı olan mimeType özelliğine dayalıdır. Ek bilgi için MIME tipleri hakkında başlıklı konuya bakın.
  • Bir değer, {QUERY_STRING} gibi makrolar içerebilir. Kullanılabilir makrolar content_redir.properties dosyasında belgelenir.
  • Bir MIME tipi content_redir.properties dosyasında tanımlı değilse, getContent sunucu uygulamacığı çağrılır ve bu sunucu uygulamacığı seçilen nesne tipine göre karşılık verir. Aşağıda, getContent sunucu uygulamacığının varsayılan davranışı başlıklı kısma bakın.
  • Belge nesnesi tipleri için, yeniden yönlendirme davranışı ayrıca bazı ayarlarla da tanımlanır; content_redir.properties dosyasını değiştirirseniz bunları da dikkate almanız gerekir. Aşağıda, Diğer ayarlarla etkileşim başlıklı kısma bakı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.
Klasör
İstemciyi, klasörü görüntüleyen bir sayfaya yönlendirir.
Belge
Belgenin içeriği varsa, içerik tarayıcıya gönderilir.
Belgenin dış başvurusu varsa, sunucu uygulamacığı istemciyi uygun şekilde yönlendirir.
Belgenin içeriği yoksa hata bildirilir.
İş Akışı Tanımlaması Belgesi
İstemciyi Workflow Designer olanağına yönlendirir.
Saklanmış Arama
İstemciyi, saklanmış aramayı görüntüleyen bir sayfaya yönlendirir.
Arama Şablonu
İstemciyi, arama şablonunu görüntüleyen bir sayfaya yönlendirir.
Yayınlama Şablonu
Yayınlama şablonunun içeriği XML olarak döndürülür.

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:
  • IgnoreRedirect True olarak ayarlıysa, belgeyi tarayıcıya gönderir.
  • IgnoreRedirect False olarak ayarlıysa, belgeyi content_redir.properties dosyasında belirtilen bileşene gönderir.
  • IgnoreRedirect ayarlı değilse (NULL), belgeyi content_redir.properties dosyasında belirtilen bileşene gönderir.

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" (Yes) 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 bkz. Dış hizmetler tercihleri.

Image Services olanağında saklanan görüntüler açılırken, uygulama aşağıdaki işlemleri gerçekleştirir:
  • "Yeniden Yönlendirmeyi İçer" = Evet ve belge özelliği IgnoreRedirect = true ise, uygulama görüntüyü tarayıcıya gönderir.
  • "Yeniden Yönlendirmeyi İçer" = Evet ve belge özelliği IgnoreRedirect = false ise, uygulama görüntüyü content_redir.properties dosyasında belirtilen hedefe gönderir.
  • "Yeniden Yönlendirmeyi İçer" = No ise ve IgnoreRedirect özelliği ayarı URL'ye eklenmediyse, uygulama görüntüyü content_redir.properties dosyasında belirtilen hedefe gönderir.

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

content_redir.properties dosyasını değiştirerek, yeniden yönlendirmeleri 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ştirgeleri, 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.


Geribildirim

Son güncelleme: Mart 2013
aeadm_config_file_content_redir.htm

© Copyright IBM Corp. 2013.
Bu bilgi merkezi Eclipse teknolojisiyle güçlendirilmiştir. (http://www.eclipse.org)