IBM FileNet P8, Versie 5.2            

De addin-menu's Bestand, Invoegen en Help aanpassen

IBM® FileNet P8 Toepassingsintegratie biedt ondersteuning voor het aanpassen van de voorgrondmenu's Bestand, Invoegen en Help van Microsoft Outlook, Word, Excel en PowerPoint. Toepassingsintegratie gebruikt COM-addins om deze toepassingen uit te breiden door aangepaste addin-menu's toe te voegen. Deze aangepaste menu's kunnen worden aangepast door ontwikkelaars door gebruik van verstrekte XML-bestanden, die informatie bevatten die gebruikt wordt door Toepassingsintegratie om de menu-inhoud voor de Microsoft-toepassingen te configureren.

Nadat Toepassingsintegratie is geïnstalleerd, kunnen ontwikkelaars de inhoud van de XML-bestanden handmatig aanpassen, zodat zij de addin-menu's kunnen aanpassen aan hun toepassingsvereisten. De aangepaste XML-bestanden kunnen dan worden gekopieerd naar andere systemen in de organisatie, om een manier te bieden voor het beheren van de toepassingsomgeving en de beschikbaarheid van functies voor een bepaalde gebruiker of klasse gebruikers. Wanneer een nieuwe wijziging wordt vereist voor een bepaalde toepassing, kan het overeenkomende XML-bestand worden bijgewerkt en weer worden gekopieerd naar de juiste systemen.

Technieken voor aanpassing van XML

Ontwikkelaars kunnen de addin-menu's als volgt aanpassen:
Tabel 1. Hier worden de verschikkende manieren afgebeeld en beschreven waarop u een addin-menu kunt aanpassen.
Aanpassen: Beschrijving
Zichtbaarheid Geef de opdrachten en voorgrondsubmenu's op die zichtbaar dienen te zijn op het menu. Met deze techniek wordt het mogelijk gemaakt om een submenu of opdracht volledig te verwijderen uit een menu zodat de beschikbaarheid van een bepaalde functie kan worden beheerd.
Status inschakeling Geef de opdrachten en voorgrondsubmenu's van Toepassingsintegratie op die zichtbaar maar uitgeschakeld (grijs) zouden moeten zijn. Met deze techniek kunnen ontwikkelaars beheren of een bepaald menu kan worden geopend of een opdracht kan worden uitgevoerd.
Label of bijschrift Geef de labels of bijschriften op voor de opdrachten en voorgrondsubmenu's van Toepassingsintegratie zoals deze dienen te worden afgebeeld voor de gebruiker. Ontwikkelaars kunnen bijvoorbeeld de opdracht "Inchecken" hernoemen nar "Document opslaan" of bepaalde opdrachten samen groeperen in een submenu met de naam "Ontwerpen."
Actie opdracht Geef op welke actie voor Toepassingsintegratie dient te worden uitgevoerd wanneer de opdracht Toepassingsintegratie word geselecteerd.
Opmerking: U kunt geen leveranciersopdrachten opgeven.
Menuhiërarchie Geef de volgorde op van de opdrachten van Toepassingsintegratie in het menu, met inbegrip van de volgorde van opdrachten en of ze zich bevinden in een mappenhiërarchie van voorgrondsubmenu's.

XML-bestandsnamen en locatie

Tijdens de installatie van Toepassingsintegratie worden de XML-bestanden geschreven naar de installatiedirectory (de standaardwaarde is C:\Program Files\FileNet\AppInt\). Wanneer een van de ondersteunde Microsoft-toepassingen wordt geopend, zoekt Toepassingsintegratie naar het overeenkomende XML-bestand in de installatiedirectory en configureert het vervolgens het addin-menu voor die toepassing volgens de specificaties in het XML-bestand. Als Toepassingsintegratie de XML-bestanden niet kan vinden in de installatiedirectory, probeert het de bestanden te verzamelen vanuit de directory Module. (De directory Module is waar de toepassingen van Microsoft Office meestal worden opgeslagen, standaard in C:\Program Files\Microsoft Office\Office.)

