Excel Automation AddIn with Installer

الوظيفة الإضافية لأتمتة Excel مع المثبتات في VB.Net

الوظيفة الإضافية ¹ لأتمتة الوظائف المحددة بواسطة المستخدم (UDF) في Excel مع برنامج التثبيت المتكامل، وكلاهما مكتوب بلغة VB.Net

حل Microsoft Visual Studio 2022 الكامل وكود مصدر المشروع.

تم تضمين أدوات التثبيت لكل من الإصدارين 32 بت و64 بت من Office / Excel.

انقر فوق "الإصدارات" > "الأصول" للحصول على أمثلة معدة مسبقًا.

معلومات أساسية

لقد كانت وظائف Excel المحددة من قبل المستخدم (UDFs) كما تم تطويرها في VB.Net موجودة منذ سنوات عديدة، ومن الأمثلة المبكرة عليها -

• http://www.cpearson.com/Excel/CreatingNETFunctionLib.aspx

• https://www.codeproject.com/Articles/7753/Create-an-Automation-Add-In-for-Excel-using-NET

على الرغم من أن هذه الوظائف تعمل بشكل جيد، إلا أن نشرها يمكن أن يكون أكثر إشكالية، لا سيما عندما لا يكون المستخدمون النهائيون على دراية بأدوات سطر الأوامر المساعدة، أو يُسمح لهم بتشغيلها، مثل Regasm لإكمال التثبيت.

أهداف التصميم

وبالتالي فإن أهداف التصميم لهذا المشروع هي:-

• الوظيفة الإضافية لأتمتة برنامج Excel مع نماذج الوظائف المتوفرة
• مُثبِّت "النقر" المتكامل، وهو مألوف أكثر للمستخدمين النهائيين
• جميع عمليات التطوير في VB.Net باستخدام Microsoft Visual Studio 2022
• لا توجد مكتبات أو أدوات مساعدة تابعة لجهات خارجية مطلوبة
• أسلوب الترميز لدعم المطورين النادرين
• أدوات التثبيت لكل من الإصدارين 32 بت و64 بت من Office

التبعيات

يلزم وجود جهاز كمبيوتر يعمل بنظام Windows مثبت عليه البرنامج التالي لإنشاء الحل

• مايكروسوفت ويندوز 10، 64 بت
• مايكروسوفت.نت فريم ورك 4.7.2
• مايكروسوفت أوفيس/إكسل 32 بت أو 64 بت
• مايكروسوفت فيجوال ستوديو 2022 (أي إصدار)

يوصى بإنشاء "بنية جديدة" لجميع المكونات المذكورة أعلاه، على جهاز كمبيوتر مخصص للتطوير إن أمكن، ومع تطبيق كافة التحديثات.

يجب أن يحتوي Visual Studio على العناصر التالية مثبتة

• عبء العمل. تطوير سطح المكتب الصافي
• عبء العمل في تطوير المكاتب/نقاط المشاركة
• تمديد مشاريع تثبيت Visual Studio 2022

المرافق الاختيارية

الأداة المساعدة التالية مفيدة لفحص عملية التسجيل، ولكنها ليست إلزامية.

• https://www.nirsoft.net/utils/registered_dll_view.html

مكتب 32/64 بت

يتم تسجيل الوظيفة الإضافية للأتمتة أثناء عملية التثبيت.

يجب كتابة قيم مختلفة إلى السجل للإصدارات 32 بت و64 بت من Office.

توفر فئة المثبت هذه القيم، ويتم تعيين خصائص الإجراء المخصص للإصدار المطلوب في كل مشروع مثبت.

يتم توفير مشاريع تثبيت Office منفصلة 32 بت و64 بت ويجب تصميمها لكل إصدار مطلوب.

الوظيفة الإضافية للأتمتة

الوظيفة الإضافية للأتمتة - تثبيت المستخدم

يقوم Visual Studio بإنشاء ملفي إخراج، setup.exe و AUTO_INSTALLER_nn.msi من كل مشروع مثبت

يمكن توزيع أي من هذه الملفات على المستخدمين النهائيين وتشغيلها للتثبيت وإلغاء التثبيت كما هو مطلوب.

الوظيفة الإضافية للأتمتة - تكوين Excel

