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

1. مقدمه

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

چیزی که یاد خواهید گرفت

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

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

• دسترسی به محیط توسعه AppSheet ( appsheet.com ).
• دسترسی به محیط توسعه Apps Script ( script.google.com ).

2. یک پروژه Apps Script ایجاد کنید

ابتدا یک پروژه 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. روی ذخیره پروژه کلیک کنید.

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

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

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

1. صفحه گسترده نمونه سفارشات پیراهن را باز کنید و سپس روی ایجاد یک کپی کلیک کنید تا یک کپی را بارگیری و در Google Sheets باز کنید. در صورت تمایل می‌توانید نام صفحه‌گسترده را به‌صورت اختیاری تغییر دهید (مثلاً «سفارش‌های پیراهن»).
2. وارد AppSheet شوید.
3. در صفحه برنامه‌های من، روی + ایجاد برنامه جدید کلیک کنید. گفتگوی Create a new app نمایش داده می شود.
4. روی Start with your own data کلیک کنید.
5. در صورت تمایل، نام برنامه را ویرایش کنید و یک دسته را انتخاب کنید.
6. روی Choose your data کلیک کنید.

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

AppSheet برنامه شما را راه اندازی می کند.

9. روی Customize your app کلیک کنید تا برنامه در ویرایشگر AppSheet باز شود.

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

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

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

4. برای ویرایش، روی Send a notification step کلیک کنید.
5. نام را به Call a script تغییر دهید.

6. در قسمت تنظیمات ، نوع کار را به Call a script تغییر دهید.

7. در قسمت Apps Script Project ، روی Browse (نماد فایل) کلیک کنید.
8. به پروژه Hello World Apps Script در Drive خود بروید و آن را انتخاب کنید.
9. روی Select کلیک کنید و در صورت درخواست مجوز، روی Authorize کلیک کنید و دستورات را دنبال کنید.

پروژه Apps Script اضافه می شود و قسمت Function Name با لیستی از توابع موجود پر می شود.

10. logThis(msg) را از لیست Function Name انتخاب کنید.

فیلد Function Arguments نمایش داده می شود.

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

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

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

5. اجرای Apps Script را تایید کنید

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

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

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

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

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

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

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

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

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