IBM FileNet P8, 버전 5.1.+            

파일, 삽입 및 도움말 기능 추가 메뉴 사용자 정의

IBM® FileNet® P8 Application Integration은 Microsoft Outlook, Word, Excel 및 PowerPoint의 파일, 삽입 및 도움말 팝업 메뉴의 사용자 정의를 지원합니다. Application Integration은 사용자 정의 기능 추가 메뉴를 추가하여 이러한 애플리케이션을 확장하도록 COM 기능 추가를 사용합니다. 이러한 사용자 정의 메뉴는 제공된 XML 파일을 통해 개발자가 수정할 수 있습니다. 이러한 파일에는 Application Integration이 Microsoft 애플리케이션의 메뉴 컨텐츠를 구성하기 위해 사용하는 정보가 들어 있습니다.

Application Integration이 설치된 후에 개발자는 각자의 애플리케이션 요구사항에 맞춰 기능 추가 메뉴를 사용자 정의하기 위해 컨텐츠를 수동으로 수정할 수 있습니다. 그런 다음 사용자 정의된 XML 파일은 특정 사용자 또는 사용자 클래스의 애플리케이션 환경 및 기능 가용성을 제어하기 위한 수단을 제공하기 위해 조직의 다른 시스템으로 복사할 수 있습니다. 특정 애플리케이션에서 새로운 변경이 필요할 때마다 해당하는 XML 파일을 업데이트하고 적합한 시스템으로 다시 복사할 수 있습니다.

XML 사용자 정의 기술

개발자는 다음과 같이 기능 추가 메뉴를 사용자 정의할 수 있습니다.
표 1. 기능 추가 메뉴에서 사용자 정의할 수 있는 다양한 방법을 나열하고 설명합니다.
사용자 정의.. 설명
가시성 메뉴에 표시되어야 하는 Application Integration 명령 및 팝업 하위 메뉴를 지정하십시오. 이 기법을 사용하면 특정 기능의 가용성을 제어하기 위해 메뉴에서 하위 메뉴 또는 명령을 완전히 제거할 수 있습니다.
사용 상태 표시되지만 사용 불가능(회색으로 처리됨)해야 하는 Application Integration 명령 및 팝업 하위 메뉴를 지정하십시오. 이 기법을 사용하면 개발자는 특정 메뉴를 열 수 있는지 여부 또는 명령을 실행할 수 있는지 여부를 제어할 수 있습니다.
레이블 또는 캡션 사용자에게 표시되어야 하는 Application Integration 명령 및 팝업 하위 메뉴의 레이블 또는 캡션을 지정하십시오. 예를 들어, 개발자는 "Checkin" 명령을 "Store Document"로 이름을 바꾸거나 특정 명령을 "Authoring"이라는 하위 메뉴에 그룹화할 수 있습니다.
명령 조치 Application Integration 명령 선택 시 수행해야 하는 Application Integration 조치를 지정하십시오.
주: 공급업체 명령을 지정할 수 없습니다.
메뉴 계층 명령 순서 및 팝업 하위 메뉴 폴더 계층에 포함되는지 여부를 포함하여 메뉴에서 Application Integration 명령의 배열을 지정하십시오.

XML 파일 이름 및 위치

Application Integration 설치 중에 XML 파일이 설치 디렉토리(기본값은 C:\Program Files\FileNet\AppInt\)에 작성됩니다. 지원되는 Microsoft 애플리케이션 중 하나가 열릴 때마다 Application Integration은 설치 디렉토리에서 해당하는 XML 파일을 검색한 다음 XML 파일에 포함된 스펙에 따라서 해당 애플리케이션의 기능 추가 메뉴를 구성합니다. Application Integration이 설치 디렉토리에서 XML 파일을 찾을 수 없는 경우 모듈 디렉토리에서 파일을 모으려고 시도합니다. (모듈 디렉토리는 Microsoft Office 애플리케이션이 일반적으로 저장되는 위치이며 기본적으로 C:\Program Files\Microsoft Office\Office입니다.)

경고:
개발자는 XML 파일의 컨텐츠를 수정할 수 있지만 Application Integration이 기능 추가 메뉴를 구성하기 위해 XML 파일을 찾아서 사용하기 위해서는 XML 파일 이름은 변경해서는 안되며 파일은 설치 또는 모듈 디렉토리에 있어야 합니다.
다음 표는 XML 파일의 이름, 각 XML 파일의 영향을 받는 Microsoft Office 애플리케이션 및 각 애플리케이션의 지원되는 버전을 식별합니다.
표 2. 해당하는 Microsoft Office 애플리케이션 및 이러한 애플리케이션의 지원되는 버전과 함께 각 SML 파일 이름을 나열합니다.
XML 파일 이름 해당 애플리케이션 지원되는 버전
FnAppIntExcelMenus.xml Excel 2003, 2007, 2010
FnAppIntOutlookMenus.xml Outlook Explorer(항목 찾아보기 창)

Outlook Inspector(항목 편집 창)

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

XML 수정 고려사항

