دوال النماذج ومرشحات البحث

متى تستخدم هذه الدوال؟

هذه الدوال مدعومة في سياق تعبير النموذج العادي. وهي تكيّف النموذج ولا تمنح صلاحية ولا تحل محل التفويض على الخادم. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

طريقة الكتابة

استخدم الدالة بصيغة hasVerb("review"). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.

مرجع الدوال الكامل

`f._in`

بديل صريح لـ f.in يبني مرشح إدراج لقيمة ضمن قائمة. التوقيع: f._in(field, values) مثال:

getRecords("service_requests", f._in("status", ["received", "in_review"]))

التوافر: متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات. ملاحظة: استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

`f.adj`

يبني مرشحاً لمديين متجاورين دون تداخل. التوقيع: f.adj(field, range) مثال:

getRecords("service_requests", f.adj("service_period", ["2026-01-01", "2026-01-31"]))

`f.and`

يبني مرشح بحث مركباً لا يطابق إلا السجلات التي تحقق كل المرشحات الفرعية. مرره حصراً إلى getRecords. التوقيع: f.and(...filters) مثال:

getRecords("licenses", f.and(f.eq("status", "approved"), f.gte("score", 80)))

`f.cd`

يبني مرشح احتواء الحقل ضمن مجموعة القيم المعطاة. التوقيع: f.cd(field, values) مثال:

getRecords("service_requests", f.cd("tags", ["priority", "inspection", "public"]))

`f.cs`

يبني مرشح احتواء لكل القيم داخل حقل قائمة. التوقيع: f.cs(field, values) مثال:

getRecords("service_requests", f.cs("tags", ["priority", "inspection"]))

`f.eq`

يبني مرشح مساواة لحقل وسجل قيمة محددة. التوقيع: f.eq(field, value) مثال:

getRecords("licenses", f.eq("status", "approved"))

`f.fts`

يبني مرشح بحث نصي كامل. التوقيع: f.fts(field, query) مثال:

getRecords("service_requests", f.fts("description", "service counter"))

`f.gt`

يبني مرشحاً للقيم الأكبر من قيمة محددة. التوقيع: f.gt(field, value) مثال:

getRecords("service_requests", f.gt("requested_amount", 0))

`f.gte`

يبني مرشحاً للقيم الأكبر من أو المساوية لقيمة محددة. التوقيع: f.gte(field, value) مثال:

getRecords("service_requests", f.gte("score", 80))

`f.ilike`

يبني مرشح نمط غير حساس لحالة الأحرف. التوقيع: f.ilike(field, pattern) مثال:

getRecords("service_requests", f.ilike("title", "%inspection%"))

`f.imatch`

يبني مرشح مطابقة تعبير نمطي غير حساس لحالة الأحرف. التوقيع: f.imatch(field, pattern) مثال:

getRecords("service_requests", f.imatch("district", "^central$"))

`f.in`

يبني مرشح إدراج لقيمة ضمن قائمة. استخدم f._in إذا كان الاسم سيجعل التعبير المعقد أقل وضوحاً. التوقيع: f.in(field, values) مثال:

getRecords("service_requests", f.in("status", ["received", "in_review"]))

`f.is`

يبني مرشحاً على أسلوب قاعدة البيانات لقيمة null أو لحالة منطقية. التوقيع: f.is(field, value) مثال:

getRecords("service_requests", f.is("closed_at", null))

`f.isdistinct`

يبني مرشحاً يتطلب قيمة مميزة عن القيمة المعطاة. التوقيع: f.isdistinct(field, value) مثال:

getRecords("service_requests", f.isdistinct("owner_id", $.current_owner_id))

`f.like`

يبني مرشح نمط حساساً لحالة الأحرف. التوقيع: f.like(field, pattern) مثال:

getRecords("service_requests", f.like("reference", "CSR%"))

`f.lt`

يبني مرشحاً للقيم الأصغر من قيمة محددة. التوقيع: f.lt(field, value) مثال:

getRecords("service_requests", f.lt("days_open", 30))

`f.lte`

يبني مرشحاً للقيم الأصغر من أو المساوية لقيمة محددة. التوقيع: f.lte(field, value) مثال:

getRecords("service_requests", f.lte("attachments_count", 10))

`f.match`

يبني مرشح مطابقة تعبير نمطي حساساً لحالة الأحرف. التوقيع: f.match(field, pattern) مثال:

getRecords("licenses", f.match("code", "^LIC-[0-9]+$"))

`f.neq`

يبني مرشح عدم مساواة لحقل وسجل قيمة محددة. التوقيع: f.neq(field, value) مثال:

getRecords("licenses", f.neq("status", "cancelled"))

`f.nilike`

يبني مرشح نفي لنمط غير حساس لحالة الأحرف. التوقيع: f.nilike(field, pattern) مثال:

getRecords("service_requests", f.nilike("title", "%archived%"))

`f.nin`

يبني مرشحاً ينفي إدراج القيمة ضمن القائمة. التوقيع: f.nin(field, values) مثال:

getRecords("service_requests", f.nin("status", ["archived", "deleted"]))

`f.nis`

يبني صيغة النفي للمرشح f.is. التوقيع: f.nis(field, value) مثال:

getRecords("service_requests", f.nis("closed_at", null))

`f.nisdistinct`

يبني مرشحاً ينفي شرط القيمة المميزة. التوقيع: f.nisdistinct(field, value) مثال:

getRecords("service_requests", f.nisdistinct("owner_id", $.current_owner_id))

`f.nlike`

يبني مرشح نفي لنمط حساس لحالة الأحرف. التوقيع: f.nlike(field, pattern) مثال:

getRecords("service_requests", f.nlike("reference", "TEST%"))

