موجودیت‌ها و پرس‌وجوها

ساخت موجودیت‌ها

یک موجودیت را از نام کلاسِ کاملاً مقیدش بسازید. موجودیت خالی آغاز می‌شود؛ آن را با متدهای زیر پر می‌کنید و سپس ذخیره‌اش می‌کنید.

var order = PSEntity("com.domain.commerce.Order");
order.identifier("ORD-2024-001");

ساخت یک موجودیت جدیدِ ذخیره‌نشده از کلاس داده‌شده.

تنظیم یک شناسانهٔ تجاریِ پایدار — کلیدی که بعداً به data$.load می‌دهید.

var idn = "PROCESS_CATEGORY_BUSINESS";
var model = data$.load(idn);
if (model == null) {
    model = PSEntity("com.paradicshift.platform.automation.process.Category");
    model.identifier(idn);
}
model.text("name", "en", "Business");
data$.persist(model);

فیلدها و مقادیر

تنظیم یک فیلد اسکالر (رشته، عدد، بولی، …). ‏value نام مستعار val است.

یک فیلد را بازمی‌خواند؛ اگر تنظیم نشده باشد null برمی‌گرداند.

order.val("total", 149.99);
order.val("currency", "USD");
order.val("hidden", false);

context$.log("total = {}", order.val("total"));   // 149.99

متن چندزبانه

فیلدهای متنی به‌ازای هر لوکال ذخیره می‌شوند، بنابراین یک رکورد می‌تواند نام یا توضیح خود را هم‌زمان به چند زبان داشته باشد.

تنظیم متن محلی‌شدهٔ یک فیلد. نام فیلد و لوکال بر اساس ترتیب خودکار تشخیص داده می‌شوند، پس هم ("name", "en", …) و هم ("en", "name", …) کار می‌کنند.

یک مقدار محلی‌شده را بازمی‌خواند. خواندن لوکالی که هرگز تنظیم نشده خطای زمان اجراست، پس اول آن را نگهبانی یا تنظیم کنید.

component.text("name", "en", "Execute access");
component.text("name", "fa", "دسترسی اجرا");

هندسهٔ GIS

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

افزودن یک هندسه به یک فیلد از یک رشتهٔ WKT. ‏gisWkt نام مستعار است.

انواع هندسهٔ WKT پشتیبانی‌شده شامل نقطه‌ها، خط‌ها، چندضلعی‌ها و گونه‌های چندگانهٔ آن‌هاست:

e.gis("location", "POINT(%f %f)".formatted(lon, lat));
e.gis("area_1",   "POLYGON((%f %f, %f %f, %f %f, %f %f, %f %f))"
                  .formatted(lon, lat, lon2, lat, lon2, lat2, lon, lat2, lon, lat));
e.gis("path",     "LINESTRING(%f %f, %f %f, %f %f)"
                  .formatted(lon, lat, lon2, lat2, lon3, lat3));

کنترل دسترسی

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

باز کردن نوع مشخصی از دسترسی (برای نمونه «list») بدون اعطای همه‌چیز.

ذخیره و پیوند

ذخیره، حذف و مرتبط‌کردن موجودیت‌ها از طریق data$ انجام می‌شود (بخش اشیای سیستمی را ببینید). یک موجودیت یک delete سهل‌الوصول هم در اختیار می‌گذارد.

data$.persist(subCat);
data$.link(subCat, model, "IN_PARENT_CATEGORY");

PSEntityQuery

یک پرس‌وجوی خواندنی روی یک کلاس پایه بسازید و بندهای select (چه چیزی برگردد)، بندهای filter (کدام سطرها) و بندهای پیمایش (دنبال‌کردن روابط) را زنجیر کنید. پرس‌وجوی آماده را به data$.query() بدهید.

var q = PSEntityQuery("com.domain.commerce.Order")
            .selectId()
            .selectVal("total")
            .filterVal("currency", "equals", "USD")
            .filterVal("total", "greater_than", 100);

var rows = data$.query(q);

بندهای انتخاب

بندهای فیلتر

پیمایش

عملگرهای فیلتر

عملگر مقایسه در یک فیلتر به‌صورت یک رشته داده می‌شود: