IBM FileNet P8, Sürüm 5.2            

Dosya, Araya Ekle ve Yardım eklenti menülerinin uyarlanması

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.

XML uyarlama teknikleri

Geliştiriciler eklenti menülerini aşağıdaki gibi uyarlayabilir:
Çizelge 1. Bir eklenti menüsünün uyarlanabileceği yolları listeler ve açıklar.
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.

XML dosyalarının adı ve yeri

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.
Çizelge 2. Her XML dosyası adını, ilgili Microsoft Office uygulamalarını ve bu uygulamaların desteklenen sürümlerini listeler.
XML dosyası adı İlgili uygulama Desteklenen sürümler
FnAppIntExcelMenus.xml Excel 2003, 2007, 2010
FnAppIntOutlookMenus.xml Outlook Explorer (öğeye göz atma penceresi)

Outlook Inspector (öğe düzenleme penceresi)

2003, 2007, 2010
FnAppIntPowerPointMenus.xml PowerPoint 2003, 2007, 2010
FnAppIntWordMenus.xml Sözcük 2003, 2007, 2010

XML değiştirilirken dikkate alınması gerekenler

XML dosyaları değiştirilmeden önce aşağıdaki noktalar dikkate alınmalıdır:
  • XML dosyaları salt okunur olarak kurulmakla birlikte, geliştiriciler dosya izinlerini değiştirerek bu dosyaları okunabilir ve yazılabilir kılabilirler.
  • IBM tarafından verilen XML dosyaları, eklenti menülerinin ve içeriklerinin belirtilmesi için doğru sözdizimini ve kullanımı sağlar. Geliştiriciler bu dosyalardaki XML biçimlemesini ve değiştirge sözdizimini yakından izlemelidirler. Buna ek olarak, herhangi bir değişiklik yapmadan önce özgün XML dosyalarını yedekleyebilirler. Bu işlem, değiştirilen dosyalardaki sözdizimi hatalarının bulunup çözülmesine yardımcı olur.
  • Application Integration, eklenti menülerini yapılandırmak için, XML dosyalarını kuruluş dizininde ada göre arar. 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.
  • Application Integration olanağının her kuruluşunda (düzeltme paketleri de içinde olmak üzere), özgün XML dosyaları kuruluş dizinine yazılır. Sonuç olarak, uyarlanmış XML dosyalarının üzerine yazılabilir. Bu nedenle, geliştiriciler değiştirdikleri XML dosyalarının yedek kopyalarını alabilir ve benzersiz dosya adları kullanarak bu dosyaları benzersiz bir klasöre saklayabilirler. Böylece, uyarlanmış XML dosyaları gerektiğinde hızla geri yüklenebilir.

XML eklenti menüsü şeması

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" olduğunda, addInMenuItem nesnesi kendi addInMenuItem alt nesnelerinin listesini (list) içerebilir ve dolayısıyla bir alt menü yapısı yaratma olanağı sağlar. Bu sıradüzenli yapı, kuruluşunuzun gereksinmelerine göre, herhangi bir derinliğe kadar yinelenebilir.
    • itemType="button" 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.

Setting etiketleri

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:
Çizelge 3. Her anahtarı, tipini, değerini ve tanımını listeler.
Anahtar Tür 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:
  • eFileMenuName
  • eOpenButtonName
  • eOpenSubMenuName
  • eOpenMyCheckoutsButtonName
  • eOpenSelectItemButtonName
  • eAddDocumentButtonName
  • eAddDocumentSubMenuName
  • eAddDocumentUseWizardButtonName
  • eAddDocumentSelectTemplateButtonName
  • eAddFolderButtonName
  • eCheckinSubMenuName
  • eCheckinQuickButtonName
  • eCheckinUseWizardButtonName
  • eTasksMyInboxButtonName
  • eSaveButtonName
  • eCancelCheckoutButtonName
  • ePropertiesButtonName
  • eLogoffButtonName
  • eInsertMenuName
  • eInsertButtonName
  • eInsertHyperlinkButtonName
  • eInsertPropPageButtonName
  • eInsertPropertyButtonName
  • eRefreshPropertyButtonName
  • eDeletePropertyButtonName
  • eHelpButtonName
  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 doğru 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 doğru 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.
yeri 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.
OpenSelection
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:
  • OfficeAdd-In.AddFolderUseAddWizard
  • OfficeAdd-In.OpenMyCheckouts
  • OfficeAdd-In.OpenSelectItem
  • OfficeAdd-In.AddDocumentUseAddWizard
  • OfficeAdd-In.AddDocumentSelectTemplate
  • OfficeAdd-In.CheckinDocumentUseCheckinWizard
  • OfficeAdd-In.CheckinDocumentQuickCheckin
  • OfficeAdd-In.Save
  • OfficeAdd-In.CancelCheckout
  • OfficeAdd-In.GetInfo
  • OfficeAdd-In.TasksMyInbox
  • OfficeAdd-In.Logoff
  • OfficeAdd-In.Help
  • OfficeAdd-In.InsertItem
  • OfficeAdd-In.InsertProperty
  • OfficeAdd-In.RefreshProperties
  • OfficeAdd-In.DeleteProperties
  • OfficeAdd-In.InsertHyperlink
  • OfficeAdd-In.InsertPropertiesPage
  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.

Örnek XML şeması

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>2007</value>
 <value>2010</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>
...


Geribildirim

Son güncelleme: Mart 2013
overview_addin_menus.htm

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