Cara membuat add-in Office langkah demi langkah

Jika Anda pernah bertanya-tanya bagaimana add-in Office (atau plugin, ekstensi—apa pun sebutan yang Anda sukai) dibuat, Anda telah datang ke tempat yang tepat. Add-in adalah aplikasi web kecil yang terintegrasi dengan Word , Excel, Outlook, PowerPoint, OneNote, Project, dan aplikasi lain untuk memperluas kemampuan Office, mulai dari mengotomatiskan tugas-tugas yang membosankan hingga terhubung dengan layanan cloud eksternal.

Sebelum Anda mulai membuat kode tanpa henti, penting untuk memahami bahwa add-in Office bukan hanya skrip mandiri : add-in tersebut berada di dalam platform Office Add-ins, dijelaskan oleh sebuah manifest, dan berjalan sebagai aplikasi web yang berkomunikasi dengan Office menggunakan API JavaScript. Dari sini, kita akan dengan tenang menguraikan semua yang perlu Anda ketahui: alat untuk membuat proyek, struktur internal, model API, cara menguji dan men-debug, cara mempublikasikannya, dan bahkan cara mengelola izin dan akses dari dalam aplikasi itu sendiri.

Apa sebenarnya add-in Office itu?

Add-in Office pada dasarnya adalah aplikasi web yang terintegrasi dengan aplikasi Microsoft 365 (Word, Excel, Outlook, PowerPoint, OneNote, Project, dll.) dan memperluas antarmuka serta kemampuannya. Anda dapat menganggapnya sebagai bagian tambahan yang "terpasang" pada ribbon, menu konteks, atau sidebar untuk menyediakan fitur baru.

Keunggulan plugin ini adalah dapat berjalan menggunakan teknologi web standar (HTML, CSS, JavaScript atau TypeScript, dan bahkan framework seperti React) dan berkomunikasi dengan dokumen atau pesan email menggunakan Office JavaScript API. Hal ini memungkinkan plugin untuk membaca dan memodifikasi konten, menampilkan antarmuka kustomnya sendiri, dan berkomunikasi dengan layanan eksternal, REST API, sistem internal perusahaan Anda, dan banyak lagi.

Dua komponen utama add-in Office

Setiap add-in Office selalu terdiri dari dua bagian berbeda , yang harus diingat sejak awal:

• Manifesto Komplemen, yang mendefinisikan konfigurasi, perilaku, dan cara integrasinya ke dalam antarmuka Office.
• Aplikasi web, yang merupakan kode sebenarnya (HTML, CSS, JavaScript/TypeScript) yang menampilkan antarmuka panel tugas, kotak dialog, atau plugin konten dan berisi logika bisnis.

Manifest berfungsi sebagai "kartu identitas" dan buku panduan untuk add-in, sementara aplikasi web adalah "mesin" yang melakukan pekerjaan sebenarnya dan berkomunikasi dengan dokumen atau email menggunakan Office JavaScript API.

Apa yang mendefinisikan manifesto pelengkap?

Manifest dari add-in Office, yang biasanya disimpan sebagai manifest.xml atau manifest.json di direktori root proyek, berisi semua informasi yang dibutuhkan Office untuk mengetahui fungsi add-in Anda, di mana add-in tersebut dihosting, dan bagaimana add-in tersebut harus ditampilkan kepada pengguna.

Manifesto tersebut menyebutkan, antara lain, elemen-elemen kunci berikut , yang harus dipantau secara cermat:

• Metadata plugin: pengenal (ID), versi, nama tampilan pengguna, deskripsi, lokal default, dll.
• Aplikasi Office yang kompatibelMisalnya, apakah add-in tersebut dapat digunakan di Word, Excel, Outlook, PowerPoint, Project, atau OneNote.
• Izin yang diperlukan: tingkat akses apa yang Anda perlukan ke dokumen, kotak surat Outlook, atau sumber daya lainnya.
• Integrasi dengan antarmuka Office: tab khusus, tombol pada pita, perintah yang ditambahkan ke menu konteks, dan elemen UI lainnya.
• Ikon dan gambar: jalur ke ikon yang akan ditampilkan di pita, menu, dan bagian lain antarmuka, dengan menghormati merek plugin.
• Dimensi pluginMisalnya, ukuran add-in konten atau tinggi yang diinginkan dari add-in Outlook.
• Aturan aktivasi di Outlook: kondisi yang menentukan kapan plugin ditampilkan dalam email atau kutipan (berdasarkan pengirim, subjek, konten, dll.).
• Pintasan keyboardPintasan khusus tersedia di Excel dan Word.

Semua ini menjadikan manifest sangat penting untuk pengembangan dan penyebaran . Saat Anda menyebarkan plugin, yang sebenarnya didistribusikan adalah file manifest, yang mengarah ke URL tempat aplikasi web dihosting.

Aplikasi web plugin

Komponen utama kedua dari teka-teki ini adalah aplikasi web, yaitu apa yang dilihat dan diinteraksikan oleh pengguna. Aplikasi ini biasanya terdiri dari halaman HTML, stylesheet CSS, dan skrip JavaScript atau TypeScript , dan dapat dibangun dengan atau tanpa framework (React adalah salah satu yang paling umum, tetapi bukan satu-satunya).

Dari halaman-halaman ini, add-in menggunakan Office JavaScript API untuk membaca dan memodifikasi konten dokumen tempat add-in dijalankan: rentang Excel, paragraf Word, pesan Outlook, slide PowerPoint, tabel, bagan, dan banyak lagi. Selain itu, sebagai aplikasi web, add-in ini dapat:

• Hubungkan ke layanan web eksternal untuk memperoleh atau mengirim data.
• Kelola autentikasi pengguna dengan OAuth, Azure AD, atau penyedia lainnya.
• Mengonsumsi REST API internal organisasi Anda.
• Terapkan semua logika bisnis yang diperlukan, dari perhitungan tingkat lanjut hingga otomatisasi yang rumit.

Alat untuk membuat add-in Office

Platform add-in Office menawarkan beberapa cara untuk membuat proyek siap pengembangan , yang disesuaikan dengan profil pengguna dan preferensi kerja yang berbeda. Opsi utamanya adalah: generator Yeoman, Visual Studio, Add-in Development Kit untuk Visual Studio Code, dan Microsoft 365 Agents Toolkit.

Buat plugin dengan generator Yeoman

Generator add-in Yeoman's Office memungkinkan Anda membuat proyek Node.js siap pakai dan mengelolanya dengan Visual Studio Code atau editor lain. Ini adalah pilihan yang sangat nyaman jika Anda terbiasa bekerja di lingkungan JavaScript murni dengan alat baris perintah.

Dengan generator ini Anda dapat membuat plugin untuk:

• Excel
• OneNote
• Outlook
• PowerPoint
• Project
• Word
• Fungsi Excel kustom

Saat menjalankan wizard, Anda dapat memilih apakah Anda menginginkan proyek berbasis HTML, CSS, dan JavaScript atau TypeScript "apa adanya," atau proyek dengan React , juga dalam JavaScript atau TypeScript. Generator akan mengurus pengaturan seluruh struktur, dependensi Node, dan konfigurasi awal.

Prasyarat untuk menggunakan Yeoman

Untuk menggunakan generator Yeoman untuk Office, Anda perlu menginstal beberapa komponen dasar , yang umum dalam ekosistem JavaScript:

• Node.js versi LTSUnduhannya dari situs web resmi Node.js dan instal sesuai dengan sistem operasi Anda.
• Yeoman dan Generator Add-In Officeyang diinstal secara global dengan perintah:
  npm install -g yo generator-office
• Langganan Microsoft 365 yang aktif dengan Office, sehingga Anda dapat menguji add-in di desktop dan di Office di web.

Buat proyek dengan Yeoman

Setelah semuanya terpasang, membuat proyek cukup mudah. ​​Dari baris perintah, di direktori tempat Anda ingin bekerja, jalankan:

