Paano gumawa ng mga add-in ng Office nang hakbang-hakbang

Kung nagtataka ka Paano gumawa ng mga add-in sa Office (o mga add-in, plugin, extension… anuman ang gusto mong tawag sa kanila), nasa tamang lugar ka. Ang mga add-on ay maliliit na web application na sumasama sa Salita, Excel, Outlook, PowerPoint, OneNote, Project at iba pa app upang palawakin ang magagawa na ng Office, mula sa pag-automate ng mabibigat na gawain hanggang sa pagkonekta sa mga external na serbisyo sa cloud.

Bago ka magsimulang magprogram na parang wala nang bukas, mahalagang maunawaan iyon Ang isang Office add-in ay hindi lamang isang simpleng standalone na scriptNakatira ito sa platform ng Office Add-ins, inilalarawan ng isang manifest, at tumatakbo bilang isang web application na nakikipag-ugnayan sa Office gamit ang JavaScript API. Mula rito, mahinahon naming hihiwalayin ang lahat ng kailangan mong malaman: mga tool para sa paggawa ng mga proyekto, panloob na istraktura, mga modelo ng API, kung paano subukan at i-debug, kung paano i-publish ang mga ito, at maging kung paano pinamamahalaan ang mga pahintulot at pag-access mula sa loob ng mga application mismo.

Ano nga ba ang isang Office add-in?

Ang isang Office add-in ay karaniwang isang web application na isinasama sa mga application ng Microsoft 365 (Word, Excel, Outlook, PowerPoint, OneNote, Project, atbp.) at pinapalawak ang kanilang interface at mga kakayahan. Maaari mong isipin ito bilang isang karagdagang piraso na "nakakabit" sa ribbon, menu ng konteksto, o isang side panel upang mag-alok ng mga bagong feature.

ang grasya ay iyon Gumagana ang plugin gamit ang mga karaniwang teknolohiya sa web. (HTML, CSS, JavaScript, o TypeScript, at maging ang mga framework tulad ng React) at nakikipag-ugnayan sa dokumento o email na mensahe gamit ang Office JavaScript API. Nagbibigay-daan ito dito na magbasa at magbago ng nilalaman, magpakita ng sarili nitong custom na interface, at makipag-ugnayan sa mga panlabas na serbisyo, REST API, mga panloob na system ng iyong kumpanya, at higit pa.

Ang dalawang pangunahing bahagi ng isang Office add-in

Ang bawat add-in ng Opisina ay palaging binubuo ng dalawang mahusay na pagkakaiba-iba ng mga bahagina dapat isaisip mula pa sa simula:

• Ang Complement Manifesto, na tumutukoy sa configuration, gawi, at kung paano ito isinasama sa interface ng Office.
• Ang web application, na siyang aktwal na code (HTML, CSS, JavaScript/TypeScript) na nag-render ng interface ng task pane, mga dialog box, o mga plugin ng nilalaman at naglalaman ng logic ng negosyo.

Ang manifesto ay kumikilos bilang “identity card” at manual ng pagtuturo ng add-in, habang ang web application ay ang "engine" na gumagawa ng totoong trabaho at nakikipag-ugnayan sa dokumento o email gamit ang Office JavaScript API.

Ano ang tumutukoy sa manifesto ng isang pandagdag

Ang manifest ng isang Office add-in, na karaniwang nakaimbak bilang manifest.xml o manifest.json Sa ugat ng proyekto, naglalaman ito ng lahat ng impormasyon na kailangang malaman ng Office kung ano ang ginagawa ng iyong add-in, kung saan ito naka-host, at kung paano ito dapat ipakita sa user.

Ang manifesto ay tumutukoy, bukod sa iba pang mga bagay, ang mga sumusunod: pangunahing elementona dapat panatilihin sa ilalim ng malapit na kontrol:

• Metadata ng plugin: identifier (ID), bersyon, pangalan ng display ng user, paglalarawan, default na lokal, atbp.
• Mga katugmang aplikasyon sa OpisinaHalimbawa, kung magagamit ang add-in sa Word, Excel, Outlook, PowerPoint, Project, o OneNote.
• Mga kinakailangang pahintulot: anong antas ng access ang kailangan mo sa dokumento, Outlook mailbox, o iba pang mapagkukunan.
• Pagsasama sa interface ng Opisina: mga custom na tab, mga button sa ribbon, mga command na idinagdag sa menu ng konteksto, at iba pang elemento ng UI.
• Mga icon at larawan: mga landas patungo sa mga icon na ipapakita sa ribbon, mga menu at iba pang bahagi ng interface, na iginagalang ang pagba-brand ng plugin.
• Mga sukat ng pluginHalimbawa, ang laki ng isang content add-in o ang gustong taas ng isang Outlook add-in.
• Mga panuntunan sa pag-activate sa Outlook: kundisyon na tumutukoy kung kailan ipinapakita ang plugin sa isang email o quote (batay sa nagpadala, paksa, nilalaman, atbp.).
• Mga Shortcut sa KeyboardAvailable ang mga custom na shortcut sa Excel at Word.

