Workplace XT işlemlerinin uyarlanması

Beliren menülerden ya da IBM FileNet Workplace XT'nin göz atma ve arama kiplerinden erişilebilen nesneler için, son kullanıcının belirli bir nesne tipi üzerinde gerçekleştirebileceği bir işlemler kümesi sunulur. Örneğin, bir belge nesnesi için kullanılabilecek işlemler, dışarı alma, aşağı yükleme, bileşik belge olarak değiştirme ve taşıma işlemleridir; bir klasör nesnesi için ise, nesne ekleme, taşıma ve silme işlemleri kullanılabilir.

Bir denetimci olarak, Workplace XT kullanıcı arabiriminde görüntülenen nesneler üzerinde gerçekleştirilebilecek işlemleri uyarlayabilirsiniz. Bir işlemin kullanıcı arabiriminden tümüyle kaldırılması gibi, görünüşle ilgili değişiklikler de gerçekleştirebilirsiniz. Ayrıca, süzgeç ölçütlerini kullanarak bir işlemin hangi koşullar altında görüntüleneceğini tanımlayabilirsiniz. Örneğin aşağı yükleme işleminin, kullanıcı belirli bir sınıf tanımına, sürüm durumuna ve içerik tipine sahip belgeleri tıklattığında görüntülemesini sağlayabilirsiniz.

Bu konuda, Workplace XT arabiriminde işlemlerin kullanıcılara sunulduğu yerler ve bu işlemleri yapılandırmak için kullandığınız menü işlemleri tanımlayıcı XML dosyası ele alınmıştır.

NOT  Daha önce Workplace uygulamasında uygulamanın Actions.xml dosyasını değiştirerek işlemleri uyarladıysanız ve Workplace XT'de de aynı uyarlanmış işlemleri kullanmak istiyorsanız, Workplace ile ilgili uyarlamaları Workplace XT Actions.xml dosyasına el ile eklemelisiniz.

Workplace XT kullanıcı arabirimindeki işlemler

İşlemler kullanıcılara beliren menülerde, İşlemler menüsünde, Araçlar menüsünde ve Özellikler bilgi sayfalarında sunulur. (Özellikler bilgi sayfalarındaki ve Çalışma Yerim beliren menülerindeki işlemleri Actions.xml dosyası tanımlar; diğer tüm işlemleri MenuActions.xml dosyası tanımlar.) Beliren menü, kullanıcı liste görünümündeki bir nesneyi ya da yol görünümündeki bir öğeyi farenin sağ düğmesiyle tıklattığında görüntülenir. Kullanılabilecek işlemler, seçilen nesnesinin tipine bağlıdır. Nesnenin Özellikler bilgi sayfasında da aynı işlemler görüntülenir. Kullanıcı liste görünümünde bir ya da daha fazla öğe seçip "İşlemler" düğmesini tıklattığında İşlemler menüsü açılır. Birden çok öğe seçildiyse, menüde yalnızca, seçilen tüm öğeler için geçerli olan işlemler gösterilir.

Workplace XT'de, bağlam menüsünü kullanarak yeni bir işlem gösterebilirsiniz. Bir işlemi İşlemler menüsünde etkinleştirmek için ActionsMenu.js dosyasına özel JavaScript eklemeniz gerekir.

ActionsMenu.js dosyasındaki showActionsMenu işlevinde şu kodu ekleyin:

            if ($("ACTIONS_MENU__işlemtanıtıcısı"))
                validActions.push("işlemtanıtıcısı");

Burada "işlem tanıtıcısı", MenuActions.xml dosyasında belirtildiği şekilde, işleminizin işlem tanıtıcısıdır.

Menü işlemleri tanımlayıcı XML dosyası

MenuActions.xml dosyası, göz atma ve arama kipi için beliren menüde ve çoklu seçim menüsünde görüntülenen işlemlerin tanımlamalarını içerir. Bu dosya <XT_konuşlandırma_yolu>\FileNet\Config\WebClient klasöründe bulunur; burada <XT_konuşlandırma_yolu>, Workplace XT'nin konuşlandırıldığı yoldur. MenuActions.xml dosyası, <XT_konuşlandırma_yolu>\FileNet\WebClient\WorkplaceXT\WEB-INF\xml klasöründe bulunan Workplace Tercihleri XML Şeması Preferences.xsd dosyasını izler.

NOTLAR 

Dosya yapısı