yo office

Wizard akan mengajukan serangkaian pertanyaan untuk menyempurnakan proyek . Misalnya, untuk add-in panel tugas pertama untuk Word, Anda mungkin menjawab sesuatu yang mirip dengan ini:

• Pilih jenis proyek: Proyek Panel Tugas Add-in Office
• Pilih jenis naskah: JavaScript
• Bagaimana Anda ingin memberi nama pada add-on tersebut? Add-in Kantor Saya
• Aplikasi klien Office mana yang ingin Anda dukung? Word

Setelah Anda menyelesaikan wizard, Yeoman akan menghasilkan semua file proyek dan menginstal modul Node yang diperlukan, sehingga Anda akan memiliki plugin dasar yang berfungsi penuh.

Struktur proyek yang dibuat dengan Yeoman

Proyek yang dibuat dengan Yeoman untuk papan tugas biasanya memiliki struktur yang sangat mirip dengan ini, di mana setiap bagian memenuhi peran spesifik:

• ./manifest.xml atau ./manifest.json: manifes yang mendefinisikan konfigurasi, izin, integrasi dengan antarmuka dan URL aplikasi web.
• ./src/taskpane/taskpane.html: templat HTML panel tugas yang akan dilihat pengguna.
• ./src/taskpane/taskpane.css: lembar gaya yang membentuk dan mendesain panel.
• ./src/taskpane/taskpane.js: kode JavaScript yang mengimplementasikan logika dan panggilan ke Office API.

Coba plugin yang dibuat dengan Yeoman

Untuk menguji add-in, cukup masuk ke folder proyek dan jalankan beberapa perintah yang memulai server web lokal dan memuat add-in ke dalam Office.

1. Buka folder akar proyek:
   cd "My Office Add-in"
2. Mulai server lokal dan uji di Word desktop dengan:
   npm start

   Perintah ini memulai server web (jika belum ada) dan membuka Word dengan add-in yang dimuat secara otomatis.

3. Jika Anda ingin mencoba add-in Word di browser Anda, Anda dapat menggunakan perintah seperti:
   npm run start -- web --document {url}

   Di mana {url} adalah alamat dokumen Word yang tersimpan di OneDrive atau pustaka SharePoint yang dapat Anda akses. Jika karena alasan tertentu add-in tidak dimuat dengan benar di Office versi web, Anda dapat menginstal secara manual dan kemudian menghapus manifes yang dimuat secara lokal secara manual.

4. Setelah dokumen diunggah, Anda dapat membuka panel tugas dari tab inisiasi dengan mengklik tombol Tampilkan panel tugasDengan mengklik tautan menjalankan Pada panel, contoh umum menyisipkan "Halo, dunia" dengan gayanya sendiri ke dalam dokumen.
5. Untuk menghentikan server lokal dan, jika perlu, menghapus plugin yang dimuat, Anda dapat menggunakan:
   npm stop

   Jika Anda telah melakukan pengunggahan lokal manual pada add-on, Anda harus mengikuti prosedur khusus untuk menghapus jenis pengunggahan lokal tersebut.

Masalah umum dengan Yeoman dan npm

Selama instalasi atau saat menjalankan proyek, cukup umum untuk menemui peringatan dan kesalahan npm . Beberapa situasi umum meliputi:

• Kegagalan langkah otomatis instalasi npm yang dijalankan oleh generator itu sendiri. Jika nanti mulai npm Ini memberikan kesalahan; biasanya, cukup masuk ke folder proyek dan menjalankannya secara manual npm install.
• Peringatan tentang dependensi yang kedaluwarsa atau tidak kompatibel, yang biasanya tidak mencegah plugin berjalan, tetapi bisa mengganggu. Jika Anda ingin menghapusnya, Anda dapat menggunakan alat ini. npm-check-update sebagai berikut:
  • Instal alat: npm i -g npm-check-updates
  • Perbarui versi di package.json: ncu -u
  • Instal ulang dependensi: npm install