Let op!:
Ontwikkelaars kunnen de inhoud van de XML-bestanden wijzigen, maar de namen van de XML-bestanden mogen niet worden gewijzigd en de bestanden moeten zich bevinden in de directory van de installatie of module zodat Toepassingsintegratie de XML-bestanden kan vinden en gebruiken om de addin-menu's te configureren.
De volgende tabel geeft de namen aan van XML-bestanden, de Microsoft Office-toepassingen die worden beïnvloed door elk XML-bestand en de ondersteunde versies voor elke toepassing.
Tabel 2. Hiermee worden alle XML-bestandsnamen afgebeeld samen met de overeenkomende Microsoft Office-toepassingen en de ondersteunde versies van deze toepassingen.
Bestandsnaam XML Overeenkomende toepassing Ondersteunde versies
FnAppIntExcelMenus.xml Excel 2003, 2007, 2010
FnAppIntOutlookMenus.xml Outlook Explorer (venster item bladeren)

Outlook Inspector (venster item bewerken)

2003, 2007, 2010
FnAppIntPowerPointMenus.xml PowerPoint 2003, 2007, 2010
FnAppIntWordMenus.xml Word 2003, 2007, 2010

Overwegingen voor XML-wijziging

De volgende punten dienen te worden overwogen voor het wijzigen van de XML-bestanden:
  • De XML-bestanden worden geïnstalleerd als alleen-lezen, maar ontwikkelaars kunnen de bestandsmachtigingen wijzigen zodat ze leesbaar en schrijfbaar worden.
  • De XML-bestanden die worden verstrekt door IBM leveren de juiste syntaxis en het juiste gebruik voor het opgeven van de addin-menu's en de inhoud daarvan. Ontwikkelaars dienen de XML-indeling en parametersyntaxis die zijn verstrekt in deze bestanden nauwgezet te volgen. Daarnaast kunnen ontwikkelaars een backup maken van de oorspronkelijke XML-bestanden voordat wijzigingen worden geïmplementeerd. Dit helpt bij foutopsporing en het oplossen van mogelijke syntaxisfouten in de gewijzigde bestanden.
  • Als u de addin-menu's wilt configureren, zoekt Toepassingsintegratie naar de XML-bestanden op naam in de installatiedirectory. Ontwikkelaars kunnen de inhoud van de XML-bestanden wijzigen, maar de namen van de XML-bestanden mogen niet worden gewijzigd en de bestanden moeten zich bevinden in de directory van de installatie of module zodat Toepassingsintegratie de XML-bestanden kan vinden en gebruiken om de addin-menu's te configureren.
  • Wanneer Toepassingsintegratie is geïnstalleerd, met inbegrip van fixpacks, worden de oorspronkelijke XML-bestanden geschreven naar de installatiedirectory. Als gevolg daarvan kunnen aangepaste XML-bestanden worden overschreven. Daarom kunnen ontwikkelaars kopieën maken van hun gewijzigde XML-bestanden en deze opslaan met unieke bestandsnamen of in een unieke map. Hierdoor kunnen aangepaste XML-bestanden snel worden hersteld indien nodig.

XML-schema addin-menu's

De standaardstructuur van het XML-schema voor de addin-menu's is als volgt:
  • addInMenusConfiguration - het object op basisniveau in het schema dat aangeeft dat de volgende XML-objecten de addin-menu's beschrijven voor een toepassing. Dit object geeft ook de versie op van het schema dat wordt gebruikt.
  • applicationName - geeft de doeltoepassing aan waarvoor de addin-menu's worden geconfigureerd.
  • applicationVersion - geeft de ondersteunde versies op voor de doeltoepassing.
  • addInMenusDefinition - elk object addInMenusConfiguration bestaat uit één (of meer in het geval van Microsoft Outlook) van deze objecten, die de objecten bevatten waarmee wordt aangegeven hoe alle invoegmenuopties voor de menu's (Bestand, Invoegen of Help) dienen te worden geconfigureerd voor de toepassing. Dit object geeft ook het type invoegmenuopties aan dat dient te worden gemaakt. Toepassingsintegratie ondersteunt de volgende typen: main voor Word, Excel en PowerPoint, en explorer en inspector voor Outlook.
  • addInMenuItem - elk object addInMenusDefinition bestaat uit één of meer van deze objecten waarmee de submenuhiërarchie en het gedrag van opdrachtknoppen worden beschreven voor elk menu. Dit wordt bereikt door het gebruik van het label itemType, dat kan worden ingesteld op popup of button.
    • Als de instelling itemType="popup" is, kan een object addInMenuItem eenlijst bevatten met eigen onderliggende objecten addInMenuItem, waardoor een submenustructuur kan worden gemaakt. Deze hiërarchische structuur kan worden herhaald tot elke benodigde diepte om uw organisatorische vereisten te bereiken.
    • Als de instelling itemType="button" is, wordt de XML-structuur afgebroken omdat alleen popup-menu's onderliggende menu-items kunnen hebben.
  • instelling - elk object addInMenuItem (popup of button) bevat een aantal instelling-tags waarmee de presentatie en het gedrag van het submenu of de knop definiëren, zoals een beschrijving van de menuoptie, het zichtbare label of onderschrift, de positie voor het invoegen van het menu en de overeenkomende actie in Toepassingsintegratie die moet worden uitgevoerd wanneer de menuoptie wordt geopend of geselecteerd. In de sectieInstelling-tags worden volledige details verstrekt voor de instelling-tags.

