دليل حقول وشاشات التهيئات والمراحل الأساسية (APEX Forms Guide)

هذا الدليل يعتبر مرجعاً لك أثناء بناء الشاشات في Oracle APEX (Interactive Reports + Modal Forms). لكل جدول تم تحديد مصدر الحقل، وهل يعتمد على جدول آخر (List of Values - LOV محقونة بـ SQL Query)، أو قائمة ثابتة (Static LOV).

[!TIP] قاعدة عامة لجميع الشاشات:

1. شاشة إعدادات النظام (SYS_SETTINGS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
COMPANY_ID Select List استعلام من جدول COMPANY
CURRENT_FISCAL_YEAR_ID Select List / Popup LOV استعلام (Dynamic LOV) من جدول FISCAL_YEARS
DEFAULT_CURRENCY_ID Select List استعلام من جدول CURRENCY
TAX_ENABLED Switch Static LOV: 1 (مُفعل), 0 (غير مُفعل)
DEFAULT_TAX_CODE_ID Select List استعلام من جدول TAX_CODES
INVENTORY_METHOD Select List Static LOV: FIFO, WEIGHTED_AVG, LIFO
COST_UPDATE_METHOD Select List Static LOV: AUTO (آلي), MANUAL (يدوي)
AUTO_POSTING Switch Static LOV: 1 (ترحيل آلي للقيود), 0 (لا)
PRICE_INCLUDES_TAX Switch Static LOV: 1 (السعر شامل الضريبة), 0 (غير شامل)
AUTO_PRICE_UPDATE Switch Static LOV: 1 (تحديث التكلفة آلياً), 0 (إيقاف)

2. شاشة السنوات المالية (FISCAL_YEARS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
YEAR_NAME Text Field نص، مثال: 2025 أو 2025-2026
START_DATE Date Picker تاريخ (بداية السنة)
END_DATE Date Picker تاريخ (نهاية السنة)
IS_CLOSED Switch Static LOV: 1 (مغلقة), 0 (مفتوحة) - الافتراضي 0
CLOSED_BY Text Field (Read-only) يتم تعبئته برمجياً عند الإغلاق (:APP_USER)
CLOSED_DATE Date Picker (Read-only) يتم تعبئته برمجياً عند الإغلاق (SYSDATE)

3. شاشة الفترات المالية (FISCAL_PERIODS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
FISCAL_YEAR_ID Select List استعلام من جدول FISCAL_YEARS
PERIOD_NAME Text Field نص، مثال: شهر يناير 2025
START_DATE Date Picker تاريخ بداية الفترة
END_DATE Date Picker تاريخ نهاية الفترة
IS_CLOSED Switch Static LOV: 1 (مغلقة), 0 (مفتوحة) - الافتراضي 0

4. شاشة أسعار الصرف (CURRENCY_RATES)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
CURRENCY_ID Select List استعلام من CURRENCY (العملات الأجنبية فقط)
BASE_CURRENCY_ID Select List استعلام من CURRENCY (حيث العملة الأساسية)
RATE_DATE Date Picker تاريخ التسعيرة
BUY_RATE Number Field رقم (يدعم منازل عشرية)
SELL_RATE Number Field رقم (يدعم منازل عشرية)
AVG_RATE Number Field رقم (غالبا يُحسب آلياً: (البيع+الشراء)/2)
SOURCE Select List Static LOV: MANUAL (يدوي), API (جلب آلي), BANK (بنك)
NOTES Textarea نص إضافي

5. أكواد الضرائب (TAX_CODES)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
CODE Text Field نص، مثال: VAT15 أو EXEMPT
NAME Text Field نص، مثال: ضريبة القيمة المضافة 15%
TAX_TYPE Select List Static LOV: VAT, SALES_TAX, WITHHOLDING
RATE Number Field نسبة، مثال 15 أو 0
IS_COMPOUND Switch Static LOV: 1 (نسبة مركبة فوق غيرها), 0 (لا)
IS_INCLUSIVE Switch Static LOV: 1 (متضمنة في السعر), 0 (تُضاف)
ACCOUNT_ID Popup LOV استعلام من جدول الدليل المحاسبي CHART_OF_ACCOUNTS
IS_DEFAULT Switch Static LOV: 1 (تطبق كافتراضي), 0 (لا)
EFFECTIVE_FROM Date Picker تاريخ بداية تطبيق الضريبة
EFFECTIVE_TO Date Picker تاريخ انتهائها (يمكن أن يكون فارغاً Null)

6. قواعد الضرائب الإقليمية (TAX_REGION_RULES)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
COUNTRY_ID Select List استعلام من COUNTRIES (يقبل Null أي أن القاعدة لكل الدول)
CITY_ID Cascading LOV استعلام من CITIES يتبّع الـ Country
AREA_ID Cascading LOV استعلام من AREAS يتبّع الـ City
TAX_CODE_ID Select List استعلام من TAX_CODES
APPLIES_TO Select List Static LOV: SALES (مبيعات), PURCHASES (مشتريات), BOTH (الكل)
ITEM_CATEGORY_ID Select List استعلام من ITEM_CATEGORIES (Null تعني جميع التصنيفات)
PRIORITY Number Field الأولوية كرقم، مثال 1 (تُنفذ أولاً)
EFFECTIVE_FROM Date Picker تاريخ
EFFECTIVE_TO Date Picker تاريخ
NOTES Textarea نص (اختياري)

7. شاشة الإعفاءات الضريبية (TAX_EXEMPTIONS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
PARTNER_TYPE Select List Static LOV: CUSTOMER (عميل), SUPPLIER (مورد)
PARTNER_ID Popup LOV استعلام ديناميكي أو Dynamic LOV: إذا اختار CUSTOMER يعرض من جدول CUSTOMERS والعكس للموردين.
TAX_CODE_ID Select List استعلام من TAX_CODES (مثلا اختيار كود صفر أو معفي)
EXEMPTION_NO Text Field رقم شهادة الإعفاء
EFFECTIVE_FROM Date Picker بداية الشهادة
EFFECTIVE_TO Date Picker نهاية الشهادة
DOCUMENT_BLOB File Release / Upload لرفع صورة الشهادة كـ BLOB
MIME_TYPE Hidden لحفظ نوع الملف بصيغة كود
NOTES Textarea أي ملاحظات على الإعفاء

8. شاشة قواعد التسعير التلقائي (PRICE_AUTO_RULES)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
RULE_NAME Text Field اسم القاعدة، مثال: ربح 15٪ لتصنيف الخضار
SCOPE Select Group Static LOV: SYSTEM (تطبق على النظام بالكامل), CATEGORY (تصنيف محدد), ITEM (صنف محدد)
ITEM_ID Popup LOV استعلام من جدول ITEMS
CATEGORY_ID Select List استعلام من ITEM_CATEGORIES
PROFIT_TYPE Select List Static LOV: PERCENTAGE (نسبة مئوية), FIXED_AMOUNT (مبلغ ثابت)
PROFIT_VALUE Number Field قيمة الربح. (مثلاً: 15)
RULE_BASED_ON Select List Static LOV: AVG_COST (على التكلفة المرجحة), LAST_COST (على آخر تكلفة)
MIN_MARGIN_PCT Number Field مثال: 5 كحد أدنى
MAX_MARGIN_PCT Number Field مثال: 100 كحد أقصى
ROUND_TO Select List Static LOV: 0.01, 0.05, 0.25, 0.50, 1
IS_ACTIVE Switch Static LOV: 1 (فعّال), 0 (غير فعّال)
PRIORITY Number Field الرقم يعبر عن الأولوية
NEEDS_APPROVAL Switch Static LOV: 1 (يحتاج موافقة), 0 (لا يحتاج)

9. شاشة الموردين (SUPPLIERS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
CODE Text Field كود المورد (مثال: V-001)
NAME Text Field اسم المورد
CONTACT_PERSON Text Field الشخص المسؤول للتواصل
COUNTRY_ID Select List استعلام من جدول COUNTRIES
CITY_ID Cascading LOV استعلام من جدول CITIES (يتبع الدولة)
AREA_ID Cascading LOV استعلام من جدول AREAS (يتبع المدينة)
CURRENCY_ID Select List استعلام من CURRENCY العملة الافتراضية للتعامل
PAYMENT_TERMS Number Field أيام السداد (مثال: 30 يوم)
CREDIT_LIMIT Number Field الحد الائتماني للمديونية
ACCOUNT_ID Popup LOV استعلام من الدليل المحاسبي CHART_OF_ACCOUNTS
OPENING_BALANCE Number Field الرصيد الافتتاحي له
BALANCE_DATE Date Picker تاريخ الرصيد الافتتاحي

10. شاشة العملاء (CUSTOMERS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
نفس الحقول... Text Field نفس الهيكل الخاص بالموردين
PRICE_LIST_ID Select List استعلام من PRICE_LISTS (لتحديد قائمة الأسعار الخاصة بالعميل)
SALESPERSON_ID Select List مندوب المبيعات المرتبط بالعميل من جدول EMPLOYEES

11. المستودعات (WAREHOUSES) ومواقع التخزين (WAREHOUSE_LOCATIONS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
(في المستودع WAREHOUSES)
CODE / NAME Text Field كود واسم المستودع
MANAGER_ID Select List استعلام من الموظفين EMPLOYEES
(في الديتيلز WAREHOUSE_LOCATIONS)
WAREHOUSE_ID Hidden / Select List يُحفظ آلياً بمعرف الماستر (المستودع الأب)
LOCATION_CODE Text Field مثلاً: (A1-02-C)
AISLE / RACK / SHELF Text Field لتحديد الرف والممر بشكل دقيق

12. حركات وتسويات المخزون (STOCK_ADJUSTMENTS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
ADJUSTMENT_NO Text Field (Read-only) مسلسل تلقائي للتسوية الجردية
WAREHOUSE_ID Select List استعلام من المستودعات WAREHOUSES
ADJUSTMENT_TYPE Select List Static LOV: INCREASE (تعلية), DECREASE (خفض), COUNT (جرد شامل)
STATUS Select List / Display Static LOV: DRAFT (مسودة), APPROVED (معتمد)
(في الديتيلز STOCK_ADJUSTMENT_LINES)
ITEM_ID Popup LOV استعلام من ITEMS الأصناف
SYSTEM_QTY Number (Read Only) الكمية التي كانت في النظام قبل الجرد
ACTUAL_QTY Number Field الكمية الفعلية بعد الجرد للمخزون
DIFF_QTY Number (Computed) الحساب الآلي (الفعلية - النظامية)

13. التحويل المخزني (STOCK_TRANSFERS)

اسم الحقل في الجدول نوع العنصر في APEX مصدر البيانات / القيم المسموحة (LOV)
TRANSFER_NO Text Field مسلسل سند التحويل
FROM_WAREHOUSE_ID Select List استعلام من المستودعات WAREHOUSES (المصدر)
TO_WAREHOUSE_ID Select List استعلام من المستودعات WAREHOUSES (الفرع/الوجهة)
STATUS Select List Static LOV: DRAFT (مسودة), IN_TRANSIT (في الطريق), RECEIVED (مستلمة)
(في الديتيلز STOCK_TRANSFER_LINES)
ITEM_ID Popup LOV استعلام الصنف
QTY Number Field الكمية المحولة
RECEIVED_QTY Number Field الكمية المستلمة (تُسجل لاحقاً عند استلام الشحنة وتعتمد)