۱. قبل از شروع
پایگاه داده AppSheet (ASDB) پایگاه داده بومی شخص ثالث AppSheet برای سازماندهی و مدیریت دادههایی است که برنامههای AppSheet را پشتیبانی میکنند. رابط کاربری و عملکرد بهبود یافته آن، در مقایسه با سایر منابع داده خارجی رایج مانند Google Sheets، Big Query و Cloud SQL، تجربه بهتری را هم برای سازنده برنامه و هم برای کاربر نهایی ایجاد میکند. پایگاه داده AppSheet به عنوان یک گزینه داده پیشفرض برای هر برنامه AppSheet ارائه میشود.
آنچه یاد خواهید گرفت
- نحوه ایجاد یک پایگاه داده جدید AppSheet با دادههای نمونه یا دادههای وارد شده از یک Google Sheet.
- نحوه سفارشیسازی دادهها در ویرایشگر پایگاه داده AppSheet.
- نحوه تولید یک برنامه AppSheet از پایگاه داده AppSheet.
- نحوه تغییر پایگاه داده و بازسازی جداول در AppSheet برای در نظر گرفتن تغییرات ساختار جدول.
آنچه خواهید ساخت
این codelab به شما نحوه تولید و سفارشیسازی یک پایگاه داده AppSheet جدید را آموزش میدهد، ابتدا از ابتدا با دادههای پیشفرض ارائه شده توسط پایگاه داده AppSheet و سپس از دادههای موجود در Google Sheet. سپس نحوه تولید یک برنامه AppSheet جدید از یک پایگاه داده AppSheet را شرح میدهد. در نهایت، نحوه تغییر جدول پایگاه داده در ویرایشگر پایگاه داده و سپس تولید مجدد جدول در ویرایشگر برنامه AppSheet را نشان میدهد.
آنچه نیاز دارید
- دسترسی به محیط توسعه AppSheet ( appsheet.com ).
۲. ایجاد و سفارشیسازی یک پایگاه داده AppSheet جدید از ابتدا
برای شروع، شما یک پایگاه داده جدید AppSheet را از ابتدا با استفاده از پایگاه داده اولیه پیشفرض آن ایجاد و سفارشیسازی میکنید. این به شما فرصتی میدهد تا بدون نیاز به انجام مراحل بعدی در codelab، با ویرایشگر پایگاه داده آزمایش کنید.
- به صفحه اصلی AppSheet ( appsheet.com ) بروید و سپس روی Create > Database > New database کلیک کنید.

- یک پایگاه داده نمونه جدید ایجاد میشود و ویرایشگر پایگاه داده AppSheet ظاهر میشود.

- با تغییر نام پایگاه داده از Untitled database به Tasks DB ، پایگاه داده را سفارشی کنید. (برای ویرایش نام پایگاه داده، روی عنوان پیشفرض، Untitled database ، دوبار کلیک کنید.)
- نام جدول Table 1 را به Tasks تغییر دهید. (برای ویرایش، روی تب دوبار کلیک کنید).
- ستون اول را از عنوان به وظیفه تغییر دهید.
- با کلیک روی + در گوشه بالا سمت چپ، یک رکورد جدید اضافه کنید.

- برای مشاهده نحوه استفاده از نوع شمارشی (Enum Type) و نوع آیتم کشویی (Dropdown Item)، روی ستون وضعیت (Status) دوبار کلیک کنید.

- اختیاری: برای رنگآمیزی هر گزینهی کشویی، روی دکمههای بعد از علامت = کلیک کنید.

- اختیاری: با اضافه کردن گزینههای جدید برای Status Enum ( روی گزینه Add کلیک کنید) به همراه رنگهای جدید، با ویرایشگر بیشتر آزمایش کنید.
- اختیاری: انواع ستونهای مختلف مانند رنگ ، پیشرفت ، بله/خیر و تلفن را آزمایش کنید و سپس رفتار آنها را مشاهده کنید.