Aşağıdaki listede gösterildiği gibi, MenuActions.xml beş kısımdan oluşur: multiSelectActions, toolbarActions, folderToobarActions, topLevelActions ve actionDefinitions.

topLevelActions dizisinde ve multiSelectActions dizisinde, işlemlerin kullanıcı arabiriminde görüneceği sırayı tanımlarsınız. Yani, topLevelActions dizisindeki değer öğelerinin sırası beliren menüye ve bilgi sayfalarına yansıtılır. multiSelectActions dizisindeki değer öğelerinin sırası ise çoklu seçim menüsüne yansıtılır. İşlemleri açıklama satırı yaparak gizleyebilirsiniz.

multiSelectActions dizisinde yalnızca çoklu seçim işlemlerini belirtebilirsiniz; yani, çoklu seçim işlemlerinin topLevelActions dizisinde listelenmesi gerekmez.

toolbarActions ve folderToolbarActions kısımlarında, belgeler ve klasörler için sisteme göz atılırken ya da arama yapılırken araç çubuğundaki İşlemler düğmesinin yanında görüntülenen araç çubuğu düğmelerini tanımlarsınız. toolbarActions kısmı belgelerle ilgili işlemleri denetler; folderToolbarActions kısmı ise klasörlerle ilgili işlemleri denetler.

actionDefinitions listesi, işlem nesnelerinden oluşur; bunların her biri, işlemin her bir nesne için görüntülenip görüntülenmeyeceğini belirleyen koşulların listesini içerir. Üst düzey bir işlemin alt menü içerebileceğini ve içeriyorsa, üst düzey işlem tanımlamasında bir subActions ayarı bulunması gerektiğini unutmayın. multiSelectActions dizisinde listelenen bir işleme ilişkin tanımlamanın da bir multiSelectURL ayarı içermesi gerektiğini akılda tutun. Tüm ayarlara ilişkin açıklamalar için Menü işlemi tanımlaması ayarları kısmına bakın.

Menü işlemleri tanımlayıcı XML dosyasındaki kısımlar

<object key="actionsConfiguration" version="1.0">
...

  <array key="multiSelectActions">
    <value>download</value>
    <value>checkout</value>
    <value>cancelCheckout</value>
    <value>file</value>
    <value>delete</value>
    <value>assignSecurityPolicy</value>
    <value>sendMail</value>
  </array>
  <array key="toolbarActions">
    <value>download</value>
    <value>checkout</value>
    <value>quickCheckin</value>
    <value>cancelCheckout</value>
    <value>addToFavorites</value>
    <value>infoProperties</value>
    <value>sendMail</value>
  </array>
  <array key="folderToolbarActions">
    <value>addDocument</value>
    <value>addFolder</value>
  </array>
  <array key="topLevelActions">
    <value>view</value> <!-- for documents, publish templates -->
    <value>open</value> <!-- for folders, searches, object stores -->
    <value>download</value>
    <value>checkout</value>
    <value>quickCheckin</value>
    <value>cancelCheckout</value>
    <value>addToFavorites</value>
    <value>removeFavorite</value>
    <value>renameFavorite</value>
    <value>sendMail</value>
    <value>launch</value>
    <value>transfer</value>
    <value>addSubscription</value>
    <value>declareAsRecord</value>
    <value>declareVersionsAsRecord</value>
    <value>testFormTemplate</value>
    <value>modifyDocumentPolicy</value>
    <value>modifyWorkflowPolicy</value>
    <value>takeOffline</value>
    <value>modifyEntryTemplate</value>
    <value>modifyRecordEntryTemplate</value>
    <!-- RM changes start-->
    <value>requestchargeout</value>
    <value>viewDocumentInfo</value>
    <!-- RM changes end -->
    <value>infoProperties</value>
    <value>moreInformation</value>
    <value>documentActions</value>
    <value>folderActions</value>
    <!-- always in the end -->
    <value>addDocument</value>
    <value>addFolder</value>
  </array>

<list key="actionDefinitions">

...

