Ja domājat par savu Office pievienojumprogrammu izveidi, jūs droši vien jau esat sapratis, ka tas nav tikai "nedaudz koda uzrakstīšana", un tas arī viss. Profesionāla Office pievienojumprogramma ietver platformas, JavaScript API, manifesta un izstrādes rīku izpratni. ko piedāvā Microsoft, papildus zināšanām par to, kā to pārbaudīt, atkļūdot un, protams, kā padarīt lietotāja pieredzi patīkamu.
Šajā rokasgrāmatā mēs aplūkosim visu ceļu, no pirmā prototipa līdz lietošanai gatavam pievienojumprogrammas modulim programmām Word, Excel, Outlook un citām Microsoft 365 lietojumprogrammāmJūs redzēsiet, kādi rīki jums ir pieejami (Yeoman, Visual Studio, Agents Toolkit, Visual Studio Code Development Kit), kā pievienojumprogramma ir strukturēta iekšēji, kā tā izveido savienojumu ar Office API un kādas darbības jāveic, lai to palaistu un atkļūdotu gan datorā, gan tīmeklī.
Office pievienojumprogrammu platforma: sākumpunkts
Visas mūsdienu Office pievienojumprogrammas ir veidotas uz Office pievienojumprogrammu platforma, kas ir kopīga pamatprogramma programmām Word, Excel, Outlook, PowerPoint, OneNote un ProjectTas nozīmē, ka viena un tā pati arhitektūra tiek atkārtoti izmantota dažādās lietotnēs un ka daudzas izstrādes daļas ir standartizētas.
Pirms vienas koda rindiņas rakstīšanas ir noderīgi saprast dažus galvenos jēdzienus: kuras lietojumprogrammas un platformas ir saderīgas, kādus programmēšanas modeļus piedāvā Office JavaScript API, kā tiek definēts pievienojumprogrammas manifests un kā ir izstrādāta saskarne. (uzdevumu paneļi, dialoglodziņi, pielāgotas cilnes utt.). Viss šis izstrādes dzīves cikls ir mentālais ietvars, ko izmantosiet, lai pārietu no prototipa līdz faktiskai pievienojumprogrammai.
Kā tiek izveidotas Office pievienojumprogrammas?
Lai sāktu savu projektu, jums ir vairāki oficiāli maršruti, katrs no tiem ir paredzēts dažādiem izstrādātāju profiliem, taču visiem ir kopīgs mērķis: Ģenerējiet HTML, CSS un JavaScript (vai TypeScript) balstītu spraudņa risinājumu, kas integrējas ar OfficeGalvenās iespējas, ko pašlaik piedāvā Microsoft, ir:
- Yeoman ģenerators Office pievienojumprogrammām.
- Visual Studio (ar īpašu atbalstu Office pievienojumprogrammām).
- Microsoft 365 aģentu rīkkopa.
- Office pievienojumprogrammu izstrādes komplekts Visual Studio kodam.
Yeoman ģenerators Office pievienojumprogrammām
Yeoman ģenerators Office vajadzībām ir ideāli piemērots, ja jums ir ērti strādāt ar tīmekļa un komandrindas vidi. Yeoman izveido pilnībā funkcionējošu Node.js projektu, ko var atvērt Visual Studio Code vai jebkurā citā redaktorā., un visa struktūra (manifests, uzdevumrūts, stili un skripti) ir gatava pielāgošanas sākšanai.
Ar šo ģeneratoru jūs varat izveidot spraudņus priekš Excel, OneNote, Outlook, PowerPoint, Project, Word un arī pielāgoti Excel funkciju projekti.Izveidojot projektu, varat izvēlēties vienkāršu veidni ar HTML, CSS un JavaScript (vai TypeScript) vai arī izveidot skeletu ar React, izvēloties arī starp JavaScript un TypeScript atkarībā no jūsu vēlmēm.
Lai sāktu lietot Yeoman, jums ir nepieciešams Instalējiet Node.js LTS versiju savā sistēmā un pēc tam globāli instalējiet Yeoman un Office specifisko ģeneratoru, izmantojot npm.No konsoles to var izdarīt, palaižot:
npm install -g yo generator-office
Kad vide ir iestatīta, jums tikai jāveic šādas darbības: skrējiens vēlamajā direktorijā:
yo office
Vedņa laikā jums tiks lūgta informācija, piemēram, par projekta veidu (piemēram, Office pievienojumprogrammas uzdevumu rūts projekts), skripta veids (JavaScript vai TypeScript), papildinājuma nosaukums un Office lietojumprogrammu, uz kuru tā ir vērsta (Word, Excel, Outlook utt.). Izmantojot jūsu atbildes, Yeoman ģenerēs projekta mapi, instalēs nepieciešamās Node atkarības un atstās pievienojumprogrammu gatavu palaišanai un testēšanai.
Visual Studio Office pievienojumprogrammām
Ja vēlaties klasiskāku pieredzi un pilnīgu IDE, Visual Studio ietver veidnes Office pievienojumprogrammu izveidei programmām Excel, Outlook, Word un PowerPointŠajā gadījumā pievienojumprogrammas projekts ir daļa no Visual Studio risinājuma un darbojas arī ar HTML, CSS un JavaScript kā saskarnes un loģikas tehnoloģijām.
Šīs pieejas priekšrocība ir tā, ka Jūs izmantojat Visual Studio iebūvētos rīkus atkļūdošanai, projektu pārvaldībai, tipu atbalstam un publicēšanai.Tātad, ja jau esat nācis no .NET pasaules vai parasti strādājat ar sarežģītiem risinājumiem, šis ceļš jums varētu šķist ērtāks.
Microsoft 365 aģentu rīkkopa
Vēl viena īpaši interesanta iespēja, ja vēlaties paplašināt tradicionālās pievienojumprogrammas iespējas, ir Microsoft 365 aģentu rīkkopa — rīkkopa, kas paredzēta Microsoft 365 paplašinājumu izveidei plašā nozīmē.Ar šo risinājumu varat izstrādāt ne tikai Office pievienojumprogrammas, bet gandrīz jebkura veida paplašinājumus, kas mijiedarbojas ar Microsoft 365 pakalpojumiem.
Ar šo rīku komplektu tas ir iespējams Ģenerējiet Office pievienojumprogrammu projektus, izmantojot veidnes un vedņus, kas izstrādāti padziļinātām integrācijāmPiemēram, scenāriji, kuros jūsu pievienojumprogramma piedalās plašākās darbplūsmās vai mijiedarbojas ar citiem mākoņpakalpojumiem 365 ekosistēmā.
Office pievienojumprogrammu izstrādes komplekts Visual Studio kodam
Ja jūsu dabiskā vide ir VS Code, jums ir pieejams oficiāls paplašinājums: Office pievienojumprogrammu izstrādes komplekts, kas tieši integrējas Visual Studio Code aktivitāšu joslāAr šo paplašinājumu varat izveidot jaunus pievienojumprogrammu projektus un ātri ielādēt piemērus no paša redaktora.
Noklikšķinot uz atbilstošās opcijas paplašinājumā, Atveras vednis, kas ģenerē jūsu spraudņa projektu, ievieto to jūsu izvēlētajā darba mapē un atver jaunā Visual Studio koda logā.Šajā jaunajā logā jau būs iekļauta projekta struktūra, parasti ar pamata uzdevumu rūts piemēru, kas palīdzēs izprast arhitektūru.
Tur jūs varat pārskatīt galvenos failus, piemēram, manifest.xml vai manifest.json projekta saknē (kur spraudnis ir konfigurēts)un failus, kas definē uzdevumrūti: ./src/taskpane/taskpane.html marķēšanai, ./src/taskpane/taskpane.css stiliem un ./src/taskpane/taskpane.js kodam, kas izmanto Office API.
Office pievienojumprogrammas divas pamatdaļas
Katrs mūsdienīgs Office pievienojumprogrammas modulis parasti sastāv no diviem galvenajiem blokiem: manifests, kas norāda, kā pievienojumprogramma integrējas ar Office, un tīmekļa lietojumprogramma, kas definē lietotāja saskarni un loģiku.
- Papildu manifests Aprakstiet pievienojumprogrammas konfigurāciju, metadatus, atļaujas, integrācijas punktus un darbību.
- Tīmekļa lietojumprogramma Tas ir HTML lapu, skriptu un stilu kopums, kas tiek parādīts uzdevumu rūtīs, satura pievienojumprogrammās, dialoglodziņos un citos Office konteineros.
Tīmekļa lietojumprogramma izmanto Office JavaScript API mijiedarbībai ar dokumentu (vai e-pasta ziņojumu, ja runa ir par Outlook), kurā darbojas pievienojumprogrammaTurklāt, tāpat kā jebkura tīmekļa lietojumprogramma, tā var autentificēties pret ārējiem pakalpojumiem, izmantot REST API, strādāt ar lietotāja identitāti un daudz ko citu.
Manifests: spraudņa konfigurācija un iespējas
Manifestā ir definēts praktiski viss, kas Office jāzina par jūsu risinājumu, tāpēc tas ir kritiski svarīgs fails. Tas ietver metadatus (ID, nosaukumu, aprakstu, versiju, noklusējuma lokalizāciju) un arī to Office lietojumprogrammu saraksts, kurās var ielādēt pievienojumprogrammu.
Manifestā ir arī noteikts, ka pievienojumprogrammai nepieciešamās atļaujas, kā tā integrējas ar Office saskarni un jebkuru pielāgoto lietotāja saskarni, ko tā pievienoTas ietver noteiktas cilnes lentē, papildu pogas, kontekstizvēlnes vai pievienojumprogrammu komandas.
Vēl viens aspekts, kas tiek kontrolēts no manifesta, ir attēli, kas izmantoti spraudņa ikonogrāfijai, zīmola pielāgošanai un konteinera izmēriem (piemēram, satura pievienojumprogrammas lielums vai Outlook pievienojumprogrammas vēlamais augstums).
Konkrētajā Outlook gadījumā varat definēt manifestā noteikumi, kas nosaka, kad spraudnis tiek aktivizēts, pamatojoties uz ziņojuma vai citāta kontekstuUn tādām lietojumprogrammām kā Excel un Word ir iespējams deklarēt īpašus īsinājumtaustiņus, kas aktivizē pievienojumprogrammu funkcijas.
Tīmekļa lietojumprogramma un mijiedarbība ar Office dokumentu
Otra galvenā daļa ir tīmekļa lietojumprogramma, kas ir tas, ko lietotājs redz un ar ko mijiedarbojas. Šī lietotne parasti tiek mitināta tīmekļa serverī (tā var būt lokāla izstrādes laikā vai mākonī ražošanas laikā) un tiek atveidota uzdevumrūtīs, dialoglodziņos vai satura reģionos Office vidē..
Lai mijiedarbotos ar dokumentu, tīmekļa lietojumprogramma paļaujas uz Office JavaScript API, kas tiek importēts, izmantojot skriptu, kas tiek mitināts oficiālajā CDNTipisks maršruts ir:
https://appsforoffice.microsoft.com/lib/1/hosted/office.js
Jebkurā spraudņa tīmekļa lapā, kurā vēlaties izmantot API, Jums ir jāatsaucas uz šo failu tagā en el no HTML dokumenta, piemēram:
<head>...<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>...</head>
No turienes jūs varat Izmantojiet Office.js pieejamos objektus un metodes, lai lasītu un modificētu saturu, parādītu dialoglodziņus, izmantotu klienta iestatījumus un veiktu daudz ko citu..
Divi API modeļi: lietojumprogrammām specifisks un vispārpieņemts
Office JavaScript API nav viens, homogēns bloks; tas ir organizēts divos atsevišķos modeļos ar savstarpēji papildinošiem mērķiem. No vienas puses, mums ir lietojumprogrammām specifiskas API (Excel, Word utt.), un, no otras puses, izplatītākās API, kas darbojas vairākos resursdatoros..
the Lietojumprogrammām specifiskas API piedāvā stingri tipizētus objektus, kas attēlo katrai programmai unikālas entītijas. (piemēram, izklājlapas, diapazoni, tabulas un diagrammas programmā Excel). Šis modelis tika ieviests kopā ar Office 2016 un izmanto solījumus, kas ļauj Vairāku darbību grupēšana vienā izsaukumā uzlabo veiktspēju, īpaši Office tīmeklī.
No otras puses Bieži sastopamie API ļauj piekļūt tām pieredzes daļām, kas tiek koplietotas starp dažādām lietojumprogrammām.Saskarnes elementi, dialoglodziņi, klienta iestatījumi un pat funkcionalitāte mijiedarbībai ar Outlook, PowerPoint vai Project ir integrēti vienā modelī. Šajā gadījumā modelis ir klasiskāks, balstīts uz atzvanīšanas iespējām, un parasti ir atļaut tikai vienu darbību katram pieprasījumamŠie bieži sastopamie API parādījās kopā ar Office 2013 un joprojām ir aktuāli, ja vēlaties, lai jūsu pievienojumprogramma darbotos pēc iespējas vairākās lietojumprogrammās.
API prasību kopas
Office.js pasaulē funkcionalitātes ir sagrupētas kopās, ko sauc par prasību kopām. Prasību kopa būtībā ir nosaukta API dalībnieku grupa, kas pārstāv konkrētu versiju vai iespēju bloku..
Ir komplekti, kas paredzēti konkrētam pielietojumam, piemēram, ExcelApi 1.7, ko var izmantot tikai programmā Excelun citi transversāli pasākumi, piemēram, DialogApi 1.1, kas tiek izmantots dialoglodziņu apstrādei jebkurā lietojumprogrammā, kas to atbalsta..
Savā pievienojumprogrammā varat pārbaudīt šīs prasību kopas, lai noteiktu vai lietojumprogramma un platforma, kurā tā darbojas, atbalsta nepieciešamās funkcijasTas ir svarīgi, ja vēlaties saglabāt saderību ar dažādām Office versijām gan galddatorā, gan tīmeklī, gan citās platformās.
Prasību kopu saderība ir atkarīga no konkrētā lietojumprogramma (Word, Excel utt.), instalētā versija un operētājsistēma vai izpildlaika videMicrosoft oficiālās dokumentācijas informācija, kuri komplekti un API ir pieejami katrai kombinācijai.
Izpētiet API ar Script Lab
Ja vēlaties ātri eksperimentēt, neizveidojot pilnīgu projektu, Script Lab ir jūsu rīcībā. Script Lab ir bezmaksas Office pievienojumprogramma, kas ļauj rakstīt, palaist un testēt Office.js koda fragmentus tieši no tādām lietojumprogrammām kā Excel vai Word..
Instalējot to no Microsoft Marketplace, jūs redzēsiet, ka tas piedāvā iepriekš sagatavotu piemēru bibliotēka dažādām tipiskām darbībām: manipulēt ar diapazoniem, strādāt ar tabulām, attēlot dialoglodziņus utt. Varat palaist šos fragmentus tādus, kādi tie ir, modificēt tos vai izmantot kā sākumpunktu savam spraudņa kodam.
Šis rīks ir īpaši noderīgs prototipa fāzē, jo Tas ļauj ātri pārbaudīt, vai API dara to, kas jums nepieciešams, redzēt, kā tas darbojas Office tīmeklī vai datorā, un pielāgot loģiku pirms tā integrēšanas reālajā projektā..
Paplašiniet Office lietotāja saskarni ar savu pievienojumprogrammu
Viena no Office pievienojumprogrammu lieliskajām priekšrocībām ir to spēja paplašiniet lietotāja saskarni un izmantojiet Word, Excel vai Outlook iebūvēto pieredzi.Šis lietotāja interfeisa paplašinājums galvenokārt ir balstīts uz spraudņu komandām un HTML konteineriem, piemēram, uzdevumrūtīm, satura spraudņiem un dialoglodziņiem.
L Spraudņu komandas ļauj lentei pievienot pielāgotu cilni, savas pogas un papildu izvēlnes. no lietojumprogrammas vai pat izvērst konteksta izvēlnes, kas parādās, ar peles labo pogu noklikšķinot uz teksta vai objektiem (piemēram, Excel šūnām). Kad lietotājs nospiež kādu no šīm komandām, tiek aktivizēta saistītā darbība: JavaScript funkcijas izpilde, uzdevumrūts atvēršana vai dialoglodziņa palaišana.
No otras puses, HTML konteineri (uzdevumu paneļi, satura spraudņi un dialoglodziņi) ir "telpa", kurā tiek parādīta jūsu tīmekļa lietotnes saskarne. Katra konteinera saturs nāk no jūsu serverī mitinātas tīmekļa lapas, kas var izmantot Office API, izsaukt ārējos pakalpojumus, autentificēt lietotājus un veikt jebkādu mūsdienu tīmekļa lietojumprogrammai raksturīgu loģiku..
Praksē jums varētu būt, piemēram, poga lentē, kas atver uzdevumrūti dokumenta labajā pusē, kā arī uznirstošo dialoglodziņu un satura spraudni, kas iegults tieši dokumenta virsmā.Tas viss tiek koordinēts, izmantojot JavaScript un Office.js.
Izveidojiet spraudņu projektus Visual Studio kodā, izmantojot izstrādes komplektu
Strādājot ar Office pievienojumprogrammu izstrādes komplektu programmā Visual Studio Code, tipiskā darbplūsma ir diezgan vienkārša. Vispirms ir jāizpilda priekšnosacījumi (Node.js, instalēts paplašinājums, Office savienojums ar Microsoft 365). Pēc tam varat palaist projekta izveides vedni no komplekta ikonas aktivitāšu joslā.
Pēc tam, kad esat izvēlējies opciju izveidot jaunu papildinājumu, jums tiks lūgts izvēlēties projekta veids, nosaukums un darba mapeKad šī informācija ir apstiprināta, paplašinājums automātiski ģenerē projektu, instalē nepieciešamās atkarības un atver risinājumu otrajā Visual Studio Code logā (ieteicams aizvērt pirmo, lai izvairītos no neskaidrībām).
Projektā vienmēr atradīsiet dažus galvenos failus: manifests (manifest.xml vai manifest.json) saknes direktorijā un uzdevumu rūts faili mapē src/taskpaneHTML definē paneļa struktūru, CSS fails kontrolē vizuālo izskatu, un JavaScript fails satur izsaukumus uz Office.js API, kas savieno saskarni ar Office klienta lietojumprogrammu.
Priekšskatījuma palaišana un apturēšana, izmantojot izstrādes komplektu
Lai pārbaudītu spraudni no VS Code, tiek izmantots pats izstrādes komplekts. Vienkārši atlasiet paplašinājuma ikonu, izvēlieties opciju “Office pievienojumprogrammas priekšskatījums (F5)” un pēc tam norādiet mērķa lietojumprogrammu., piemēram, “Excel Desktop (Edge Chromium)” vai “Word Desktop (Edge Chromium)”.
Paplašinājums ir atbildīgs par Pārliecinieties, vai ir izpildīti priekšnosacījumi, startējiet lokālo tīmekļa serveri, reģistrējiet pievienojumprogrammu un palaidiet Office datora lietojumprogrammu. ar pievienojumprogrammu, kas ielādēta no jūsu lokālās vides. Pirmajā reizē var būt nepieciešamas dažas minūtes, jo tiek instalētas atkarības un, iespējams, jums būs jāpiekrīt lokālā sertifikāta instalēšanai.
Kad esat pabeidzis testēšanu vai atkļūdošanu, ir svarīgi Pareizi apturiet priekšskatījumu pašā paplašinājumā, izmantojot opciju “Apturēt Office pievienojumprogrammas priekšskatījumu”.Tas izslēdz serveri, noņem pievienojumprogrammu no reģistra un notīra kešatmiņu. Pēc tam varat droši aizvērt Office lietojumprogrammu.
Ja, palaižot spraudni, kaut kas noiet greizi, parasti ir jāpārbauda VS Code iebūvētais terminālis. Ja problēmas joprojām pastāv, pirms priekšskatījuma restartēšanas ieteicams aizvērt visas atvērtās Office instances un apturēt visus mantotos izstrādes komplekta serverus.Sarežģītāku problēmu gadījumā ir pieejama problēmu novēršanas dokumentācija, un galu galā jūs vienmēr varat atvērt problēmu vietnē GitHub, lai saņemtu palīdzību.
Spraudņa izveide, izmantojot Yeoman: no "Sveika, pasaule" līdz kaut kam sarežģītākam
Kad spraudņa ģenerēšanai izmantojat Yeoman, praktiskais process notiek diezgan skaidrā secībā. Pēc Node.js, Yeoman un Office ģeneratora instalēšanas jūs palaižat komandu `yo office`, atbildat uz dažiem jautājumiem un saņemat mapi ar izpildāmu projektu..
Tipiskā Word piemērā jūs varētu izvēlēties Office pievienojumprogrammas uzdevumrūts projektu ar JavaScript, nosauciet to par “Mana Office pievienojumprogramma” un atlasiet Word kā klienta lietojumprogrammu.Ģenerators izveidos spraudņa skeletu un palaidīs sākotnējo npm instalēšanu, lai sagatavotu atkarības.
Lai apskatītu izveidoto, vienkārši atveriet projekta mapi un Atveriet galvenos failus: manifestu (manifest.xml vai manifest.json), uzdevumrūts HTML, tā CSS un JavaScript skriptu, kas satur izsaukumus uz Office.js.Piemērā parasti ir iekļauta vienkārša darbība, piemēram, dokumentā ierakstot "Sveika, pasaule" vai mainot kāda teksta stilu.
Izpilde tiek veikta no komandrindas. Projekta saknes direktorijā varat palaist komandu `npm start`, lai startētu lokālo serveri un atvērtu Word ar ielādēto pievienojumprogrammu.Ja vēlaties to izmēģināt Office tīmeklī, ir pieejams arī komandas variants, kas ietver dokumenta vietrādi URL pakalpojumā OneDrive vai SharePoint:
npm run start -- web --document {url}
Ja programmā Word pievienojumprogrammas uzdevumrūts netiek parādīta automātiski, Varat atvērt jaunu dokumentu, doties uz cilni Sākums un pievienojumprogrammā noklikšķināt uz pogas "Rādīt uzdevumrūti".Panelī parasti ir saite vai poga “Palaist”, kas aktivizē piemēra funkcionalitāti (piemēram, ievietojot “Sveika, pasaule” zilā krāsā).
Ja vēlaties apturēt lokālo serveri un atinstalēt spraudni, Varat izmantot komandu npm stop, kas izslēdz serveri un parastajā gadījumā noņem šai sesijai reģistrēto pievienojumprogrammu.Ja kādreiz manuāli ielādējāt to kā lokālu pievienojumprogrammu pakalpojumā Office tīmeklī, jums būs jāievēro manuālās noņemšanas procedūra no pašas Office saskarnes.
Dažreiz Yeoman veiktā atkarību automātiskā instalēšana (npm instalēšana) var neizdoties. Ja, palaižot komandu npm start, rodas kļūdas, vienkāršākais veids ir doties uz projekta mapi un palaist komandu npm install, lai novērstu trūkstošos moduļus.Instalēšanas laikā ir normāli parādīties daži brīdinājumi; vairumā gadījumu tie netraucē visam darboties.
Ja vēlaties precizēt pakotņu versijas un attīrīt novecojušas atkarības, varat izmantot npm-check-updates (ncu), lai pārbaudītu un atjauninātu atkarības vairumāPlūsma būtu instalēt ncu globāli, palaist ncu -u projekta saknē un visbeidzot vēlreiz palaist npm install.
Pirmais Outlook pievienojumprogrammas komponents ar Yeoman
Outlook gadījumam ir sava nianse, jo īpaši pieejamo klientu dažādības dēļ: Outlook tīmeklī, jaunā Outlook versija operētājsistēmā Windows, klasiskā Outlook versija operētājsistēmā Windows un Outlook versija operētājsistēmā MacViņi visi var izmantot vienu un to pašu papildinājumu, ja atbilstat priekšnosacījumiem.
Izveides process ar Yeoman ir ļoti līdzīgs Word procesam. Instalējiet Node.js, Yeoman un Office ģeneratoru, palaidiet savu Office un šoreiz kā klienta lietojumprogrammu izvēlieties Outlook.Atkal jūs izvēlaties uzdevumu dēļa tipa projektu, definējat spraudņa nosaukumu un arī izlemjat, kāda veida manifestu vēlaties izmantot (piemēram, “Vienotais manifests pakalpojumam Microsoft 365” vai “Tikai pievienojumprogrammu manifests” atkarībā no jūsu scenārija).
Ģenerators sagatavos jums projektu ar tā manifestu (JSON vai XML), uzdevumrūts HTML, stiliem un JavaScript, kas izmanto Office API, lai piekļūtu atlasītajam ziņojumam. Pamata piemērā parasti uzdevumrūtī ir redzams vismaz viens e-pasta rekvizīts, piemēram, tēma..
npm start
Šī komanda palaiž lokālo tīmekļa serveri un Reģistrējiet pievienojumprogrammu, lai tā automātiski ielādētos programmā OutlookPēc tam dodieties uz ziņojumu lasīšanas rūtī vai atveriet to atsevišķā logā un tur meklējiet pogu “Rādīt uzdevumu paneli”, kas atbilst jūsu pievienojumprogrammaiAtrašanās vieta atšķiras atkarībā no klienta:
- Programmā Outlook tīmeklī un jaunajā Outlook darbam ar Windows parasti tai var piekļūt no ziņojumu darbību joslas lietojumprogrammu izvēlnē.
- Klasiskajā Outlook versijā darbam ar Windows poga parasti tiek rādīta lentes cilnē Sākums vai Ziņojums.
- Programmā Outlook darbam ar Mac pievienojumprogrammas nosaukums būs redzams lentē; iespējams, lai to atrastu, būs jāizvērš daudzpunkties izvēlne.
Atverot uzdevumrūti, tiks ielādēts jūsu spraudņa saskarne un Varat noklikšķināt uz saites vai pogas “Palaist”, lai, piemēram, e-pasta tēmu parādītu pašā panelī.Tas ir ātrs veids, kā pārbaudīt, vai Outlook API darbojas un vai jūsu pievienojumprogramma saņem atlasītā ziņojuma kontekstu.
Lai apturētu lokālo serveri un atinstalētu spraudni, varat Konsolē izmantojiet komandu `npm stop`, kas izslēgs serveri un iztīrīs pievienojumprogrammas reģistru, ja tā tika instalēta, izmantojot `npm start`.Ja pievienojumprogrammu ielādējāt manuāli, atbilstošajā Outlook lietojumprogrammā būs jāveic manuālās noņemšanas process.
Šeit darbojas tie paši problēmu novēršanas padomi: Ja npm instalēšana sākotnēji neizdodas, palaidiet to manuāli, ignorējiet nekritiskus brīdinājumus un izmantojiet npm-check-updates, ja vēlaties atjaunināt atkarības kontrolētā veidā.Turklāt oficiālajā dokumentācijā ir iekļauti sarežģītāki koda piemēri, piemēram, īpaša “Hello World” pievienojumprogramma programmai Word vai sarežģītākas pamācības programmai Outlook.
Kā atrast un izmantot pievienojumprogrammu sistēmā Office
Kad pievienojumprogramma ir instalēta vai augšupielādēta jūsu Microsoft 365 kontā, nākamais solis ir atrast to lietojumprogrammā. Pirmā lieta, kas jādara, ir pārliecināties, vai esat pieteicies Office ar pareizo kontu.jo daudzi papildinājumi ir saistīti ar lietotāju vai abonementu.
Tādās lietojumprogrammās kā Word, Excel vai PowerPoint standarta ceļš ir doties uz izvēlni Ievietot > Manas pievienojumprogrammas, kur tiek parādīts lodziņš “Office pievienojumprogrammas”.Tur varat meklēt savu pievienojumprogrammu pēc nosaukuma; ja tas sākumā neparādās, pārbaudiet, vai esat pareizi autentificējies, un nospiediet atsvaidzināšanas pogu, lai atkārtoti ielādētu sarakstu.
Kad sarakstā esat atradis pievienojumprogrammu, vienkārši Veiciet dubultklikšķi, lai to palaistu un ielādētu dokumentāNo šī brīža to var izmantot tāpat kā lokālās testēšanas laikā, bet norādot uz ražošanas vidi vai mitināšanu, ko esat konfigurējis pievienojumprogrammas tīmekļa lietojumprogrammai.
Ar šo pārskatu jums tagad ir pilnīgs priekšstats par procesu: sākot ar rīku izvēli (Yeoman, Visual Studio, Agents Toolkit vai VS Code Kit), caur pievienojumprogrammas iekšējo struktūru (manifests plus tīmekļa lietojumprogramma), mijiedarbību ar Office, izmantojot Office.js, prasību kopas un Script Lab, kā arī praktiskas darbplūsmas pievienojumprogrammu testēšanai, atkļūdošanai un palaišanai programmā Word, Excel vai Outlook gan datorā, gan tīmeklī; ar stingri nostiprinātiem pamatiem, pārvērst vienkāršu prototipu par ražošanai gatavu Office pievienojumprogrammu Tas kļūst daudz skaidrāks un vieglāk pārvaldāms ceļš. Dalieties ar šo informāciju, un citi uzzinās par šo terminu..