Ang lahat ng ito ay gumagawa Ang manifesto ay kritikal para sa parehong pag-unlad at paglalathala.Kapag na-deploy mo ang plugin, ang aktwal na ipinamamahagi ay ang manifest file, na tumuturo sa URL kung saan naka-host ang web application.

Ang web application ng plugin

Ang pangalawang pangunahing piraso ng palaisipan ay ang web application, na siyang nakikita at nakikipag-ugnayan ng user. Ang application na ito ay karaniwang binubuo ng Mga HTML page, CSS stylesheet, at JavaScript o TypeScript scriptat maaaring itayo nang may o walang mga balangkas (Ang React ay isa sa pinakakaraniwan, ngunit hindi ang isa lamang).

Mula sa mga pahinang ito, ginagamit ng plugin ang Opisina ng JavaScript API upang basahin at baguhin ang nilalaman ng dokumento kung saan ito tumatakbo: Excel ranges, Word paragraphs, Outlook messages, PowerPoint slides, tables, charts, at marami pang iba. Higit pa rito, bilang isang web app, maaari itong:

• Kumonekta sa mga panlabas na serbisyo sa web upang makakuha o magpadala ng data.
• Pamahalaan ang pagpapatunay ng user gamit ang OAuth, Azure AD, o iba pang provider.
• Gumamit ng mga panloob na REST API ng iyong organisasyon.
• Ipatupad ang lahat ng kinakailangang lohika ng negosyo, mula sa mga advanced na kalkulasyon hanggang sa mga kumplikadong automation.

Mga tool para sa paggawa ng mga add-in sa Office

Nag-aalok ang Office add-in platform ng ilang paraan upang lumikha ng mga proyektong handa para sa pagpapaunladAng mga ito ay iniangkop sa iba't ibang profile at kagustuhan sa trabaho. Ang mga pangunahing opsyon ay: ang Yeoman generator, Visual Studio, ang Visual Studio Code Add-on Development Kit, at ang Microsoft 365 Agents Toolkit.

Gumawa ng mga plugin gamit ang Yeoman generator

Hinahayaan ka ng Yeoman's Office Add-In Generator Gumawa ng mga proyektong Node.js na handa nang gamitin at pamahalaan ang mga ito gamit ang Visual Studio Code o ibang editor. Ito ay isang napaka-maginhawang opsyon kung komportable kang magtrabaho sa isang purong JavaScript na kapaligiran, na may mga tool sa command-line.

Sa generator na ito magagawa mo lumikha ng mga add-on para sa:

• Manguna
• OneNote
• Tanawan
• PowerPoint
• proyekto
• Salita
• Mga custom na function ng Excel

Kapag pinatakbo mo ang wizard, maaari mong piliin kung gusto mo ng isang proyekto batay sa HTML, CSS at JavaScript o TypeScript na "bareback"o isang proyekto na may GantihinKatulad nito, sa JavaScript o TypeScript. Pinangangasiwaan ng generator ang pag-set up ng buong istraktura, mga dependency ng Node, at paunang pagsasaayos.

Mga kinakailangan para sa paggamit ng Yeoman

Upang gumana sa Yeoman generator para sa Opisina, kailangan mong magkaroon ng ilang software na naka-install. pangunahing bahagina karaniwan sa JavaScript ecosystem:

• Bersyon ng Node.js LTSIto ay dina-download mula sa opisyal na website ng Node.js at naka-install ayon sa iyong operating system.
• Yeoman at ang Office Add-In Generatorna naka-install sa buong mundo gamit ang command:
  npm install -g yo generator-office
• Isang aktibong subscription sa Microsoft 365 gamit ang Office, para masubukan mo ang mga add-in sa desktop at sa Office sa web.

Gumawa ng proyekto kasama si Yeoman

Kapag na-install mo na ang lahat, ang paglikha ng proyekto Ito ay medyo prangka. Mula sa command line, sa direktoryo kung saan mo gustong magtrabaho, tatakbo ka:

yo office

Magtatanong ang assistant ng sunud-sunod na tanong sa ayusin ang proyektoHalimbawa, para sa unang add-in ng task pane para sa Word, maaari mong sagutin ang isang bagay na katulad nito:

• Pumili ng uri ng proyekto: Proyekto ng Office Add-in Task Pane
• Pumili ng isang uri ng script: JavaScript
• Paano mo gustong pangalanan ang add-on? Aking Office Add-in
• Aling application ng kliyente ng Office ang gusto mong suportahan? Salita

Kapag natapos mo na ang wizard, bubuo si Yeoman ng lahat ng mga file ng proyekto at i-install ang kinakailangang mga module ng Node, nang sa gayon makakahanap ka ng fully functional na pangunahing accessory.

Ang istraktura ng proyekto ay nabuo kasama si Yeoman

Ang proyektong ginawa kasama si Yeoman para sa isang task board ay karaniwang may kasamang a magkatulad na istraktura dito, kung saan ang bawat bahagi ay gumaganap ng isang tiyak na tungkulin:

• ./manifest.xml o ./manifest.json: ang manifest na tumutukoy sa pagsasaayos, mga pahintulot, pagsasama sa interface at URL ng web application.
• ./src/taskpane/taskpane.html: ang HTML template ng task panel na makikita ng user.
• ./src/taskpane/taskpane.css: ang mga style sheet na humuhubog at nagdidisenyo ng panel.
• ./src/taskpane/taskpane.js: ang JavaScript code na nagpapatupad ng logic at tumatawag sa Office API.

Subukan ang isang plugin na ginawa gamit ang Yeoman

Upang subukan ang add-on, simple lang ipasok ang folder ng proyekto at magpatakbo ng ilang mga utos na simulan ang lokal na web server at i-load ang add-in sa Office.

1. Pumunta sa root folder ng proyekto:
   cd "My Office Add-in"
2. Simulan ang lokal na server at subukan sa desktop Word gamit ang:
   npm start

   Sinisimulan ng command na ito ang web server (kung hindi pa ito) at binubuksan ang Word nang awtomatikong na-load ang add-in.

3. Kung gusto mong subukan ang Word add-in sa iyong browser, maaari kang gumamit ng command tulad ng:
   npm run start -- web --document {url}

   Saan {url} Ito ay ang address ng isang dokumento ng Word na nakaimbak sa OneDrive o sa isang library ng SharePoint kung saan mayroon kang access. Kung sa ilang kadahilanan ay hindi naglo-load nang tama ang add-in sa Office sa web, maaari kang gumamit ng manu-manong pag-install at manu-manong pag-alis ng lokal na na-load na manifest.

4. Kapag na-upload na ang dokumento, maaari mong buksan ang task pane mula sa tab pagtanggap sa bagong kasapi sa pamamagitan ng pag-click sa pindutan Ipakita ang pane ng gawainSa pamamagitan ng pag-click sa link Tumakbo Sa panel, ang karaniwang halimbawa ay naglalagay ng "Hello, world" na may sariling istilo sa dokumento.
5. Upang ihinto ang lokal na server at, kung kinakailangan, i-uninstall ang na-load na plugin, maaari mong gamitin ang:
   npm stop

   Kung nagsagawa ka ng manu-manong lokal na pag-upload ng add-on, kakailanganin mong sundin ang partikular na pamamaraan upang alisin ang ganoong uri ng lokal na pag-upload.

Mga karaniwang problema sa Yeoman at npm

Sa panahon ng pag-install o pagpapatupad ng proyekto, medyo karaniwan itong makaharap mga babala at error ng npmAng ilang mga karaniwang sitwasyon ay:

• Mga pagkabigo ng awtomatikong hakbang install npm na ang generator mismo ay tumatakbo. Kung mamaya magsimula na ako Nagbibigay ito ng mga pagkakamali; kadalasan, sapat na upang pumunta sa folder ng proyekto at manu-manong patakbuhin ang a npm install.
• Mga babala tungkol sa hindi napapanahon o hindi tugmang mga dependency, na kadalasang hindi pumipigil sa plugin na tumakbo ngunit maaaring nakakainis. Kung gusto mong i-clear ang mga ito, maaari mong gamitin ang tool npm-check-updates tulad ng sumusunod:
  • I-install ang tool: npm i -g npm-check-updates
  • I-update ang mga bersyon sa package.json: ncu -u
  • I-install muli ang mga dependency: npm install