<object key="action">
    <setting key="id">download</setting>
    <setting key="title" localizationKey="server.MenuActions_xml.download">Download…</setting>
    <setting key="url">
       getContent?
       mode=download&amp;
       objectType={OBJECT_TYPE}&amp;
       id={OBJECT_ID}&amp;
       vsId={VERSION_SERIES_ID}&amp;
       objectStoreName={OBJECT_STORE_NAME}&amp;
       returnUrl={RETURN_URL}
    </setting>
    <setting key="multiSelectURL">
       operations/WcmMultiDownloadObject.jsp?
       returnUrl={RETURN_URL}
    </setting>
    <setting key="img">images/action/toolbar/Download23.gif</setting>
    <array key="objectTypes">
       <value>document</value>
    </array>
    <array key="excludedContentTypes">
       <!--RM Change start -->
       <value>application/x-filenet-rm-physicalrecord</value>
       <value>application/x-filenet-rm-electronicrecord</value>
       <value>application/x-filenet-rm-emailrecord</value>
       <!-- RM Change ends -->

<!-- entry template mime types -->
       <value>application/x-filenet-entrytemplate</value>
       <value>application/x-filenet-documententrytemplate</value>
       <value>application/x-filenet-folderentrytemplate</value>
       <value>application/x-filenet-customobjectentrytemplate</value>
       <value>application/x-filenet-formdataentrytemplate</value>
       <value>application/x-filenet-declarerecordentrytemplate</value>
       <value>application/x-filenet-pageentrytemplate</value>
       <value>application/x-filenet-sectionentrytemplate</value>
       <value>application/x-filenet-cfwpageentrytemplate</value>
       <value>application/x-filenet-cfwsectionentrytemplate</value>
       <value>application/x-filenet-cfwtextentrytemplate</value>
       <value>application/x-filenet-localsectionentrytemplate</value>

<!-- wcm mime types -->
       <value>application/x-filenet-sp-cr</value>
       <value>application/x-filenet-sp-target</value>
       <value>application/x-filenet-sp-page</value>
       <value>application/x-filenet-sp-section</value>
       <!-- Form policies -->
       <value>application/x-filenet-documentpolicy</value>
       <value>application/x-filenet-workflowpolicy</value>

<!-- external documents (pointing to an URL) -->
       <value>application/x-filenet-external</value>
    </array>
    <setting key="isPopup">false</setting>
    <setting key="popupHeight">600</setting>
    <setting key="popupWidth">750</setting>
</object>

Menü işlemi tanımlaması ayarları

Aşağıdaki çizelgede, MenuActions.xml dosyasındaki her işlem tanımlaması ayarı açıklanmıştır. Her ayar anahtar özniteliğiyle tanıtılır. Tersi belirtilmiyorsa, ayar isteğe bağlıdır. İsteğe bağlı bir ayar olmadığında varsayılan değeri kullanılır.

URL örüntüsü makroları

Aşağıdaki çizelgede gösterilen makrolar, işlem tanımlamalarına ilişkin url ayarında kullanlır. Bunlar işlemi gerçekleştiren sayfanın URL adresini ve URL adresinde o sayfaya geçirilen değiştirgeleri tanımlar. Gerçek URL adresinde makroların yerine ilgili değer konur. Örneğin, örüntü operations/Test.jsp?id={OBJECT_ID} ve işlemin çağrıldığı nesnenin tanıtıcısı {A73BEEB2-B0B7-11D2-8853-0000F80883E3} ise, işlemin URL adresi şöyle olur: operations/Test.jsp?id={A73BEEB2-B0B7-11D2-8853-0000F80883E3}.

Makro Değer
{OBJECT_STORE_NAME} Nesne deposu adı, örneğin "TEST_OS".
{OBJECT_ID} GUID ya da yol biçiminde nesne tanıtıcısı.
{OBJECT_LABEL} Kullanıcı arabiriminde görüntülendiği şekilde nesne etiketi.
{OBJECT_TYPE} Dizgi olarak nesne tipi; örneğin "document" ya da "folder".
{VERSION_SERIES_ID} ID ya da GUID biçiminde sürüm serisi.
{CLASS_ID} GUID biçiminde sınıf tanıtıcısı.
{CONTENT_TYPE} URL için kodlanmış dizgi olarak içerik tipi.
{MAJOR_VERSION} Ana sürüm; örneğin, "1".
{MINOR_VERSION} İkincil sürüm; örneğin, "2".
{VERSION_STATUS} Sayı olarak sürüm durumu; örneğin, "1".
{RETURN_URL} URL için kodlanmış olarak dönüş URL adresi; örneğin, "http://<sunucu>:<kapı>/WorkplaceXT/Browse.jsf"
{TIME_ZONE} Saat dilimi tanıtıcısı.