IBM FileNet P8, النسخة 5.2            

تهيئة قوائم الوظائف الاضافية ملف وادراج ومساعدة

يتيح IBM® FileNet P8 Application Integration الدعم لتهيئة القوائم المنبثقة ملف وادراج ومساعدة الى Microsoft Outlook و Word و Excel و PowerPoint. ويقوم Application Integration بتشغيل البرامج المساعدة COM Add-Ins لتمديد هذه التطبيقات من خلال اضافة قوائم مهيأة للبرنامج المساعد. يمكنك تعديل هذه القوائم المهيئة بواسطة المطورين من خلال استخدام ملفات XML المتاحة، والتي تتضمن معلومات يتم استخدامها بواسطة Application Integration لتوصيف محتويات القائمة لتطبيقات Microsoft.

بعد تركيب Application Integration، يمكن لمطوري البرمجيات القيام يدويا بتعديل المحتويات الخاصة بملفات XML لتهيئة قوائم البرامج المساعدة لتتفق مع متطلبات التطبيق الخاصة بهم. ويمكن بعد ذلك نسخ ملفات XML التي تم تهيئتها الى أنظمة أخرى في المؤسسة، لاتاحة طريقة للتحكم في بيئة التشغيل للتطبيق واتاحة الخاصية لمستخدم معين أو فئة محددة من المستخدمين. وعندما تكون هناك حاجة الى تغييرات جديدة في تطبيق معين، يمكن تحديث ملف XML المقابل ونسخه مرة أخرى الى الأنظمة المناسبة.

تقنيات تهيئة XML

يمكن لمطوري البرمجيات تهيئة قوائم الوظائف الاضافية كما يلي:
جدول 1. تعرض وتوضح الطرق المختلفة التي يمكن اتباعاها لتهيئة قوائم الوظائف الاضافية.
تهيئة... الوصف
رؤية حدد أوامر Application Integration والقوائم الفرعية المنبثقة التي يجب أن تكون مرئية من القائمة. هذا الطريقة تتيح ازالة كاملة للقوائم أو الأوامر الفرعية من القائمة لكي يتم التحكم في اتاحة خصائص معينة.
حالة الاتاحة حدد أوامر Application Integration والقوائم الفرعية المنبثقة التي يجب أن تكون مرئية من القائمة، ولكن غير متاحة للتشغيل (باللون الرمادي). هذه الطريقة تسمح لمطوري البرمجيات امكانية التحكم فيما اذا كان من الممكن فتح قوائم أو اوامر معينة وتنفيذها.
التسمية المميزة أوالتسمية التوضيحية حدد التسميات أوالتسميات التوضيحية الى أوامر Application Integration والقوائم الفرعية المنبثقة التي يجب أن تكون تظهر للمستخدم. على سبيل المثال، يمكن لمطوري البرمجيات اعادة تسمية الأمر "تخصيص" الى "تخزين وثيقة" أو تجميع أوامر معينة معا في أحد القوائم الفرعية وتسميتها "التأليف."
تصرف الأمر حدد تصرف 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، يجب عدم تغيير أسماء ملفات XML ويجب أن تكون الملفات موجودة في دليل التركيب أو دليل وحدات البرامج لكي يتمكن Application Integration من ايجادها وتشغيلها لتوصيف قوائم الوظائف الاضافية.
يوضح الجدول التالي أسماء ملفات XML، وتطبيقات Microsoft Office التي تتأثر بكل من ملفات XML، والنسخ المدعمة بالنسبة الى كل من التطبيقات.
جدول 2. لعرض كل من أسماء ملفات XML مع تطبيقات Microsoft Office والنسخ المدعمة من هذه التطبيقات.
اسم ملف 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 يتم تركيبها كملفات للقراءة فقط، الا أن مطوري البرمجيات يمكنهم تعديل التصاريح الخاصة بالملف بحيث تصبح قابلة للقراءة-الكتابة.
  • تقوم ملفات XML التي يتم تقديمها بواسطة IBM باتاحة الصيغة الصحيحة والاستخدام لتحديد قوائم الوظائف الاضافية والمحتويات الخاصة بها. ويجب أن يقوم مطوري البرمجيات باتباع سياق ونسق ومعاملات XML المقدمة في هذه الملفات بدقة. بالاضافة الى ذلك، يمكن لمطوري البرمجيات عمل نسخ احتياطية من ملفات XML الأصلية قبل تنفيذ أي تعديلات. هذا يساعد في تصحيح أخطاء وحل أخطاء السياق المحتملة في الملفات التي تم تعديلها.
  • ولكي يمكن توصيف قوائم الوظائف الاضافية، سيقوم Application Integration بالبحث عن ملفات XML من خلال الاسم في دليل التركيب. أثناء قيام مطوري البرمجيات بتعديل محتويات ملفات XML، يجب عدم تغيير أسماء ملفات XML ويجب أن تكون الملفات موجودة في دليل التركيب أو دليل وحدات البرامج لكي يتمكن Application Integration من ايجادها وتشغيلها لتوصيف قوائم الوظائف الاضافية.
  • وعند تركيب Application Integration، بما يتضمن حزم برامج التصحيحات، يتم كتابة ملفات XML الأصلية على دليل التركيب. ونتيجة لذلك، يمكن احلال ملفات XML المهيأة. ولذلك، يجب أن يقوم مطوري البرمجيات بعمل نسخ احتياطية من ملفات XML التي سيتم تعديلها، وحفظهم باستخدام أسماء متفردة أو في حافظات بأسماء متفردة. وهذا يسمح بتخزين ملفات XML التي تم تهيئتها بسهولة كلما تطلب الأمر.