Paglikha ng mga add-on gamit ang Visual Studio

Visual Studio Pinapayagan ka nitong lumikha ng mga add-in ng Office nang direkta mula sa Visual Studio. Sa kasong ito, ang add-in na proyekto ay bahagi ng isang mas malaking solusyon at batay din sa HTML, CSS, at JavaScript.

Binibigyang-daan ka ng Visual Studio na lumikha ng mga add-in para sa:

• Manguna
• Tanawan
• PowerPoint
• Salita

Oo, Hindi nito sinusuportahan ang paggawa ng mga add-in para sa OneNote o ProjectPara sa mga application na iyon, kakailanganin mong gamitin ang Yeoman generator at sundin ang mga partikular na quickstart.

Bumuo at i-customize ang plugin sa Visual Studio

Kapag gumawa ka ng proyekto ng plugin gamit ang Visual Studio, bubuo ang kapaligiran isang pangunahing add-on na may limitadong pag-andar, nilayon bilang panimulang punto. Mula doon, ikaw ang namamahala sa pag-customize:

• El mahayag, pagsasaayos ng metadata, mga pahintulot, mga panuntunan sa pag-activate at mga elemento ng interface.
• Mga file HTML, CSS at JavaScript na humuhubog sa task pane o mga dialog box.

Upang masulit ito, mahalagang malaman pangkalahatang konsepto ng platform ng plugin (cycle ng buhay ng pag-unlad, manifest, mga modelo ng API, set ng mga kinakailangan) at gayundin ang mga partikular na aspeto ng bawat application: Excel, Word, Outlook, atbp.

Patakbuhin, i-debug, at i-publish mula sa Visual Studio

Sa panahon ng pag-unlad, pinapatakbo ng Visual Studio ang plugin laban sa isang lokal na web server (localhost)Kapag handa mo na ito para sa produksyon, ang karaniwang proseso ay binubuo ng:

1. I-publish ang web application sa isang server o serbisyo sa pagho-host (halimbawa, Microsoft Azure).
2. I-update ang manifesto upang tumuro ito sa final URL kung saan naka-host ang application.
3. Pagpili ng paraan ng pagpapatupad (catalog ng panloob na plugin, AppSource, atbp.) at ipamahagi ang manifest file sa mga user.

Ang mga detalye sa kung paano mag-debug sa iba't ibang platform at kung paano malutas ang mga partikular na problema ay makikita sa dokumentasyon. Nagde-debug ng Office Add-in sa Visual Studio at sa pangkalahatang mga gabay sa pagsubok at pag-debug.

Office Add-in Development Kit para sa Visual Studio Code

Kung ang iyong natural na kapaligiran ay Visual Studio Code, maaari mong i-install ang Office Add-in Development Kit, isang extension na nagpapadali sa iyong buhay kapag gumagawa, nagpapatakbo at nagde-debug ng mga proyekto ng plugin mula sa mismong editor.

Sa extension na ito magagawa mo lumikha ng mga bagong add-on na proyekto Mula sa isang may gabay na interface, maaari kang mag-load ng mga halimbawa nang direkta sa iyong kapaligiran nang hindi kinakailangang manu-manong i-set up ang buong configuration. Dina-download ang extension mula sa Visual Studio Marketplace at isinasama sa activity bar ng VS Code na may sarili nitong icon.

Gumawa ng proyekto gamit ang Development Kit

Mag-click sa pindutan ng paglikha ng proyekto ibinigay ng extension. Kung hindi mo ito na-install, sasabihan kang i-install ito.

Mula sa pahina ng extension, ipapakita sa iyo ang paglalarawan ng proyekto at maaari mong piliin ang opsyon Lumikha upang simulan ang pagbuo ng add-on.

Piliin ang folder ng trabaho kung saan malilikha ang proyekto kapag lumitaw ang dialog box ng pagpili ng folder.

Ang Development Kit ay lilikha ng istraktura ng file at Magbubukas ang proyekto sa pangalawang window ng VS Code.Sa puntong ito, ipinapayong isara ang paunang window upang gumana lamang sa bagong pagkakataon.

Ang resultang proyekto ay naglalaman din isang pangunahing add-on ng task pane, na may sample na code na handang tumakbo at baguhin.

Istruktura at mga pangunahing file sa isang proyekto ng VS Code

La istraktura ng ganitong uri ng proyekto Ito ay halos kapareho sa nabuo ni Yeoman, at karaniwan mong makikita ang:

1. Isang file ./manifest.xml o ./manifest.json sa ugat, kasama ang configuration at functionality ng add-on.
2. Ang file ./src/taskpane/taskpane.html na naglalaman ng HTML ng task pane.
3. Ang stylesheet ./src/taskpane/taskpane.css na kumokontrol sa visual na disenyo.
4. Ang iskrip ./src/taskpane/taskpane.js gamit ang Office JavaScript API code na nagkokonekta sa task pane sa Office application.

Subukan at ihinto ang isang plugin mula sa Development Kit

Upang subukan ang plugin mula sa VS Code gamit ang Development Kit Sundin lang ang ilang napakasimpleng hakbang gamit ang sariling activity bar ng extension:

1. Buksan ang extension sa pamamagitan ng pag-click sa icon. Office Add-in Development Kit sa activity bar.
2. Piliin ang pagpipilian Office Add-In Preview (F5), na naghahanda sa kapaligiran ng paglilinis.
3. Piliin ang opsyon mula sa menu ng mabilisang pagpili Desktop ng {Office Application} (Edge Chromium), pinapalitan ang {Office Application} ng app na gusto mo (Word, Excel, atbp.). Inilulunsad nito ang desktop application, nilo-load ang add-in, at ikinakabit ang debugger.

Sa prosesong ito, sinusuri ng kit na ang lahat ng nakaraang mga kinakailangan at mga palabas sa pandulo Detalyadong impormasyon kung may mali. Ang una boot Maaaring tumagal ng ilang sandali dahil ini-install ang mga kinakailangang dependency at certificate.

Kapag natapos mo ang pagsubok at pag-debug, ito ay napakahalaga itigil nang maayos ang pluginAng simpleng pagsasara ng Office app ay hindi palaging magiging wasto ang pagpaparehistro ng add-in. Upang gawin ito nang tama:

1. Buksan muli ang extension mula sa icon nito sa activity bar.
2. Mag-click sa Ihinto ang pag-preview sa Office add-in, na nagsasara ng web server at nag-clear sa log ng plugin mula sa cache.
3. Sa wakas isara ang Window ng aplikasyon sa opisina.

Kung napansin mo na ang plugin ay hindi nagsisimula o kumikilos nang kakaiba, karaniwan itong nakakatulong. Isara ang lahat ng pagkakataon ng Opisina at siguraduhing nahinto mo ang nakaraang server gamit ang sariling opsyon ng extension. Makakakita ka rin ng partikular na seksyon tungkol dito sa opisyal na dokumentasyon. pag-troubleshoot sa panahon ng pagbuo ng mga add-in ng OfficeAt sa matinding mga kaso, maaari kang magbukas ng isyu anumang oras sa GitHub.

Toolkit ng Mga Ahente ng Microsoft 365

Ang isa pang modernong opsyon ay ang paggamit Toolkit ng Mga Ahente ng Microsoft 365Isa itong hanay ng mga tool na idinisenyo upang lumikha ng halos anumang uri ng extension para sa Microsoft 365, kabilang ang mga add-in ng Office. Ito ay lalong kapaki-pakinabang kapag gusto mong isama ang mas advanced na lohika o gumamit ng mga kakayahan ng matalinong ahente sa loob ng Microsoft 365 ecosystem.

Gamit ang tool na ito magagawa mo i-configure ang mga proyekto ng plugin mula sa mas malawak na pananaw (hindi lang classic na Office, kundi ang buong Microsoft 365 environment), na gumagamit ng mga partikular na template at wizard. Ang opisyal na dokumentasyon ay nagdedetalye kung paano gumawa ng mga add-in na proyekto gamit ang toolkit na ito at kung paano isama ang mga ito sa iba pang mga serbisyo at daloy ng trabaho.

Access sa Office JavaScript API

Upang makipag-ugnayan ang iyong web application sa dokumento ng Office o mensahe kung saan ito tumatakbo, kailangan mong i-load ang Library ng Office JavaScript (office.js), na inihahatid mula sa opisyal na CDN ng Microsoft.

Ang karaniwang URL ng library ay:
https://appsforoffice.microsoft.com/lib/1/hosted/office.js

Sa anumang webpage ng iyong plugin na kailangang gumamit ng API, kakailanganin mong magdagdag ng isang script tag sa loob ng ulo ganito:

<head> ... <script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script> </head>

