مرشحات المستخدم

تشمل مناطق مستكشف البيات إمكانية تحديد مرشحات المستخدم لإتاحة إمكانية إدخال بيانات لتقييد الصفوف و/أو الأعمدة التي يتم عرضها في المنطقة. ويمكن تحديد المرشحات بشكل فردي باستخدام معلمات مرشح المستخدم 1–25. بدلاً من ذلك، يمكن تحديد مخطط واجهة مستخدم لتسجيل المرشحات. في هذه الحالة، يجب ربط حقول مدخلات المخطط بمرشحات المنطقة عن طريق تحديد رمز الاختصار xpath= في معلمات مرشح المستخدم ذات الصلة.

تنطبق هذه المعلمات على أنواع المناطق

  • مستكشف بيانات - عبارات SQL متعددة (F1–DE)

  • مستكشف بيانات استعلام - عبارات SQL متعددة (F1–DE-QUERY)

  • معلومات مستكشف بيانات - عبارة SQL فردية (F1–DE-SINGLE)

ويتم تحديد مرشح المستخدم باستخدام رموز الاختصار التالية:

رمز الاختصار

الوصف

القيم الصالحة

تعليقات

name=

يتم استخدام رمز الاختصار إذا كان يجب ملء مرشح المنطقة مسبقًا بقيمة من السياق العام أو سياق البوابة أو النقل من منطقة أخرى.

اسم حقل MD

datasource=

يتم من خلال رمز الاختصار تحديد مصدر القيمة التي تم ملؤها مسبقًا للمرشح المحدد في رمز اختصار الاسم.

في حالة ترك رمز الاختصار هذا فارغًا، يفترض ما يلي:

- إذا تم نقل الحقل من نطاق آخر، تُستخدم قيمة النقل.

- إذا لم يتم نقل أي قيمة، يتم التحقق من سياق البوابة لتحديد ما إذا كان هذا الحقل موجودًا (في حالة وجوده، تؤخذ قيمته).

- في حالة استمرار عدم وجود قيمة، يتم التحقق من السياق العام.

- في حالة استمرار عدم وجود قيمة، لا تظهر قيمة افتراضية.

G

للإشارة إلى أنه يجب أن يتم من خلال المنطقة البحث عن قيمة المرشح في السياق العام.

P

للإشارة إلى أنه يجب أن يتم من خلال المنطقة البحث عن قيمة المرشح في سياق البوابة.

D

للإشارة إلى أنه يجب أن يتم من خلال المنطقة البحث عن قيمة المرشح في نموذج بيانات الصفحة.

type=

لتحديد البيان المرئي المستخدم في تسجيل قيم المرشحات.

DATE

تقوم المرشحات من هذا النوع بتسجيل تاريخ.

DATE/TIME

تقوم المرشحات من هذا النوع بتسجيل تاريخ ووقت.

STRING

تقوم المرشحات من هذا النوع بتسجيل سلسلة

MONEY

تقوم المرشحات من هذا النوع بتسجيل حقل نقدي. يجب أن يشير نوع المرشح هذا أيضًا إلى رمز اختصار العملة.

NUMBER

تقوم المرشحات من هذا النوع بتسجيل حقل رقمي. يمكن أن يشير نوع المرشح هذا أيضًا إلى رمز اختصار القيم العشرية.

LOOKUP

تقوم المرشحات من هذا النوع بتسجيل قيمة بحث. يجب أن يشير نوع المرشح هذا أيضًا إلى رمز اختصار البحث.

TABLE

يتم من خلال المرشحات من هذا النوع تسجيل قيمة جدول إشرافي (الرمز والوصف). يجب أن يشير نوع المرشح هذا أيضًا إلى رمز اختصار الجدول.

CHARTYPE

تقوم المرشحات من هذا النوع بتسجيل قيم خاصية محدد مسبقًا لنوع خاصية (الرمز والوصف). يجب أن يشير نوع المرشح هذا أيضًا إلى رمز اختصار الخاصية.

ASIS

تقوم المرشحات من هذا النوع بتسجيل قائمة بالقيم المطلوب الإشارة إليها في عبارة 'IN' بجملة SQL.

label=

يحدد تسمية المرشح التي يتم عرضها في شريط وصف المنطقة وفي منطقة المدخلات.

اسم حقل MD

أدخل اسم حقل صالحًا يجب استخدام تسميته لتسمية المرشح. يجب أن يكون هذا دائمًا هو الخيار المستخدم في حالة الحاجة إلى لغات متعددة.

'text'

يحدد النص مباشرة.

cur=

يحدد رمز العملة الذي يتم تطبيقه عندما يكون type=MONEY.

رمز العملة