میتوانید با ویرایشگر پایگاه داده بیشتر آزمایش کنید. در مراحل بعدی، یک پایگاه داده جدید ایجاد میکنید.
۳. با وارد کردن از یک صفحه Google، پایگاه داده جدید ایجاد و سفارشی کنید
مراحل بعدی نحوه وارد کردن دادهها از یک صفحه گسترده گوگل (Google Sheet) را نشان میدهد.
ایجاد پایگاه داده از یک Sheet
- ابتدا، یک کپی از این صفحه عمومی گوگل تهیه کنید و نام آن را به
ASDB: IO Codelabتغییر دهید.
توجه کنید که دو تب دارد، Tasks و Owners .
- مانند قبل، به صفحه اصلی AppSheet ( appsheet.com ) بروید و سپس روی Create > Database > Import from Sheets کلیک کنید.

- در انتخابگر فایل گوگل درایو، کپی خود از Sheet با نام
ASDB: IO Codelabیا هر نام دیگری که برای آن انتخاب کردهاید را انتخاب کنید.
این منجر به ایجاد یک پایگاه داده جدید AppSheet میشود که از دادههای موجود در Sheet تولید شده است.

اضافه کردن یک ارجاع به جدول وظایف
در مرحله بعد، از جدول وظایف، یک ارجاع به جدول مالکان (Owners) اضافه میکنید.
- در جدول وظایف (Tasks) در پایگاه داده AppSheet، روی ستون مالک (Owner) دوبار کلیک کنید تا تنظیمات آن را ویرایش کنید.
- نوع را از متن به منابع > مرجع تغییر دهید.

- جدول را طوری تنظیم کنید که به عنوان مالک (Owners) ارجاع داده شود، و سپس روی ذخیره (Save) کلیک کنید.

- هشداری در مورد تغییر نوع ستون ظاهر میشود. در این حالت، دادههای این ستون با نوع ستون جدید سازگار است، بنابراین میتوانید برای ادامه روی بله کلیک کنید.

- سپس پایگاه داده AppSheet تلاش میکند تا ردیفهای مربوطه در جدول Owners را با نامهای موجود در جدول Tasks مطابقت دهد. از آنجایی که این مجموعه داده مطابقت دارد، پایگاه داده AppSheet باید ستون Owner را با ارجاعات صحیح به ردیفهای Owners پر کند.

- برای آزمایش ارجاع، روی یک سلول Owner کلیک کنید و آن را به مالک دیگری مانند Sarah بهروزرسانی کنید.

پس از انتخاب، مقدار جدید ( سارا ) در سلول مالک (در جدول وظایف) ظاهر میشود.

ستون برچسب جدول ارجاعشده را تغییر دهید
پایگاه داده AppSheet به شما امکان میدهد برای هر جدولی یک ستون Label انتخاب کنید. این به شما امکان میدهد مشخص کنید کدام ستون را میخواهید در جدول والد نمایش دهید. این همچنین آنچه را که در جدول والد در یک برنامه frontend لینک شده AppSheet نشان داده میشود، تعیین میکند. بنابراین به جای نمایش ستون Name از جدول Owners در جدول Tasks (که قبلاً نشان داده شده است)، میتوانید ستون Email را از جدول Owners نمایش دهید.
- برای انجام این کار، ستون Label را در جدول Owners به Email تغییر دهید، برای این کار، نشانگر ماوس را در سمت راست سربرگ ستون Email نگه دارید و روی بیضی عمودی کلیک کنید.

این، منوی متنی ستون را فراخوانی میکند.

- برای تنظیم برچسب ستون به عنوان ستون ایمیل ، از منوی زمینه، گزینه «استفاده از ستون به عنوان برچسب» را انتخاب کنید.

- برای مشاهدهی اینکه ستون ایمیل به عنوان برچسب ستونی که به جدول وظایف اشاره میکند انتخاب شده است، روی تب جدول وظایف کلیک کنید و توجه کنید که ستون مالک (Owner) اکنون آدرسهای ایمیل را نمایش میدهد. ممکن است لازم باشد مرورگر را رفرش کنید تا ستون مالک (Owner) بهروزرسانی شده را ببینید.