Voor een voorbeeld van hoe deze tags worden gebruikt in het XML-schema, raadpleegt u Voorbeeld van XML-schema.

Instelling-tags

Elk object addInMenuItem gebruiktinstelling-tags om de presentatie en het gedrag te definiëren van submenu's of opdrachtknoppen van addin-menu's. De syntaxis voor de tag verschilt afhankelijk van de sleutel die wordt gedefinieerd. Bijvoorbeeld, sommige sleutels vereisen het veld type maar andere niet:

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

In de volgende tabel, wanneer een sleutel geen gebruik vereist van het veld type of geen specifieke waarde vereist, is de invoer in de kolom Type of Waarde "Niet van toepassing". Wanneer de waarde voor de sleutel geen bekende variabele van Toepassingsintegratie is, zoals popup of button wordt de invoer in de kolom Waarde cursief afgebeeld; bijvoorbeeld30002. Daarnaast, als een sleutel niet vereist is, bevat de invoer in de kolom Beschrijving de indicator [Optioneel].

Toepassingsintegratie ondersteunt de volgende instelling-tags.
Tabel 3. Hiermee wordt elke sleutel afgebeeld samen met het type, de waarde en de beschrijving ervan.
Sleutel Type Waarde Beschrijving
itemType Niet van toepassing popup Geeft aan dat de invoegmenuoptie een voorgrondsubmenu is met onderliggende menu's. Dit kan opdrachtknoppen en aanvullende voorgrondsubmenu's bevatten.
  Niet van toepassing button Geeft aan dat de addin-menuoptie een opdrachtknop is zonder onderliggende items.
beschrijving Niet van toepassing Bestandsmenu P8 [Optioneel] Biedt een beschrijving voor de addin-menuoptie die alleen informationeel is; deze beschrijving is niet zichtbaar voor de gebruiker.
label enum eOpenSubMenuName Levert het zichtbare label of onderschrift voor de addin-menuoptie met gebruik van één van de volgende enum-constanten:
  • 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 Levert het zichtbare label of onderschrift voor de addin-menuoptie door een geheel getal op te geven dat overeenkomt met een resource-ID dat is gedefinieerd door een bestand voor het lokaliseren van resources.
  tekst Inchecken... Levert het zichtbare label of onderschrift voor de addin-menuoptie door de werkelijke tekstreeks te verstrekken.
zichtbaar Niet van toepassing waar Hiermee wordt opgegeven dat de addin-menuoptie (en onderliggende items als de menuoptie een voorgrondsubmenu is) zichtbaar is voor de gebruiker.
    onwaar Hiermee wordt opgegeven dat de addin-menuoptie (en onderliggende items als de menuoptie een voorgrondsubmenu is) niet zichtbaar is voor de gebruiker (met andere woorden, de menuoptie wordt niet afgebeeld in de invoegmenuopties).
ingeschakeld Niet van toepassing waar Hiermee wordt opgegeven dat de addin-menuoptie is ingeschakeld, waardoor het mogelijk wordt voor de gebruiker om het voorgrondsubmenu te openen of de opdrachtknop te selecteren.
    Onwaar Hiermee wordt opgegeven dat de addin-menuoptie niet kan worden geopend of geselecteerd door de gebruiker (met andere woorden, de menuoptie is uitgeschakeld in het addin-menu).