Mula sa sandaling iyon, magkakaroon ka ng namespace ng Office na magagamit at magagamit mo ang parehong mga API na tukoy sa application (Excel, Word, atbp.) tulad ng Mga karaniwang API na ibinabahagi ng ilang mga application. Higit pa rito, ipinapaliwanag ng opisyal na dokumentasyon kung paano paganahin ang mga feature tulad ng intellisense sa editor upang gumana nang mas kumportable.

Magagamit na mga modelo ng API

Nag-aalok ang Office add-in platform dalawang pangunahing modelo ng API sa JavaScriptna nagpupuno sa isa't isa at dapat na malinaw na makilala:

• Mga API na tukoy sa application
• Mga karaniwang API

ang Mga API na tukoy sa application Idinisenyo ang mga ito upang makipag-ugnayan sa mga katutubong bagay ng isang partikular na application. Halimbawa, sa mga API ng Excel maaari kang magtrabaho sa mga worksheet, saklaw, talahanayan, chart, at iba pang mga elementong partikular sa Excel, gamit ang mga bagay na malakas ang pagkaka-type.

Gumagana ang modelong API na ito ipinapangako at sumusuporta sa isang modelo ng batch operationsNagbibigay-daan ito sa iyo na i-chain ang maramihang mga operasyon sa iisang kahilingan sa application ng Office, na lubos na nagpapahusay sa pagganap, lalo na sa Office sa web. Ang modelong ito ay lumabas sa Office 2016 at pinalawak ng mga bagong hanay ng mga kinakailangan.

ang Mga karaniwang APIPara sa kanilang bahagi, nakatuon sila sa mga pag-andar ibinahagi sa pagitan ng ilang mga aplikasyon sa Opisina, gaya ng mga dialog box, setting ng kliyente, o ilang partikular na bahagi ng user interface. Ang modelong ito ay batay sa mga callback Sa halip na mga pangako, pinapayagan lamang nito ang isang operasyon sa bawat kahilingan. Ito ay backward compatible, dahil ipinakilala ito sa Office 2013 at ginagamit, halimbawa, upang makipag-ugnayan sa Outlook, PowerPoint, o Project sa isang pangunahing antas.

Mga hanay ng kinakailangan sa API

Sa loob ng JavaScript API, ang iba't ibang pangkat ng mga functionality ay isinaayos sa tinatawag na hanay ng mga kinakailanganAng bawat hanay ay nagpapangkat ng isang hanay ng mga miyembro ng API sa ilalim ng isang pangalan at bersyon, na nagbibigay-daan sa iyong malaman nang eksakto kung anong mga kakayahan ang available sa bawat kliyente ng Office.

Halimbawa, makakahanap ka ng mga set tulad ng:

• ExcelApi 1.7, na nagpapangkat ng mga partikular na API para sa Excel na available mula sa isang partikular na bersyon.
• DialogApi 1.1, na nag-aalok ng mga karaniwang function ng dialog box para sa ilang application ng Office.