۴. ایجاد یک برنامه AppSheet از پایگاه داده AppSheet
پس از اتمام سفارشیسازیهای پایگاه داده، میتوانید یک برنامه AppSheet را مستقیماً از پایگاه داده ایجاد کنید. این کار در صورتی مفید است که بخواهید رابط کاربری frontend سفارشی داشته باشید، نیاز به اضافه کردن اتوماسیون یا فیلترهای امنیتی و غیره داشته باشید. برای انجام این کار، موارد زیر را انجام دهید:
- روی برنامهها (Apps) در سمت راست ویرایشگر ASDB کلیک کنید.

این کار منوی زمینهای سمت راست را برای تولید یک برنامه جدید فراخوانی میکند.

- برای ایجاد یک برنامه جدید ، روی برنامه New AppSheet کلیک کنید.

همانطور که برنامه تولید میشود، توجه کنید که برنامه یک هشدار دارد:
Column "Owner" in Tasks_Schema has a reference to an unknown table or slice "Owners". Open the column definition to select a source table.
دلیل این امر آن است که برنامهی تولید شده فقط جدول Tasks را دارد و ستون Owner آن به یک جدول ناشناخته به نام Owners ارجاع دارد.
برای رفع این مشکل، جدول Owners را به برنامه AppSheet اضافه کنید.
- در صفحه داده در ویرایشگر AppSheet، روی + کلیک کنید.

- در منوی زمینهای افزودن داده ، AppSheet Database را به عنوان منبع داده انتخاب کنید.

- سپس پایگاه داده ASDB:IO Codelab (یا هر نامی که در مراحل قبلی برای پایگاه داده خود انتخاب کردهاید) را انتخاب کنید.

- در پنجرهی بعدی، گزینهی پیشفرض SELECT ALL را انتخاب کنید و سپس روی Add to app کلیک کنید.

با اضافه شدن جدول Owners به برنامه، خطای Reference دیگر نمایش داده نمیشود.

- اکنون که جدول جدید Owners AppSheet اضافه شده است، میتوانید با کلیک روی صفحه Views در AppSheet و کلیک روی + در کنار PRIMARY NAVIGATION ، یک View جدید برای نمایش این دادهها ایجاد کنید.

- در کادر محاورهای افزودن نمای جدید ، روی ایجاد نمای جدید کلیک کنید.

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

تبریک میگویم، برنامه شما اکنون کامل شده است!
- برای آزمایش ارجاع بین وظایف و مالکان، روی نمای مالکان یا نمای وظایف در پیشنمایش موبایل کلیک کنید و سپس یک رکورد را برای مشاهده رکوردهای مرتبط (ارجاع داده شده) انتخاب کنید.

برای مثال، میتوانید روی نمای Owners کلیک کنید و سپس روی یک رکورد کلیک کنید تا جزئیات بیشتری را بررسی کرده و رکوردهای Task مرتبط با آن را مشاهده کنید.

۵. پایگاه داده را تغییر دهید و جدول وظایف (Tasks) را بازسازی کنید.
حالا که یک پایگاه داده Appsheet ایجاد کردهاید و یک برنامه جدید از آن ایجاد کردهاید، سعی کنید یک جدول در پایگاه داده را تغییر دهید. نوع داده یک ستون را تغییر دهید و مشاهده کنید که در برنامه AppSheet لینک شده چه اتفاقی میافتد.
- در جدول وظایف (Tasks) در پایگاه داده، نوع ستون تاریخ سررسید (Date Date ) را به Date and time > Date تغییر دهید.

توجه داشته باشید که وقتی به برنامه AppSheet برمیگردید، متوجه میشوید که پایگاه داده با یک هشدار بهروزرسانی شده است:
App Schema for table 'Tasks' is out of sync with the schema in AppSheet database. Please regenerate the table structure

- برای بازسازی، روی کلیک کنید
آیکون بازسازی در گوشه بالا سمت راست. - این یک کادر محاورهای هشدار ایجاد میکند:

- برای ادامه روی Regenerate کلیک کنید. این کار نوع ستون Due Date را در برنامه به Date تغییر میدهد و عنصر ورودی date picker را در فرم ویرایش برای رکوردهای Task فعال میکند.

۶. تبریک
شما آزمایشگاه کد پایگاه داده AppSheet (ASDB) را تکمیل کردید!
مطالعه بیشتر
- پایگاه داده AppSheet، سایت رسمی مستندات