Membuat add-on dengan Visual Studio

Visual Studio memungkinkan Anda membuat add-in Office langsung dari dalam Visual Studio. Dalam hal ini, proyek add-in merupakan bagian dari solusi yang lebih besar dan juga berbasis HTML, CSS, dan JavaScript.

Visual Studio memungkinkan Anda membuat add-in untuk:

• Excel
• Outlook
• PowerPoint
• Word

Namun, fitur ini tidak mendukung pembuatan add-in untuk OneNote atau Project . Untuk aplikasi tersebut, Anda perlu menggunakan generator Yeoman dan mengikuti panduan cepat yang spesifik.

Mengembangkan dan menyesuaikan plugin di Visual Studio

Saat Anda membuat proyek plugin dengan Visual Studio, lingkungan tersebut akan menghasilkan plugin dasar dengan fungsionalitas terbatas , yang dimaksudkan sebagai titik awal. Dari situ, Anda dapat menyesuaikannya:

• El nyata, menyesuaikan metadata, izin, aturan aktivasi, dan elemen antarmuka.
• File HTML, CSS dan JavaScript yang membentuk panel tugas atau kotak dialog.

Untuk mendapatkan hasil maksimal, penting untuk memahami konsep umum platform add-in (siklus pengembangan, manifest, model API, kumpulan persyaratan) dan juga aspek spesifik dari setiap aplikasi: Excel, Word, Outlook, dll.

Jalankan, debug, dan publikasikan dari Visual Studio

Selama pengembangan, Visual Studio menjalankan plugin terhadap server web lokal (localhost) . Setelah siap untuk produksi, proses umumnya adalah sebagai berikut:

1. Publikasikan aplikasi web di server atau layanan hosting (misalnya, Microsoft Azure).
2. Perbarui manifesto sehingga mengarah ke URL final tempat aplikasi dihosting.
3. Memilih metode implementasi (katalog plugin internal, AppSource, dll.) dan mendistribusikan file manifes kepada pengguna.

Detail tentang cara melakukan debugging pada berbagai platform dan cara mengatasi masalah spesifik dapat ditemukan dalam dokumentasi Debugging Office Add-ins di Visual Studio dan dalam panduan pengujian dan debugging umum.

Kit Pengembangan Add-in Office untuk Visual Studio Code

Jika lingkungan kerja Anda adalah Visual Studio Code, Anda dapat menginstal Office Add-In Development Kit , sebuah ekstensi yang memudahkan pembuatan, menjalankan, dan men-debug proyek add-in dari dalam editor itu sendiri.

Dengan ekstensi ini, Anda dapat membuat proyek plugin baru dari antarmuka terpandu dan memuat contoh langsung ke lingkungan Anda, tanpa harus mengkonfigurasi semuanya secara manual. Ekstensi ini diunduh dari Visual Studio Marketplace dan terintegrasi ke dalam bilah aktivitas VS Code dengan ikonnya sendiri.

Buat proyek dengan Kit Pengembangan

Klik tombol pembuatan proyek yang disediakan oleh ekstensi. Jika Anda belum menginstalnya, Anda akan diminta untuk menginstalnya.

Dari halaman ekstensi, Anda akan diperlihatkan deskripsi proyek dan Anda dapat memilih opsi Buat untuk mulai membuat add-on.

Pilih folder kerja tempat proyek akan dibuat saat kotak dialog pemilihan folder muncul.

Development Kit akan membuat struktur file dan membuka proyek di jendela VS Code kedua . Pada tahap ini, disarankan untuk menutup jendela awal agar hanya bekerja di jendela baru tersebut.

Proyek yang dihasilkan juga berisi plugin panel tugas dasar , dengan kode contoh yang siap dijalankan dan dimodifikasi.

Struktur dan file kunci dalam proyek VS Code

Struktur proyek-proyek jenis ini sangat mirip dengan yang dihasilkan oleh Yeoman, dan Anda biasanya akan menemukan:

1. File ./manifest.xml atau ./manifest.json di akarnya, dengan konfigurasi dan fungsionalitas add-on.
2. file ./src/taskpane/taskpane.html yang berisi HTML panel tugas.
3. Lembar gaya ./src/taskpane/taskpane.css yang mengendalikan desain visual.
4. Naskah ./src/taskpane/taskpane.js dengan kode Office JavaScript API yang menghubungkan panel tugas ke aplikasi Office.

Uji dan hentikan plugin dari Development Kit

Untuk menguji plugin dari VS Code dengan Development Kit, cukup ikuti beberapa langkah mudah menggunakan activity bar ekstensi tersebut:

1. Buka ekstensi dengan mengklik ikon. Kit Pengembangan Add-in Office di bilah aktivitas.
2. Pilih opsi Pratinjau Add-In Office (F5), yang mempersiapkan lingkungan pemurnian.
3. Pilih opsi dari menu pilihan cepat {Aplikasi Office} Desktop (Edge Chromium), mengganti {Aplikasi Office} dengan aplikasi yang Anda inginkan (Word, Excel, dll.). Ini akan meluncurkan aplikasi desktop, memuat add-in, dan memasang debugger.

Selama proses ini, kit akan memverifikasi bahwa semua prasyarat telah terpenuhi dan menampilkan informasi detail di terminal jika terjadi kesalahan. Booting pertama mungkin membutuhkan waktu sedikit karena dependensi dan sertifikat yang diperlukan sedang diinstal.

Setelah selesai melakukan pengujian dan debugging, sangat penting untuk menghentikan add-in dengan benar , karena sekadar menutup aplikasi Office tidak selalu membatalkan pendaftaran add-in dengan benar. Untuk melakukannya dengan benar:

1. Buka kembali ekstensinya dari ikonnya di bilah aktivitas.
2. Klik pada Berhenti melihat pratinjau add-in Office, yang menutup server web dan menghapus log plugin dari cache.
3. Akhirnya tutup Jendela aplikasi Office.

Jika Anda mendapati add-in tidak berjalan atau berperilaku aneh, menutup semua instance Office dan memastikan Anda telah menghentikan server sebelumnya menggunakan opsi add-in itu sendiri seringkali membantu. Dokumentasi resmi juga menyertakan bagian khusus tentang pemecahan masalah selama pengembangan add-in Office , dan dalam kasus ekstrem, Anda selalu dapat membuka masalah di GitHub.

Toolkit Agen Microsoft 365

Opsi modern lainnya adalah menggunakan Microsoft 365 Agents Toolkit , seperangkat alat yang dirancang untuk membuat hampir semua jenis ekstensi untuk Microsoft 365, termasuk add-in Office. Ini sangat berguna ketika Anda ingin mengintegrasikan logika yang lebih canggih atau menggunakan kemampuan agen cerdas dalam ekosistem Microsoft 365.

Dengan alat ini, Anda dapat mengkonfigurasi proyek add-in dari perspektif yang lebih luas (tidak hanya Office klasik, tetapi seluruh lingkungan Microsoft 365), dengan memanfaatkan templat dan wizard khusus. Dokumentasi resmi menjelaskan cara membuat proyek add-in menggunakan toolkit ini dan cara mengintegrasikannya dengan layanan dan alur kerja lainnya.

Akses ke Office JavaScript API

Agar aplikasi web Anda dapat berkomunikasi dengan dokumen atau pesan Office tempat aplikasi tersebut berjalan, Anda perlu memuat pustaka JavaScript Office (office.js) , yang disajikan dari CDN resmi Microsoft.

URL perpustakaan standar adalah:
https://appsforoffice.microsoft.com/lib/1/hosted/office.js

Pada setiap halaman web plugin Anda yang perlu menggunakan API, Anda harus menambahkan tag skrip di dalam bagian head seperti ini:

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