XML 파일을 수정하기 전에 다음 사항을 고려해야 합니다.
  • XML 파일은 읽기 전용으로 설치되지만 개발자는 읽기-쓰기 가능으로 만들기 위해 파일 권한을 수정할 수 있습니다.
  • IBM이 제공하는 XML 파일은 기능 추가 메뉴 및 해당 컨텐츠를 지정하기 위해 올바른 구문 및 사용법을 제공합니다. 개발자는 이러한 파일에 제공된 XML 포맷팅 및 매개변수 구문을 반드시 따라야 합니다. 또한 개발자는 수정을 구현하기 전에 원본 XML 파일을 백업할 수 있습니다. 이는 수정된 파일에서 잠재적인 구문 오류를 디버깅 및 해결하는 데 도움이 됩니다.
  • 기능 추가 메뉴를 구성하기 위해 Application Integration은 설치 디렉토리에서 이름으로 XML 파일을 검색합니다. 개발자는 XML 파일의 컨텐츠를 수정할 수 있지만 Application Integration이 기능 추가 메뉴를 구성하기 위해 XML 파일을 찾아서 사용하기 위해서는 XML 파일 이름은 변경해서는 안되며 파일은 설치 또는 모듈 디렉토리에 있어야 합니다.
  • 수정팩을 포함하여 Application Integration이 설치될 때마다 원본 XML 파일이 설치 디렉토리에 작성됩니다. 그 결과 사용자 정의된 XML 파일을 겹쳐쓸 수 있습니다. 그러므로 개발자는 수정된 XML 파일의 백업 사본을 만들고 이를 고유한 파일 이름을 사용하여 고유한 폴더에 저장할 수 있습니다. 그러면 필요에 따라 사용자 정의된 XML 파일을 빠르게 복원할 수 있습니다.

XML 기능 추가 메뉴 스키마

기능 추가 메뉴의 XML 스키마의 기본 구조는 다음과 같습니다.
  • addInMenusConfiguration - 스키마에서 다음 XML 오브젝트를 식별하는 최상위 레벨 오브젝트는 애플리케이션의 기능 추가 메뉴를 설명합니다. 이 오브젝트는 또한 사용 중인 스키마의 version을 지정합니다.
  • applicationName - 기능 추가 메뉴를 구성 중인 대상 애플리케이션을 식별합니다.
  • applicationVersion - 대상 애플리케이션의 지원되는 버전을 지정합니다.
  • addInMenusDefinition - 각 addInMenusConfiguration 오브젝트는 각 기능 추가 메뉴(파일, 삽입 또는 도움말)를 애플리케이션에 어떻게 구성해야 하는지를 지정하는 오브젝트를 포함하는 이러한 오브젝트 중 하나(Microsoft Outlook의 경우 하나 이상)로 구성되어 있습니다. 이 오브젝트는 또한 작성해야 하는 기능 추가 메뉴의 type을 지정합니다. Application Integration은 다음 유형을 지원합니다. Word, Excel 및 PowerPoint의 경우 main이고 Outlook의 경우 explorerinspector입니다.
  • addInMenuItem - 각 addInMenusDefinition 오브젝트는 하위 메뉴 계층 및 각 메뉴의 명령 단추 동작을 설명하는 이러한 오브젝트 중 하나 이상으로 구성되어 있습니다. 이는 itemType 태그를 사용하여 수행할 수 있으며 이를 popup 또는 button으로 설정할 수 있습니다.
    • itemType="popup"addInMenuItem 오브젝트에는 자체 addInMenuItem 오브젝트 하위의 list를 포함할 수 있으므로 하위 메뉴 구조를 작성할 수 있습니다. 이 계층 구조는 조직 요구사항을 달성하는 데 필요한 깊이까지 반복할 수 있습니다.
    • itemType="button"popup 메뉴 항목에만 하위 메뉴 항목을 포함할 수 있으므로 XML 구조가 종료됩니다.
  • setting - 각 addInMenuItem 오브젝트(popup 또는 button)에는 메뉴 항목의 설명, 표시 가능한 레이블 또는 캡션, 메뉴 삽입 위치 및 메뉴 항목이 열리거나 선택될 때 실행할 해당하는 Application Integration 조치 등과 같은 하위 메뉴 또는 단추의 모양 및 동작을 정의하는 여러 setting 태그가 들어 있습니다. 설정 태그 섹션은 setting 태그의 전체 세부사항을 제공합니다.

XML 스키마에서 이러한 태그를 사용하는 방법의 예제는 샘플 XML 스키마의 내용을 참조하십시오.

설정 태그

addInMenuItem 오브젝트는 setting태그를 사용하여 기능 추가 메뉴 하위 메뉴 또는 명령 단추의 모양 및 동작을 정의합니다. 태그의 구문은 정의 중인 key에 따라 다릅니다. 예를 들어, 몇몇 key에는 type 필드가 필요하지만 몇몇은 필요하지 않습니다.

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

