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.
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. Beispielsweise können Entwickler den Befehl Einchecken in Dokument speichern ändern oder bestimmte Befehle in einem Untermenü mit der Bezeichnung Authoring zusammenfassen. |
Befehlsaktion | Geben Sie an, welche Application Integration-Aktion ausgeführt werden soll, wenn ein Application Integration-Befehl ausgewählt wird. Anmerkung: Sie dürfen 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. |
Während der Installation von Application Integration werden die XML-Dateien in das Installationsverzeichnis geschrieben (das Standardverzeichnis ist C:\Programme\FileNet\AppInt\). 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 dies das Verzeichnis C:\Programme\Microsoft Office\Office.)
XML-Dateiname | Entsprechende Anwendung | Unterstützte Versionen |
---|---|---|
FnAppIntExcelMenus.xml | Excel | 2003, 2007, 2010 |
FnAppIntOutlookMenus.xml | Outlook Explorer (Elementsuchfenster) Outlook Inspector (Elementeditierfenster) |
2003, 2007, 2010 |
FnAppIntPowerPointMenus.xml | PowerPoint | 2003, 2007, 2010 |
FnAppIntWordMenus.xml | Word | 2003, 2007, 2010 |
Ein Beispiel zur Verwendungsweise dieser Tags im XML-Schema finden Sie in XML-Beispielschema.
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 Wert für key nicht die Verwendung eines Felds type oder kein angegebener Wert erforderlich ist, ist in der Spalte Typ oder Wert der Eintrag Nicht zutreffend angegeben. 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].
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:
|
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 menuId-Wert 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 MicrosoftOffice 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. Anmerkung: Dieses Schlüssel-/Typpaar ist nur für Popup-Untermenüs gültig.
|
|
Nicht zutreffend | Nicht zutreffend | Wenn es sich beim Add-in-Menüpunkt um eine Befehlsschaltfläche handelt, wird das übergeordnete Element in der angegebenen XML-Datei durch Verwendung des Tags <list
key="children"> eingeschlossen. Deshalb ist an dieser Stelle für setting in der XML-Datei die Angabe des übergeordneten Elements nicht erforderlich.
Anmerkung: 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. Anmerkung: Dieser Wert gibt die gewünschte Position für den Menüpunkt im übergeordneten Popup-Menü an.
|
command | standard |
|
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:
|
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. Anmerkung: 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 version="1.0" ?>
<!-- IBM FileNet P8 Application Integration 4.0-Add-inMenüs für Excel -->s
<!-- Add-In-Menüs - Konfigurationsinformation -->
<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-Menüs - Hauptmenüdefinitionen -->
<object key="addInMenusDefinition" type="main">
<list key="children">
<!-- P8-Menü 'Datei' -->
<object key="addInMenuItem">
<setting key="itemType">popup</setting>
...
<list key="children">
<!-- Untermenü 'Dokument öffnen' -->
<object key="addInMenuItem">
<setting key="itemType">popup</setting>
<setting key="description">Untermenü mit Befehlen zum Öffnen von Dokumenten. </Setting>
<setting key="label" type="text">Dokument öffnen</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">
<!-- Dokument öffnen - Schaltfläche 'Eigene Auscheckvorgänge...' -->
<object key="addInMenuItem">
<setting key="itemType">button</setting>
...
<list key="children" />
</object>
<!-- Dokument öffnen - Schaltfläche 'Objekt auswählen...' -->
<object key="addInMenuItem">
<setting key="itemType">button</setting>
...
<list key="children" />
</object>
</list>
<list key="children" />
</object>
<!-- Untermenü 'Dokument hinzufügen' -->
<object key="addInMenuItem">
<setting key="itemType">popup</setting>
...
<list key="children" />
</object>
...
<!-- Schaltfläche 'Ordner hinzufügen...' -->
<object key="addInMenuItem">
<setting key="itemType">button</setting>
<setting key="description">Führt den Assistenten 'Ordner hinzufügen' aus</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-Menü 'Einfügen' -->
<object key="addInMenuItem">
<setting key="itemType">popup</setting>
...
<list key="children">
...
</list>
<list key="children" />
</object>
<!-- P8-Menü 'Hilfe' -->
<object key="addInMenuItem">
<setting key="itemType">popup</setting>
...
<list key="children">
...
</list>
<list key="children" />
</object>
</list>
</object>
</object>
...