Mulai saat itu, Anda akan memiliki akses ke namespace Office dan dapat menggunakan API khusus aplikasi (Excel, Word, dll.) serta API umum yang digunakan bersama oleh beberapa aplikasi. Selain itu, dokumentasi resmi menjelaskan cara mengaktifkan fitur seperti IntelliSense di editor untuk alur kerja yang lebih nyaman.

Model API yang tersedia

Platform add-in Office menawarkan dua model API JavaScript utama , yang saling melengkapi dan harus dibedakan dengan jelas:

• API khusus aplikasi
• API Umum

API khusus aplikasi dirancang untuk berinteraksi dengan objek asli dari aplikasi tertentu. Misalnya, dengan API Excel Anda dapat bekerja dengan lembar kerja, rentang, tabel, bagan, dan elemen khusus Excel lainnya, menggunakan objek bertipe kuat.

Model API ini bekerja dengan promise dan mendukung model operasi batch , di mana Anda dapat menggabungkan beberapa operasi menjadi satu permintaan ke aplikasi Office, yang sangat meningkatkan kinerja, terutama di Office versi web. Model ini muncul di Office 2016 dan telah diperluas dengan serangkaian persyaratan baru.

Di sisi lain, API umum berfokus pada fungsionalitas yang digunakan bersama di berbagai aplikasi Office , seperti kotak dialog, pengaturan klien, atau bagian tertentu dari antarmuka pengguna. Model ini didasarkan pada callback, bukan promise, dan hanya mengizinkan satu operasi per permintaan. Model ini kompatibel dengan versi sebelumnya, karena telah diperkenalkan sejak Office 2013, dan digunakan, misalnya, untuk berinteraksi dengan Outlook, PowerPoint, atau Project pada tingkat dasar.

Set persyaratan API

Dalam API JavaScript, berbagai kelompok fitur diorganisasikan ke dalam apa yang disebut set persyaratan . Setiap set mengelompokkan sejumlah anggota API di bawah nama dan versi, memungkinkan Anda untuk mengetahui dengan sangat tepat kemampuan mana yang tersedia di setiap klien Office.

Misalnya, Anda dapat menemukan set seperti:

• ExcelApi 1.7, yang mengelompokkan API tertentu untuk Excel yang tersedia dari versi tertentu.
• DialogApi 1.1, yang menawarkan fungsi kotak dialog umum untuk beberapa aplikasi Office.

Add-in dapat menggunakan kumpulan API ini untuk memeriksa saat runtime apakah aplikasi mendukung API yang diperlukan , dan dengan demikian menyesuaikan perilakunya atau menampilkan pesan yang sesuai jika sesuatu tidak tersedia. Kompatibilitas spesifik dari setiap kumpulan bervariasi tergantung pada platform ( Windows , Mac , web, seluler) , versi Office, dan aplikasi itu sendiri (Word, Excel, dll.).

Jelajahi API dengan Script Lab

Jika Anda ingin bereksperimen dengan API tanpa membangun proyek lengkap, Anda dapat menggunakan Script Lab , sebuah add-on gratis yang tersedia di Microsoft Marketplace.

Script Lab memungkinkan Anda menguji cuplikan kode langsung di dalam aplikasi seperti Excel atau Word , dan langsung melihat bagaimana pengaruhnya terhadap dokumen. Ini ideal untuk mempelajari API, memvalidasi bagian-bagian kecil logika, atau membangun prototipe cepat sebelum mengintegrasikannya ke dalam add-in Anda yang sebenarnya.

Di dalam Script Lab, Anda akan menemukan pustaka contoh yang sudah jadi yang dapat Anda jalankan apa adanya atau gunakan sebagai dasar untuk kode Anda sendiri. Selain itu, dokumentasi resminya menyertakan video singkat yang mendemonstrasikan Script Lab dalam عمل, yang sangat membantu untuk memahami semua kemampuannya.

Perluas antarmuka pengguna Office

Salah satu keunggulan add-in adalah bahwa add-in tidak terbatas pada menjalankan kode "di balik layar ," tetapi dapat sepenuhnya diintegrasikan ke dalam antarmuka Office, menambahkan tab, tombol, menu, dan panel yang disesuaikan dengan kebutuhan Anda.