`f.nxl`

يبني مرشحاً لمدى لا يمتد إلى يسار المدى المعطى. التوقيع: f.nxl(field, range) مثال:

getRecords("service_requests", f.nxl("service_period", ["2026-01-01", "2026-01-31"]))

`f.nxr`

يبني مرشحاً لمدى لا يمتد إلى يمين المدى المعطى. التوقيع: f.nxr(field, range) مثال:

getRecords("service_requests", f.nxr("service_period", ["2026-01-01", "2026-01-31"]))

`f.or`

يبني مرشح بحث مركباً يطابق السجل عند تحقق أي مرشح فرعي. مرره حصراً إلى getRecords. التوقيع: f.or(...filters) مثال:

getRecords("service_requests", f.or(f.eq("priority", "high"), f.eq("priority", "urgent")))

`f.ov`

يبني مرشح تداخل لمجال أو مجموعة قيم. التوقيع: f.ov(field, values) مثال:

getRecords("service_requests", f.ov("service_area", ["central", "north"]))

`f.ov_array`

يبني مرشح تداخل بين حقلي قوائم. التوقيع: f.ov_array(field, values) مثال:

getRecords("service_requests", f.ov_array("categories", ["roads", "lighting"]))

`f.phfts`

يبني مرشح بحث نصي كامل يطابق عبارة متصلة. التوقيع: f.phfts(field, query) مثال:

getRecords("service_requests", f.phfts("description", "street light"))

`f.plfts`

يبني مرشح بحث نصي كامل بصيغة عبارة عادية. التوقيع: f.plfts(field, query) مثال:

getRecords("service_requests", f.plfts("description", "road repair"))

`f.sl`

يبني مرشحاً لمدى يقع بالكامل إلى يسار المدى المعطى. التوقيع: f.sl(field, range) مثال:

getRecords("service_requests", f.sl("service_period", ["2026-02-01", "2026-02-28"]))

`f.sr`

يبني مرشحاً لمدى يقع بالكامل إلى يمين المدى المعطى. التوقيع: f.sr(field, range) مثال:

getRecords("service_requests", f.sr("service_period", ["2026-01-01", "2026-01-31"]))

`f.wfts`

يبني مرشح بحث نصي كامل بصيغة الويب، بما فيها عوامل البحث المدعومة. التوقيع: f.wfts(field, query) مثال:

getRecords("service_requests", f.wfts("description", "lighting OR roads"))

`getRecord`

يبحث عن سجل واحد لتعبير نموذج. قد ينتج عن غياب العميل أو مهلة البحث قيمة فارغة أو شبيهة بـ null؛ لا تستخدمه لإثبات الصلاحية. التوقيع: getRecord(qualifiedRecordId) مثال:

getRecord("licenses:license-42")

`getRecords`

يبحث عن سجلات لتعبير نموذج باستخدام مرشح مبني بـ f.*. لا تعرض نتائج البحث في مخرج عام ما لم يراجع مالك الخدمة نطاق البيانات. التوقيع: getRecords(entityKey, filters) مثال:

getRecords("licenses", f.eq("status", "approved"))

`hasAnyScope`

يتحقق من احتواء جلسة النموذج الحالية على أي نطاق من قائمة النطاقات المعطاة. التوقيع: hasAnyScope(scopes) مثال:

hasAnyScope(["central-service-centre", "north-service-centre"])

`hasScope`

يتحقق من احتواء جلسة النموذج الحالية على نطاق واحد بالاسم المعطى. التوقيع: hasScope(scope) مثال:

hasScope("central-service-centre")

`hasVerb`

يتحقق من أفعال جلسة النموذج للعضو الحالي. تعيد المعالجة على الخادم true، لذلك لا تمثل وسيلة تفويض من جهة الخادم. التوقيع: hasVerb(verb) مثال:

hasVerb("review")

`hasVerbOnRecord`

يتحقق من الفعل الممنوح لعضو النموذج الحالي على سجل مؤهل ونطاقاته. استخدمه لتكييف تجربة النموذج فقط، وليس لفرض التفويض. التوقيع: hasVerbOnRecord(verb, qualifiedRecordId) مثال:

hasVerbOnRecord("update", $.license_id)

`isWeekday`

يتحقق مما إذا كان التاريخ يوم عمل، مع استخدام بيانات الوردية الاختيارية نفسها والرجوع إلى السبت والأحد عند غيابها. التوقيع: isWeekday(date, entityId?) مثال:

isWeekday($.appointment_date, $.assigned_position_id)

`isWeekend`

يتحقق مما إذا كان التاريخ غير يوم عمل للكيان المرتبط بالوردية اختيارياً. عند غياب بيانات الوردية، يرجع إلى السبت والأحد. التوقيع: isWeekend(date, entityId?) مثال:

isWeekend($.appointment_date, $.assigned_position_id)

قائمة تحقق قبل النشر

ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.

​متى تستخدم هذه الدوال؟

​طريقة الكتابة

​مرجع الدوال الكامل

​f._in

​f.adj

​f.and

​f.cd

​f.cs

​f.eq

​f.fts

​f.gt

​f.gte

​f.ilike

​f.imatch

​f.in

​f.is

​f.isdistinct

​f.like

​f.lt

​f.lte

​f.match

​f.neq

​f.nilike

​f.nin

​f.nis

​f.nisdistinct

​f.nlike

​f.nxl

​f.nxr

​f.or

​f.ov

​f.ov_array

​f.phfts

​f.plfts

​f.sl

​f.sr

​f.wfts

​getRecord

​getRecords

​hasAnyScope

​hasScope

​hasVerb

​hasVerbOnRecord

​isWeekday

​isWeekend

​قائمة تحقق قبل النشر