다음 표에서 keytype 필드를 사용할 필요가 없거나 지정된 값이 필요하지 않는 경우 유형 또는 열의 입력은 "적용 불가능"입니다. key 값이 알려진 Application Integration 변수가 아니면(예: popup또는 button) 열의 항목이 기울임꼴로 나타납니다(예: 30002). 또한 key가 필요하지 않으면 설명 열의 항목에는 [Optional] 표시기가 포함됩니다.

Application Integration은 다음 setting 태그를 지원합니다.
표 3. 각 키를 해당 유형, 값 및 설명과 함께 나열합니다.
유형 설명
itemType 해당 없음 popup 기능 추가 메뉴 항목이 하위가 있는 팝업 하위 메뉴이며 여기에는 명령 단추 및 추가적인 팝업 하위 메뉴를 포함할 수 있음을 표시합니다.
  해당 없음 button 기능 추가 메뉴 항목이 하위가 없는 명령 단추임을 표시합니다.
description 해당 없음 P8 File Menu [Optional] 정보 전용인 기능 추가 메뉴 항목의 설명을 제공합니다. 이 설명은 사용자에게는 표시되지 않습니다.
label enum eOpenSubMenuName 다음 열거 상수 중 하나를 사용하여 기능 추가 메뉴 항목에 표시되는 레이블 또는 캡션을 제공합니다.
  • 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 자원 지역화 파일에 정의된 자원 ID에 해당하는 정수 값을 지정하여 기능 추가 메뉴 항목에 표시되는 레이블 또는 캡션을 제공합니다.
  text Checkin... 실제 텍스트 문자열을 제공하여 기능 추가 메뉴 항목에 표시되는 레이블 또는 캡션을 제공합니다.
visible 해당 없음 true 사용자에게 표시되는 기능 추가 메뉴 항목 및 메뉴 항목이 팝업 하위 메뉴인 경우 모든 하위를 지정합니다.
    false 기능 추가 메뉴 항목 및 메뉴 항목이 팝업 하위 메뉴인 경우 모든 하위가 사용자에게 표시되지 않음을 지정합니다. 즉, 메뉴 항목이 기능 추가 메뉴에 나타나지 않습니다.
enabled 해당 없음 true 기능 추가 메뉴 항목이 사용 가능하므로 사용자가 팝업 하위 메뉴를 열거나 명령 단추를 선택할 수 있음을 지정합니다.
    False 사용자가 열거나 선택할 수 없는(즉, 메뉴 항목이 기능 추가 메뉴에서 사용 불가능함) 기능 추가 메뉴 항목을 지정합니다.
parent menuId 30002 기능 추가 메뉴 항목의 상위 메뉴에 "menuId" 값을 제공합니다. 메뉴 항목이 팝업 하위 메뉴이면 이 값은 일반적으로 기존 Microsoft Office 팝업 메뉴의 제어 ID입니다. Microsoft Office 애플리케이션에서 메뉴 ID에 대한 자세한 정보는 Microsoft Office Developers Guide for Office 2003/XP/2007을 참조하십시오.
  topLevel 해당 없음 기능 추가 메뉴 항목이 팝업 하위 메뉴인 경우 이 키 및 유형 쌍은 하위 메뉴가 애플리케이션의 최상위 레벨 메뉴 표시줄에 있음을 표시합니다.
주: 이 키 및 유형 쌍은 팝업 하위 메뉴에만 유효합니다.
  해당 없음 해당 없음 기능 추가 메뉴 항목이 명령 단추이면 상위는 <list key="children"> 태그를 사용하여 지정된 XML에 암시되어 있습니다. 그러므로 XML에서 이 setting 위치에서는 상위 스펙이 필요하지 않습니다.
주: 이 키 및 유형 쌍은 명령 단추에만 유효합니다.
location 해당 없음 4 상위 메뉴에서 기능 추가 메뉴 항목의 삽입 위치를 지정합니다. -1 값은 메뉴 항목이 기존 메뉴의 맨 아래에 추가됨을 표시합니다.
주: 이 값은 상위 팝업 메뉴에서 메뉴 항목의 원하는 위치를 표시합니다.
command standard
OfficeAdd-In.
OpenSelection
사용자가 명령 단추를 선택할 때 수행할 Application Integration 오퍼레이션을 지정합니다. 다음 열거 상수 중 하나를 지정할 수 있습니다.
  • 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 해당 없음 기능 추가 메뉴 항목이 팝업 하위 메뉴인 경우 메뉴 클릭은 무시됩니다. 그러므로 XML에서 이 setting 위치에서는 명령 스펙이 필요하지 않습니다.
주: 이 키 및 유형 쌍은 팝업 하위 메뉴에만 유효합니다.

XML 스키마에서 이러한 태그를 사용하는 방법의 예제는 샘플 XML 스키마의 내용을 참조하십시오.

샘플 XML 스키마

다음 코드 단편은 Excel 애플리케이션의 기능 추가 메뉴의 기본 XML 스키마 구조를 보여줍니다.
<?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>
...


피드백

마지막 업데이트 날짜: 2011년 7월


© Copyright IBM Corp. 2011.
이 Information Center는 Eclipse 기술로 구현됩니다. (http://www.eclipse.org 웹 사이트 참조)