Cara paling umum untuk memperluas antarmuka adalah:

• Perintah plugin yang terintegrasi ke dalam pita atau menu konteks.
• Kontainer HTML, seperti panel tugas, add-on konten, dan kotak dialog khusus.

Perintah tambahan memungkinkan Anda menambahkan tab atau grup tombol baru ke pita Office, atau bahkan memperluas menu konteks yang muncul saat Anda mengklik kanan teks atau objek di Excel. Saat pengguna mengklik salah satu perintah ini, perintah tersebut dapat menjalankan kode JavaScript, membuka panel tugas tertentu, atau meluncurkan kotak dialog.

Di sisi lain, panel tugas, add-in konten, dan kotak dialog adalah kontainer HTML yang menampilkan antarmuka add-in Anda. Konten disediakan oleh halaman web yang Anda tentukan dalam manifes, dan dari halaman-halaman ini Anda dapat menggunakan API Office untuk berinteraksi dengan dokumen, di samping semua yang dilakukan situs web pada umumnya: otentikasi, panggilan ke API eksternal, visualisasi data, dan sebagainya.

Dokumentasi untuk elemen antarmuka pengguna untuk add-in Office menjelaskan secara detail tentang cara mendesain pengalaman pengguna , pola apa yang direkomendasikan, dan cara memanfaatkan setiap jenis kontainer.

Temukan dan gunakan plugin yang sudah terpasang

Dari sudut pandang pengguna akhir, setelah add-in diinstal atau didistribusikan, menemukannya di dalam Office sangat mudah , meskipun ada nuansanya tergantung pada aplikasinya.

1. Pertama-tama, Anda harus melakukannya Masuk ke Office dengan akun Microsoft 365 yang sesuai. Untuk melakukannya, buka aplikasi Office apa pun dan, di sudut kanan atas, pilih opsi masuk lalu masukkan email dan kata sandi Anda.
2. Di aplikasi desktop Word, Excel, atau PowerPoint, Anda dapat membuka Sisipkan > Add-on Saya untuk melihat daftar add-on yang tersedia untuk aplikasi tersebut.
3. Di dalam kotak Add-in OfficeAnda dapat mencari add-on berdasarkan nama. Jika tidak muncul, periksa apakah Anda masuk dengan akun yang benar dan, jika perlu, klik Memperbarui untuk menyegarkan daftar.
4. Ketika Anda menemukan aksesorinya, lakukan saja klik dua kali di atasnya sehingga memulai dan menampilkan antarmukanya dalam dokumen.

Perilaku ini, yang didasarkan pada penautan add-in ke akun pengguna , memungkinkan add-in tersedia secara konsisten di berbagai perangkat dan aplikasi, selama Anda menggunakan akun Microsoft 365 yang sama.

Mengelola add-on dan ekstensi di office suite lainnya

Meskipun di sini kita fokus pada platform add-in Office, ada baiknya untuk memahami konteksnya dengan membandingkannya dengan suite perkantoran lain dan manajemen ekstensinya , karena filosofi umumnya serupa.

Add-in COM dan add-in di Microsoft Office klasik

Pada versi desktop seperti Word 2016, selain add-in berbasis web modern, komponen dan add-in COM tradisional masih tersedia . Untuk mengelolanya, buka File > Opsi dan, di bagian Add-in, tinjau daftar yang dikelompokkan berdasarkan jenisnya.

Memilih item dari daftar akan menampilkan detailnya di bagian bawah jendela. Contoh tipikalnya adalah add-on FoxitReader PDF Creator , yang ditambahkan secara opsional saat menginstal Foxit Reader dan menyertakan tab atau tombol tambahan untuk membuat dan memanipulasi PDF dari Word.

