اکشن‌های پایه

اکشن‌های پایه اکشن‌های "ضمنی" هستند که کارهایی را انجام می‌دهند که افراد معمولاً هنگام تعامل با یک پایگاه داده می‌خواهند انجام دهند: Create، Update، Delete. اکشن‌های پایه به‌طور خودکار schema جدول منبع پشتیبان مدل را ردیابی می‌کنند. با ردیابی خودکار schema، منظورمان این است که متابیس فرم‌های اکشنی برای افراد ایجاد می‌کند تا پر کنند که شامل همهٔ فیلدهای جدول منبع اصلی که زیربنای آن مدل است می‌شود.

اگر فقط می‌خواهید به افراد گزینهٔ به‌روزرسانی یک زیرمجموعه از ستون‌ها، یا به‌روزرسانی ستون‌ها در چندین جدول را بدهید، می‌توانید یک اکشن سفارشی بنویسید.

ایجاد اکشن‌های پایه

بعد از اینکه اکشن‌ها فعال شدند، می‌توانید اکشن‌های پایه را روی یک مدل جدید یا موجود که فقط یک جدول پایگاه داده را می‌پوشاند ایجاد کنید.

1. یک مدل انتخاب کنید و روی دکمهٔ info کلیک کنید، سپس روی Model detail کلیک کنید.
2. در صفحهٔ جزئیات مدل، روی تب Actions کلیک کنید.
3. روی ... کنار New Action کلیک کنید و Create basic actions را انتخاب کنید.

محدودیت‌های اکشن پایه

اکشن‌های پایه فقط برای مدل‌های "پایه" در دسترس هستند:

• مدل‌های ساخته‌شده با استفاده از query builder گرافیکی. اکشن‌های پایه برای مدل‌های ایجادشده با کوئری‌های native (SQL) در دسترس نیستند.
• مدل باید یک جدول خام واحد در یک پایگاه داده را "بپوشاند". کوئری باید به سادگی آن جدول را در مرحلهٔ دادهٔ ویرایشگر notebook انتخاب کند، و نه بیشتر: بدون join، بدون ستون‌های سفارشی، بدون فیلتر یا خلاصه‌سازی، بدون مرتب‌سازی.
• جدول زیربنایی فقط می‌تواند یک کلید اصلی (entity) داشته باشد.

انواع اکشن پایه

اکشن‌های پایه شامل موارد زیر هستند:

• Update
• Delete
• Create

Update

اکشن به‌روزرسانی یک فرم با فیلدهای قابل ویرایش برای هر ستون در جدول منبع اصلی به افراد ارائه می‌دهد.

هنگام تنظیم یک اکشن Update در یک داشبورد، باید یک کلید entity (مثل یک ID) را از یک فیلتر داشبورد به اکشن ارسال کنید. برای مقادیر دیگر، می‌توانید یا از شخص بخواهید که برای هر فیلد یک مقدار وارد کند، یا یک فیلد را به‌طور خودکار از طریق پارامترها (مثل مقادیر تنظیم‌شده در فیلترهای داشبورد) پر کنید.

Delete

اکشن Delete یک فرم ایجاد می‌کند که از افراد برای یک کلید entity درخواست می‌کند و رکورد (ردیف) متناظر با آن ID در جدول زیربنایی که مدل را پشتیبانی می‌کند حذف می‌کند.

Create

اکشن Create همان اکشن INSERT INTO است. اکشن Create یک فرم با فیلدهای قابل ویرایش برای هر ستون در جدول منبع اصلی پشتیبان مدل ارائه می‌دهد. بعد از پر شدن، اکشن رکورد را در جدول اصلی که زیربنای مدل است درج می‌کند.

اکشن‌های پایه در داشبوردها

هنگام تنظیم اکشن‌ها در یک داشبورد، می‌توانید یا از شخص بخواهید که برای هر فیلد یک مقدار وارد کند، یا یک فیلد را به‌طور خودکار از طریق پارامترها (مثل مقادیر تنظیم‌شده در فیلترهای داشبورد) پر کنید.

اکشن Update پایه نیاز دارد که یک مقدار برای کلید entity ارسال کنید.

به اکشن‌ها در داشبوردها مراجعه کنید.

آرشیو کردن اکشن‌های پایه

چون اکشن‌های پایه از جادو ساخته شده‌اند، نمی‌توانید آن‌ها را آرشیو کنید. فقط می‌توانید آن‌ها را روشن یا خاموش کنید. از صفحهٔ جزئیات مدل، کنار دکمهٔ New action، روی منوی ... کلیک کنید و Disable basic actions را کلیک کنید.

اکشن‌های پایه از نمای جزئیات object

اگر اکشن‌های پایه را برای یک مدل فعال کرده‌اید، می‌توانید روی یک رکورد جداگانه کلیک کنید تا جزئیات object آن را مشاهده کنید. از آن مدل جزئیات object، می‌توانید روی سه نقطه (...) کلیک کنید و update یا delete را انتخاب کنید تا آن رکورد خاص را تغییر دهید.

مطالعهٔ بیشتر

• مقدمه‌ای بر اکشن‌ها
• اکشن‌های سفارشی
• اکشن‌ها در داشبوردها