ملفات XML لقوائم الوظائف الاضافية

الهيكل الأساسي الى XML Schema لقوائم الوظائف الاضافية هو كما يلي:
  • addInMenusConfiguration - عنصر المستوى الرئيسي في الوصف المنطقي والذي يقوم بتعريف عناصر XML التالية التي تقوم بتوصيف قوائم الوظائف الاضافية في التطبيق. كما يقوم هذا العنصر بتحديد نسخة الوصف الشامل الذي يتم تنفيذه.
  • applicationName - يقوم بتعريف التطبيق المستهدف الذي سيتم توصيف قوائم الوظائف الاضافية عليه.
  • applicationVersion - يحدد النسخ المستهدفة من التطبيق المستهدف.
  • addInMenusDefinition - كل من عناصر addInMenusConfiguration تتكون من واحد أو أكثر (أو أكثر في حالة Microsoft Outlook) من العناصر التي تتضمن العناصر التي تحدد كيفية توصيف كل من قوائم الوظائف الاضافية (ملف، ادراج، مساعدة) للتطبيق. كما يقوم هذا العنصر بتحديد النوع لقائمة الوظائف الاضافية التي يجب تكوينها. ويدعم Application Integration الأنواع التالية: main بالنسبة الى Word و Excel و PowerPoint، و explorer و inspector بالنسبة الى Outlook.
  • addInMenuItem - كل من عناصر addInMenusDefinition تتكون من واحد أو أكثر من هذه العناصر التي تقدم وصف للتسلسل الهرمي للقوائم الفرعية ومفاتيح الأوامر وطريقة عملها لكل من القوائم. وذلك يتم من خلال استخدام الشارة itemType، والتي يمكن تحديدها في popup أو button.
    • وفي حالة itemType="popup"، فان العنصر addInMenuItem يمكن أن يتضمن list الخاص بالعناصر الفرعية addInMenuItem له، وهذا يتيح امكانية تكوين هيكل بالقوائم الفرعية. ويمكن تكرار هيكل التسلسل الهرمي هذا لأي عمق مطلوب وذلك لتنفيذ كل المتطلبات التنظيمية.
    • وفي حالة itemType="button"، يتم انهاء هيكل XML حيث أن بنود القائمة popup فقط هي التي يمكن أن يكون لها بنود قوائم فرعية.
  • setting - كل من عناصر addInMenuItem أو (popup أو button) تتضمن عدد من الشارات setting والتي تقوم بتعريف طريقة ظهور وطريقة عمل القوائم الفرعية أو الاختيارات، مثل الوصف الخاص ببند القائمة، ورؤية التسمية أو التسمية التوضيحية، ومكان ادراج القائمة، وتصرف Application Integration الذي سيتم تنفيذه عند فتح أو تحديد بند القائمة. القسم تحديد الشارات يقدم تفاصيل كاملة عن شارات setting.

على سبيل المثال، للتعرف على كيفية استخدام هذه الشارات في ملفات XML، see مثال لملف XML Schema.

تحديد الشارات

كل من عناصر addInMenuItem تقوم باستخدام الشارات setting لتعريف طريقة الظهور وطريقة عمل القوائم الفرعية للوظائف الاضافية أو مفاتيح الأوامر. وتتوقف صيغة الشارة على المفتاح الذي يتم تعريفه. على سبيل المثال، بعرض المفاتيح تتطلب المجال النوع، بينما البعض الآخر لا يتطلب ذلك:

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

في الجدول التالي، اذا كان المفتاح لا يتطلب استخدام مجال النوع أو لا يتطلب تحديد قيمة، فسيكون الادخال في عمود النوع أو القيمة هو "غير قابل للتطبيق". واذا كانت القيمة الخاصة بالمفتاح ليست بأحد متغيرات Application Integration المعروفة، مثل popup أو button، فسيظهر الادخال في عمود القيمة بخط مائل؛ على سبيل المثال، 30002. بالاضافة الى ذلك، اذا كان المفتاح غير مطلوب، سيتضمن الادخال في عمود الوصف المؤشر [اختياري].

