Add-in-Menüs 'Datei', 'Einfügen' und 'Hilfe' anpassen

IBM FileNet P8 Application Integration stellt die Unterstützung zum Anpassen der Popup-Menüs Datei, Einfügen und Hilfe von Microsoft® Outlook, Word, Excel und PowerPoint bereit. Application Integration verwendet COM-Add-ins, um diese Anwendungen zu erweitern, indem benutzerdefinierte Add-in-Menüs hinzugefügt werden. Anwendungsentwickler können diese benutzerdefinierten Menüs ändern, indem Sie die bereitgestellten XML-Dateien verwenden, die Informationen enthalten, mit denen Application Integration die Menüinhalte für die Microsoft Anwendungen konfiguriert.

Nachdem Application Integration installiert wurde, können Anwendungsentwickler die Inhalte der XML-Dateien manuell ändern, um die Add-in-Menüs an die Anforderungen ihrer Anwendungen anzupassen. Die angepassten XML-Dateien können anschließend in andere Systeme der Organisation kopiert werden, um eine Möglichkeit bereitzustellen, die Anwendungsumgebung und die Verfügbarkeit von Features für einen bestimmten Benutzer oder eine bestimmte Benutzergruppe zu steuern. Immer wenn eine neue Änderung für eine bestimmte Anwendung erforderlich ist, kann die entsprechende XML-Datei aktualisiert und erneut in die entsprechenden Systeme kopiert werden.

In den folgenden Abschnitten werden die vorhandenen Add-in-Menüs beschrieben und Anweisungen zum Ändern sowie Aspekte der Änderungen bereitgestellt:

XML-Anpassungsverfahren

Anwendungsentwickler können die Add-in-Menüs wie folgt anpassen:

Anpassen von... Beschreibung
Anzeige Geben Sie die Befehle und Popup-Untermenüs von Application Integration an, die im Menü angezeigt werden sollen. Dieses Verfahren ermöglicht es Ihnen, ein Untermenü oder einen Befehl vollständig aus einem Menü zu entfernen, um die Verfügbarkeit eines bestimmten Features zu steuern.
Aktivierungsstatus Geben Sie die Befehle und Popup-Untermenüs von Application Integration an, die im Menü angezeigt werden sollen, die jedoch inaktiviert (abgeblendet) sein sollen. Dieses Verfahren ermöglicht es den Anwendungsentwicklern, zu steuern, ob ein bestimmtes Menü geöffnet oder ein Befehl ausgeführt werden kann.
Bezeichnung oder Titel Geben Sie die Bezeichnungen oder Titel für die Befehle und Untermenüs von Application Integration so an, wie Sie dem Benutzer angezeigt werden sollen. So kann beispielsweise ein Anwendungsentwickler den Befehl "Checkin" in "Dokument speichern" umbenennen oder bestimmte Befehle in einem Untermenü namens "Authoring" gruppieren.
Befehlsaktion Geben Sie an, welche Application Integration-Aktion ausgeführt werden soll, wenn ein Application Integration-Befehl ausgewählt wird.

HINWEIS   Sie können keine Herstellerbefehle angeben.

Menühierarchie Geben Sie die Anordnung der Application Integration-Befehle im Menü an, einschließlich der Reihenfolge der Befehle und ob sie in einer Ordnerhierarchie eines Popup-Untermenüs enthalten sein sollen.

Namen und Position von XML-Dateien

Während der Installation von Application Integration werden die XML-Dateien in das Installationsverzeichnis geschrieben (das Standardverzeichnis ist C:\Programme\FileNet\AppInt\). Immer wenn eine der unterstützten Microsoft Anwendungen geöffnet wird, sucht Application Integration nach der entsprechenden XML-Datei im Installationsverzeichnis und konfiguriert das Add-in-Menü für die betreffende Anwendung anhand der in der XML-Datei enthaltenen Angaben. Wenn Application Integration die XML-Dateien im Installationsverzeichnis nicht findet, versucht das Programm die Dateien aus dem Modulverzeichnis zu erfassen. (Das Modulverzeichnis ist das Verzeichnis, in dem die Microsoft Office Anwendungen in der Regel installiert werden, standardmäßig ist das C:\Programme\Microsoft Office\Office.)

VORSICHT  Anwendungsentwickler können zwar den Inhalt der XML-Dateien ändern, die Namen der XML-Dateien dürfen jedoch nicht geändert werden und die Dateien müssen sich im Installations- oder Modulverzeichnis befinden, damit Application Integration die XML-Dateien zum Konfigurieren der Add-in-Menüs lokalisieren und verwenden kann.

Die folgende Tabelle gibt die Namen der XML-Dateien an, die Microsoft Office Anwendungen, auf die sich die einzelnen XML-Dateien beziehen, und die unterstützten Versionen für jede Anwendung.

XML-Dateiname Entsprechende Anwendung Unterstützte Versionen
FnAppIntExcelMenus.xml Excel 2003, XP, 2007
FnAppIntOutlookMenus.xml Outlook Explorer (Elementsuchfenster)
Outlook Inspector (Elementeditierfenster)
2003, XP, 2007
FnAppIntPowerPointMenus.xml PowerPoint 2003, XP, 2007
FnAppIntWordMenus.xml Word 2003, XP, 2007

Aspekte von XML-Änderungen

Die folgenden Punkte sollten Sie in Betracht ziehen, bevor Sie die XML-Dateien ändern:

XML-Add-in-Menüschema

Die Basisstruktur des XML-Schemas für die Add-in-Menüs sieht folgendermaßen aus:

Ein Beispiel zur Verwendungsweise dieser Tags im XML-Schema finden Sie in XML-Beispielschema.

Einstellungstags

Jedes Objekt addInMenuItem verwendet die Tags setting, um die Darstellung und das Verhalten der Untermenüs und Befehlsschaltflächen von Add-in-Menüs zu definieren. Die Syntax für den Tag hängt davon ab, welcher Schlüssel (key) definiert wird. So ist beispielsweise für einige keys das Feld type erforderlich, für andere nicht:

<setting key="itemType">popup</setting>

<setting key="parent" type="menuId">30002</setting>

Wenn in der folgenden Tabelle für einen Schlüssel (key) die Verwendung des Felds type oder ein angegebener Wert nicht erforderlich ist, enthält die Spalte Typ oder Wert den Eintrag "Nicht zutreffend". Ist der Wert für key keine bekannte Application Integration-Variable, wie popup oder button, wird der Eintrag in der Spalte Wert in Kursivschrift dargestellt, zum Beispiel 30002. Ist key nicht erforderlich, enthält der Eintrag in der Spalte Beschreibung den Vermerk [Optional].

Application Integration unterstützt die folgenden setting-Tags.

Schlüssel Typ Wert Beschreibung
itemType Nicht zutreffend popup Gibt an, dass das Add-in-Menü ein Popup-Untermenü mit untergeordneten Elementen ist, die Befehlsschaltflächen und weitere Popup-Untermenüs einschließen können.
  Nicht zutreffend button Gibt an, dass der Add-in-Menüpunkt eine Befehlsschaltfläche ohne untergeordnete Elemente ist.
Beschreibung Nicht zutreffend P8-Menü 'Datei' [Optional] Stellt eine informelle Beschreibung für den Add-in-Menüpunkt zur Verfügung, die für den Benutzer nicht sichtbar ist.
label enum eOpenSubMenuName Stellt die sichtbare Bezeichnung oder den Titel für den Add-in-Menüpunkt bereit, indem eine der folgenden Aufzählungskonstanten verwendet werden:
  • 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 Stellt die sichtbare Bezeichnung oder den Titel für den Add-in-Menüpunkt bereit, indem ein ganzzahliger Wert angegeben wird, der einer Ressourcen-ID entspricht, die in einer Ressourcenlokalisierungsdatei definiert ist.
  text Einchecken... Stellt die sichtbare Bezeichnung oder den Titel für den Add-in-Menüpunkt bereit, indem die tatsächliche Textzeichenfolge angegeben wird.