parent menuId 30002 Biedt de waarde "menuId" voor het bovenliggende menu van de addin-menuoptie. Wanneer de menuoptie een voorgrondsubmenu is, is deze waarde meestal het besturings-ID van een bestaand voorgrondmenu van Microsoft Office. Voor meer informatie over menu-ID's in Microsoft Office-toepassingen raadpleegt u de Microsoft Office Handleiding voor ontwikkelaars voor Office 2003/XP/2007.
  topLevel Niet van toepassing Wanneer de addin-menuoptie een voorgrondsubmenu is, geeft dit sleutel- en waardepaar aan dat het submenu wordt geplaatst op de menubalk op het hoogste niveau van de toepassing.
Opmerking: Dit sleutel- en waardepaar is alleen geldig voor voorgrondsubmenu's.
  Niet van toepassing Niet van toepassing Wanneer de addin-menuoptie een opdrachtknop is, wordt het bovenliggende item geïmpliceerd in de opgegeven XML via het gebruik van de tag <list key="children">. Daarom is er geen specificatie van het bovenliggende item vereist op de locatie van deze instelling in de XML.
Opmerking: Dit sleutel- en waardepaar is alleen geldig voor opdrachtknoppen.
locatie Niet van toepassing 4 Geeft de invoegpositie op voor deze addin-menuoptie in het bovenliggende menu. Een waarde van -1 geeft aan dat de menuoptie wordt toegevoegd onderaan het bestaande menu.
Opmerking: Deze waarde geeft de gewenste positie aan voor de menuoptie in het bovenliggende voorgrondmenu.
opdracht standaard
OfficeAdd-In.
OpenSelection
Geeft de bewerking voor Toepassingsintegratie op die dient te worden uitgevoerd wanneer een opdrachtknop wordt geselecteerd door de gebruiker. Een van de volgende enum-constanten kan worden opgegeven:
  • 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
  standaard Niet van toepassing Wanneer de addin-menuoptie een voorgrondsubmenu is, worden menukliks genegeerd. Daarom is er geen opdrachtspecificatie vereist op de locatie van deze instelling in de XML.
Opmerking: Dit sleutel- en waardepaar is alleen geldig voor voorgrondsubmenu's.

Voor een voorbeeld van hoe deze tags worden gebruikt in het XML-schema, raadpleegt u Voorbeeld van XML-schema.

Voorbeeld van XML-schema

Met het volgende codefragment wordt de standaardstructuur van het XML-schema toegelicht voor de invoegmenuopties van de Excel-toepassing:
<?xml version="1.0" ?>
 <!-- IBM FileNet P8 Toepassingsintegratie 4.0 Addin-menu's voor Excel-->
 <!-- Addin-menu's - Configuratiegegevens -->
 <object key="addInMenusConfiguration" version="1.0">
 <setting key="applicationName">Excel</setting>
 <array key="applicationVersion">
 <value>2003</value>
 <value>2007</value>
 <value>2010</value>
 </array>
 <!-- Addin-menu's - Definities hoofdmenu -->
 <object key="addInMenusDefinition" type="main">
 <list key="children">
 <!-- P8 Menu Bestand -->
 <object key="addInMenuItem">
 <setting key="itemType">popup</setting>
 ...
 <list key="children">
 <!-- Submenu document openen -->
 <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">
 <!-- Document openen - Knop Mijn uitcheckbewerkingen... -->
 <object key="addInMenuItem">
 <setting key="itemType">button</setting>
 ...
 <list key="children" />
 </object>
 <!-- Document openen - Knop Optie selecteren... -->
 <object key="addInMenuItem">
 <setting key="itemType">button</setting>
 ...
 <list key="children" />
 </object>
 </list>
 <list key="children" />
 </object>
 <!-- Submenu document toevoegen -->
 <object key="addInMenuItem">
 <setting key="itemType">popup</setting>
 ...
 <list key="children" />
 </object>
 ...
 <!-- Knop Map toevoegen... -->
 <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 Menu Invoegen -->
 <object key="addInMenuItem">
 <setting key="itemType">popup</setting>
 ...
 <list key="children">
 ...
 </list>
 <list key="children" />
 </object>
 <!-- P8 Menu Help -->
 <object key="addInMenuItem">
 <setting key="itemType">popup</setting>
 ...
 <list key="children">
 ...
 </list>
 <list key="children" />
 </object>
 </list>
 </object>
 </object>
...


Feedback

Laatst bijgewerkt: Maart 2013
overview_addin_menus.htm

© Copyright IBM Corp. 2013.
Dit informatiecentrum maakt gebruik van Eclipse-technologie. (http://www.eclipse.org)