أدخل مرجعًا لرمز عملة صالح.

dec=

يحدد عدد الخانات العشرية في حالة type=NUMBER.

رقم صالح

هذا الرمز اختياري. في حالة إدخاله، يجب أن يكون عددًا صحيحًا. وفي حالة عدم إدخاله، تكون القيمة الافتراضية هي عدد الخانات العشرية المحددة في رمز العملة برمز العملة المحدد في سجل التثبيت.

lookup=

يحدد إشارة البحث التي تظهر القيم الخاصة بها عندما يكون type=LOOKUP.

اسم حقل البحث

أدخل مرجعًا لاسم حقل بحث صالح.

table=

يحدد الجدول الإشراف الذي تظهر القيم الخاصة به عندما يكون type=TABLE.

اسم الجدول

أدخل مرجعًا إلى اسم جدول تحكم صالح.

chartype=

يحدد رمز نوع الخاصية الذي تظهر القيم الخاصة به عندما يكون type=CHARTYPE.

رمز نوع الخاصية

أدخل مرجعًا لرمز نوع خاصية صالح.

xpath=

يُستخدم رمز الاختصار هذا في الربط مع مخطط واجهة المستخدم لمنطقة الترشيح. بالنسبة لكل مرشح، يجب تحديد المسار X لعنصر مخطط خريطة واجهة المستخدم المقابلة.

المسار X

يجب أن يكون type= mnemonic ملائمًا أيضًا لحقل مدخلات المخطط، وإلا فقد تفشل عبارة SQL الخاصة بالاستعلام.

likeable=

يحدد رمز الاختصار هذا ما إذا كان هناك بحث يُفضل إجراؤه على القيمة المدخلة، عندما يكون type=STRING.

S

سيضيف الاستعلام % للاحقة قيمة المرشح.

P

سيضيف الاستعلام % لبادئة قيمة المرشح.

PS

سيضيف الاستعلام % لبادئة ولاحقة قيمة المرشح.

divide=

يتحكم رمز الاختصار في ظهور السطر المقسم أعلى و/أو أسفل المرشح.

ملاحظة، يمكن تحديد هذه المعلمة مرتين إذا أردت وضع سطور المقسم أعلى وأسفل أي مرشح، كمثال divide=above divide=below.

أعلى من

يؤدي ذلك إلى وضع سطر مقسم أعلى المرشح.

أقل من

يؤدي ذلك إلى وضع سطر مقسم أسفل المرشح.

searchField=

يتحكم رمز الاختصار هذا في الملء الأولي للمرشح عند بدء المنطقة كأداة بحث من مخطط واجهة المستخدم.

اسم حقل MD

أدخل اسم الحقل الذي يوافق اسم searchField المحدد في عنصر HTML الذي يخص oraSearchField بشكل تام في مخطط واجهة المستخدم.

encrypt=

يحدد رمز الاختصار هذا ما إذا كان مرشح المستخدم بالقيمة مشفر ويحتاج إلى البحث عنه باستخدام قيمة المجزأة أم لا.

[TBL_​NAME؜FLD_​NAME؜WHERE_​FLD؜WHERE_​VALUE]

ملاحظة: يجب أن يكون اسم الحقل المشار إليه هنا هو القيمة المصدر للحقل. وبالرغم من ذلك، يجب أن تستخدم عبارة SQL القيمة المجزأة في المرشح الخاص بها.

يجب إدخال اسم جدول واسم حقل صالحين.

WHERE_​FLD وWHERE_​VALUE هما قيمتان اختياريتان. لكن في حالة إدخالهما، يجب إدخالهما معًا. استخدم هذا فقط لتشفير الحقل في حالة وجود حقل آخر له قيمة معينة. وفيما يلي أحد الأمثلة.

encrypt=[CI_​PERSON,PER_​ID_​NBR,ID_​TYPE_​NBR,'SSN']. يمكن أن تشير القيمة WHERE_​VALUE أيضًا إلى مرشح آخر. وفيما يلي أحد الأمثلة.

encrypt=[CI_​PERSON,PER_​ID_​NBR,ID_​TYPE_​NBR,F1].

أمثلة:

  • label=F1_​NBR_​DAYS type=NUMBER

  • label=F1_​SHOW_​ALL_​REQ_​FLG type=LOOKUP lookup=F1_​SHOW_​ALL_​REQ_​FLG

  • قيمة المرشح حيث مخطط واجهة المستخدم المحدد والوصف عبارة عن أحد المرشحات. type=STRING xpath=description likeable=S

    • type=STRING label=DESCR likeable=S divide=below

    • label=REQ_​TYPE_​CD type=TABLE table=F1_​REQ_​TYPE