Di bagian bawah jendela ini terdapat area bernama Kelola , dengan menu tarik-turun dan tombol Lanjutkan… yang memungkinkan Anda mengelola jenis ekstensi tertentu: mengaktifkan, menonaktifkan, atau menghapusnya. Tidak semua add-on menambahkan tombol atau tab yang terlihat; ini sepenuhnya bergantung pada bagaimana pengembang mendesainnya.

Ekstensi di LibreOffice Calc

Di LibreOffice, khususnya di Calc, Anda dapat mengelola ekstensi dari menu Alat > Pengelola Ekstensi . Ini menampilkan daftar ekstensi yang terpasang, dengan opsi untuk menambahkan yang baru, memperbarui yang sudah ada, atau menghapus instalasinya.

Beberapa ekstensi muncul dengan gembok kuning kecil , yang menunjukkan bahwa ekstensi tersebut merupakan bagian dari paket dasar LibreOffice dan tidak dapat dihapus. Untuk menginstal ekstensi baru, Anda biasanya pergi ke halaman ekstensi dan templat resmi LibreOffice , yang terletak di https://extensions.libreoffice.org/ . Meskipun situs tersebut sebagian besar dalam bahasa Inggris, sebagian besar pengembang menerbitkan ekstensi mereka dalam bahasa tersebut, jadi tidak perlu merasa terintimidasi olehnya.

Add-on dalam dokumen Google Docs

Google Docs juga menawarkan sistem add-on yang terintegrasi ke dalam antarmuka itu sendiri . Dari menu Add-ons sebuah dokumen, Anda dapat mengelola add-on yang sudah terpasang dan mencari add-on baru di basis data Google.

Sistem ini memungkinkan Anda untuk memfilter berdasarkan kategori, melihat jumlah pengguna yang telah menginstal setiap add-on , memeriksa peringkat dan ulasan, serta menginstal langsung hanya dengan beberapa klik. Toko terintegrasi ini sangat menyederhanakan proses, karena tidak perlu mengunjungi situs web pengembang eksternal mana pun untuk menemukan add-in.

Izin dan akses ke fitur perangkat

Beberapa plugin, terutama yang berbasis teknologi web modern, mungkin memerlukan akses ke kemampuan perangkat seperti kamera, geolokasi, atau mikrofon. Jika ini terjadi, browser atau platform itu sendiri akan menampilkan kotak dialog yang meminta persetujuan Anda.

Anda biasanya akan melihat opsi seperti Izinkan, Izinkan sekali, atau Tolak :

• Jika Anda memilih MengizinkanAdd-on tersebut akan dapat mengakses sumber daya yang diminta secara terus-menerus, hingga Anda menghapus instalasi add-on tersebut atau menghapus cache browser tempat add-on tersebut dijalankan.
• Jika Anda memilih Izinkan sekaliAkses hanya akan diberikan selama sesi saat ini, hingga Anda menutup tab atau jendela tempat add-on tersebut berjalan.
• Jika Anda memilih MenyangkalAdd-on tersebut tidak akan memiliki akses dan, ketika membutuhkannya lagi, ia akan meminta izin lagi melalui kotak dialog lain.

Jika sewaktu-waktu Anda ingin mencabut izin yang telah Anda setujui dengan "Izinkan" , Anda harus menghapus instalasi add-on atau membersihkan cache browser Anda agar keputusan sebelumnya dilupakan dan memerlukan permintaan baru.

Ekosistem add-in Office menawarkan kerangka kerja yang sangat fleksibel untuk memperluas Word, Excel, Outlook, dan aplikasi Office lainnya menggunakan teknologi web standar, alat seperti Yeoman, Visual Studio, dan VS Code Development Kit, serta API JavaScript dengan model spesifik dan umum yang didukung oleh serangkaian persyaratan. Dengan memahami peran manifes, struktur proyek, opsi debugging, metode penyebaran, dan implikasi izin serta akses perangkat, dimungkinkan untuk membangun solusi yang ampuh yang terintegrasi secara mulus ke dalam pengalaman Office sehari-hari tanpa mengganggu alur kerja pengguna.