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.

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:

XML uyarlama teknikleri

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.

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.

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 Değiştirilirken dikkate alınması gerekenler

XML dosyaları değiştirilmeden önce aşağıdaki noktalar dikkate alınmalıdır:

XML eklenti menüsü şeması

Eklenti menülerine ilişkin XML şemasının temel yapısı aşağıdaki gibidir:

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:

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:
  • 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 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.
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>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>
...