Krijo një shtesë për Office Është bërë një mënyrë shumë e fuqishme për të zgjeruar Word, Excel, Outlook, PowerPoint dhe aplikacione të tjera. Microsoft 365 pa pasur nevojë të zhvillohen shtesa tradicionale për desktop. Këto shtesa të reja bazohen në teknologjitë standarde të uebit dhe JavaScript API për Office, duke mundësuar krijimin e përvojave moderne, të sigurta dhe të lehta për t’u instaluar në të gjithë organizatën.
Në rreshtat e mëposhtëm do të gjeni një udhëzues shumë të plotë rreth mjetet e zhvillimit, llojet e manifesteve, API-të e disponueshme dhe opsionet e vendosjesduke integruar dokumentacionin zyrtar të Microsoft-it. Ideja është që ju të mund të kaloni nga e para në një shtesë funksionale, duke kuptuar se çfarë bën secila pjesë dhe cilat vendime teknike duhet të merrni në çdo hap.
Çfarë është një shtesë moderne e Office dhe si është strukturuar ajo?
Shtojca moderne të Office Ato mbështeten në platformën e shtesave të Office, e cila është e përbashkët për Word, Excel, PowerPoint, OneNote, Outlook dhe Project, në desktop, ueb dhe, në disa raste, në celular. Të gjitha ndajnë të njëjtën arkitekturë bazë të përbërë nga dy pjesë qartësisht të diferencuara.
Pjesa e parë është manifesti i komplementitKy skedar vepron si "kartë identiteti" e shtesës. Ai deklaron meta të dhënat (ID, emër, version, gjuhë), me cilat aplikacione të Office mund të përdoret, çfarë lejesh i nevojiten, çfarë komandash shton në shirit, cilat ikona përdor, ku ndodhet aplikacioni web dhe në cilat kontekste duhet të aktivizohet (për shembull, në Outlook, vetëm për mesazhe ose takime që plotësojnë rregulla të caktuara).
Pjesa e dytë është aplikim të internetit Ky aplikacion ofron ndërfaqen e përdoruesit dhe logjikën e biznesit. Ai përbëhet nga HTML, CSS dhe JavaScript (ose TypeScript) dhe funksionon brenda një kontejneri HTML të Office (paneli i detyrave, shtesa e përmbajtjes ose kutia e dialogut). Prej andej, ai përdor bibliotekën office.js për të lexuar dhe shkruar në dokument, për të thirrur shërbime të jashtme, për të trajtuar vërtetimin, për të shfaqur kutitë e dialogut dhe për të kryer çdo detyrë tjetër tipike të një aplikacioni modern në internet.
Mjete për krijimin e shtesave të Office
Nuk ka një mënyrë të vetme për të filluar një projekt shtesë. Microsoft ofron disa mjete zyrtareKëto mjete u përshtaten profileve të ndryshme të përdoruesve: nga ata që preferojnë shabllonet e Visual Studio deri te ata që punojnë çdo ditë me Node.js dhe Visual Studio Code. Ekzistojnë gjithashtu mjete të palëve të treta ose më të specializuara, siç janë redaktorët e ndërfaqes së përdoruesit për VBA.
Gjeneratori Yeoman për shtesat e Office
Gjeneratori Yeoman për Office është ndoshta opsioni më fleksibël për zhvilluesit e uebit. Ju lejon të krijoni projekte të bazuara në Node.js me të cilat mund të modifikoni Kodi i Visual Studio ose botuesi juaj i preferuar. Ndihmësi ju udhëzon përmes një sërë pyetjesh për të zgjedhur llojin e shtesës (paneli i detyrave, shtesa e përmbajtjes, funksionet e personalizuara, Outlook, etj.) dhe aplikacionin e synuar.
Me këtë gjenerator mundeni krijoni projekte për Excel, OneNote, Outlook, PowerPoint, Project, Word dhe funksione të personalizuara të Excel-it. Për më tepër, ju lejon të zgjidhni midis një grumbulli të thjeshtë me HTML, CSS dhe JavaScript/TypeScript ose një arkitekture të bazuar në React, gjithashtu në JavaScript ose TypeScript, me të gjithë strukturën e projektit të përgatitur tashmë.
Visual Studio për projekte Office
Nëse lëvizni më rehatshëm në mjedise .NETVisual Studio përfshin shabllone specifike për shtesat e Office. Këto shabllone mbulojnë kryesisht Excel, Outlook, Word dhe PowerPoint, duke krijuar një zgjidhje të plotë që përfshin manifestin e shtesës, aplikacionin web dhe, opsionalisht, projektet e lidhura me backend.
Projekti Visual Studio Gjithashtu bazohet në HTML, CSS dhe JavaScript, por integrohet me ekosistemin klasik të Microsoft.Debugging, publikim, paketim i integruar, etj. Është një zgjedhje e mirë kur tashmë po punoni me zgjidhje për ndërmarrjet në Visual Studio dhe dëshironi ta mbani gjithçka të centralizuar në të njëjtin IDE.
Seti i mjeteve të agjentëve të Microsoft 365 dhe Seti i zhvilluesve të shtesave të Office
Seti i mjeteve të agjentëve të Microsoft 365 Është projektuar për të shkuar përtej shtesave tradicionale dhe për të krijuar praktikisht çdo lloj shtese për ekosistemin Microsoft 365, duke kombinuar robotët, shtesat dhe shtesat e Teams. Me këtë mjet, ju mund të gjeneroni projekte shtesash të Office që përshtaten brenda aplikacioneve më të gjera të Microsoft 365.
Kompleti i Zhvilluesve të Shtojcave të Office Është një zgjerim i Visual Studio Code që e thjeshton shumë jetën e përditshme. Nga brenda VS Code, mund të krijoni projekte të reja shtesash, të ngarkoni mostra kodi gati për testim dhe të menaxhoni të gjithë ciklin jetësor të zhvillimit pa dalë nga redaktuesi. Zgjerimi është projektuar për të funksionuar si me manifeste të unifikuara ashtu edhe me manifeste vetëm për shtesa.
Manifesti: zemra e konfigurimit të shtesës
Çdo shtesë e Office përshkruhet nga një skedari manifest Kjo u tregon aplikacioneve se si ta ngarkojnë atë, cilat opsione të ndërfaqes duhet të ekspozojnë dhe cilat leje duhet të kërkojnë. Ekzistojnë dy shabllone kryesore të manifestit dhe zgjedhja midis tyre përcakton se si mund ta integroni shtesën tuaj me zgjerime të tjera të Microsoft 365.
Llojet e manifestit: manifest vetëm plotësues dhe manifest i unifikuar
- Manifesti i vetëm komplementit. Është formati klasik për shtesat e prodhimit të Office në Excel, OneNote, Outlook, PowerPoint, Project dhe Word. Është shkruar në XML dhe përqendrohet vetëm në përshkrimin e shtesës, pa e përzier atë me lloje të tjera aplikacionesh.
- Manifesti i Unifikuar për Microsoft 365. Evolucioni i modelit të manifestit në formatin JSON, i përdorur historikisht në aplikacionet Teams. Ky format lejon që lloje të ndryshme të zgjerimeve të Microsoft 365 - shtesa të Office, zgjerime të Teams, etj. - të paketohen në një aplikacion të vetëm.
Logjika e konfigurimit është e ngjashme në të dyja rastetJu përcaktoni një identifikues unik (zakonisht një GUID), versionin, emrin e shfaqur, përshkrimin, gjuhët e mbështetura, ikonat, llojet e lejeve (për shembull, lexoni ose lexoni/shkruani dokumente) dhe strukturën e ndërfaqes (skedat, grupet dhe butonat e shiritit). Gjithashtu specifikoni URL-në e hapjes së aplikacionit web dhe çdo cilësim shtesë, siç janë shkurtesat e tastierës në Excel ose Word, rregullat e aktivizimit në Outlook ose dimensionet e paneleve dhe shtesat e përmbajtjes.
Elementet kryesore të deklaruara në manifest
Shtim metadata bazëManifesti duhet të detajojë me kujdes se si shtesa integrohet në përvojën e Office. Kjo përfshin imazhet e markës dhe ikonat e komandave në shirit, të cilat duhet të mbahen në një server që lejon ruajtjen në memorje (kokat HTTP me Cache-Control: no-cache ose të ngjashme për prodhim).
Një aspekt tjetër kritik është siguriTë gjitha URL-të që tregojnë për aplikacionin web ose burimet e shtesave duhet të përdorin HTTPS. Ndërsa disa skenarë zhvillimi lejojnë certifikata HTTP ose të vetë-nënshkruara, nëse doni të ekzekutoni shtesën në Office në web ose ta publikoni atë në Microsoft Marketplace, SSL është i detyrueshëm për të shmangur paralajmërimet për përmbajtje të përzier dhe për të siguruar mbrojtjen e të dhënave gjatë transportit.
Nëse planifikoni ta shpërndani shtesën tuaj përmes Microsoft Marketplace, manifesti duhet të përfshijë, Përveç GUID-it unik, një URL mbështetjeje teknike e arritshme dhe e vlefshme. Microsoft zbaton një sërë udhëzimesh validimi ku rishikohen konsistenca e të dhënave të manifestit, sjellja e shtesës dhe përputhshmëria me kërkesat e sigurisë dhe përvojës së përdoruesit.
Domenet dhe origjinat e lejuara për Office.js
Manifesti kontrollon gjithashtu cilat domene mund të lundrohen brenda panelit të shtojcaveNë Office në internet dhe Outlook për Windows të ri, paneli i detyrave mund të ngarkojë pothuajse çdo URL. Megjithatë, në aplikacionet për desktop, sjellja është më e rreptë: nëse shtesa përpiqet të lundrojë në një domen tjetër përveç domenit të faqes kryesore, URL-ja hapet jashtë aplikacionit, në një dritare të veçantë të shfletuesit.
Për të shmangur atë kërcim të jashtëm në desktopMund të listoni në mënyrë të qartë çdo domen shtesë që dëshironi të shfaqet në dritaren e shtesës në manifest. Nëse objektivi është i listuar, ai do të hapet brenda panelit si në desktopin e Office ashtu edhe në Office në internet; përndryshe, në desktop, do të hapet në një shfletues të jashtëm.
Ndërveprimi me dokumentet duke përdorur API-n JavaScript të Office
Aplikacioni në internet i shtesës komunikon me dokumentin e Office. (ose me mesazhin në rastin e Outlook) nëpërmjet bibliotekës Office JavaScript API, e aksesueshme nëpërmjet CDN zyrtare të Microsoft në https://appsforoffice.microsoft.com/lib/1/hosted/office.jsThjesht referojuni këtij skripti në seksion <head> nga faqja për të qenë në gjendje të përdorni llojet dhe metodat e disponueshme.
Pasi të ngarkohet biblioteka, ju keni qasje në dy modele API plotësuese:
- API-të specifike për aplikacionin.
- API-të e zakonshme.
Çdo model është projektuar për të mbuluar skenarë të ndryshëm, megjithëse ato mund të kombinohen në të njëjtin aksesor në varësi të nevojave.
API-të specifike të aplikacionit
API-të specifike të aplikacionit ofrojnë objekte të tipizuara fort Këto përfaqësojnë entitete native të aplikacionit specifik të Office. Për shembull, në Excel keni objekte për fletë pune, diapazone, tabela dhe grafikë, të cilat ju lejojnë të manipuloni të dhënat në një mënyrë të strukturuar dhe efikase.
Ky model bazohet në operacione në grupJu i ndërthurni veprimet brenda një konteksti dhe, kur të jeni gati, i sinkronizoni ndryshimet me Office. Kjo mënyrë pune zvogëlon numrin e udhëtimeve midis shtesës dhe aplikacionit, duke përmirësuar ndjeshëm performancën, veçanërisht në Office në internet.
API-të e përbashkëta për veçoritë e përbashkëta
API-të e zakonshme Ato përqendrohen në funksionalitete të ndërthurura të pranishme në disa aplikacioneelementët e ndërfaqes, kutitë e dialogut, cilësimet e klientit, etj. Ky model përdor thirrje kthyese në vend të premtimeve dhe, sipas dizajnit, çdo thirrje kryen një operacion të vetëm kundër aplikacionit.
Me API-të e zakonshme, për shembull, mund të shfaq një kuti dialogu që shfaqet, menaxhon konfigurimin e një shtese në hostë të ndryshëm ose qas në aftësi të caktuara të Outlook, PowerPoint ose Project që nuk mbulohen ende nga API-të specifike të aplikacionit, në varësi të rastit të përdorimit.
Setet e kërkesave dhe përputhshmëria ndërplatformore
Pajtueshmëria e API-t është e organizuar në grupe kërkesashKëto grupojnë anëtarë specifikë të API-t nën një emër versioni. Ekzistojnë grupe kërkesash specifike për aplikacionin, siç është ExcelApi 1.7dhe të tjera të përbashkëta, si p.sh. DialogApi 1.1, të cilat funksionojnë aty ku mbështetet funksionaliteti i kutisë së dialogut.
Shtesa mund të kontrollojë gjatë kohës së ekzekutimit nëse aplikacioni i Office në të cilin po ekzekutohet i plotëson kërkesat e nevojshme. Kjo ju lejon të përshtatni përvojën ose të çaktivizoni veçoritë e përparuara kur hosti nuk i plotëson kërkesat minimale, në vend që të shkaktojë gabime të papritura.
Eksploro API-në me Script Lab
Script Lab është një shtesë falas Ai vepron si një terren testimi për API-në JavaScript të Office. Instalohet nga Microsoft Marketplace dhe funksionon brenda aplikacioneve si Excel ose Word, duke ju lejuar të shkruani dhe ekzekutoni fragmente kodi në kohë reale në dokumentin aktual.
Brenda Script Lab keni qasje në një bibliotekë me shembuj të gatshëm për përdorim që demonstrojnë aftësi të ndryshme të API-tMund t’i përdorni këto fragmente si bazë për kodin tuaj, t’i modifikoni dhe menjëherë ta shihni rezultatin në dokument, gjë që e përshpejton shumë fazën e prototipimit dhe testimit të funksionaliteteve përpara se t’i përfshini ato në shtojcën tuaj përfundimtare.
Si të zgjerohet ndërfaqja e përdoruesit të Office
Një nga avantazhet e mëdha të shtesave është se ato lejojnë integroni funksionalitetin direkt në ndërfaqen e Officenë mënyrë që përdoruesi të mos ndihet sikur po "largohet" nga aplikacioni. Kjo arrihet duke kombinuar komandat e shtojcave dhe kontejnerët HTML siç janë panelet e detyrave, shtojcat e përmbajtjes dhe kutitë e dialogut.
- Komandat e shtesave Ato përdoren për të shtuar skeda të personalizuara, grupe të reja dhe butona ose menu shtesë në shiritin e Office.
- Kontejnerë HTML (panelet e detyrave, shtesat e përmbajtjes dhe dialogët) veprojnë si një sipërfaqe mbi të cilën shfaqet ndërfaqja e shtesës.
Në një skenar tipik, mund të keni një komandë që shton një grup me një buton "Analizo të dhënat" në Excel; kur shtypet, një panel detyrash hapet në të djathtë me aplikacionin tuaj në internet, i cili analizon diapazonin e zgjedhur, thërret një shërbim të të mësuarit automatik dhe kthen rezultatet duke nxjerrë në pah qelizat ose duke krijuar grafikë duke përdorur API-në specifike të Excel-it.
Krijo një shtesë për panelin e detyrave me Yeoman (shembull në Word)
Për t’i vënë në praktikë të gjitha këto koncepteËshtë e dobishme të shihet se si të ndërtohet një shtesë për panelin e detyrave në praktikë duke përdorur gjeneratorin e Yeoman, si për Word ashtu edhe për Outlook. Edhe pse detajet e ndërfaqes ndryshojnë midis aplikacioneve, struktura e projektit dhe rrjedha e punës janë shumë të ngjashme.
Parakushtet e mjedisit të zhvillimit
Para gjenerimit të projektitDuhet të keni të instaluar versionin më të fundit LTS të Node.js, i cili mund të shkarkohet nga faqja zyrtare e internetit. Pasi të instalohet, instaloni globalisht Yeoman dhe gjeneratorin e Office duke përdorur komandën npm install -g yo generator-officeSë fundmi, sigurohuni që e keni Office të lidhur me një abonim në Microsoft 365 që përfshin Office në internet, pasi do ta testoni shtesën si në desktop ashtu edhe në shfletues.
Krijimi i një shtese në Word me një panel detyrash
Hapi i parë është përcaktoni llojin e manifestit të cilën dëshironi ta përdorni në varësi të faktit nëse keni ndërmend ta kombinoni shtesën tuaj me zgjerime të tjera në një aplikacion të vetëm apo jo. Pasi të keni marrë vendimin tuaj, ekzekutoni yo office në drejtorinë e punës.
Gjatë asistent interaktivPër shembull, mund të zgjidhni një lloj projekti, të caktoni një emër si "Shtesa ime e Office" dhe të zgjidhni Word si aplikacionin klient të synuar. Kur të përfundojë, gjeneratori krijon dosjen e projektit, instalon varësitë Node dhe përgatit gjithçka për të filluar.
Brenda zgjidhjes do të gjeni skedarin manifest (manifest.json o manifest.xml) në rrënjë, e cila përcakton konfigurimin e plugin-it; skedari ./src/taskpane/taskpane.html me shënimin e panelit të detyrave; CSS në ./src/taskpane/taskpane.css; dhe kodi që thërret API-n e Office në ./src/taskpane/taskpane.ts o .jsvarësisht nëse keni zgjedhur TypeScript apo JavaScript.
Për të testuar shtesën në Word për desktopThjesht duhet të shkoni në dosjen rrënjë të projektit (cd "My Office Add-in"dhe ekzekuto npm startKjo komandë hap serverin lokal të uebit dhe nis Word-in me shtesën e ngarkuar tashmë në modalitetin e ngarkimit anësor. Nëse preferoni ta provoni në Word në ueb, mund të përdorni një komandë si kjo: npm run start -- web --document {url}, duke zëvendësuar URL-në me atë të një dokumenti të ruajtur në OneDrive ose SharePoint.
Serveri i zhvillimit dhe menaxhimi i varësive
Gjatë zhvillimit është e zakonshme që npm install Mund të dështojë gjatë hapit automatik që ekzekuton Yeoman, veçanërisht nëse ka konflikte me versionet e varësisë. Në këto raste, thjesht shkoni në dosjen e projektit dhe niseni. npm install manualisht për ta zgjidhur atë.
Nëse shfaqen paralajmërime të varësisë së vjetëruarMund të mbështeteni te mjeti npm-check-updates, duke e instaluar atë me npm i -g npm-check-updates, duke vrapuar ncu -u për të përditësuar diapazonin e versioneve në package.json dhe duke përfunduar procesin me një të re npm installShumë nga këto paralajmërime nuk janë kritike, por është praktikë e mirë t'i rishikoni ato periodikisht për ta mbajtur projektin të shëndetshëm.
Për të ndaluar serverin e zhvillimit dhe çinstaloni shtojcën në modalitetin e ngarkimit anësor, mund ta ekzekutoni npm stop në direktorinë rrënjë. Nëse e keni ngarkuar më parë shtesën manualisht (për shembull, duke ngarkuar manifestin në Office on the Web), do t'ju duhet ta hiqni atë manualisht edhe nga ndërfaqja përkatëse e administrimit.
Nga struktura bazë e një shtese dhe mjetet e zhvillimit (Yeoman, Visual Studio, Agents Toolkit, Script Lab) deri te roli i manifestit, API-të JavaScript, kontrollet e sigurisë dhe opsionet e vendosjes (lokal, Marketplace, vendosje e centralizuar ose nëpërmjet ofruesve si Qlik), ju keni një hartë mjaft e plotë për të vendosur se çfarë lloj shtese ju nevojitet, si ta ndërtoni atë dhe si ta vini në duart e përdoruesve tuaj pa surpriza teknike.