ويدعم Application Integration شارات setting التالية.
جدول 3. لعرض كل من المفاتيح، مع النوع والقيمة والوصف الخاص به.
المفتاح النوع القيمة الوصف
itemType غير قابل للتطبيق popup يشير الى أن بند القائمة الخاصة بالوظيفة المساعدة هو عبارة عن قائمة فرعية منبثقة تظهر مع تفرعات، والتي يمكن أن تتضمن مفاتيح الأوامر وقوائم فرعية أخرى اضافية.
  غير قابل للتطبيق :NONE. يشير الى أن بند القائمة الخاصة بالوظيفة المساعدة هو عبارة عن أحد مفاتيح اختيار الأمر بدون تفرعات.
الوصف غير قابل للتطبيق قائمة ملف P8 [اختياري] ويقدم شرح لبند قائمة الوظيفة الاضافية والذي يعتبر اخباري فقط؛ ولن يكون هذا الوصف مرئيا للمستخدمين.
التسمية 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 لادخال التسمية المرئية أو التسمية التوضيحية لبند قائمة الوظيفة الاضافية بتحديد قيمة من رقم صحيح تقابل كود تعريف أحد المصادر المعرفة في ملف الترجمة الخاص بالمصدر.
  النص انهاء تخصيص... لادخال تسمية مرئية أو تسمية توضيحية لبند قائمة الوظيفة الاضافية من خلال ادخال نص من مجموعة حروف معينة.
visible غير قابل للتطبيق true يحدد أن بند القائمة للوظيفة الاضافية (وأي من التفرعات الخاصة به اذا كان بند القائمة عبارة عن قائمة فرعية منبثقة) سيكون مرئيا للمستخدم.
    false يحدد أن بند القائمة للوظيفة الاضافية (وأي من التفرعات الخاصة به اذا كان بند القائمة عبارة عن قائمة فرعية منبثقة) سيكون مرئيا للمستخدم (أي أنه، بند القائمة لن يظهر في قوائم الوظيفة الاضافية).
enabled غير قابل للتطبيق true يحدد أن بند القائم للوظيفة الاضافية سيكون متاحا، أي أنه سيكون من الممكن للمستخدم فتح القائمة الفرعية المنبثقة أو تحديد مفتاح الأمر.
    خطأ يحدد أن بند القائمة للوظيفة الاضافية لا يمكن فتحه أو تحديده من خلال المستخدم (أي أنه، بند القائمة لن يكون متاحا في قوائم الوظيفة الاضافية).
parent menuId 30002 قم بادخال قيمة "menuId" للقائمة الرئيسية من بند القائمة لوظيفة الاضافية. اذا كان بند القائمة عبارة عن قائمة فرعية منبثقة، ستكون هذه القيمة هي كود التحكم لأحد القوائم المنبثقة الى Microsoft Office. للحصول على المزيد من المعلومات عن أكواد القوائم في Microsoft Office Applications، ارجع الى Microsoft Office Developers Guide for Office 2003/XP/2007.
  topLevel غير قابل للتطبيق اذا كان بند القائمة للوظيفة الاضافية عبارة عن قائمة فرعية منبثقة، فان هذا المفتاح مع قيمة النوع تحدد أن القائمة الفرعية سيتم وضعها بخط القائمة ذات المستوى الرئيسي من التطبيق.
ملاحظة: وهذا المفتاح مع النوع يعتبر صحيحا مع القوائم الفرعية المنبثقة فقط.
  غير قابل للتطبيق غير قابل للتطبيق اذا كان بند القائمة للوظيفة الاضافية هو عبارة عن مفتاح أمر، فسيتم العنصر الرئيسي يكون متضمنا في XML المحدد من خلال استخدام الشارة <list key="children">. وعلى ذلك، ليس من الضروري تحديد عنصر رئيسي في المكان setting هذا في ملف XML.
ملاحظة: وهذا المفتاح مع النوع يعتبر صحيحا مع مفاتيح الأوامر فقط.
المكان غير قابل للتطبيق 4 يحدد مكان الادراج لبند القائمة للوظيفة الاضافية على القائمة الرئيسية. القيمة -1 توضح أن بند القائم سيتم الحاقه في نهائة القائمة الموجودة.
ملاحظة: وهذه القيمة توضح المكان المطلوب لبند القائمة في القائمة الرئيسية المنبثقة.
الأمر 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 غير قابل للتطبيق اذا كان بند القائمة الخاصة بالوظيفة المساعدة هو عبارة عن قائمة فرعية منبثقة، سيتم تجاهل الضغط على القائمة. وعلى ذلك، ليس من الضروري تحديد أمر في المكان setting هذا في ملف XML.
ملاحظة: وهذا المفتاح مع النوع يعتبر صحيحا مع القوائم الفرعية المنبثقة فقط.

على سبيل المثال، للتعرف على كيفية استخدام هذه الشارات في ملفات XML، see مثال لملف XML Schema.

مثال لملف XML Schema

مقطع الكود التالي يوضح هيكل XML schema الرئيسي لقوائم الوظائف الاضافية في تطبيق 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>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>
...


تعليق توضيحي

آخر تحديث: مارس 2013
overview_addin_menus.htm

© .IBM حقوق النشر لشركة 2013.
يتم تشغيل مركز المعلومات هذا من خلال تقنيات Eclipse. ‏‎(http://www.eclipse.org)‎‏