visible Nicht zutreffend true Gibt an, dass der Add-in-Menüpunkt (und eventuell vorhandene untergeordnete Elemente, wenn es sich bei dem Menü um ein Popup-Untermenü handelt) dem Benutzer angezeigt wird.
    false Gibt an, dass der Add-in-Menüpunkt (und eventuell vorhandene untergeordnete Elemente, wenn es sich bei dem Menü um ein Popup-Untermenü handelt) für den Benutzer nicht sichtbar ist (das heißt, dass der Menüpunkt nicht im Add-in-Menü angezeigt wird).
enabled Nicht zutreffend true Gibt an, dass der Add-in-Menüpunkt aktiviert ist und es dem Benutzer dadurch möglich ist, das Popup-Untermenü zu öffnen oder die Befehlsschaltfläche auszuwählen.
    False Gibt an, dass der Add-in-Menüpunkt vom Benutzer nicht geöffnet oder ausgewählt werden kann (das heißt, der Menüpunkt ist im Add-in-Menü inaktiviert).
parent menuId 30002 Stellt den Wert "menuId" für das übergeordnete Menü des Add-in-Menüpunkts bereit. Wenn es sich bei dem Menüpunkt um ein Popup-Untermenü handelt, ist dieser Wert in der Regel die Steuer-ID eines vorhandenen Microsoft Office Popup-Menüs. Weitere Informationen zu Menü-IDs in Microsoft Office Anwendungen finden Sie im Microsoft Office Developers Guide for Office 2003/XP/2007.
  topLevel Nicht zutreffend Wenn es sich bei dem Add-in-Menüpunkt um ein Popup-Untermenü handelt, gibt dieses Schlüssel-/Typpaar an, dass das Untermenü in die Ausgangsmenüleiste der Anwendung angeordnet ist. HINWEIS  Dieses Schlüssel-/Typpaar ist nur für Popup-Untermenüs gültig.
  Nicht zutreffend Nicht zutreffend Ist der Add-in-Menüpunkt eine Befehlsschaltfläche, wird das übergeordnete Element in der angegebenen XML-Datei durch die Verwendung des Tags <list key="children"> impliziert. Deshalb ist an dieser Stelle für setting in der XML-Datei die Angabe des übergeordneten Elements nicht erforderlich. HINWEIS  Dieses Schlüssel-/Typpaar ist nur für Befehlsschaltflächen gültig.
location Nicht zutreffend 4 Gibt die Einfügeposition für diesen Add-in-Menüpunkt im übergeordneten Menü an. Der Wert -1 gibt an, dass der Menüpunkt unten an das vorhandene Menü angehängt wird. HINWEIS  Dieser Wert gibt die gewünschte Position für den Menüpunkt im übergeordneten Popup-Menü an.
command standard OfficeAdd-In.
OpenSelection
Gibt die Application Integration-Operation an, die ausgeführt werden soll, wenn der Benutzer eine Befehlsschaltfläche auswählt. Eine der folgenden Aufzählungskonstanten kann angegeben werden:
  • 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 Nicht zutreffend Wenn der Add-in-Menüpunkt ein Popup-Untermenü ist, werden Menüklicks ignoriert. Deshalb ist an dieser Stelle für setting in der XML-Datei die Befehlsangabe nicht erforderlich. HINWEIS  Dieses Schlüssel-/Typpaar ist nur für Popup-Untermenüs gültig.

Ein Beispiel zur Verwendungsweise dieser Tags im XML-Schema finden Sie in XML-Beispielschema.

XML-Beispielschema

Das folgende Codefragment verdeutlicht die grundlegend XML-Schemastruktur für die Add-in-Menüs für die Anwendung Excel:

<?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>
...