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.
İş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.
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.
NOTLARAş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.
<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&
objectType={OBJECT_TYPE}&
id={OBJECT_ID}&
vsId={VERSION_SERIES_ID}&
objectStoreName={OBJECT_STORE_NAME}&
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>
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.
Anahtar | Ayar | Değer |
---|---|---|
baseURLKey |
<setting key="baseURLKey"> |
Bu ayar varsa, Workplace XT'nin temel URL adresi (varsayılan değer) yerine Records Manager uygulamasının temel URL adresi kullanılır. Geçerli olan tek değer "rm" değeridir. |
classes |
<array key="classes"> |
Bu işlem için geçerli olan sınıfların listesini
tanımlar. Değerler GUID biçiminde olmalıdır. İşlem yalnızca,
listelenen sınıflar için kullanılabilir. NOT Bu ayar varsa excludedClasses ayarını tanımlamayın. |
contentTypes |
<array key="contentTypes"> |
Bu işlem için geçerli olan Mime tiplerinin ve taşıyıcı tiplerinin listesini
tanımlar. İşlem yalnızca, belirtilen içerik tiplerindeki
nesneler için kullanılabilir. Bu ayar yoksa, işlem tüm içerik tipleri için kullanılabilir. Bu ayarın değerleri "*" ve "?" genel arama karakterlerini destekler. "*" herhangi bir sayıda (0 karakter de içinde olmak üzere) anlamına gelir. "?" tek bir karakter anlamına gelir. NOT Bu ayar varsa excludedContentTypes ayarını tanımlamayın. |
excludedClasses |
<array key="excludedClasses"> |
Bu işlem için geçerli olmayan sınıfların listesini
tanımlar. Değerler GUID biçiminde olmalıdır. İşlem,
listelenen sınıflar için kullanılamaz. NOT Bu ayar varsa classes ayarını tanımlamayın. |
excludedContentTypes |
<array key="excludedContentTypes"> |
Bu işlem için geçerli olmayan Mime tiplerinin ve taşıyıcı tiplerinin listesini
tanımlar. İşlem, listelenen içerik tiplerinde olmayan tüm
nesneler için kullanılabilir. Bu ayarın değerleri de "*" ve "?" genel
arama karakterlerini destekler. NOT Bu ayar varsa contentTypes ayarını tanımlamayın. |
excludedObjectTypes |
<array key="excludedObjectTypes"> |
Bu işlem için geçerli olmayan nesne tiplerinin listesini
tanımlar. NOT Bu ayar varsa objectTypes ayarını tanımlamayın. |
favoritesOnly |
<setting key="favoritesOnly"> |
Değer true ise, işlem yalnızca Sık Kullanılanlar sayfasında görüntülenir. Varsayılan değer false'tır. |
hideBasedOnVersionStatusConditions |
<setting key="hideBasedOnVersionStatusConditions"> |
Değer true (varsayılan değer) ise, işlemin sayfada
görüntülenip görüntülenmeyeceğini nesnenin sürüm durumu
belirler. Bu anahtar yalnızca promoteVersion ve
demoteVersion işlem tanımlamaları için geçerlidir. Varsayılan değer false'tır. |
hideForFavorites |
<setting key="hideForFavorites"> |
Değer true ise, Sık Kullanılanlar sayfasında bu işlem görüntülenmez.
Bu anahtar yalnızca addToFavorites işlem
tanımlamaları için geçerlidir. Varsayılan değer false'tır. |
hideForVersions |
<setting key="hideForVersions"> |
Değer true ise, bilgi sayfalarında bir nesnenin sürümü için bu işlem gösterilmez. Yani, bir nesneye ilişkin bir bilgi sayfasından "Sürümler" özellik sayfasına gittikten sonra belirli bir nesnenin bilgi sayfasına giderseniz, işlem görüntülenmez. Varsayılan değer true'dur. |
hideInSitePreferences |
<setting key="hideInSitePreferences"> |
Değer true ise, Site Tercihleri kullanıcı arabiriminde bu işlem görüntülenmez. Varsayılan değer false'tır. |
hideWhenCheckedOut |
<setting key="hideWhenCheckedOut"> |
Değer true ise, belge dışarı alındığında bu işlem gösterilmez. Varsayılan değer false'tır. |
id |
<setting key="id"> |
Bir işleme ilişkin benzersiz bir tanıtıcıyı tanımlar. Değer belirtilmesi gereklidir. |
img |
<setting key="img"> |
İşlemin simgesini tanımlar. Bu ayar gerekli değildir. Değer, 16x16 piksel boyutlu bir görüntüye ilişkin geçerli bir
yol olmalıdır. NOT url ile benzer şekilde, göreli bir yol kullanabilirsiniz. |
isPopup |
<setting key="isPopup"> |
Değer true ise, bir nesne seçildiğinde bu işlem yeni bir pencerede açılır. Varsayılan değer false'tır. |
multiSelectPopupHeight |
<setting key="multiSelectPopupHeight"> |
Yeni pencerenin piksel olarak yüksekliğini tanımlar. isPopup false değerine ayarlıysa
ya da multiSelectURL
kullanılmıyorsa bu ayar yoksayılır. Varsayılan değer 600'dür. |
multiSelectPopupWidth |
<setting key="multiSelectPopupWidth"> |
Yeni pencerenin piksel olarak genişliğini tanımlar. isPopup false değerine ayarlıysa
ya da multiSelectURL
kullanılmıyorsa bu ayar yoksayılır. Varsayılan değer 800'dür. |
multiSelectURL |
<setting key="multiSelectURL"> |
Çoklu seçim URL adresini tanımlar. Bu ayar, çoklu seçim
işlemini gerçekleştiren sayfanın URL adresini tanımlar. Çoklu
seçimi destekleyen her işlem için bu ayar gereklidir. İşlem,
MenuActions.xml dosyasının multiSelectActions
kısmına eklenmelidir. |
objectTypes |
<array key="objectTypes"> |
Bu işlem için geçerli olan nesne tiplerinin listesini
tanımlar. Bu ayar yoksa, tüm nesne tipleri geçerlidir. Geçerli değerler şunlardır: - objectstore NOT Bu ayar varsa excludedObjectTypes ayarını tanımlamayın. |
onclick |
<setting key="onclick"> |
Kullanıcı kullanıcı arabiriminde işlemi tıklattığında çağrılacak olay işlemini tanımlar. |
popupHeight |
<setting key="popupHeight"> |
Yeni pencerenin piksel olarak yüksekliğini tanımlar. isPopup false değerine ayarlıysa
bu ayar yoksayılır. Varsayılan değer 600'dür. |
popupWidth |
<setting key="popupWidth"> |
Yeni pencerenin piksel olarak genişliğini tanımlar. isPopup false değerine ayarlıysa
bu ayar yoksayılır. Varsayılan değer 800'dür. |
renderSeparatorAbove |
<setting key="renderSeparatorAbove"> |
Değer true ise, bu işlem işlem listesinin üstüne ayırıcı bir çizgi çizer. Varsayılan değer false'tır. |
returnParameters |
<setting key="returnParameters"> |
İşlemin işlenmesi tamamlanınca içerilecek URL değiştirgelerini tanımlar. Bazı durumlarda, bir işlem tamamlandıktan sonra ana sayfanın yenilenmesini sağlayan bir düzenek olarak kullanılır. |
rmHideIfAlreadyDeclared |
<setting key="rmHideIfAlreadyDeclared"> |
Değer true ise, bu işlem yalnızca, belge kayıt olarak
bildirilmediğinde görüntülenir. Varsayılan değer false'tır. NOT Bu ayar, Site Tercihleri'nde Records Manager seçildiyse geçerlidir. |
rmOnly |
<setting key="rmOnly"> |
Değer true ise, bu işlem yalnızca, Site Tercihleri'nde Records Manager seçildiyse görüntülenir. Varsayılan değer false'tır. |
roles |
<array key="roles"> |
Bu işlem için geçerli olan erişim rollerinin listesini
tanımlar. İşlemi yalnızca, listelenen rollerden birinin ya da
daha fazlasının üyesi olan kullanıcılar görebilir. Erişim
rolleri Content Engine olanağında tanımlanır. Varsayılan değer "Everyone" değeridir. NOT Rolleri Site Tercihleri'nin İşlem Rolü Erişimi sayfasında da ayarlayabilirsiniz. |
shortId |
<array key="shortId"> |
İşlemin kısa tanıtıcısını tanımlar. NOT Yalnızca araç çubuğunda ve İşlemler düğmesinde kullanılabilir. |
showInActionsMenuOnly |
<setting key="showInActionsMenuOnly"> |
Değer true ise, Belge Ekle, İleri Düzey Belge Ekle ve Klasör Ekle işlemleri yalnızca İşlemler menüsünde (seçilen öğenin beliren menülerinde değil) görüntülenir. Varsayılan değer false'tır. |
showOnlyWhenCheckedOut |
<setting key="showOnlyWhenCheckedOut"> |
Değer true ise, bu işlem yalnızca belge dışarı alındığında gösterilir. Varsayılan değer false'tır. |
subActions |
<array key="subActions"> |
Bir alt menüde görüntülenen işlemleri tanımlar. subActions dizisindeki her değer için bir
actionDefinition tanımlamanız gerektiğini unutmayın.NOT Tek bir alt menü düzeyiniz olabilir; subActions dizisinde listelenen işlemlerin kendi alt menüleri olamaz. |
title |
<setting key="title"> |
İşlemin kullanıcı arabiriminde görüntülenen etiketini tanımlar. Bu ayar gereklidir. |
titleForSitePreferences |
<setting key="titleForSitePreferences"> |
Site Tercihleri'nin İşlem Rolü Erişimi sayfasında işlem
görüntülendiğinde gösterilen başlık. Bu ayar içerilmezse,
title ayarının değeri kullanılır. |
url |
<setting key="url"> |
İşlemi gerçekleştiren sayfanın URL adresini ve URL
adresinde o sayfaya geçirilen değiştirgeleri tanımlar. Bu
dizginin biçimi URL örüntüsü
makroları kısmında açıklanmıştır. Bu ayar gereklidir. |
useToken |
<setting key="useToken"> |
Değer true ise, yeniden yönlendirmeden önce URL adresinin sonuna bir kullanıcı simgesi eklenir. Bu yalnızca, site tercihlerinde simge desteği seçildiyse gerçekleşir. Varsayılan değer false'tır. |
versionStatusConditions |
<array key="versionStatusConditions"> |
İşlem için geçerli olan sürüm durumu değerlerini
tanımlar. Bu ayar yoksa, her sürüm durumu değeri geçerlidir. Geçerli değerler şunlardır: - released Ana sürüm içeren bir sürüm serisi için inprocess
değerini kullanın. Ana sürüm içermeyen bir sürüm serisi için inprocessNoMajor
değerini kullanın. Bu değerlerle ilgili bilgi edinmek için Sürüm oluşturma özellikleri konusuna bakın. |
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ı. |