گسترش Google Sheets با افزونه‌ها

Google Sheets یک راه‌حل صفحه‌گسترده مبتنی بر ابر با همکاری هم‌زمان و ابزارهای قدرتمند برای تجسم، پردازش و برقراری ارتباط داده‌ها است.

می‌توانید کاربرگ‌نگار را با افزونه‌هایی گسترش دهید که بهبودهای گردش کار سفارشی‌سازی شده ایجاد می‌کنند، اتصال به سیستم‌های شخص ثالث را ایجاد می‌کنند و داده‌های کاربرگ‌نگار خود را با سایر برنامه‌های Google Workspace (مانند Google Slides) یکپارچه می‌کنند.

می‌توانید افزونه‌های Sheets را که دیگران در Google Workspace Marketplace ساخته‌اند، ببینید.

کاری که می توانید انجام دهید

در اینجا چند کار وجود دارد که می توانید با افزونه ای که Google Sheets را گسترش می دهد انجام دهید:

افزونه‌های Sheets با استفاده از Apps Script ساخته می‌شوند. برای کسب اطلاعات بیشتر درباره نحوه دسترسی و مدیریت Google Sheets با Apps Script، به گسترش Google Sheets مراجعه کنید.

ساختار ورق

یک صفحه گسترده Google Sheets از یک یا چند صفحه تشکیل شده است. هر صفحه در اصل یک شبکه دو بعدی از سلول ها است که متن، اعداد، پیوندها یا مقادیر دیگر را می توان در آن ذخیره کرد. گروهی از یک یا چند سلول مجاور را محدوده می نامند.

سرویس Apps Script Spreadsheet چندین کلاس را برای نمایش ساختارهای سازمانی در Sheets (مانند Sheet و Range ) ارائه می‌کند. می توانید از این کلاس ها برای خواندن و اصلاح داده ها و رفتار Sheets استفاده کنید.

محرک ها

راه‌اندازهای Apps Script به یک پروژه اسکریپت اجازه می‌دهد تا زمانی که شرایط خاصی وجود دارد، مانند زمانی که صفحه‌گسترده باز می‌شود یا زمانی که یک افزونه نصب می‌شود، یک عملکرد مشخص را اجرا کند.

برای اطلاعات بیشتر در مورد اینکه چه محرک هایی را می توان با برافزاهای Sheets استفاده کرد و چه محدودیت هایی برای استفاده از آنها اعمال می شود، به محرک های افزودنی مراجعه کنید.

توابع سفارشی

Google Sheets تعدادی توابع داخلی مانند SUM و AVERAGE دارد که می‌توان آنها را از داخل یک سلول Google Sheet فراخوانی کرد. افزونه‌های Sheets می‌توانند توابع سفارشی اضافی را برای تکمیل این توابع داخلی تعریف کنند. هنگامی که کاربر افزونه را نصب می کند، هر توابع سفارشی تعریف شده همراه با افزونه بلافاصله در دسترس قرار می گیرد. این امکان وجود دارد که یک افزونه فقط از تعاریف تابع سفارشی تشکیل شده باشد. تعاریف تابع سفارشی در درجه اول با انتشار یک افزونه حاوی تعاریف با دیگران به اشتراک گذاشته می شود.

ایجاد توابع سفارشی افزودنی

هر تابعی که در یک پروژه اسکریپت الحاقی تعریف شده باشد می تواند به عنوان یک تابع سفارشی استفاده شود. هنگامی که تابع اجرا شد و افزونه نصب شد، می‌توانید تابع سفارشی را مانند هر تابع دیگر برگه‌های داخلی فراخوانی کنید: در یک سلول Sheet، = را وارد کنید و نام تابع و هر پارامتر مورد نیاز را وارد کنید. اگر خطایی وجود نداشته باشد، نتیجه برگردانده شده توسط تابع در سلول Sheet قرار می گیرد و در صورت لزوم به سلول های همسایه سرریز می شود.

هنگام ایجاد توابع سفارشی در یک افزونه، باید دستورالعمل های کلی عملکرد سفارشی را دنبال کنید:

علاوه بر این، توابع سفارشی تعریف شده در افزونه ها ملاحظات خاصی دارند:

  • هنگام نامگذاری تابع خود، سعی کنید یک نام منحصر به فرد ایجاد کنید، که احتمالاً مربوط به نام افزونه شما باشد. اگر دو یا چند افزونه نصب شده توابع سفارشی را با یک نام تعریف کنند، کاربران فقط می توانند از یکی از آنها استفاده کنند.
  • افزونه شما باید به وضوح نشان دهد که چه عملکردهای سفارشی ارائه می دهد. حتما نظرات JSDoc دقیقی را برای عملکردهای سفارشی خود ارائه دهید تا Apps Script بتواند اطلاعات تکمیل خودکار را به کاربر ارائه دهد. علاوه بر این، ارائه اسناد اضافی از عملکردهای سفارشی را در خود افزونه یا در یک صفحه وب پشتیبانی افزونه در نظر بگیرید.
  • توابع سفارشی که در کمتر از 30 ثانیه کامل نمی شوند با Internal error executing the custom function شکست می خورند. با محدود کردن میزان پردازشی که در یک عملکرد سفارشی انجام می دهید، یک تجربه کاربری خوب ایجاد کنید. در جایی که می توانید عملکرد را بهینه کنید .
  • توابع سفارشی نمی‌توانند از سرویس‌های Apps Script که نیاز به مجوز دارند استفاده کنند و با خطای You do not have permission to call X service در صورت تلاش، با شکست مواجه می‌شوند. فقط از خدمات مجاز در عملکرد سفارشی خود استفاده کنید.
  • هر تابع سفارشی در یک برگه منجر به تماس جداگانه ای با سرورهای Apps Script می شود. اگر کاربر بخواهد از توابع سفارشی در تعداد زیادی سلول استفاده کند، ممکن است توابع به کندی اجرا شوند. برای کاهش این امر، عملکردهای سفارشی خود را تا حد امکان ساده نگه دارید. اگر به این تابع برای انجام پردازش های پیچیده یا گسترده نیاز دارید، از یک تابع سفارشی استفاده نکنید—به جای آن، این عملکرد را از طریق یک آیتم منو، گفتگو یا تعامل نوار کناری ارائه دهید.

ماکروهای برگه

ماکروها به شما امکان می دهند اقدامات انجام شده در Google Sheets را ضبط کنید و بعداً با یک میانبر صفحه کلید آنها را تکرار کنید. هنگامی که یک ماکرو در یک برگه ایجاد می شود، به عنوان یک تابع ماکرو در پروژه Apps Script متصل به آن صفحه اضافه می شود. برای اطلاعات بیشتر درباره ماکروها، ماکروهای Google Sheets را ببینید.

متأسفانه، ماکروهای Sheets را نمی‌توان با افزونه‌ها توزیع کرد. اگر یک تعریف کلان را در مانیفست افزونه اضافه کنید، برای کاربران آن افزونه در دسترس نیست.