AppSheet را با Apps Script متصل کنید

۱. مقدمه

در این آزمایشگاه کد، شما یک پروژه Apps Script با نام "Hello World" ایجاد می‌کنید و سپس یک تابع ساده به logThis اضافه می‌کنید که پیامی را که به آن ارسال شده است، ثبت می‌کند. سپس یک اتوماسیون Appsheet ایجاد می‌کنید و از آن می‌خواهید که اسکریپت را فراخوانی کند. پس از فراخوانی اسکریپت، به ویرایشگر Apps Script برمی‌گردید و اجرای آن را تأیید می‌کنید.

آنچه یاد خواهید گرفت

• نحوه ایجاد یک پروژه Apps Script با یک تابع ساده.
• چگونه یک برنامه AppSheet ساده بر اساس یک Google Sheet موجود ایجاد کنیم.
• چگونه یک اتوماسیون AppSheet ایجاد کنیم که تابع اسکریپت را فراخوانی کند.
• نحوه بررسی اجرای موفقیت‌آمیز اسکریپت از AppSheet.

آنچه نیاز دارید

• دسترسی به محیط توسعه AppSheet ( appsheet.com ).
• دسترسی به محیط توسعه‌ی اسکریپت برنامه‌ها ( script.google.com ).

۲. یک پروژه اسکریپت برنامه‌ها ایجاد کنید

ابتدا، یک پروژه Apps Script با نام "Hello World" ایجاد کنید و سپس یک تابع ساده به logThis اضافه کنید که پیامی را که به آن ارسال شده است، ثبت می‌کند.

1. به صفحه اصلی Apps Script بروید و سپس روی + New Project کلیک کنید.
2. عنوان پروژه را به Hello World.
3. اسکریپت را در ویرایشگر به این صورت به‌روزرسانی کنید:

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

4. روی ذخیره پروژه کلیک کنید.

برای اطلاعات بیشتر، به ایجاد و حذف پروژه‌ها مراجعه کنید.

۳. یک برنامه AppSheet ایجاد کنید

در مرحله بعد، شما به سرعت یک برنامه AppSheet جدید را بر اساس یک نمونه کپی شده از Google Sheet ایجاد می‌کنید و سپس آن را به‌روزرسانی می‌کنید تا پروژه Apps Script را که قبلاً ایجاد کرده‌اید، فراخوانی کند.

1. صفحه گسترده نمونه سفارش پیراهن را باز کنید و سپس برای دانلود و باز کردن یک کپی در گوگل شیت، روی «ایجاد یک کپی» کلیک کنید. در صورت تمایل می‌توانید نام صفحه گسترده را تغییر دهید (مثلاً «سفارش پیراهن»).
2. وارد AppSheet شوید.
3. در صفحه «برنامه‌های من»، روی « + ساخت یک برنامه جدید» کلیک کنید. کادر محاوره‌ای « ایجاد یک برنامه جدید» نمایش داده می‌شود.
4. روی «شروع با داده‌های خودتان» کلیک کنید.
5. در صورت تمایل، نام برنامه را ویرایش کنید و یک دسته انتخاب کنید.
6. روی «انتخاب داده‌هایتان» کلیک کنید.

7. برای دسترسی به گوگل درایو خود، روی گوگل کلیک کنید.
8. به صفحه گسترده سفارش‌های پیراهن که قبلاً کپی کرده‌اید بروید و آن را انتخاب کنید.

AppSheet برنامه شما را تنظیم می‌کند.

9. برای باز کردن برنامه در ویرایشگر AppSheet، روی گزینه‌ی «سفارشی‌سازی برنامه» کلیک کنید.

۴. یک اتوماسیون ایجاد کنید

در مرحله بعد، یک اتوماسیون Appsheet ایجاد می‌کنید و آن را وادار به فراخوانی اسکریپت می‌کنید.

1. اتوماسیون > ربات‌ها را انتخاب کنید.
2. روی + ربات جدید کلیک کنید.
3. اولین مورد را در لیست پیشنهادات انتخاب کنید: وقتی یک رکورد سفارش پیراهن ایجاد یا به‌روزرسانی می‌شود، یک اعلان ارسال شود.

4. برای ویرایش آن، روی مرحله ارسال اعلان کلیک کنید.
5. نام را به Call a script تغییر دهید.

6. در قسمت تنظیمات ، نوع وظیفه را به فراخوانی اسکریپت تغییر دهید.

7. در فیلد پروژه اسکریپت برنامه‌ها ، روی مرور (آیکون فایل) کلیک کنید.
8. به پروژه Hello World Apps Script در درایو خود بروید و آن را انتخاب کنید.
9. روی «انتخاب» کلیک کنید و در صورت درخواست تأیید، روی «مجوز» کلیک کنید و دستورالعمل‌ها را دنبال کنید.

پروژه اسکریپت برنامه‌ها اضافه شده و فیلد نام تابع با فهرستی از توابع موجود پر شده است.

10. از لیست نام تابع، logThis(msg) را انتخاب کنید.

فیلد آرگومان‌های تابع نمایش داده می‌شود.

11. برای آرگومان msg ، عبارت زیر را با استفاده از Expression Assistant وارد کنید: 'Hello from AppSheet'

12. برای ذخیره برنامه، روی ذخیره کلیک کنید.
13. در پنل پیش‌نمایش، روی آیکون موبایل یا تبلت کلیک کنید تا شبیه‌ساز برنامه نمایش داده شود.

14. یک سفارش پیراهن جدید اضافه کنید و روی ذخیره کلیک کنید.
15. برای همگام‌سازی تغییرات، روی همگام‌سازی کلیک کنید.

۵. اجرای اسکریپت برنامه‌ها را تأیید کنید

پس از فراخوانی اسکریپت، به ویرایشگر Apps Script برگردید و اجرای آن را تأیید کنید.

1. به صفحه اصلی Apps Script برگردید و پروژه Hello World را مشاهده کنید.
2. برای تأیید اینکه تابع logThis با موفقیت تکمیل شده است، روی Executions در نوار پیمایش کلیک کنید. اگر گزارش ظاهر نشد، روی Refresh کلیک کنید.

۶. مراحل اضافی اختیاری

به عنوان یک گام اضافی در این کارگاه، پروژه Apps Script Examples را مرور کنید و برخی از مثال‌های AppSheet را اجرا کنید.

با مثال‌های اسکریپت برنامه‌ها شروع کنید

1. برای شروع، ابتدا یک کپی از پروژه Apps Script Examples تهیه کنید.
2. روی نماد کپی کلیک کنید.
3. پروژه جدید را ذخیره کنید و برای تأیید برنامه‌های موجود در پروژه، روی Run کلیک کنید.

با چند نمونه آزمایش کنید

• createCalendarEvent() - یک رویداد تقویم جدید ایجاد می‌کند.
• createDoc() - ایجاد خودکار یک سند جدید.
• createSheet() - یک برگه جدید ایجاد می‌کند.
• createSlideDeck() - با استفاده از یک تصویر و متن، یک اسلاید دک جدید ایجاد می‌کند.

برای اطلاعات بیشتر در مورد این ویژگی مهم، به بخش «فراخوانی اسکریپت برنامه‌ها از یک اتوماسیون» مراجعه کنید، که یک مرور کلی دقیق، ویدیوی ویژگی، آموزش‌ها و یک پروژه اسکریپت برنامه‌های قابل کپی که شامل بسیاری از مثال‌های کاربردی اسکریپت AppSheet-Apps است را ارائه می‌دهد.