مانیفست XML در افزونه آفیس چیست؟

پلتفرم افزودنی آفیس که برای ساخت برنامه کاربردی که برنامه آفیس را گسترش می دهد و برای تعامل با محتوای سند آفیس استفاده می شود. با استفاده از افزونه آفیس، توسعه دهنده می تواند از HTML، CSS، جاوا اسکریپت برای تعامل با Word، Excel، PowerPoint، Outlook استفاده کند. این برنامهها میتوانند در چندین پلتفرم مانند Windows، Mac، iPad و در یک مرورگر اجرا شوند. افزونه آفیس می تواند هر کاری را که یک صفحه وب در داخل مرورگر انجام دهد انجام دهد.
با استفاده از افزونه آفیس، توسعه دهنده می تواند کارهای زیر را انجام دهد:
افزودن قابلیت جدید به آفیس کلاینت:
با استفاده از افزونه آفیس، توسعهدهنده میتواند از دادههای خارجی در دفتر استفاده کند، قابلیتهای شخص ثالث را اضافه کند، اسناد اداری را خودکار کند، مشتریان درونآفیس. مثال: Microsoft graph API که برای افزایش بهره وری استفاده می شود.
یک شیء تعاملی جدید ایجاد کنید که می تواند در سند آفیس جاسازی شود:
افزونه آفیس میتواند نقشهها، نمودارها و تجسم تعاملی را ارائه دهد تا توسعهدهندگان بتوانند برگه اکسل سفارشی و ارائه پاورپوینت را اضافه کنند.
افزایه های آفیس مانیفست XML
معرفی
فایل مانیفست XML افزونه آفیس برای توضیح نحوه فعال شدن افزونه شما هنگام نصب و استفاده از آن با اسناد و برنامههای کاربردی، استفاده میشود. فایل مانیفست حاوی آدرسهای اینترنتی ارجاعی است که برنامه وب شما میتواند در آنها قرار گیرد و منابع دیگری برای تصاویر افزودنی مانند. offappmanifest.xsd برای توصیف طرح XML استفاده میشود که در برنامههای اداری مانند برنامه rich Client و کلاینت وب مربوطه آنها رایج است.
توجه: طرح مانیفست نسخه 1.1 باید در افزونه آفیس استفاده شود.
یک فایل مانیفست XML بر اساس طرحواره ای است که یک Office-Add-in را فعال می کند که برای انجام کارهای زیر استفاده می شود:
- فایل XML برای توصیف خود با استفاده از نام نمایش شناسه، نسخه و توضیحات و محل پیش فرض استفاده می شود.
- فایل XML برای تعیین محل HTML که برای ارائه رابط کاربری آفیس افزونه استفاده می شود، استفاده می شود.
- فایل XML برای تعیین بعد پیشفرض درخواستی برای افزودنی محتوا و همچنین ارتفاع درخواستی برای افزونه Outlook استفاده میشود.
- فایل XML برای تعریف مجوز استفاده شده توسط افزونه آفیس برای اهداف خواندن یا نوشتن استفاده می شود.
- فایل XML برای نمایش محتوا در سند، در پنجره کار یا به صورت متنی با پیام، قرار ملاقات یا مورد درخواست جلسه استفاده می شود.
- فایل XML قوانینی را تعریف میکند که برای مشخص کردن زمینهای که در آن فعال میشوند یا با استفاده از پیام، قرار ملاقات، یا آیتم درخواست جلسه برای افزونه Outlook در تعامل هستند، استفاده میشوند.
بیشتر بخوانید: توسعه افزونه آفیس: Vsto Add-ins در مقابل Javascript Api
نمونه ها و طرحواره های فایل XML Manifest v1.1
مثال زیر محتوا، پنل وظیفه، Outlook و افزونه دفتر فرهنگ لغت را نشان می دهد:
در ویژوال استودیو، طراح مانیفست ویژوال استودیو برای تنظیمات مانیفست افزونه آفیس به جای تغییر دستی XML استفاده می شود. به طور پیش فرض فایل مانیفست ویژوال استودیو در طراح مانیفست باز می شود. با استفاده از مانیفست، طراح یافتن و کاهش خطای ورود داده در کادر لیست کشویی را آسانتر میکند.
نمونه ای از افزودنی دفتر محتوا Manifestv1.1
افزودنی محتوا:
افزودنی دفتر محتوا می تواند مستقیماً در اکسل یا پاور پوینت گنجانده شود و برای افزودن عملکرد مستقیم به سند استفاده شود. افزودنی محتوا رابط کاربری را برای اجرای کد برای ویرایش سند یا نمایش داده ها از منبع داده ارائه می دهد.
<!--?xml encoding="utf-8" version="1.0"-->
<!--?xml encoding="utf-8" version="1.0"-->
<officeapp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ContentApp">
<id>01eac144-e55a-45a7-b6e3-f1cc60ab0126</id>
<alternateid>en-US\WA123456789</alternateid>
<version>1.0.0.0</version>
<providername>Microsoft</providername>
<defaultlocale>en-US</defaultlocale>
<displayname defaultvalue="Sample content add-in">
<description defaultvalue="Describe the features of this app.">
<iconurl defaultvalue="https://contoso.com/ENUSIcon.webp">
<hosts>
<host name="Workbook">
<host name="Database">
</host></host></hosts>
<requirements>
<sets defaultminversion="1.1">
<set name="TableBindings">
</set></sets>
</requirements>
<defaultsettings>
<sourcelocation defaultvalue="https://contoso.com/apps/content.html">
<requestedwidth>400</requestedwidth>
<requestedheight>400</requestedheight>
</sourcelocation></defaultsettings>
<permissions>Restricted</permissions>
<allowsnapshot>true</allowsnapshot>
</iconurl></description></displayname></officeapp>
<!--?xml-->
شکل: طرح افزودنی محتوا
نمونه ای از افزونه آفیس در پنل وظیفه Manifestv1.1 Task Panel:
پنل وظیفه رابطی را ارائه می دهد که معمولاً در سمت راست پنجره در داخل word، Outlook، PowerPoint نمایش داده می شود. افزونه Task Panel رابط کاربری را برای اجرای کد برای ویرایش سند یا ایمیل ها، نمایش داده ها از منبع داده فراهم می کند. پانل وظیفه زمانی استفاده می شود که نیازی به افزودن عملکرد مستقیم به سند نباشد.
<!--?xml encoding="utf-8" version="1.0"-->
<!--?xml encoding="UTF-8" version="1.0"-->
<officeapp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="TaskPaneApp">
<id>412ce350-4161-4ad0-a5f5-0ec9d2cd3570</id>
<version>1.0.0.0</version>
<providername>Microsoft</providername>
<defaultlocale>en-US</defaultlocale>
<displayname defaultvalue="Sample task pane add-in">
<override locale="en-US" value="Project add-in">
</override></displayname>
<description defaultvalue="Describe the features of this app.">
<override locale="en-US" value="Adds project management information to documents">
</override></description>
<iconurl defaultvalue="https://contoso.com.sa/ProjectApp/Topgunas-SA.webp">
<override locale="en-US" value="https://contoso.com/ProjectApp/Topgunen-US.webp">
</override></iconurl>
<appdomains>
<appdomain>http://www.projectlogin.com</appdomain>
<appdomain>http://m.projectlogin.com</appdomain>
<appdomain>http://www.projectlogin.com.sa</appdomain>
<appdomain>http://m.projectlogin.com.sa</appdomain>
</appdomains>
<hosts>
<host name="Document">
<host name="Workbook">
<host name="Presentation">
<host name="Project">
</host></host></host></host></hosts>
<defaultsettings>
<sourcelocation defaultvalue="https://contoso.com.sa/ProjectApp/ProjectAppar_SA.html">
<override locale="en-US" value="https://contoso.com/ProjectApp/ProjectAppen-US.html">
</override></sourcelocation>
</defaultsettings>
<permissions>ReadWriteDocument</permissions>
</officeapp>
<!--?xml-->
آیا می خواهید شرکت توسعه افزونه Trusted Outlook را استخدام کنید؟ جستجوی شما در اینجا به پایان می رسد.
نمونه ای از افزونه Outlook Office Manifestv1.1
افزونه Outlook Office:
با استفاده از افزونه Outlook، توسعهدهنده میتواند از HML، CSS، جاوا اسکریپت برای ساخت برنامهای استفاده کند که بتواند چندین پلتفرم مانند ویندوز، مک و IOS را اجرا کند.
<!--?xml encoding="utf-8" version="1.0"--><!--?xml encoding="UTF-8" version="1.0"-->
<!--?xml encoding="utf-8" version="1.0"-->
<officeapp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="MailApp">
<id>971E76EF-D73E-567F-ADAE-5A76B39052CF</id>
<version>1.0</version>
<providername>Microsoft</providername>
<defaultlocale>en-us</defaultlocale>
<displayname defaultvalue="YouTube">
<description defaultvalue="Watch YouTube videos referenced in the e-mails you
receive without leaving your email client.">
<override locale="fr-fr" value="Visualisez les vid????os
YouTube r????f????renc????es dans vos courriers ????lectronique
directement depuis Outlook et Outlook Web App.">
</override></description>
<!-- Change the following line to specify -->
<!-- the web serverthat hosts the icon file. -->
<iconurl defaultvalue="https://webserver/YouTube/YouTubeLogo.webp">
<hosts>
<host name="Mailbox">
</host></hosts>
<requirements>
<sets defaultminversion="1.1">
<set name="Mailbox">
</set></sets>
</requirements>
<formsettings><form xsi:type="ItemRead">
<desktopsettings>
<!-- Change the following line to specify -->
<!-- the web server that hosts the HTML file. -->
<sourcelocation defaultvalue="https://webserver/YouTube/YouTube_read_desktop.htm">
<requestedheight>216</requestedheight>
</sourcelocation></desktopsettings>
<tabletsettings>
<!-- Change the following line to specify -->
<!-- the web server that hosts the HTML file. -->
<sourcelocation defaultvalue="https://webserver/YouTube/YouTube_read_tablet.htm">
<requestedheight>216</requestedheight>
</sourcelocation></tabletsettings></form>
<form xsi:type="ItemEdit">
<desktopsettings>
<!-- Change the following line to specify -->
<!-- the web server that hosts the HTML file. -->
<sourcelocation defaultvalue="https://webserver/YouTube/YouTube_compose_desktop.htm">
</sourcelocation></desktopsettings>
<tabletsettings>
<!-- Change the following line to specify -->
<!-- the web server that hosts the HTML file. -->
<sourcelocation defaultvalue="https://webserver/YouTube/YouTube_compose_tablet.htm">
</sourcelocation></tabletsettings></form>
</formsettings>
<permissions>ReadWriteItem</permissions>
<rule mode="Or" xsi:type="RuleCollection">
<rule mode="And" xsi:type="RuleCollection">
<rule mode="Or" xsi:type="RuleCollection">
<rule formtype="Read" itemtype="Appointment" xsi:type="ItemIs">
<rule formtype="Read" itemtype="Message" xsi:type="ItemIs">
</rule>
<rule propertyname="BodyAsPlaintext" regexname="VideoURL" regexvalue="http://(((www\.)?youtube\.com/watch\?v=)|
(youtu\.be/))[a-zA-Z0-9_-]{11}" xsi:type="ItemHasRegularExpressionMatch">
</rule>
<rule mode="Or" xsi:type="RuleCollection">
<rule formtype="Edit" itemtype="Appointment" xsi:type="ItemIs">
<rule formtype="Edit" itemtype="Message" xsi:type="ItemIs">
</rule>
</rule>
</rule></rule></rule></rule></rule></iconurl></displayname></officeapp>
<!--?xml-->
نتیجه
در این وبلاگ به بررسی افزونه آفیس و فایل مانیفست در افزونه آفیس پرداخته ایم. همچنین در مورد نمونه محتوا، پنل وظیفه، افزونه چشم انداز در آفیس صحبت کرده ایم.