بعد تشغيل برنامج التثبيت، يحتاج المستخدمون إلى تكوين Excel لتمكين الوظيفة الإضافية للأتمتة.

من Excel > ملف > خيارات > الوظائف الإضافية > إدارة وظائف Excel الإضافية

انقر فوق "الأتمتة"، وقم بالتمرير لأسفل وحدد "الأتمتة". الوظائف

انقر فوق "موافق" للتأكيد

الوظيفة الإضافية للأتمتة - صيغ Excel

يتم توفير نموذجين لصيغ Excel

=IFX() في خلية ورقة العمل تقوم بإرجاع السلسلة النصية AUTO FX OK

=TIMENOW() في خلية ورقة العمل تقوم بإرجاع الوقت الحالي بالمللي ثانية، على سبيل المثال 12:34:56.789

هذه دالة "متطايرة" وسيتم إعادة حسابها عند الضغط على المفتاح F9 أو عند تغيير خلية أخرى.

يمكن إدراج الوظائف التي تقدمها الوظيفة الإضافية من خلال النقر على الصيغ > إدراج دالة وتحديد AUTOMATION.Functions كفئة

الوظيفة الإضافية للأتمتة - إلغاء التثبيت

يمكن للمستخدمين إلغاء تثبيت الوظيفة الإضافية عن طريق النقر بزر الماوس الأيمن فوق الزر "ابدأ" في Windows وتحديد التطبيقات والميزات

قم بالتمرير لأسفل إلى Automation FX وحدد إلغاء التثبيت

ملاحظات التنفيذ

وحدة فئة المثبت

وحدة فئة المثبت

تقوم الوحدة النمطية للفئة Installer.vb بإجراء تحديثات تسجيل التجميع والتسجيل المطلوبة عندما يقوم المطور أو المستخدم النهائي بتشغيل برنامج التثبيت .exe أو .msi.

يتم توفير العلامة <System.ComponentModel.RunInstaller(True)> تلقائيًا بواسطة vb.net في الملف Installer.Designer.vb عند إضافة وحدة نمطية جديدة لفئة Installer إلى مشروع.

يتم استخدام هذه العلامة بواسطة برنامج التثبيت لاستدعاء Public Overrides Sub Install(stateSaver As IDictionary) عبر خصائص الإجراء المخصص في المشروعين AUTO_INSTALLER_32 وAUTO_INSTALLER_64.

يقوم Install الفرعي بعد ذلك باستدعاء RegisterAssembly وهو ما يعادل وظيفيًا ² تشغيل RegAsm.exe يدويًا.

يستخدم RegAsm.exe نفسه الأساليب التي تم الكشف عنها بواسطة RegistrationServices ³

خصائص تكوين COM

وظائف AUTO_FUNCTIONS للمشروع - الخصائص

يجب دائمًا مراعاة النقاط التالية لتجنب إجراء أي تحديثات متعارضة للسجل أثناء التطوير والاختبار.

في المشروع AUTO_FUNCTIONS > الخصائص، لا ينبغي تحديد الخيارات أدناه في أي وقت.

• Register for COM Interop في قسم الترجمة
• Make assembly COM-Visible في قسم التطبيق > معلومات التجميع

يجب أيضًا عدم استخدام العلامات <ComRegisterFunction> و <ComUnRegisterFunction> في أي وحدة نمطية.

---

المشروعان AUTO_INSTALLER_32 وAUTO_INSTALLER_64 - خصائص الإخراج الأساسية

في كل مشروع > خصائص الإخراج الأساسية، يجب تعيين التسجيل على vsdrpDoNotRegister

بناء الإنتاج

يجب تطوير نسخة إنتاجية جديدة للتأكد من أن جميع المعرفات الفريدة العمومية (GUIDs) فريدة من نوعها وأن كافة تحديثات Visual Studio ومراجعها وتبعياتها مدمجة.

الحواشي

1. https://support.microsoft.com/en-us/topic/excel-com-add-ins-and-automation-add-ins-91f5ff06-0c9c-b98e-06e9-3657964eec72 ↩

2. https://learn.microsoft.com/en-us/dotnet/framework/interop/registering-assemblies-with-com ↩

3. https://learn.microsoft.com/en-us/dotnet/api/system.runtime.interopservices.registrationservices?view=netframework-4.8.1 ↩