IBM FileNet P8 Application Integration, Microsoft® Outlook, Word, Excel ve PowerPoint uygulamalarının Dosya, Araya Ekle ve Yardım beliren menülerini uyarlama desteği sağlar. Application Integration, bu uygulamaları özel eklenti (Add-In) menüleri ekleyerek genişletmek için COM Eklentileri'ni kullanır. Geliştiriciler, Application Integration olanağının menü içeriğini Microsoft uygulamaları için yapılandırmak üzere kullandığı bilgileri içeren XML dosyalarını kullanarak bu özel menüleri değiştirebilirler.
Application Integration kurulduktan sonra, geliştiriciler eklenti menülerini uygulama gereksinmelerine göre uyarlamak için XML dosyalarının içeriğini el ile değiştirebilirler. Böylece uyarlanan XML dosyaları kuruluştaki diğer sistemlere kopyalanarak, belirli bir kullanıcı ya da kullanıcı sınıfı için uygulama ortamını ve özellik kullanılabilirliğini denetleme olanağı elde edilir. Belirli bir uygulama için yeni bir değişiklik gerektiğinde, ilgili XML dosyaları güncellenerek ilgili sistemlere yeniden kopyalanabilir.
Aşağıdaki kısımlarda, var olan eklenti menüleri ele alınmış ve menülerin değiştirilmesiyle ilgili yönergeler ve dikkate alınması gereken noktalar belirtilmiştir:
Geliştiriciler eklenti menülerini aşağıdaki gibi uyarlayabilir:
Uyarlanacak öğe... | Açıklama |
---|---|
Görünürlük | Menüde görünmesi gereken Application Integration komutlarını ve beliren alt menülerini belirtir. Bu teknik, belirli bir özelliğin kullanılabilirliğini denetlemek için, bir alt menünün ya da komutun bir menüden tümüyle kaldırılmasına olanak sağlar. |
Durumu Etkinleştir | Görünmesi gereken, ancak geçersiz kılınmış olan (gri renkte görüntülenen) Application Integration komutlarını ve beliren alt menüleri belirtir. Bu teknik, geliştiricilere belirli bir menünün açılıp açılmayacağını ya da bir komutun yürütülüp yürtülmeyeceğini denetleme olanağı verir. |
Etiket ya da Başlık | Kullanıcıya görüntülenmesi gereken biçimde, Application Integration komutlarının ve beliren alt menülerinin etiketlerini ya da başlıklarını belirtir. Örneğin, geliştiriciler "Geri Ver" komutunu "Belgeyi Sakla" olarak değiştirebilir ya da belirli komutları "Yazma" adlı bir alt menüde gruplayabilirler. |
Komut İşlemi | Bir Application Integration komutu seçildiğinde gerçekleştirilmesi gereken
Application Integration işlemini belirtir. NOT Üretici firma komutlarını belirtemezsiniz. |
Menü Sıradüzeni | Menüdeki Application Integration komutlarının düzenini (komutların sırası ve beliren alt menü klasör sıradüzeni içinde bulunup bulunmadığı da içinde olamk üzere) belirtir. |
Application Integration kuruluşu sırasında XML dosyaları kuruluş dizinine yazılır (varsayılan dizin şöyledir: C:\Program Files\FileNet\AppInt\). Desteklenen Microsoft uygulamalarından biri açıldığında, Application Integration kuruluş dizininde ilgili XML dosyasını arar ve o uygulamaya ilişkin eklenti menüsünü XML dosyasındaki belirtimlere göre yapılandırır. Application Integration XML dosyalarını kuruluş dizininde bulamazsa, dosyaları Module dizininden toplamayı dener. (Module dizini genel olarak Microsoft Office uygulamalarının saklandığı yerdir ve varsayılan olarak şurada bulunur: C:\Program Files\Microsoft Office\Office.)
DİKKAT Geliştiriciler XML dosyalarının içeriğini değiştirebilirler; ancak, Application Integration olanağının eklenti menülerini yapılandırmak üzere bu XML dosyalarını bulabilmesi ve kullanabilmesi için, XML dosyası adları değiştirilmemeli ve bu dosyalar kuruluş dizininde ya da module dizininde bulunmalıdır.
Aşağıdaki çizelge XML dosyalarının adlarını, her XML dosyasını etkilediği Microsoft Office uygulamalarını ve her uygulamanın desteklenen sürümlerini göstermektedir.
XML dosyası adı | İlgili uygulama | Desteklenen sürümler |
---|---|---|
FnAppIntExcelMenus.xml | Excel | 2003, XP, 2007 |
FnAppIntOutlookMenus.xml | Outlook Explorer (öğeye göz atma penceresi) Outlook Inspector (öğe düzenleme penceresi) |
2003, XP, 2007 |
FnAppIntPowerPointMenus.xml | PowerPoint | 2003, XP, 2007 |
FnAppIntWordMenus.xml | Word | 2003, XP, 2007 |
XML dosyaları değiştirilmeden önce aşağıdaki noktalar dikkate alınmalıdır:
Eklenti menülerine ilişkin XML şemasının temel yapısı aşağıdaki gibidir:
addInMenusConfiguration
- şemadaki en üst düzey nesne; izleyen XML
nesnelerinin bir uygulamaya ilişkin eklenti menülerini tanımladığını belirtir. Bu nesne,
kullanılacak şemanın sürümünü de (version
) belirtir. applicationName
- eklenti menülerinin yapılandırılacağı hedef uygulamayı tanıtır. applicationVersion
- hedef uygulamanın desteklenen sürümlerini belirtir. addInMenusDefinition
- her addInMenusConfiguration
nesnesi, uygulama için her eklenti menüsünün (Dosya, Araya Ekle, Yardım) nasıl
yapılandırılması gerektiğini belirten nesneleri içeren bir nesneden (uygulama
Microsoft Outlook ise, birden fazla nesneden) oluşur. Bu nesne, yaratılması gereken
eklenti menüsünün tipini de (type
) belirtir. Application Integration şu
tipleri destekler: Word, Excel ve PowerPoint için main
, Outlook
için explorer
ve inspector
.addInMenuItem
- her addInMenusDefinition
nesnesi, her
menü için alt menü sıradüzeni ve komut düğmesi davranışını tanımlayan bir ya da daha
fazla nesneden oluşur. Bu tanımlama, popup
ya da button
olarak
ayarlanabilecek itemType
etiketiyle sağlanır.
itemType="popup"
(beliren menü) olduğunda, addInMenuItem
nesnesi
kendi addInMenuItem
alt nesnelerinin listesini (list
)
içerebilir ve dolayısıyla bir alt menüsü yapısı yaratma olanağı sağlar. Bu sıradüzenli
yapı, kuruluşunuzun gereksinmelerine göre, herhangi bir derinliğe kadar yinelenebilir.itemType="button"
(düğme) olduğunda, yalnızca popup
menü öğelerinin alt menü öğeleri olabileceği için, XML yapısı sonlanır. setting
- her addInMenuItem
nesnesi (popup
ya da button
), alt menünün ya da düğmenin görünüşünü ve davranışını
tanımlayan (örneğin, menü öğesinin tanımı, görünür etiket ya da başlık, menü ekleme
konumu ve menü öğesi açıldığında ya da seçildiğinde yürütülecek Application Integration
işlemi) setting
etiketlerini içerir. Setting
etiketleri kısmında, setting
etiketlerine ilişkin tüm ayrıntıları bulabilirsiniz.Bu etiketlerin XML şemasında nasıl kullanıldığını gösteren bir örnek için Örnek XML şeması kısmına bakın.
Her addInMenuItem
nesnesi, eklenti menüsü alt menülerinin ya da komut
düğmelerinin görüşünü ve davranışını tanımlamak için setting
etiketlerini
kullanır. Etiketin sözdizimi, tanımlanacak anahtara (key
) bağlıdır. Örneğin,
bazı key
'ler type
alanını gerektirirken, diğerleri bu alanı
gerektirmez:
<setting key="itemType">popup</setting>
<setting key="parent" type="menuId">30002</setting>
Aşağıdaki çizelgede, bir key
type
alanının kullanılmasını ya
da bir değer belirtilmesini gerektirmiyorsa, Tip ya da
Değer kolonunda "Burada geçerli değil" girişi yer almaktadır. key
değeri tanınan bir Application Integration değişkeni
(popup
ya da button
gibi) değilse, Değer
kolonundaki giriş italik yazı tipiyle belirtilmiştir; örneğin, 30002
.
Ayrıca, bir key
gerekli değilse, Açıklama kolonundaki giriş
[İsteğe bağlı] göstergesini içerir.
Application Integration aşağıdaki setting
etiketlerini destekler:
Anahtar | Tip | Değer | Açıklama |
---|---|---|---|
itemType |
Burada geçerli değil | popup |
Eklenti menüsü öğesinin, komut düğmeleri ve ek beliren alt menüleri içerebilecek, alt öğeleri bulunan bir beliren alt menü olduğunu gösterir. |
Burada geçerli değil | button |
Eklenti menüsü öğesinin, alt öğeleri olmayan bir komut düğmesi olduğunu gösterir. | |
description |
Burada geçerli değil | P8 Dosya menüsü | [İsteğe bağlı] Eklenti menüsü öğesinin bir tanımını sağlar; bu tanım yalnızca bilgi verme amacına yöneliktir, kullanıcıya görünmez. |
label |
enum |
eOpenSubMenuName |
Aşağıdaki listeleme değişmezlerinden birini kullanarak, eklenti menüsü öğesinin görünen
etiketini ya da başlığını belirtir:
|
resourceID |
119 | Kaynak yerelleştirme dosyasındaki bir kaynak tanıtıcısının karşılığı olan bir tamsayı değerini belirterek, eklenti menüsü öğesinin görünen etiketini ya da başlığını sağlar. | |
text |
Checkin... | Gerçek metin dizgisini belirterek, eklenti menüsü öğesinin görünen etiketini ya da başlığını sağlar. | |
visible |
Burada geçerli değil | true |
Eklenti menüsü öğesinin (ve menü öğesi beliren alt menüyse, alt öğelerin) kullanıcı için görünür olduğunu belirtir. |
false |
Eklenti menüsü öğesinin (ve menü öğesi beliren alt menüyse, alt öğelerin) kullanıcı için görünür olmadığını belirtir (bu durumda, menü öğesi Eklenti menüsünde görünmez). | ||
enabled |
Burada geçerli değil | true |
Eklenti menüsü öğesinin etkinleştirildiğini ve dolayısıyla, kullanıcının beliren alt menüyü açabileceğini ya da komut düğmesini seçebileceğini belirtir. |
False |
Eklenti menüsü öğesinin kullanıcı tarafından açılamayacağını ya da seçilemeyeceğini belirtir (yeni, eklenti menüsünde bu menü öğesi geçersiz kılınmıştır). | ||
parent |
menuId |
30002 | Eklenti menüsü öğesinin üst menüsünün "menuId" değerini belirtir. Menü öğesi beliren alt menüyse, bu değer tipik olarak, var olan bir Microsoft Office beliren menüsünün denetim tanıtıcısıdır. Microsoft Office uygulamalarındaki menü tanıtıcılarıyla ilgili ek bilgi için Microsoft Office Developers Guide for Office 2003/XP/2007 belgesine bakın. |
topLevel |
Burada geçerli değil | Eklenti menüsü öğesi beliren alt menüyse, bu anahtar ve tip çifti, alt menünün uygulamanın en üst düzey menü çubuğuna yerleştirildiğini gösterir. NOT Bu anahtar ve tip çifti yalnızca beliren alt menüler için geçerlidir. | |
Burada geçerli değil | Burada geçerli değil |
Eklenti menüsü öğesi bir komut düğmesiyse, belirtilen XML dosyasında <list
key="children"> etiketi kullanılarak üst öğe örtük olarak belirtilir. Bu nedenle, XML dosyasındaki bu setting yerinde üst öğe belirtimi gerekli
değildir. NOT Bu anahtar ve tip çifti yalnızca komut düğmeleri için geçerlidir. |
|
location |
Burada geçerli değil | 4 |
Bu eklenti menüsü öğesinin üst menüye eklendiği konumu belirtir. -1 değeri,
menü öğesinin var olan menünün sonuna eklendiğini gösterir. NOT Bu değer, üst beliren menüde menü öğesi için istenen konumu gösterir. |
command |
standard |
OfficeAdd-In. |
Kullanıcı bir komut düğmesini seçtiğinde gerçekleştirilecek Application Integration
işlemini belirtir. Aşağıdaki listeleme değişmezlerinden biri belirtilebilir:
|
standard |
Burada geçerli değil | Eklenti menüsü öğesi beliren alt menüyse, menü tıklatmaları yoksayılır. Bu
nedenle, XML dosyasındaki bu setting yerinde komut belirtimi gerekli
değildir. NOT Bu anahtar ve tip çifti yalnızca beliren alt menüler için geçerlidir. |
Bu etiketlerin XML şemasında nasıl kullanıldığını gösteren bir örnek için Örnek XML şeması kısmına bakın.
Aşağıdaki kod parçası, Excel uygulamasına ilişkin eklenti menülerinin temel XML şeması yapısını göstermektedir:
<?xml version="1.0" ?> <!-- IBM FileNet P8 Application Integration 4.0 Excel Add-In Menus--> <!-- Add-In Menus - Configuration Info --> <object key="addInMenusConfiguration" version="1.0"> <setting key="applicationName">Excel</setting> <array key="applicationVersion"> <value>2003</value> <value>XP</value> <value>2007</value> </array> <!-- Add-In Menus - Main Menu Definitions --> <object key="addInMenusDefinition" type="main"> <list key="children"> <!-- P8 File Menu --> <object key="addInMenuItem"> <setting key="itemType">popup</setting> ... <list key="children"> <!-- Open Document SubMenu --> <object key="addInMenuItem"> <setting key="itemType">popup</setting> <setting key="description">Submenu of commands for opening documents.</Setting>
<setting key="label" type="text">Open Document</setting> <setting key="visible">true</setting> <setting key="enabled">true</setting> <setting key="location">3</setting> <setting key="command" type="standard"></setting>
<list key="children"> <!-- Open Document - My Checkouts... Button --> <object key="addInMenuItem"> <setting key="itemType">button</setting>
... <list key="children" /> </object> <!-- Open Document - Select Item... Button --> <object key="addInMenuItem"> <setting key="itemType">button</setting> ... <list key="children" /> </object> </list> <list key="children" /> </object> <!-- Add Document SubMenu --> <object key="addInMenuItem"> <setting key="itemType">popup</setting> ... <list key="children" /> </object> ... <!-- Add Folder... Button --> <object key="addInMenuItem"> <setting key="itemType">button</setting> <setting key="description">Performs the Add Folder Wizard</setting>
<setting key="label" type="enum">eAddFolderButtonName</setting> <setting key="visible">true</setting> <setting key="enabled">true</setting> <setting key="parent" type="menuId">30002</setting> <setting key="location">1</setting> <setting key="command" type="standard">OfficeAdd-In.AddFolderUseAddWizard</setting> <list key="children" /> </object> ... </list> <list key="children" /> </object> <!-- P8 Insert Menu --> <object key="addInMenuItem"> <setting key="itemType">popup</setting> ... <list key="children"> ... </list> <list key="children" /> </object> <!-- P8 Help Menu --> <object key="addInMenuItem"> <setting key="itemType">popup</setting> ... <list key="children"> ... </list> <list key="children" /> </object> </list> </object> </object> ...