Maaaring gamitin ng mga accessory ang mga set na ito upang Suriin sa runtime kung sinusuportahan ng isang application ang mga kinakailangang APIat sa gayon ay iakma ang pag-uugali nito o magpakita ng naaangkop na mga mensahe kung may hindi available. Ang partikular na compatibility ng bawat set ay nag-iiba depende sa plataporma (Windows, Kapote(web, mobile), ang bersyon ng Office at ang application mismo (Word, Excel, atbp.).

Galugarin ang mga API gamit ang Script Lab

Kung gusto mong gumamit ng mga API nang hindi bumubuo ng isang buong proyekto, maaari mong gamitin Script Lab, isang libreng add-on na available sa Microsoft Marketplace.

Hinahayaan ka ng Script Lab Direktang sumubok ng mga snippet ng code sa loob ng mga application tulad ng Excel o WordNakikita sa real time kung paano nakakaapekto ang mga ito sa dokumento. Ito ay perpekto para sa pag-aaral ng API, pagpapatunay ng maliliit na piraso ng lohika, o pagbuo ng mabilis na mga prototype bago isama ang mga ito sa iyong aktwal na plugin.

Sa loob ng Script Lab makikita mo isang library ng mga pre-built na halimbawa na maaari mong patakbuhin bilang ay o gamitin bilang batayan para sa iyong sariling code. Higit pa rito, ang opisyal na dokumentasyon ay kinabibilangan ng mga maiikling video na nagpapakita ng Script Lab sa pagkilos, na lubhang kapaki-pakinabang para sa pagkuha ng ideya ng lahat ng magagawa nito.

Palawakin ang user interface ng Office

Isa sa mga lakas ng mga accessories ay iyon Hindi lang sila nag-execute ng code na "behind the scenes"ngunit maaari silang ganap na isama sa interface ng Opisina, pagdaragdag ng mga tab, mga pindutan, mga menu at mga panel na iniayon sa iyong mga pangangailangan.

ang pinakakaraniwang anyo Ang mga sumusunod ay mga paraan upang mapalawak ang interface:

• Mga utos ng plugin na isinama sa ribbon o mga menu ng konteksto.
• Mga lalagyan ng HTML, gaya ng mga task pane, content add-on, at custom na dialog box.

Los mga utos ng plugin Binibigyang-daan ka ng mga command na ito na magdagdag ng mga bagong tab o mga grupo ng button sa ribbon ng Office, o kahit na palawakin ang menu ng konteksto na lalabas kapag nag-right-click ka sa teksto o mga bagay sa Excel. Kapag pinindot ng isang user ang isa sa mga command na ito, maaari itong magsagawa ng JavaScript code, magbukas ng partikular na task pane, o maglunsad ng dialog box.

Para sa kanilang bahagi, mga task pane, content add-in, at dialog box Ito ang mga HTML container na nagpapakita ng interface ng iyong add-in. Ang nilalaman ay ibinibigay ng mga web page na iyong tinukoy sa manifest, at mula sa mga page na ito maaari mong gamitin ang Office API upang makipag-ugnayan sa dokumento, bilang karagdagan sa lahat ng ginagawa ng isang regular na website: pagpapatotoo, mga tawag sa mga panlabas na API, visualization ng data, atbp.

Ang dokumentasyon para sa mga elemento ng user interface para sa mga add-in ng Office ay napupunta sa detalye tungkol sa kung paano idisenyo ang karanasan ng gumagamit, anong mga pattern ang inirerekomenda at kung paano samantalahin ang bawat uri ng container.

Maghanap at gumamit ng naka-install na plugin

Mula sa pananaw ng end user, kapag na-install o naipamahagi na ang isang plugin, Ang paghahanap nito sa loob ng Opisina ay napakadali.bagaman mayroon itong mga nuances depende sa aplikasyon.

1. Una sa lahat, kailangan mo Mag-log in sa Opisina gamit ang naaangkop na Microsoft 365 account. Upang gawin ito, buksan ang anumang application ng Office at, sa kanang sulok sa itaas, piliin ang opsyon sa pag-sign-in at ilagay ang iyong email at password.
2. Sa Word, Excel, o PowerPoint na mga desktop application, maaari kang pumunta sa Ipasok > Aking Mga Add-on upang makita ang listahan ng mga available na add-on para sa application na iyon.
3. Sa loob ng kahon Mga Add-in sa OpisinaMaaari kang maghanap para sa add-on ayon sa pangalan. Kung hindi ito lalabas, tingnan kung naka-log in ka gamit ang tamang account at, kung kinakailangan, mag-click sa I-update ang upang i-refresh ang listahan.
4. Kapag nahanap mo ang accessory, gawin mo lang i-double click ito upang magsimula at ipakita ang interface nito sa loob ng dokumento.

Ang pag-uugali na ito, batay sa link ng mga add-on sa user accountNagbibigay-daan ito sa mga add-in na palaging available sa iba't ibang device at application, hangga't ginagamit mo ang parehong Microsoft 365 account.

Pamamahala ng mga add-on at extension sa iba pang mga office suite

Bagama't nakatuon kami sa platform ng mga add-in ng Office dito, nakakatulong na magkaroon ng ilang konteksto sa pamamagitan ng paghahambing nito sa iba pang mga office suite at ang kanilang extension managementdahil ang pangkalahatang pilosopiya ay magkatulad.

COM add-in at add-in sa classic na Microsoft Office

Sa mga desktop na bersyon tulad ng Word 2016, bilang karagdagan sa mga modernong web-based na add-in, mayroon pa rin Mga bahagi ng COM at tradisyonal na mga add-inUpang pamahalaan ang mga ito, maaari kang pumunta sa File > Mga Opsyon at, sa seksyong mga add-on, suriin ang listahang nakapangkat ayon sa uri.

Kapag pumili ka ng isang item mula sa listahan, ang mga sumusunod ay ipapakita: ang mga detalye nito sa ibaba ng bintana. Ang isang karaniwang halimbawa ay ang add-on. FoxitReader PDF Lumikha, na opsyonal na idinaragdag kapag nag-i-install ng Foxit Reader at nagsasama ng karagdagang tab o mga button para gumawa at magmanipula ng mga PDF mula sa Word.

Sa ibaba ng window na ito ay may isang lugar na tinatawag Pamamahalana may drop-down na menu at isang button Upang pumunta… na nagbibigay-daan sa iyong pamahalaan ang isang partikular na uri ng extension: i-activate, i-deactivate, o alisin ang mga ito. Hindi lahat ng add-on ay nagdaragdag ng mga nakikitang button o tab; Ito ay ganap na nakasalalay sa kung paano sila idinisenyo ng developer..

Mga extension sa LibreOffice Calc

Sa LibreOffice, partikular sa Calc, maaari mong pamahalaan ang mga extension mula sa menu Mga Tool > Extension ManagerDoon ay makikita mo ang isang listahan ng mga naka-install na extension, na may mga pagpipilian upang magdagdag ng mga bago, i-update ang mga umiiral na, o i-uninstall ang mga ito.

Lumilitaw ang ilang extension kasama ng isang maliit na dilaw na padlockIto ay nagpapahiwatig na sila ay bahagi ng batayang pakete ng LibreOffice at hindi maaaring alisin. Upang mag-install ng mga bago, karaniwan kang pumunta sa opisyal na website ng LibreOffice. Mga extension at template ng LibreOffice, naka-host sa https://extensions.libreoffice.org/Bagama't ang site ay halos nasa English, karamihan sa mga developer ay nag-publish ng kanilang mga extension sa wikang iyon, kaya nakakatulong na huwag matakot dito.

Mga add-on sa mga dokumento ng Google Docs

Google Docs Nag-aalok din ito ng isang sistema ng pinagsamang mga plugin sa loob mismo ng interface. Mula sa menu Mga komplikasyon Mula sa isang dokumento, maaari mong pamahalaan ang mga na-install mo na at maghanap ng mga bago sa database. Google.

Pinapayagan ng system I-filter ayon sa mga kategorya, tingnan ang bilang ng mga user na nag-install ng bawat add-on.Maaari mong tingnan ang mga rating at review, at direktang i-install sa ilang pag-click lang. Ang pinagsama-samang tindahan na ito ay lubos na pinasimple ang proseso, dahil hindi na kailangang bisitahin ang anumang panlabas na website ng developer upang makahanap ng mga add-in.

Mga pahintulot at access sa mga feature ng device

Maaaring kailanganin ng ilang plugin, lalo na ang mga nakabatay sa modernong teknolohiya sa web access sa mga kakayahan ng device gaya ng camera, heyograpikong lokasyon, o mikropono. Kapag nangyari ito, ang browser o ang platform mismo ay nagpapakita ng isang dialog box na humihingi ng iyong pahintulot.

Karaniwang makikita mo ang mga pagpipilian tulad ng Payagan, Payagan Minsan, o Tanggihan:

• Kung pipiliin mo PayaganMagagawang i-access ng add-on ang mga hiniling na mapagkukunan nang tuluy-tuloy, hanggang sa i-uninstall mo ang add-on o i-clear ang cache ng browser kung saan ito tumatakbo.
• Kung pipiliin mo Payagan minsanIbibigay lang ang access sa kasalukuyang session, hanggang sa isara mo ang tab o window kung saan tumatakbo ang add-on.
• Kung pipiliin mo TanggihanHindi magkakaroon ng access ang add-on at, kapag kailangan itong muli, hihingi itong muli ng pahintulot sa pamamagitan ng isa pang dialog box.

Kung sa anumang oras gusto mo bawiin ang isang pahintulot na tinanggap mo gamit ang "Payagan"Kakailanganin mong i-uninstall ang add-on o i-clear ang cache ng iyong browser upang pilitin ang mga nakaraang desisyon na makalimutan at kailanganin muli.

Nag-aalok ang Office add-in ecosystem isang napaka-flexible na framework para sa pagpapalawak ng Word, Excel, Outlook, at higit pa Gamit ang mga karaniwang teknolohiya sa web, mga tool tulad ng Yeoman, Visual Studio, o ang VS Code Development Kit, at isang JavaScript API na may partikular at karaniwang mga modelo na sinusuportahan ng mga hanay ng mga kinakailangan, at may matibay na pag-unawa sa papel ng manifest, istraktura ng proyekto, mga opsyon sa pag-debug, mga paraan ng pag-deploy, at ang mga implikasyon ng mga pahintulot at pag-access sa device, posible na bumuo ng mga mahuhusay na solusyon na hindi nakakagambala sa pang-araw-araw na karanasan sa Opisina.