دالات وسمات مخطط واجهة المستخدم

ملاحظة: يشير مصطلح "الحقل" في هذا الموضوع إلى كل من المفهوم العام لعرض البيانات وتسجيلها في "حقل" ما وأيضًا إلى كائن بيانات التعريف المتوفر في المنتج لتحديد الحقول. عند الإشارة إلى الأخير، يتم استخدام مصطلح "حقل MD" (حقل بيانات التعريف) ويتم إدخال ارتباط تشعبي لتوثيق الحقل.

المحتويات

ربط مستند XML بمستند HTML

إنشاء قائمة منسدلة

تنسيق حقول المدخلات والمخرجات

عرض التسميات

تعليمات تمكين مخطط واجهة المستخدم

البحث باستخدام منطقة مستكشف منبثق

عرض الأخطاء

إطلاق JavaScript لأحداث المستعرض

إخفاء العناصر

استدعاء الخدمات المستندة إلى المخطط

تجديد مخطط معروض أو صفحة بوابة

تضمين تنقل إطار العمل

تشغيل سكريبت مساعد عمليات الأعمال

الخروج من مخطط واجهة مستخدم مع قيم الحد

تضمين مقطع مخطط

تضمين مكون ويب

إظهار المخطط الافتراضي عند الإضافة

تكوين رسم بياني

تحميل وتنزيل ملف قيم مفصولة بفواصل

إنشاء مقاطع مخطط منطقة البوابة

مكتبات JavaScript المطلوبة

اكتشاف التغييرات غير المحفوظة

إخفاء علامات تبويب البوابة

ربط مستند XML بمستند HTML

ليس مطلوبًا سوى سمتين مختلفتين لربط مستند XML لمخطط واجهة المستخدم بمستند HTML الخاص به. تتطلب هاتين السمتين مستند XML مضمن داخل HTML، حيث يكون XML مربوطًا بواسطة عُقد <xml>.

تحذير: يجب تضمين علامتي <xml></xml> في مستند HTML الخاص بك حتى يتم إجراء الربط.

ربط حقل


الصياغة	القيم	الوصف
oraField=" "	المسار X لعنصر الحقل	يتم استخدام هذه السمة لربط عنصر HTML مباشرة بعنصر XML، حيث يتم تحديد عنصر XML في مخطط XML لمخطط واجهة المستخدم. يتم استخدام السمة مع أي عرض لعنصر HTML، مثل: <span> و<div> و<input>.

HTML لعنصر الإدخال:


<html>
<body>
<table>
   <tr>
      <td>Address:</td>
      <td><input type="text" oraField="address"/></td>
   </tr>
   <tr>
      <td>City:</td>
      <td><input type="text" oraField="city"/></td>
   </tr>
   <tr>
      <td>State:</td>
      <td><input type="text" oraField="state"/></td>
   </tr>
   <tr>
      <td>Zip:</td>
      <td><input type="text" oraField="zip"/></td>
   </tr>
</table>
</body>
<xml>
   <root>
      <address>123 Main St</address>
      <city>Alameda</city>
      <state>CA</state>
      <zip>94770</zip>
   </root>
</xml>
</html>

HTML المعروض

HTML لعناصر div وspan.


<html>
<body>
 
<div oraField="address"></div>
<span oraField="city"></span>
<span>,</span>
<span oraField="state"></span>
<span oraField="zip"></span>
<span oraField="country"></span>
 
</body>
<xml>
   <root>
      <address>123 Main St</address>
      <city>Alameda</city>
      <state>CA</state>
      <zip>94770</zip>
   </root>
</xml>
</html>

HTML المعروض:

ربط قائمة

يتم استخدام هذه السمة لربط جدول HTML بقائمة XML، حيث يتم تحديد قائمة XML في مخطط XML لمخطط واجهة المستخدم. الغرض من العنصر هو تحفيز إطار العمل لإجراء نسخ متماثل لأجل HTML للجدول لكل عملية حدوث للقائمة.


الصياغة	القيم	الوصف
oraList=" "	المسارX لعنصر القائمة	يتم استخدام هذه السمة لربط جدول HTML بقائمة XML، حيث يتم تحديد قائمة XML في مخطط XML لمخطط واجهة المستخدم. الغرض من العنصر هو تحفيز إطار العمل لإجراء نسخ متماثل لأجل HTML للجدول لكل عملية حدوث للقائمة.

ملاحظة: يجب أن تحتوي سمات oraField المضمنة في القائمة على مسار X للتنقل مرتبط بالقائمة. راجع المثال المذكور أدناه.

<html>
<head><title>Bind xml list element</title></head>
<body>
<table oraList="payment">
   <thead>
      <tr>
         <th><span>Pay Date</span></th>
         <th><span>Amount</span></th>
        </tr>
        <tr/>
    </thead>
    <tr>
      <td>
         <span oraField="date" oraType="date"></span>
      </td>
      <td align="right">
         <span oraField="amount" oraType="money"></span>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
    <payment>
        <date>2008-01-01</date>
        <amount>44.28</amount>
    </payment>
    <payment>
        <date>2008-02-01</date>
        <amount>32.87</amount>
    </payment>
    <payment>
        <date>2008-03-01</date>
        <amount>21.76</amount>
    </payment>
</root>
</xml>
</html>

HTML المعروض:

إنشاء قائمة منسدلة

يتم توفير السمات التالية لإنشاء عنصر "select" بتنسيق HTML، ويُسمى أيضًا قائمة منسدلة، في مصادر أخرى.


Source	الصياغة	القيم	الأمثلة
بحث	oraSelect="lookup: ;"	حقل البحث	`... <td>House Type:</td> <td> <select oraField="houseType" oraSelect="lookup:HOUSE_TYPE;"> </select> </td>`
بحث قابل للتوسيع	oraSelect="lookupBO: ;"	رمز كائن العمل	`... <td>UI Device Display Type:</td> <td> <select oraField="uiDeviceType" oraSelect="lookupBO: F1-DeviceDisplayTypes;"></select> </td>`
نوع الخاصية (محددة مسبقًا)	oraSelect="charType: ;"	رمز نوع الخاصية	`... <td>Usage:</td> <td> <select oraField="statusReasonUsage" oraSelect="charType:F1-SRUSG;"></select> </td> ...`
جدول التحكم	oraSelect="table: ;" ملاحظة: لا تعمل هذه السمة إلا مع الجداول التي تتبع بنية جدول التحكم القياسي، حيث يوجد جدول لغة يتضمن العمود DESCR كعمود الوصف الخاص به. استخدم قاموس بيانات "برنامج معاينة التطبيق" لتحديد الجداول التي تؤهل لهذه الوظيفة. تحذير: لا تعمل دالة oraSelect إلا في حالة عرض أقل من 500 قيمة.	اسم الجدول	`... <td>Currency: </td> <td> <select oraField="currency" oraSelect="table:CI_CURRENCY_CD;"> </select> </td> ...`
خدمة الصفحة	oraSelect="service: ;"	اسم خدمة الصفحة	`... <td>Country:</td> <td> <select oraField="country" oraSelect="service:CIPTCNTW;"> </select> </td> ...`
القائمة المضمنة	يُستخدم لإنشاء قائمة منسدلة للتحديد على أساس داخل قائمة في XML المخطط. oraSelect="valuePath: ;descPath: "	بعد valuePath، تتم الإشارة إلى المسار X للعنصر الذي يقوم بإيقاف القيم. بعد descPath، تتم الإشارة إلى المسار X للعنصر الذي يقوم بإيقاف الأوصاف.	<html> <body> <table summary="" border="0" cellpadding="1" cellspacing="1"> <tr> <td>Select: </td> <td><select oraSelect= "valuePath:list/value; descPath:list/desc" oraField="target"></select></td> </tr> </table> </body> <xml> <root> <target>10</target> <list> <value>10</value> <desc>Ten</desc> </list> <list> <value>20</value> <desc>Twenty</desc> </list> <list> <value>40</value> <desc>Forty</desc> </list> </root> </xml> </html>
سكريبت الخدمة	oraSelect="ss: ;"	رمز سكريبت الخدمة	راجع الصياغة الإضافية المطلوبة عند استخدام هذه الدالة المذكورة أدناه.
خدمة الأعمال	oraSelect="bs: ;"	رمز خدمة الأعمال	راجع الصياغة الإضافية المطلوبة عند استخدام هذه الدالة المذكورة أدناه.

عند تحديد سكريبت خدمة أو خدمة أعمال، يجب توفير معلومات ربط إضافية لتمرير البيانات من الخدمة وإليها.


الصياغة	القيم	الوصف
oraSelectIn=" ;"	serviceXPath:element;	تُستخدم لإدخال قيمة عنصر آخر إلى الخدمة (الربط مع المسار X للخدمة).
oraSelectIn=" ;"	serviceXPath:'Literal';	تُستخدم لإدخال أحد الثوابت أو قيمة حرفية إلى الخدمة (الربط مع المسار X للخدمة).
oraSelectOut="valuePath: ; descPath: "	راجع الأمثلة المذكورة أدناه	يُستخدم للإشارة إلى العناصر في مخرجات الخدمة التي تحتوي على القيم والعناصر التي تحتوي على الأوصاف.

إليك مثال يوضح استخدام خدمة أعمال:

...
<td>External System: </td>
<td>
   <select oraField="externalSystem" 
    oraSelect="bs:F1-RetrieveExternalSystems" 
    oraSelectIn="outboundMsgType:boGroup/parameters/outboundMsgType;" 
    oraSelectOut="valuePath:results/externalSystem; 
    descPath:results/description">
   </select>
</td>
...

عادةً يتم استخدام طريقة إنشاء القائمة المنسدلة هذه عند وجود تبعية بين العناصر وقائمة القيم الصالحة في قائمة منسدلة (للعنصر الفرعي) تستند إلى عنصر آخر في المخطط (العنصر الرئيسي). عندما يتغير العنصر الرئيسي، يمكن أن يكون تجديد العنصر الفرعي مطلوبًا. يمكن تنفيذ طريقة الأداء هذه باستخدام الدالة التي تم استدعاؤها في حدث onChange في المخطط. الصياغة هي oraHandleDependentElements('dependent element');. يمكن استدعاء عناصر هدف متعددة (تابعة).

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

...
<div>
   <label oraLabel="boGroup/parameters/outboundMsgType"></label>
      <span>
         <select oraSelect="table:F1_OUTMSG_TYPE"  
          oraField="boGroup/parameters/outboundMsgType"
          onChange="oraHandleDependentElements('boGroup/parameters/externalSystem');">
         </select>
      </span>
</div>
...

تنسيق حقول المدخلات والمخرجات

تم تصميم السمات التالية لتطبيق تنسيق نوع البيانات لحقول المدخلات والمخرجات.

التنسيق الآلي


الصياغة
oraSchemaDataTypes="false"

يتم استخدام هذه السمة الآلية لتحفيز التنسيق الآلي في مستند HTML المقدم. يتم إجراء التنسيق الآلي وفقًا لسمات نوع البيانات المحددة في مخطط واجهة المستخدم. لمزيد من التفاصيل حول تنسيق نوع بيانات محدد، الرجاء الرجوع إلى أوصاف سمة oraType أدناه.

تحذير: سيتم إدخال السمة oraSchemaDataTypes="true" آليًا في HTML الخاص بمخطط واجهة المستخدم! إذا كنت لا ترغب في تطبيق أنواع بيانات المخطط على HTML المعروض، يجب تحديد هذه السمة في عقدة النص بقيمة "خطأ". مطلوب تحديد السمة <body oraSchemaDataTypes="false"> لتجنب التنسيق الآلي!

مخطط واجهة المستخدم:

<schema>
    <schemaDate dataType="date"/> 
    <schemaDateTime dataType="dateTime"/> 
    <schemaFKRef fkRef="CI_USER"/> 
    <schemaLookup dataType="lookup" lookup="ACCESS_MODE"/> 
    <schemaMoney dataType="money"/> 
    <schemaNumber dataType="number"/> 
    <schemaTime dataType="time"/> 
</schema>

HTML لمخطط واجهة المستخدم:


<html>
<body oraSchemaDataTypes="true">
<table border="1" cellpadding="1" cellspacing="1">
   <tr><th>dataType</th><th>result type</th><th>input result</th><th> display-only result</th></tr>
   <tr>
      <td rowspan="2">date (from schema)</td>
      <td>raw</td>
      <td><input oraField="schemaDate" oraType="string" /></td>
      <td><span oraField="schemaDate" oraType="string"></span></td>
   </tr>
   <tr>
      <td>rendered</td>
      <td><input oraField="schemaDate"></td>
      <td><span oraField="schemaDate"></span></td>
   </tr>
 
   <tr>
      <td rowspan="2">dateTime (from schema)</td>
      <td>raw</td>
      <td><input oraField="schemaDateTime" oraType="string"></td>
      <td><span oraField="schemaDateTime" oraType="string"></span></td>
   </tr>
   <tr>
      <td>rendered</td>
      <td><input oraField="schemaDateTime"></td>
      <td><span oraField="schemaDateTime"></span></td>
   </tr>

   <tr>
      <td rowspan="2">fkRef (from schema)**</td>
      <td>raw</td>
      <td><input oraField="schemaFkRef" oraType="string"></td>
      <td><span oraField="schemaFkRef" oraType="string"></span></td>
   </tr>
   <tr>
      <td>rendered</td>
      <td><input oraField="schemaFkRef"></td>
      <td><span oraField="schemaFkRef"></span></td>
   </tr>
 
   <tr>
      <td rowspan="2">lookup (from schema)</td>
      <td>raw</td>
      <td><input oraField="schemaLookup" oraType="string"></td>
      <td><span oraField="schemaLookup" oraType="string"></span></td>
   </tr>
   <tr>
      <td>rendered</td>
      <td><input oraField="schemaLookup"></td>
      <td><span oraField="schemaLookup"></span></td>
   </tr>
   
   <tr>
      <td rowspan="2">money (from schema)</td>
      <td>raw</td>
      <td><input oraField="schemaMoney" oraType="string"></td>
      <td><span oraField="schemaMoney" oraType="string"></span></td>
   </tr>
   <tr>
      <td>rendered</td>
      <td><input oraField="schemaMoney"></td>
      <td><span oraField="schemaMoney"></span></td>
   </tr>
 
   <tr>
      <td rowspan="2">number (from schema)</td>
      <td>raw</td>
      <td><input oraField="schemaNumber" oraType="string"/></td>
      <td><span oraField="schemaNumber" oraType="string"></span></td>
   </tr>
   <tr>
      <td>rendered</td>
      <td><input oraField="schemaNumber"></td>
      <td><span oraField="schemaNumber"></span></td>
   </tr>
 
   <tr>
      <td rowspan="2">time (from schema)</td>
      <td>raw</td>
      <td><input oraField="schemaTime" oraType="string"></span></td>
      <td><span oraField="schemaTime" oraType="string"></span></td>
   </tr>
   <tr>
      <td>rendered</td>
      <td><input oraField="schemaTime"></td>
      <td><span oraField="schemaTime"></span></td>
   </tr>
 
</table>
 
</body>
<xml>
<root>
   <schemaDate>2007-11-02</schemaDate>
   <schemaDateTime>2007-11-02-23.45.00</schemaDateTime>
   <schemaFkRef>USD</schemaFkRef>
   <schemaLookup>A</schemaLookup>
   <schemaMoney>1000000</schemaMoney>
   <schemaNumber>5661976.11548</schemaNumber>
   <schemaTime>23.45.00</schemaTime>
</root>
</xml>
</html>

HTML المعروض.

تنسيق التاريخ

يتم استخدام هذه الدالة لعرض تاريخ ما وفقًا لملف بيانات العرض للمستخدم. بالنسبة لحقول المدخلات، يتم تنسيق البيانات بواسطة الإعداد عندما يخرج المستخدم من الحقل.


الصياغة
oraType="date"


<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Date: </td>
      <td><span oraField="date" oraType="date"></span></td>
   </tr>
   <tr>
      <td>Date: </td>
      <td><input oraField="date" oraType="date"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <date>2008-12-28</date>
</root>
</xml>
</html>

HTML المعروض.

تنسيق الوقت

يتم استخدام هذه الدالة لعرض وقت ما وفقًا لملف بيانات العرض للمستخدم. بالنسبة لحقول المدخلات، يتم تنسيق البيانات بواسطة الإعداد عندما يخرج المستخدم من الحقل.


الصياغة
oraType="time"

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Time: </td>
      <td><span oraField="time" oraType="time"></span></td>
   </tr>
   <tr>
      <td>Time: </td>
      <td><input oraField="time" oraType="time"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <time>00.28.54.389</time>
</root>
</xml>
</html>

HTML المعروض.

تنسيق الوقت والتاريخ

يتم استخدام هذه الدالة لعرض طابع زمني وفقًا لملف بيانات العرض للمستخدم. في حالة استخدام هذه الدالة لعنصر إدخال، يتم تقسيمها إلى جزأين، أحدهما لأجل التاريخ والآخر لأجل الوقت. اختياريًا، يمكن إيقاف الفترة الزمنية لعنصر الوقت والتاريخ باستخدام قيمة السمة 'time:suppress'.


الصياغة
oraType="dateTime; time:suppress"


<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Date time: </td>
      <td><span oraField="dateTime" oraType="dateTime"></span></td>
   </tr>
   <tr>
      <td>Date only: </td>
      <td><span oraField="dateTime" oraType="dateTime; time:suppress"></span></td>
   </tr>
   <tr>
      <td>Date time: </td>
      <td><input oraField="dateTime" oraType="dateTime"/></td>
   </tr>
   <tr>
      <td>Date only: </td>
      <td><input oraField="dateTime" oraType="dateTime; time:suppress"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>

HTML المعروض.

تنسيق التاريخ / الوقت بالوقت القياسي

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


الصياغة
oraType="dateTime; stdTime:true;"

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Date time: </td>
      <td><span oraField="dateTime" oraType="dateTime; stdTime:true;"></span></td>
   </tr>
   <tr>
      <td>Date time: </td>
      <td><input oraField="dateTime" oraType="dateTime; stdTime:true;"/></td>
   </tr>
</table>
</body> 
<xml>
<root>
   <dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>

HTML المعروض.

ملاحظة: يتم عرض تسمية المنطقة الزمنية لأن 1:28 قيمة مبهمة. قانونًا، يتكرر حدوث 1 نوفمبر 2009 1:28 صباحًا مرتين حيث تتم إزالة التوقيت الصيفي في 2:00 صباحًا. عند استخدام دالة stdTime، لا تظهر تسميات المنطقة الزمنية إلا عند الطلب لتوضيح التداخلات في الفترات الزمنية.

HTML المعروض لأجل اليوم التالي.

HTML المعروض لأجل oraType="dateTime; stdTime:true" في اليوم التالي

تنسيق الوقت والتاريخ مع مرجع المنطقة الزمنية


الصياغة	القيم الصالحة	الوصف
oraType="dateTime; stdTimeRef: ;"	الإشارة إلى مسار X بعد علامة النقطتين.	يتم استخدام هذه الدالة لعرض عنصر وقت / تاريخ وفقًا لجدول التوقيت الصيفي لمنطقة زمنية تمت الإشارة إلى المسار X الخاص بها. لاحظ أنه من المفترض تخزين الوقت المعالج بالتوقيت القياسي للمنطقة الزمنية المُشار إليها - وبذلك لا يتم إلا تنفيذ تحويل التوقيت الصيفي - وليس تحويل المنطقة الزمنية.
oraType="dateTime; displayRef: ;"	الإشارة إلى مسار X بعد علامة النقطتين.	تتشابه هذه الدالة مع دالة stdTimeRef، فيما عدا أن هذه الدالة سوف تقوم بتنفيذ تحويل المنطقة الزمنية بالإضافة إلى تحويل التوقيت الصيفي. ليتم استخدام displayRef بشكل صحيح، فقط قم بربطها بعناصر المنطقة الزمنية التي تم تخزينها في المنطقة الزمنية الأساسية.

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

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Date time: </td>
      <td><span oraField="dateTime" oraType="dateTime; stdTimeRef:timeZone;"></span></td>
   </tr>
   <tr>
      <td>Date time: </td>
      <td><input oraField="dateTime" oraType="dateTime; stdTimeRef:timeZone;"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <timeZone>US-EAST</timeZone>
   <dateTime>2009-11-01-00.28.54</dateTime>
</root>
</xml>
</html>

HTML المعروض.

ملاحظة: يتم دائمًا عرض تسمية المنطقة الزمنية لمنطقة زمنية مُشار إليها.

HTML المعروض لأجل اليوم التالي.

HTML المعروض لأجل oraType="dateTime; stdTimeRef:xpath" في اليوم التالي

تنسيق المدة


الصياغة
oraType="duration"

يتم استخدام هذه الدالة لعرض المدة الزمنية. بالنسبة لأي عنصر إدخال، يتم تحويل القيمة التي يدخلها المستخدم من دقائق إلى ساعة ودقائق حسب الحاجة. على سبيل المثال، يتم تحويل قيمة مدخلة '90' إلى '00:01:30' عند الخروج من حقل الإدخال.

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Duration: </td>
      <td><span oraField="duration" oraType="duration"></span></td>
   </tr>
   <tr>
      <td>Duration: </td>
      <td><input oraField="duration" oraType="duration"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <duration>90</duration>
</root>
</xml>
</html>

HTML المعروض.

تنسيق يوم في الشهر


الصياغة
oraType="dayInMonth"

يتم استخدام هذه الدالة لعرض قيمة يوم وشهر مترابطة.

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Day In Month: </td>
      <td><span oraField="dayMonth" oraType="dayInMonth"></span></td>
   </tr>
   <tr>
      <td>Day In Month: </td>
      <td><input oraField="dayMonth" oraType="dayInMonth"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <dayMonth>0228</dayMonth>
</root>
</xml>
</html>

HTML المعروض.

تنسيق شهر في السنة


الصياغة
oraType="monthInYear"

يتم استخدام هذه الدالة لعرض قيمة شهر وسنة مترابطة.

<html>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
      <td>Month In Year: </td>
      <td><span oraField="month" oraType="monthInYear"></span></td>
   </tr>
   <tr>
      <td>Month In Year: </td>
      <td><input oraField="month" oraType="monthInYear"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <month>200811</month>
</root>
</xml>
</html>

HTML المعروض.

تنسيق القيمة النقدية

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


الصياغة	الوصف
oraType="money: "	تحديد رمز عملة مباشرةً بعد علامة النقطتين.
oraType="money;currencyRef: "	الإشارة إلى مسار X (بعد علامة النقطتين) لعنصر يشير إلى رمز عملة.
oraType="money"	إذا لم يتم تحديد عملة أو مرجع عملة، يتم استخدام عملة التثبيت.

ملاحظة: يجب تحديد زوج من مراجع صحف الأنماط، cisEnabled وcisDisabled، في عنوان المخطط من أجل المحاذاة لليمين. تتحكم صحيفة الأنماط في طريقة عرض الحقل. إذا كنت ترغب في تغيير العرض، يجب تجاوز نمط oraMoney.

<html>
<head>
    <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
    <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Amount, currency specified:</td>
      <td><span oraType="money:EUR" oraField="totalAmt"></span></td>
   </tr>
   <tr>
      <td>Amount, default currency:</td>
      <td><span oraType="money" oraField="totalAmt"></span></td>
   </tr>
   <tr>
      <td>Amount, default input:</td>
      <td><input oraType="money" oraField="totalAmt"/></td>
   </tr>
   <tr>
      <td>Amount, currency reference:</td>
      <td><input oraType="money;currencyRef:cur" oraField="totalAmt"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <totalAmt>50500.09</totalAmt>
   <cur>EUR</cur>
</root>
</xml>
</html>

HTML المعروض

تنسيق الرقم

يتم استخدام هذه الدالة لعرض رقم أو للتحقق من قيمة مدخلات. بالنسبة لعناصر الإدخال، يقوم النظام بإظهار خطأ إذا تم إدخال قيمة غير رقمية.


الصياغة
oraType="number"

<html>
<head>
    <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
    <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Count:</td>
      <td><span oraType="number" oraField="count"></span></td>
   </tr>
   <tr>
      <td>Count, input:</td>
      <td><input oraType="number" oraField="count"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <count>989</count>
</root>
</xml>
</html>

HTML المعروض.

تنسيق مرجع المفتاح الخارجي

وفقًا للإعدادات الافتراضية، عندما يتم عرض عنصر بنوع oraType fkRef، يتم تمكين حقول بحث وتنقل وقائمة سياق وسلسلة معلومات (إذا تم تكوين مرجع المفتاح الخارجي وفقًا لذلك). يتم توفير صياغة لتتيح لك إيقاف أي من تلك الميزات اختياريًا.

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


الصياغة
oraType="fkRef:true\|false; info:true\|false; context:true\|false; navigation:true\|false; search:true\|false"

fkRef. يؤدي استخدام قيمة "true" إلى تمكين كل عمليات معالجة مرجع المفتاح الخارجي التالية. لتعطيل معالجة مرجع المفتاح الخارجي آليًا، استخدام قيمة "false".
المعلومات. يؤدي استخدام قيمة "true" إلى عرض سلسلة المعلومات في مخطط واجهة المستخدم، إن أمكن.
السياق. يؤدي استخدام قيمة "true" إلى عرض قائمة سياق تظهر قبل عنصر مرجع المفتاح الخارجي، إن أمكن.
التنقل. يؤدي استخدام قيمة "true" إلى عرض سلسلة المعلومات كارتباط تشعبي، إن أمكن. يؤدي النقر على الرابط التشعبي إلى التنقل إلى الصفحة الملائمة.
بحث. يؤدي استخدام قيمة "true" إلى عرض أيقونة بحث تقوم بإطلاق منطقة البحث إن أمكن.

ملاحظة: لا تكون وظيفة قائمة السياق وتنقل المفتاح الخارجي متاحة إلا لمخططات واجهة المستخدم المعروضة في منطقة بوابة. لا تدعم مخططات واجهة المستخدم المعروضة أثناء معالجة سكريبت مساعد عمليات الأعمال خيارات التنقل. لا تكون وظيفة البحث متاحة إلا لعناصر HTML للإدخال.

مخطط واجهة المستخدم:


<schema>
  <bo fkRef="F1-BOMO"/>
</schema>

HTML لمخطط واجهة المستخدم:


<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Business Object</td>
      <td><span oraField="bo" oraType="fkRef:true; info:true; context:true; navigation:true;"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
   <bo>F1-COUNTRY</bo>
</root>
</xml>
</html>

HTML المعروض.

تنسيق البحث

يتم استخدام هذه الدالة لعرض الوصف الخاص بقيمة بحث.


الصياغة	القيم الصالحة
oraType="lookup: "	اسم حقل البحث بعد علامة النقطتين.


<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Status:</td>
      <td><span oraField="status" oraType="lookup:BATCH_JOB_STAT_FLG"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
   <status>PD</status>
</root>
</xml>
</html>

HTML المعروض.

تنسيق البحث القابل للتوسيع

يتم استخدام هذه الدالة لعرض الوصف الخاص بقيمة بحث قابل للتوسيع.


الصياغة	القيم الصالحة
oraType="lookupBO: "	اسم رمز كائن العمل بعد علامة النقطتين.


<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Value:</td>
      <td><span oraField="status" oraType="lookupBO:F1-DeviceDisplayTypes"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
    <status>oraTablet</status>
</root>
</xml>
</html>

HTML المعروض.

تنسيق نوع الخاصية

يتم استخدام هذه الدالة لعرض الوصف الخاص بقيمة خاصية محددة مسبقًا.


الصياغة	القيم الصالحة
oraType="charType: "	رمز نوع الخاصية بعد علامة النقطتين.


<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
        <td>Skill:</td>
        <td><span oraType="charType:CM-SKILL" oraField="skill"></span></td>
    </tr>
</table>
</body>
<xml>
<root>
    <skill>10</skill>
</root>
</xml>
</html>

HTML المعروض.

تنسيق جدول التحكم

يتم استخدام هذه الدالة لعرض الوصف الخاص بجدول تحكم له جدول لغة مرتبط.


الصياغة	القيم الصالحة
oraType="table: "	رمز الجدول بعد علامة النقطتين.


<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Currency:</td>
      <td><span oraType="table:CI_CURRENCY_CD" oraField="curr"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
   <curr>USD</curr>
</root>
</xml>
</html>

HTML المعروض.

تنسيق إضافة / إزالة الشبكة


الصياغة	الوصف
oraType="addGridRow"	يتم استخدام الدالة addGridRow لإنشاء مربع حوار "إدراج صف" في مخطط واجهة المستخدم. يتم عرض صورة "إضافة". يؤدي نقر الصورة إلى إدراج صف جديد في الشبكة. وفقًا للإعدادات الافتراضية، إذا كانت القائمة فارغة، تتم إضافة صف شبكة فارغ آليًا. معنى ذلك أن يظهر للمستخدم دائمًا صف شبكة واحد على الأقل عند استخدام هذه السمة.
oraType="deleteGridRow"	يتم استخدام الدالة deleteGridRow لإنشاء مربع حوار "حذف صف" في مخطط واجهة المستخدم. يتم عرض صورة "حذف". يؤدي نقر الصورة إلى إزالة الصف المجاور من الشبكة.

ملاحظة: يجب تحديد سمتي الحذف والإضافة في عنصر <td> لأن مربعي الحوار الحذف والإضافة ذات صلة داخل الجدول فقط.

تحذير: تم تصميم هذه السمات لتعمل مع إجراء كائن العمل "استبدال" وليس "تحديث". لذلك، إذا كان المخطط يحتوي على شبكة، يجب استخدام إجراء كائن العمل "استبدال" لتحديث كائن العمل. لمزيد من المعلومات، ارجع إلى إجراء كائن العمل استبدال.

مثال:

<html>
<head>
<title>Demonstrate Grid Add and Grid Delete OraTypes</title>
    <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
    <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table oraList="listEntry">
   <thead>
      <tr>
         <th/>
         <th/>
         <th><span>Date</span></th>
         <th><span>Amount</span></th>
      </tr>
      <tr/>
   </thead>
   <tr>
      <td oraType="addGridRow"></td>
      <td oraType="deleteGridRow"></td>
      <td>
         <input oraField="date" oraType="date"></input>
      </td>
      <td align="right">
         <input oraField="amount" oraType="money"></input>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <listEntry>
      <date>2008-01-01</date>
      <amount>44.28</amount>
   </listEntry>
   <listEntry>
      <date>2008-02-01</date>
      <amount>32.87</amount>
   </listEntry>
   <listEntry>
      <date>2008-03-01</date>
      <amount>21.76</amount>
   </listEntry>
</root>
</xml>
</html>

HTML المعروض.

العناصر غير المنسقة

يتم استخدام هذه الدالة لعرض محتويات أحد العناصر الذي يحتوي على بيانات "أولية" (raw) كما هو محدد لعنصر المخطط الجاري عرضه.


الصياغة
oraType="raw"

مخطط واجهة المستخدم:


<schema>
    <rawStuff type="raw"/>
</schema>

HTML لمخطط واجهة المستخدم:


<html>
<head>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>Raw Stuff:</td>
      <td><span oraType="raw" oraField="rawStuff"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
   <rawStuff>
      <ele1>text in element 1</ele1>
      <group1>
         <ele2>text inside element 2, group 1</ele2>
         <ele3>text inside element 3, group 1</ele3>
      </group1>
   </rawStuff>
</root>
</xml>
</html>

HTML المعروض.

تنسيق السلسلة

يتم استخدام هذه الدالة لعرض محتويات أحد العناصر، مثل XML pretty-print (تحسين الطباعة)، عندما يحتوي العنصر على XML تم تجاوزه.


الصياغة
oraType="xmlString"

ملاحظة: ليس أمرًا مطلوبًا، لكن يتم تحديث pretty print (الطباعة المناسبة) التي تخص XML المعروض إذا قمت بتحديد زوج من مراجع صحف الأنماط، cisEnabled وcisDisabled، في عنوان المخطط.

مثال:

<html>
<head>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>XML Stuff:</td>
      <td><span oraType="xmlString" oraField="xmlStuff"></span></td>
      </tr>
</table>
</body>
<xml>
<root>
   <xmlStuff>
      <ele1>text in element 1</ele1>
      <group1>
         <ele2>text inside element 2, group 1</ele2>
         <ele3>text inside element 3, group 1</ele3>
      </group1>
   </xmlStuff>
</root>
</xml>
</html>

HTML المعروض.

HTML المعروض بدون oraType=”xmlString”

تنسيق HTML

يتم استخدام هذه الدالة لعرض محتويات أحد العناصر مثل HTML في مقابل النص العادي. يتم عرض عنصر محدد على أنه oraType="fkref" في شكل HTML.


الصياغة
oraType="html"

تحذير:

لتجنب تنفيذ عنصر HTML ضار، لا يتم دعم كل علامات HTML. يتم تحديد قائمة العلامات المدعومة في تعريف المحتوى المُدار F1-HTMLWhiteList.

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

إذا تم تكوين عنصر HTML في سكريبت، للحصول على مزيد من المعلومات، ارجع إلى صياغة تحرير البيانات. لتجاوز نص مكوَّن بلغة جافا، استخدم الواجهة البرمجية للتطبيق لجافا WebStringUtilities.asHTML.


<html>
<head>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table summary="" border="0" cellpadding="1" cellspacing="1">
   <tr>
   <td>Info :</td>
   <td><span oraType="html" oraField="info"></span></td>
   </tr>
</table>
</body>
<xml>
<root>
   <info><b>text in bold</b></info>
</root>
</xml>
</html>

HTML المعروض.

HTML المعروض بدون oraType="html"

عرض التسميات

اشتقاق تسمية من عنصر

يتم استخدام هذه السمة للحصول على تسمية حساسة للغة لعنصر HTML <span> أو <td> أو <input>.


الصياغة	القيم الصالحة
oraLabel=" "	المسارX لعنصر في مخطط واجهة المستخدم. يجب أن يشير العنصر إلى سمة mapField= أو mdField= أو label=.

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

ملاحظة: إذا كان المخطط يحتوي على عدة سمات، ستختار سمة oraLabel التسمية المطلوب عرضها طبقًا للهيكلية التالية: تتجاوز سمة التسمية سمة mdField، والتي بدورها تقوم بتجاوز سمة mapField.

مخطط واجهة المستخدم:

<schema>
   <user mapField="USER_ID"/> 
   <info type="group" mapXML="CLOB">
      <city label="Metro Area"/> 
      <age mdField="AGE_LBL"/>
   </info> 
</schema>

HTML:

<html>
<head><title oraMdLabel="BUS_LBL"></title></head>
<body>
<table>
   <tr>
      <td oraLabel="user"></td>
      <td><input oraField="user"/></td>
   </tr>
   <tr>
      <td oraLabel="info/city"></td>
      <td><input oraField="info/city"/></td>
   </tr>
   <tr>
      <td oraLabel="info/age"></td>
      <td><input oraField="info/age"/></td>
   </tr>
   <tr>
      <td/>
      <td><input type="button" oraMdLabel="ACCEPT_LBL"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <user>RWINSTON</user>
   <info>
      <city>Alameda</city>
      <age>32</age>
   </info>
</root>
</xml>
</html>

HTML المعروض:

اشتقاق تسمية من حقل

يتم استخدام هذه السمة للحصول على تسمية حساسة للغة لعنصر HTML <span> أو <td> أو <input> أو <title>. يتم اشتقاق نص التسمية من الحقل المُشار إليه.


الصياغة	القيم الصالحة
oraMdLabel=" "	رمز حقل MD.

ملاحظة: يمكن أيضًا تحديد التسميات المشتقة من تعريف المخطط، لمزيد من المعلومات، ارجع إلى اشتقاق تسمية من عنصر.

HTML:

<html>
<head><title oraMdLabel="F1_DETAILS_LBL"></title></head>
<body>
<table>
   <tr>
      <td oraLabel="user"></td>
      <td><input oraField="user"/></td>
   </tr>
   <tr>
      <td oraLabel="info/city"></td>
      <td><input oraField="info/city"/></td>
   </tr>
   <tr>
      <td oraLabel="info/age"></td>
      <td><input oraField="info/age"/></td>
   </tr>
   <tr>
      <td/>
      <td><input type="button" oraMdLabel="ACCEPT_LBL"/></td>
   </tr>
</table>
</body>
<xml>
<root>
   <user>RWINSTON</user>
   <info>
      <city>Alameda</city>
      <age>32</age>
   </info>
</root>
</xml>
</html>

HTML المعروض:

تعليمات تمكين مخطط واجهة المستخدم

يوضح قسم عرض التسميات طرق لاشتقاق التسمية لأحد العناصر باستخدام حقل MD أساسي. بالإضافة إلى ذلك، إذا كان حقل MD نفسه يحتوي على نص تعليمات، فسوف يقوم النظام بإنشاء تلميح أداة مجاور لتسمية العنصر. يؤدي نقر تلميح الأداة إلى السماح للمستخدم بعرض نص التعليمات.

يمكن تغيير عرض تلميح الأداة. لمزيد من المعلومات، ارجع إلى خيارات تخصيص الشكل وأسلوب العرض

البحث باستخدام منطقة مستكشف منبثق

خيار البحث

يتم استخدام هذه السمة لتمكين وظيفة منطقة البحث لعناصر HTML للإدخال.


الصياغة	القيم الصالحة
oraSearch=" "	رمز المنطقة.

ملاحظة: تتشابه سمة oraSearch مع سمة oraType، لأنها سوف تكون مضمنة "آليًا" في HTML عبر سمة oraSchemaDataTypes. هذا يعني أنه ليس من المطلوب ترميز سمة oraSearch في HTML لمخطط واجهة المستخدم إلا إذا لم يتم تحديد منطقة بحث في المخطط أو في مرجع المفتاح الخارجي لعنصر المخطط.

مثال على تحديد البحث في HTML. مخطط واجهة المستخدم:

<schema>
   <uiMap/> 
</schema>

HTML لمخطط واجهة المستخدم

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>UI Map with Search </td>
      <td><input oraField="uiMap" oraSearch="F1-UISRCH"></td>
   </tr>
</table>
</body>
<xml>
<root>
   <uiMap/>
</root>
</xml>
</html>

مثال على تحديد البحث في المخطط. مخطط واجهة المستخدم:

<schema> 
   <uiMap search="F1-UISRCH"/>
</schema>

HTML لمخطط واجهة المستخدم

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>UI Map with Search </td>
      <td><input oraField="uiMap"></td>
   </tr>
</table>
</body>
<xml>
<root>
   <uiMap/>
</root>
</xml>
</html>

يوضح المثال التالي تحديد مرجع المفتاح الخارجي لمنطقة البحث. مخطط واجهة المستخدم:


<schema>
   <uiMap fkRef="F1-UISRC"/> 
</schema>

HTML لمخطط واجهة المستخدم

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>UI Map with Search </td>
      <td><input oraField="uiMap"></td>
   </tr>
</table>
</body>
<xml>
<root>
   <uiMap/>
</root>
</xml>
</html>

في كل الحالات، لا يختلف HTML المعروض.

تهيئة حقول البحث

يتم استخدام هذه السمة الاختيارية لتهيئة مرشحات منطقة البحث. يمكن تهيئة العديد من المرشحات. لا يمكن استخدام هذه السمة إلا بالتزامن مع سمة oraSearch.


الصياغة	القيم الصالحة	خيارات قيمة الحقل	تعليقات
oraSearchField=" "	زوج واحد أو أكثر من أزواج اسم الحقل وقيمة الحقل مفصولة بواسطة علامة نقطتين. يتم فصل كل زوج بواسطة فاصلة منقوطة. oraSearchField="fieldName:fieldValue: ..." يتم استخدام اسم الحقل لتحديد مرشح المنطقة المطلوب تهيئته عند بدء البحث. يجب أن يتطابق اسم الحقل مع قيمة رمز الاختصار searchField المحددة في معلمة المرشح المخفي أو مرشح المستخدم لمنطقة بحث.	بدون قيمة	إذا لم تحدد قيمة حقل، فسيتم استخدام قيمة عنصر الإدخال الذي يحتوي على سمة oraSearchField.
		المسار X	تتم الإشارة إلى المسارX لعنصر المخطط الذي يحتوي على القيمة المطلوب استخدامها.
		"قيمة حرفية"	تتم الإشارة إلى قيمة حرفية مطلوب إدخالها.

ملاحظة: إذا لم يتم تحديد سمة oraSearchField وكان لعنصر المخطط بحث له fkRef محدد ممكَّن، يقوم إطار العمل آليًا بإنشاء oraSearchField حيث يكون اسم الحقل مساوي لحقول المفتاح (MD) لمرجع المفتاح الخارجي.

تحذير: يمكن استدعاء منطقة المستكشف المنبثق بإحدى الطريقتين: من خلال نقر زر البحث أو ضغط مفتاح enter من الحقل الموجود أيسر الزر. إذا قمت بنقر الزر، فلن يتم تمرير معلومات حقل البحث إلى المنطقة. لا يتم استخدام معلومات حقل البحث إلا لتهيئة قيم مرشح المنطقة عند الضغط على enter.

تتم تهيئة قيمتي من قيم المرشح كما هو موضح في المثال التالي:

<schema>
   <bo/> 
   <uiMap/>
</schema>

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>UI Map with Search </td>
      <td><input oraField="uiMap" oraSearch="F1-UISRCH" oraSearchField="MAP_CD; BUS_OBJ_CD:bo;"></td>
    </tr>
</table>
</body>
<xml>
<root>
   <bo/>
   <uiMap/>
</root>
</xml>
</html>

تعيين حقول البحث المعروضة

يتم استخدام هذه السمة الاختيارية لتوجيه القيم المعروضة بواسطة منطقة البحث. يمكن تحديد حقول متعددة. لا يمكن استخدام هذه السمة إلا بالتزامن مع سمة oraSearch.


الصياغة	القيم الصالحة	خيارات قيمة الحقل	تعليقات
oraSearchOut=" "	زوج واحد أو أكثر من أزواج اسم الحقل وقيمة الحقل مفصولة بواسطة علامة نقطتين. يتم فصل كل زوج بواسطة فاصلة منقوطة. oraSearchOut="field name:xpath target; ..." يتم استخدام اسم الحقل لتحديد نتيجة البحث الناتجة من منطقة الاستعلام. يجب أن يتطابق اسم الحقل مع رمز الاختصار ELEMENT_NAME المحدد في معلمة نتائج بحث منطقة المستكشف.	بدون قيمة	إذا لم تحدد قيمة حقل، فسوف يتلقى عنصر الإدخال الذي يحتوي على سمة oraSearchField القيمة الناتجة.
oraSearchOut=" "		المسار X	تتم الإشارة إلى المسارX لعنصر المخطط الذي يجب أن يتلقى القيمة الناتجة.

ملاحظة: إذا لم يتم تحديد سمة oraSearchOut، فسوف يقوم إطار العمل بإنشاء قيمة افتراضية حيث يتم تعيين اسم الحقل بقيمة تساوي اسم حقل oraSearchField's.

يتم عرض قيمتين في المثال التالي:

<schema>
   <bo/>
   <mo/>
</schema>

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
   <tr>
      <td>BO Search </td>
      <td><input oraField="bo" oraSearch="Z1-BOSRCH" oraSearchOut="BUS_OBJ_CD; MO_CD:mo;"></td>
   </tr>
</table>
</body>
<xml>
<root>
   <bo/>
   <mo/>
</root>
</xml>
</html>

عرض الأخطاء

عرض متغيرات الأخطاء

يمكن عرض أحد متغيرات الأخطاء التالية.


الصياغة
oraErrorVar="ERRMSG-TEXT"
oraErrorVar="ERRMSG-LONG"
oraErrorVar="ERRMSG-CATEGORY"
oraErrorVar="ERRMSG-NUMBER"

...
<table width="100%" cellpadding="12">
   <tr class="oraErrorText">
      <td>
         <a href="" onclick="oraShowErrorAlert(); return false;">
            <span  class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
         </a>
      </td>
   </tr>
</table>
...

HTML المعروض

تمييز حقل به خطأ

ملاحظة: لمزيد من المعلومات حول إيقاف خطأ ما، ارجع إلى عبارة Terminate في صياغة تحرير البيانات.


الصياغة	تعليقات
oraError="automate:true\|false; prefix: "	سيؤدي تحديد automate:true إلى تمكين تمييز العنصر الذي به خطأ عند إصدار خطأ ما آليًا. لاحظ أن القيمة صواب هي القيمة الافتراضية ولا داعي إلى تحديدها. يتم تحديد automate:false لإيقاف تمييز الحقل.
	يستخدم النظام مطابقة بين اسم العنصر المشار إليه في الخطأ وأسماء العناصر في مخطط واجهة المستخدم. في حالة وجود عناصر المخطط في مسار X لا يتطابق مع ما يشير إليه الخطأ، استخدم prefix:XPath للتحديد.

ملاحظة: يجب تحديد زوج من مراجع صحف الأنماط، cisEnabled وcisDisabled، لمرجع النمط oraError. تتحكم صحيفة الأنماط في طريقة عرض الحقل الذي به خطأ. إذا كنت ترغب في تغيير العرض، يجب تجاوز نمط oraError.

يوضح مثال HTML التالي أن العناصر في المخطط محددة في مجموعة تُسمى boGroup. لن يتضمن اسم العنصر الناتج عن الخطأ هذه المجموعة، لكي تعمل خاصية تمييز الحقل بشكل صحيح، يجب أن تشير السمة prefix: إلى اسم المجموعة.

<html>
<head>
   <title>User Zone Input</title>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body oraError="automate:true; prefix:boGroup">
<table width="100%" cellpadding="12">
   <tr class="oraErrorText">
      <td>
         <a href="" onclick="oraShowErrorAlert(); return false;">
            <span  class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
         </a>
      </td>
   </tr>
</table>
<table width="100%" border="0" cellpadding="4">
   <tr style="padding-top:30px;">
      <td align="right" class="label">User Id</td>
      <td>
         <span oraField="boGroup/userId" class="normal"/>
      </td>
   </tr>
   <tr>
      <td align="right" class="label">First Name</td>
      <td>
         <input oraField="boGroup/firstName" class="normal"/>
      </td>
   </tr>
   <tr>
      <td align="right" class="label">Last Name</td>
      <td>
         <input oraField="boGroup/lastName" class="normal"/>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <boGroup>
      <userId>BOND007</userId>
      <firstName>James</firstName>
      <lastName></lastName>
   </boGroup>
</root>
</xml>
</html>

HTML المعروض، حيث يكون عنصر الخطأ الناتج مساوِ إلى القيمة 'lastName':

oraErrorElement الذي يتم عرضه آليًا باستخدام oraError في علامة النص.

تجاوز اسم عنصر الخطأ

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


الصياغة	القيم الصالحة	تعليقات
oraErrorElement=	"اسم العنصر"	يجب أن يتطابق اسم العنصر المُشار إليه هنا تمامًا مع اسم عنصر الخطأ المُعَّين عند ظهور الخطأ. يمكن الإشارة إلى أكثر من حقل HTML بواسطة نفس اسم عنصر الخطأ.

يوضح هذا سيناريو حيث يكون فيه اسم العنصر المرتبط بالخطأ مختلف عن اسم العنصر في المخطط.

<html>
<head>
   <title>User Zone Input</title>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table width="100%" cellpadding="12">
   <tr class="oraErrorText">
      <td>
         <a href="" onclick="oraShowErrorAlert(); return false;">
            <span  class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
         </a>
      </td>
   </tr>
</table>
<table width="100%" border="0" cellpadding="4">
   <tr style="padding-top:30px;">
      <td align="right" class="label">User Id</td>
      <td>
         <span oraField="userId" class="normal"/>
      </td>
   </tr>
   <tr>
      <td align="right" class="label">First Name</td>
      <td>
         <input oraField="firstName" class="normal" oraErrorElement="firstName"/>
      </td>
   </tr>
   <tr>
      <td align="right" class="label">Last Name</td>
      <td>
         <input oraField="familyName" class="normal"  oraErrorElement="lastName"/>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <userId>BOND007</userId>
   <firstName>James</firstName>
   <familyName></familyName>
</root>
</xml>
</html>

HTML المعروض.

عرض رسالة الخطأ المنبثقة

عندما يتم عرض نص الخطأ، يمكن استخدام هذه الدالة لينبثق مربع حوار الخطأ القياسي (والذي يعرض مزيدًا من المعلومات) عندما يقوم مستخدم بنقر رسالة الخطأ.


الصياغة
oraShowErrorAlert(); return false;

<html>
<head>
   <link rel="stylesheet" type="text/css" href="cisDisabled.css"/>
   <link rel="stylesheet" type="text/css" href="cisEnabled.css"/>
</head>
<body>
<table width="100%" cellpadding="12">
   <tr class="oraErrorText">
      <td>
         <a href="" onclick="oraShowErrorAlert(); return false;">
            <span  class="oraErrorText" oraErrorVar="ERRMSG-TEXT"></span>
         </a>
      </td>
   </tr>
</table>
<table>
   <tr>
      <td >Address:</td>
      <td><input type="text" oraField="address"/></td>
   </tr>
   <tr>
      <td>City:</td>
      <td><input type="text" oraField="city"/></td>
   </tr>
   <tr>
      <td>State:</td>
      <td><input type="text" oraField="state"/></td>
   </tr>
   <tr>
      <td>Zip:</td>
      <td><input type="text" oraField="zip"/></td>
   </tr>
   <tr>
      <td/>
      <td style="padding-top=15px;">
         <oraInclude map="F1-SaveCancelButtons"/>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <address>123 Main St</address>
   <city>Alameda</city>
   <state>CA</state>
   <zip>94770</zip>
</root>
</xml>
</html>

HTML المعروض.

مربع حوار الخطأ القياسي المنبثق الذي تم إطلاقه من خلال نقر رسالة الخطأ:

نافذة تفصيلية يتم إطلاقها باستخدام دالة oraShowAlert

إطلاق JavaScript لأحداث المستعرض

استخدام إطار عمل JavaScript

توجد العديد من أحداث JavaScript التي يمكن استخدامها داخل بيئة HTML/Javascript. تتضمن هذه أحداث مثل onLoad وonBlur وonChange وما إلى ذلك. يستخدم إطار عمل مخطط واجهة المستخدم أيضًا بعض من هذه الأحداث. من المهم أن يعمل أي مخطط واجهة مستخدم تقوم بتطويره مع إطار العمل للحصول على نتائج متسقة (يمكن ألا يتم دائما تنفيذ الأحداث بنفس الترتيب في كل الأوقات!).

تحذير:

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

إذا كان جافا سكريبت مطلوبًا في مقطع أو مخطط واجهة مستخدم XHTML، فسيكون من الضروري وضعه في علامة ![CDATA[ ]] للتأكد من وجود مستند XML صالح. لاحظ أنه يمكن أن يتطلب الأمر تعطيل العلامات نفسها لتحسين التوافق مع المستعرضات الأقدم. على سبيل المثال:


<script type="text/javascript">
/* <![CDATA[ */

//
// javascript
//

/* ]]> */

</script>

حدث تغيير العنصر


الصياغة	القيم الصالحة
oraChange=" "	دالة JavaScript.

في حالة وجود معالج أحداث مرتبط بالفعل بأحد عناصر HTML في وقت تحميل مخطط واجهة المستخدم، يقوم إطار العمل بإزالة المعالج وإرفاق معالج أحداث مجمع. يقوم المعالج المجمع باستدعاء أي معالج إطار عمل أولاً ثم يستدعي أدوات المعالجة الأخرى (المخصصة) بعد ذلك.

تحذير: لاحظ أنه يجب استخدام الدالة لتنفيذ منطق يقوم بتعديل قيمة بيانات الحقل المرتبط مرة أخرى - أو سيحدث تكرار لا نهائي.

في المثال التالي يتم تنفيذ دالة oraInvokeBS عند نقر الزر.

<html>
  <head>
    <title>oraInvokeBS test</title>
  </head>
  <body>
    <table>
      <tr>
        <td>User Id:</td>
        <td>
          <input oraField= "xmlGroup/userId"/>
          <input type="button" value="Search" oraChange="oraInvokeBS('UserSearch','xmlGroup');"/>
        </td>
      </tr>
      <tr>
        <td/>
        <td>Search Results</td>
      </tr>
      <tr>
        <td/>
        <td>
          <table oraList="xmlGroup/searchList">
            <tr>
              <td><span oraField="userId"></span>
              </td>
            </tr>
          </table>
        </td>
      </tr>
    </table>
  </body>
  <xml>
    <root>
      <xmlGroup>
        <userId/>
        <searchList>
            <userId></userId>
        </searchList>
      </xmlGroup>
    </root>
  </xml>
</html>

حدث تحميل الصفحة


الصياغة	القيم الصالحة
oraLoad=" "	دالة JavaScript.

تحذير: عند تنفيذ oraLoad في مخطط واجهة مستخدم لأحد المقاطع وكنت تحتاج إلى تنفيذ دالة JavaScript أثناء تحميل الصفحة، (حيث تقوم الدالة باستدعاء كائن عمل أو خدمة أعمال أو سكريبت خدمة)، يمكنك استخدام الصياغة الخاصة "oraLoad[$SEQUENCEID]". للحصول على الصياغات الخاصة الأخرى المستخدمة مع مقاطع المخطط، ارجع إلى قسم إنشاء عنوان منطقة بوابة.

في المثال التالي، يتم تنفيذ دالة oraDisplayNone أثناء تحميل الصفحة.

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
        <td oraLoad="oraDisplayNone(item,'userId','')">User Id: </td>
        <td><span oraField="userId"></span></td>
    </tr>
</table>
</body>
<xml>
<root>
    <userId>SPLAXT</userId>
</root>
</xml>
</html>

HTML المعروض

بعد حدث تحميل الصفحة


الصياغة	القيم الصالحة
oraAfterLoad=""	دالة JavaScript.

في المثال التالي، يتم تنفيذ دالة oraGetValueFromScript بعد تحميل الصفحة.

<div>
  <label for="boGroup_parameters_externalSystem" oraLabel="boGroup/parameters/externalSystem">
  </label>
    <span>
      <select oraSelect="bs:F1-RetrieveExternalSystems" class="oraInput" 
        id="boGroup_parameters_externalSystem" oraField="boGroup/parameters/externalSystem" 
        oraSelectOut="valuePath:results/externalSystem; descPath:results/description" 
        oraSelectIn="outboundMsgType:boGroup/parameters/outboundMsgType" 
        oraAfterLoad
        ="oraGetValueFromScript(document.getElementById('boGroup_parameters_externalSystem');">
      </select>
    </span>

</div>

إخفاء العناصر

إخفاء باستخدام دالة

يوفر النظام تقنيات متعددة لإخفاء عنصر HTML.


الصياغة	القيم الصالحة	تعليقات
oraDisplayNone(item );	(item, 'XPath', 'value', 'operator')	يُستخدم في إخفاء عنصر على أساس قيمة عنصر آخر (تتم الإشارة إليه باستخدام المسار X الخاص به). أدخل قيمة ' ' لتفسير أي قيمة فارغة. بشكل افتراضي، يكون المعامل هو '='. بدلاً من ذلك، يمكن تعيين هذه على معامل آخر مثل '!=' أو '>' أو '<'.
oraDisplayNone(item );	(item, function name,true \| false)	تُستخدم للإشارة إلى دالة JavaScript، التي يجب أن تعرض قيمة منطقية.
oraIsSuppress="true"		استخدم هذا الخيار للحقول التي يجب إخفاؤها دائمًا ولا تعتمد على شيء آخر. قم بتعيين هذه السمة على عنصر HTML (عنصر div).

مثال حيث تكون تسمية معرف المستخدم مخفية في حالة عدم وجود قيمة معرف مستخدم.

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
        <td oraLoad="oraDisplayNone(item,'userId','')">User Id: </td>
        <td><span oraField="userId"></span></td>
    </tr>
</table>
</body>
<xml>
<root>
    <userId></userId>
</root>
</xml>
</html>

مثال حيث يكون زر "حفظ" مخفيًا إذا كان المستخدم لا يمتلك حماية الوصول إلى إجراء تغيير ('C') لخدمة التطبيق 'F1-DFLTS'.

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
   <td oraLoad="oraDisplayNone(item, oraHasSecurity('F1-DFLTS', 'C'), false );">
      <input name="Save" type="button" onclick="oraInvokeBO('CM-IndividualTaxpayer', null, 'replace')"/>
   </td>
    </tr>
</table>
</body>
<xml>
<root>
    <userId></userId>
</root>
</xml>
</html>

التحقق من حماية الوصول للمستخدم

يوفر النظام دالتين للتحقق من حماية وصول المستخدم إلى وضع وصول وخدمة تطبيق محددة. عادةً يتم استخدامها لإخفاء العناصر.


الصياغة	المعلمات
oraHasSecurity( )	"رمز خدمة التطبيق"
oraHasSecurity( )	"وضع الوصول"
oraHasSecurityPath('x','y')	"المسار X لخدمة التطبيق"
oraHasSecurityPath('x','y')	"المسار X لوضع الوصول"

لعرض مثال على دالة oraHasSecurity، راجع القسم السابق. فيما يلي مثال حيث يكون زر الحالة مخفيًا إذا كان المستخدم لا يمتلك حماية الوصول إلى وضع الوصول "ACT" لخدمة التطبيق 'FORMTST'.

<html>
<body>
<table>
    <tr>
   <td oraLoad="oraDisplayNone(item, oraHasSecurityPath('appService', 'accessMode'), false );">
      <input oraField="statusLabel" type="button" onclick="oraRunScript('UpdateState','status');"/>
   </td>
    </tr>
</table>
</body>
<xml>
<root>
    <status>ACTIVATE</status>
<statusLabel>Activate</statusLabel>
<appService>FORMTST</appService>
    <accessMode>ACT</accessMode>
</root>
</xml>
</html>

استدعاء الخدمات المستندة إلى المخطط

يوفر النظام دالات لاستدعاء خدمة أعمال أو كائن عمل أو سكريبت خدمة.

دالة استدعاء كائن العمل

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


الصياغة	المعلمات	تعليقات
oraInvokeBO( )	'BO Name'
	'XPath' أو فارغ	تحديد عنصر مجموعة عبر المسار X. إذا تم تحديد كلمة خالي، فسوف يتم تمرير كائن XML المضمن بالكامل.
	'action'	تحديد الإجراء المطلوب استخدامه. القيم الصالحة هي إضافة وحذف وقراءة وتحديث واستبدال وfastAdd وfastUpdate. Fastpath: للمزيد من المعلومات حول إجراءات كائن العمل المختلفة، ارجع إلى إجراءات كائن العمل.

مثال بالعبارة التي تم استدعاؤها في دالة JavaScript.

function invokeBO {
     if (!oraInvokeBO('F1-User','xmlGroup','read')) {
          oraShowErrorAlert();
          return;
}
}

مثال بالعبارة التي تم استدعاؤها في onClick.

<input type="button"  class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeBO('F1-User');"/>

دالة استدعاء خدمة الأعمال

يتم استخدام هذه الدالة لتنفيذ تفاعل خدمة أعمال مباشرة من HTML لمخطط واجهة المستخدم. تقوم بعرض قيمة "صواب" أو "خطأ" اعتمادًا على ما إذا كان الاستدعاء سيواجه خطأ أم لا.


الصياغة	المعلمات	تعليقات
oraInvokeBS( )	"اسم خدمة الأعمال"
oraInvokeBS( )	'XPath' أو فارغ	تحديد عنصر مجموعة عبر المسار X. إذا تم تحديد كلمة خالي، فسوف يتم تمرير كائن XML المضمن بالكامل.

مثال بالعبارة التي تم ترميزها في دالة JavaScript.

function invokeBS {
     if (!oraInvokeBS('F1-UserSearch','xmlGroup')) {
          oraShowErrorAlert();
          return;
  }
}

مثال بالعبارة التي تم استدعاؤها عبر onClick.

<input type="button"  class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeBS('F1-RetrieveInfo');"/>

دالة استدعاء سكريبت الخدمة

يتم استخدام هذه الدالة لتنفيذ تفاعل سكريبت الخدمة مباشرة من HTML لمخطط واجهة المستخدم. تقوم بعرض قيمة "صواب" أو "خطأ" اعتمادًا على ما إذا كان الاستدعاء سيواجه خطأ أم لا.


الصياغة	المعلمات	تعليقات
oraInvokeSS( )	"اسم سكريبت الخدمة"
oraInvokeSS( )	'XPath' أو فارغ	تحديد عنصر مجموعة عبر المسار X. إذا تم تحديد كلمة خالي، فسوف يتم تمرير المستند الذي ينتمي إلى العقدة الرئيسية. إذا لم تكن العقدة الرئيسية كافية، فيمكن تمرير المستند بالكامل دائمًا باستخدام الصياغة التالية: `oraInvokeSS('service script', null, null, [$SEQUENCEID])`

مثال بالعبارة التي تم استدعاؤها في دالة JavaScript.


function invokeSS {
     if (!oraInvokeSS('F1-GetUsers','xmlGroup')) {
          oraShowErrorAlert();
          return;
}
}

مثال بالعبارة التي تم استدعاؤها في onClick.

<input type="button"  class="oraButton" oraMdLabel="DISPLAY_LBL" onClick="oraInvokeSS('F1-GetUserInfo');"/>

تجديد مخطط معروض أو صفحة بوابة

تجديد المخطط

لا يتم استخدام هذه الدالة إلا "لتجديد" منطقة المخطط التي تصدر الأمر فقط.


الصياغة
oraRefreshMap;

...
    <tr>
        <td/>
        <td><input type="button" onclick="oraRefreshMap();" value="Refresh"/></td>
    </tr>
...

تجديد الصفحة

يتم استخدام هذه الدالة لتحديث كل المناطق في البوابة.


الصياغة
oraRefreshPage;

...
    <tr>
        <td/>
        <td><input type="button" onclick="oraRefreshPage();" value="Refresh"/></td>
    </tr>
...

تضمين تنقل إطار العمل

التنقل باستخدام خيار التنقل

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


الصياغة	المعلمات
oraNavigate( );	"رمز خيار التنقل"
oraNavigate( );	"المسارX للمفتاح"

تحذير: لا يتم استخدام هذه الدالة إلا لمخطط واجهة مستخدم في منطقة بوابة. لا يجب استخدامها في مخطط واجهة مستخدم تم إطلاقه بواسطة سكريبت مساعد عمليات أعمال.

يعرض المثال التالي استخدامين ممكنين لهذه الدالة: كعنوان URL وفي شكل زر. لاحظ أنه يجب أن يحتوي مخطط واجهة المستخدم على سمة fkRef. لمزيد من المعلومات، ارجع إلى تنسيق مرجع المفتاح الخارجي.

<schema>
    <userId fkRef="CI_USER"/>
</schema>

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
       <td>User Link: </td>
       <td><a href="" onclick="oraNavigate('userMaint','userId'); return false;">
         <span oraField="userId" oraType="fkRef:CI_USER"></span></a>
       </td>
    </tr>
    <tr>
        <td>User Button: </td>
        <td><input type="submit" onclick="oraNavigate('userMaint','userId')" 
          value="Go to User"/></td>
    </tr>
</table>
</body>
<xml>
<root>
    <userId>SPLAXT</userId>
</root>
</xml>
</html>

HTML المعروض.

إطلاق سكريبت مساعد عمليات الأعمال


الصياغة	المعلمات	تعليقات
oraRunScript( );	"رمز سكريبت مساعد عمليات الأعمال".
oraRunScript( );	"عنصر المسار X"	يمكن تمرير قيمة عنصر واحدة أو أكثر في مساعد عمليات الأعمال حيث يمكن الإشارة إليها كمتغيرات مؤقتة.

تحذير: لا تنطبق هذه الدالة إلا على مخططات واجهة المستخدم المعروضة في مناطق البوابة. لا يمكن أن تقوم مخططات واجهة المستخدم التي تم إطلاقها داخل سكريبت مساعد عمليات أعمال جاري بإطلاق سكريبت مساعد عمليات أعمال آخر مباشرة من HTML لمخطط واجهة المستخدم. بدلاً من ذلك، يتم عرض قيمة من مخطط واجهة المستخدم وتنفيذ نوع خطوة 'تنفيذ السكريبت' أو 'نقل التحكم'.

ملاحظة: من الضروري في مؤلف السكريبت أن يتم سحب المعلومات خارج التخزين المؤقت في الخطوات الأولية للسكريبت.

في المثال التالي، يتم إنشاء متغير مؤقت يُسمى personId بقيمة '1234567890' ويتم إطلاق سكريبت مساعد عمليات أعمال يُسمى "تحرير العنوان".

<html>
<body>
<table>
   <tr>
      <td>
         <div oraField="address"></div>
         <span oraField="city"></span>
         <span>,</span>
         <span oraField="state"></span>
         <span oraField="zip"></span>
         <span oraField="country"></span>
         <a href="" onClick="oraRunScript('Edit Address','personId');">edit</a>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <personId>1234567890</personId>
   <address>123 Main St</address>
   <city>Alameda</city>
   <state>CA</state>
   <zip>94770</zip>
</root>
</xml>
</html>

HTML المعروض.

إطلاق سكريبت مساعد عمليات الأعمال مع قيم

يتم استخدام هذه الدالة لإطلاق مساعد عمليات أعمال، مع إدخال زوج اسم/قيمة للدفع داخل التخزين المؤقت. يمكن تمرير قيم متعددة. يمكن أن يشير سكريبت مساعد عمليات الأعمال إلى المتغيرات المؤقتة حسب الاسم.


الصياغة	المعلمات	تعليقات
oraRunScriptWithValues( );	"رمز سكريبت مساعد عمليات الأعمال".
oraRunScriptWithValues( );	قيمة:"اسم عنصر المسار X"	زوج واحد أو أكثر من قيم وأسماء العناصر.

ملاحظة:إذا كنت ترغب في إدخال قيم إلى سكريبت مساعد عمليات الأعمال وهي غير موجودة في بنية XML لمخطط واجهة المستخدم، يجب استخدام هذه الدالة JavaScript، بدلاً من oraRunScript.

في المثال بالأسفل، تكون دالة JavaScript التي تسمى 'editUser()' مسئولة عن إطلاق سكريبت مساعد عمليات الأعمال الذي يُسمى 'UserEdit'. سيتم إنشاء المتغير المؤقت الذي يُسمى 'userId' بقيمة 'CMURRAY'.

<html>
<head>
<script type="text/javascript">
 
function editUser() {
    var values = {'userId': 'CMURRAY'};
    oraRunScriptWithValues('UserEdit', values);
    return;
}
 
</script>
</head>
<body>
...
</body>
</html>

الخروج من مخطط واجهة مستخدم مع قيم الحد

يتم استخدام هذه الدالة للخروج من مخطط واجهة مستخدم. عند الخروج من المخطط يمكنك تحديد قيمة ليتم عرضها للسكريبت وتحديد، بالإضافة إلى ذلك، ما إذا كان يتم عرض XML تم تحديثه.


الصياغة	المعلمات	تعليقات
oraSubmitMap( );	"قيمة العرض"
oraSubmitMap( );	قيمة منطقية	يحدد ما إذا كان يجب عرض XML الذي تم تحديثه. القيمة الافتراضية هي صواب.

في المثال التالي، سيعرض زر "حفظ" المعلومات التي تم تحديثها، ولكن لن يقوم زر "إلغاء" بعرضها.

<html>
<body>
<table>
   <tr>
      <td/>
      <td style="padding-bottom:15px;">
         <a href="" onclick="oraShowErrorAlert(); return false;">
         <span oraErrorVar="ERRMSG-TEXT"></span></a>
      </td>
   </tr>
   <tr>
      <td >Address:</td>
      <td><input type="text" oraField="address"/></td>
   </tr>
   <tr>
      <td>City:</td>
      <td><input type="text" oraField="city"/></td>
   </tr>
   <tr>
      <td>State:</td>
      <td><input type="text" oraField="state"/></td>
   </tr>
   <tr>
      <td>Zip:</td>
      <td><input type="text" oraField="zip"/></td>
   </tr>
   <tr>
      <td/>
      <td style="padding-top=15px;">
         <input type="button" value="Save" onClick="oraSubmitMap('SAVE');"/>
         <input type="button" value="Cancel" onClick="oraSubmitMap('CANCEL',false);"/>
      </td>
   </tr>
</table>
</body>
<xml>
<root>
   <address>123 Main St</address>
   <city>Alameda</city>
   <state>CA</state>
   <zip>94770</zip>
</root>
</xml>
</html>

زري الحفظ والإلغاء اللذان تم عرضهما:

تضمين مقطع مخطط

يتم استخدام هذه الدالة لتضمين مقطع مخطط في مخطط واجهة مستخدم آخر. لاحظ أنه يمكن استخدام تضمين عقدة في مخطط أو مقطع مخطط.


الصياغة	المعلمات	تعليقات
<oraInclude map=' ' prefixPath=' '/>	map='UI Map Code'
<oraInclude map=' ' prefixPath=' '/>	prefixPath='Xpath'	اختياريًا، حدد بادئة مسار X ليتم إلحاقها بكل قيمة سمة مضمنة oraUploadData وoraDownloadData وdescPath وvaluePath oraSelect وoraList وoraLabel وoraField محددة في HTML لمقطع مخطط واجهة المستخدم الذي تم تضمينه. ملاحظة: لا تنطبق هذه الوظيفة إلا على قيم سمات المسار X عند عدم ظهور تلك القيم أسفل سمة oraList. لن تتأثر أية قيمة لمسار X موجودة داخل جدول يحتوي على سمة oraList بواسطة prefixPath.

مثال على مقطع مخطط بزري، باسم 'F1-SaveCancelButtons'.

<input onClick ="oraSubmitMap('SAVE');" oraMdLabel="SAVE_BTN_LBL" class="oraButton" 
type="button"/>
<input onClick ="oraSubmitMap('CANCEL',false);" oraMdLabel="CANCEL_LBL" class="oraButton" 
type="button"/>

مثال على مخطط يحتوي على مقطع مخطط باسم 'F1-SaveCancelButtons'.

...
<tr>
   <td colspan="2" align="center">
<oraInclude map="F1-SaveCancelButtons"/>
   </td>
</tr>
...

تضمين مكون ويب

مكون الويب هو عنصر HTML مخصص يقوم بإنشاء ميزة واجهة مستخدم محددة. يشتمل كل مكون ويب مدعوم عادةً على سمة HTML محددة واحدة أو أكثر تؤثر على كيفية عمل مكون الويب وكيفية عرضه. قد تحتوي مكونات الويب المركبة على كائن تكوين نظام مقابل يحدد السلوك والمعلومات المعروضة بواسطة عنصر واجهة المستخدم الناتج. على سبيل المثال، يحتوي مكون الويب الذي يقوم بإنشاء "شجرة" معلومات على جدول تكوين شجرة يحدد تفاصيل حول كيفية استرجاع المعلومات للشجرة وكيفية عرض كل نقطة توصيل.

السمات العامة

فيما يلي بعض السمات العامة التي يمكن استخدامها لكل مكون ويب:

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

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

القيمة الحرفية. يمكن الإشارة إلى القيمة مباشرة. مثال:
```
treename="F1-Tree"
```
مرجع XPath. يجب أن تستخدم مراجع XPath الصياغة الصريحة x[value]. مثال:
```
treename="x[migrationTree]"
```
مرجع سياق عام أو مرجع سياق بوابة. يجب أن تستخدم هذه المراجع الصياغة الصريحة c[value].
```
treename="c[TREE_NAME]"
```
مرجع تسمية الحقل. يجب أن تستخدم هذه المراجع الصياغة الصريحة md[value] .
```
text=md[F1_ADD_LBL]"
```
مرجع نص تعليمات الحقل. يجب أن تستخدم هذه المراجع الصياغة الصريحة mdh[value] .
```
text=mdh[F1_OPERATIONS_LBL]"
```

بالنسبة إلى السمات المركبة التي تدعم زوجًا واحدًا أو أكثر من أزواج الأسماء/القيم، تتبع صياغة تحديد الأسماء والقيم نفس القواعد الموضحة أدناه للقيم الحرفية ومراجع XPath والسياق. يجب استخدام النقطتين (":") لفصل الاسم عن القيمة والفواصل المنقوطة (";") لفصل كل زوج.

context="FIELD_NAME1:x[value1];FIELD_NAME2:F1AB;x[fieldName3]:c[FIELD_NAME3];"

قد يحتوي مكون الويب المحدد على سمات HTML إضافية خاصة بوظيفته.

ملاحظة: أي مخطط واجهة مستخدم يحدد مكون ويب يجب أن يتضمن مقطع مخطط F1-OJETLIBSR ضمن علامة "النص".

<body>
<oraInclude map="F1-OJETLIBSR"/>
..
</body>

ملاحظة: يمكن إدخال سمات HTML القياسية أيضًا (على سبيل المثال، المعرف=".." والنمط=".."). تُحدد هذه السمات بأنها سمات عادية. ويجب ملاحظة أن مكونات الويب نفسها قد تتحكم مباشرةً في بعض جوانب الأنماط وبالتالي تتجاوز أية إعدادات أنماط مُدخلة في مكون ويب HTML. على سبيل المثال، يوفر تكوين النظرة العامة المرتبطة بالسياق إعدادات للون النص الذي من شأنه تجاوز أي لون محدد في HTML.

توضح الأقسام التالية كل مكون ويب مدعوم.

الأشجار

لمزيد من المعلومات حول تكوين الشجرة، ارجع إلى الأشجار.


الصياغة	المعلمات	تعليقات
<ou-tree...></ou-tree>	treename="singleValue"	يجب إدخال مرجع لاسم كائن الشجرة الذي يحدد تكوين الشجرة المطلوب عرضها. تتوقع هذه السمة قيمة واحدة تتبع الصياغة الموضحة في قسم القيمة الواحدة أعلاه.
<ou-tree...></ou-tree>	context="..."	قم اختياريًا بإدخال زوجًا واحدًا أو أكثر من أزواج الأسماء/القيم. تتبع الصياغة المثال الموضح في معلومات السمات المركبة أعلاه.

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

<ou-tree treename="C1-PremiseTree"></ou-tree>

النظرة العامة المرتبطة بالسياق

لمزيد من المعلومات حول التكوين المرتبط بتحديد النظرة العامة المرتبطة بالسياق، ارجع إلى النظرة العامة المرتبطة بالسياق.


الصياغة	المعلمات	تعليقات
<ou-insights ...></ou-insights>	insightType="singleValue"	استخدم هذه السمة لتحديد نوع نظرة عامة مطلوب عرضه. يجب إدخال هذه السمة أو سمة فئة النظرة العامة. تتوقع هذه السمة قيمة واحدة تتبع الصياغة الموضحة في قسم القيمة الواحدة أعلاه.
	insightClass="singleValue"	استخدم فئة نظرة عامة لعرض كل أنواع النظرة العامة لمجموعة النظرة العامة المرتبطة بهذه الفئة. تتوقع هذه السمة قيمة واحدة تتبع الصياغة الموضحة في قسم القيمة الواحدة أعلاه.
	context="..."	قم اختياريًا بإدخال زوجًا واحدًا أو أكثر من أزواج الأسماء/القيم. تتبع الصياغة المثال الموضح في معلومات السمات المركبة أعلاه.
	mode="preview"	قم اختياريًا بإدخال وضع المعاينة للإشارة إلى خوارزمية النظرة العامة الأساسية التي تقوم بإعداد البيانات التي يتم فيها استدعاء النظرة العامة في وضع المعاينة، دون توفر سياق. وفقًا لذلك، تعرض الخوارزمية معلومات نموذجية.
	class=" "	يمكنك اختياريًا إدخال فئة مساعد CSS للتحكم في جوانب النظرة العامة المعروضة. القيم المدعومة: class="card-full-width" - قابل للتطبيق على النظرات العامة للبطاقة. استخدم فئة الخيار هذه للتأكد من تعديل عرض النظرة العامة للبطاقة لعرض المنطقة التي تحتوي عليها. تستخدم النظرات العامة للبطاقة التي لا تقوم بتعيين هذه المعلمة عرضًا ثابتًا.

المثال التالي هو من مخطط معاينة النظرة العامة حيث يكون نوع النظرة العامة هو النوع الموجود في السياق. لا توجد حاجة إلى بيانات سياق والوضع هو 'معاينة'.

<ou-insights insightType="x[insightType]" mode="preview"></ou-insights>

يستخدم المثال التالي فئة نظرة عامة ويقوم بإدخال قيم السياق من عناصر XPath بأسماء سياق محددة بوضوح.

<ou-insights insightClass="C1CI" context="PER_ID:x[personId];ACCT_ID:x[accountId];PREM_ID:x[premiseId];"></ou-insights>

الزر

يوفر مكون ويب الزر الدعم لمجموعة تنسيقات الأزرار القياسية المستخدمة في النظام.


الصياغة	المعلمات	تعليقات
<ou-button...></ou-button>	type=”singleValue”	يجب تحديد نوع الزر المطلوب عرضه. تتوقع هذه السمة قيمة واحدة تتبع الصياغة الموضحة في قسم القيمة الواحدة أعلاه. قيم النوع الصالحة هي: image - الصورة فقط text - النص فقط imageText - الصورة متبوعة بالنص menu - النص بالإضافة إلى إقحام القائمة المنسدلة لفتح القائمة imageMenu - الصورة بالإضافة إلى إقحام القائمة المنسدلة لفتح القائمة إذا لم يتم إدخال سمة نوع، فسيتم عرض صورة "زر متقطع".
	img=”singleValue”	تحديد مسار الصورة المطلوب عرضها. يجب إدخال هذه السمة أو سمة مرجع الصورة لنوع زر يتضمن صورة. تتوقع هذه السمة قيمة واحدة تتبع الصياغة الموضحة في قسم القيمة الواحدة أعلاه. لاحظ أنه بالنسبة لصور SVG، إذا كان المرجع يتضمن فقط اسم ملف SVG بدون مسار، فمن المفترض أن يكون المسار هو مخزن إطار عمل SVG.
	imgRef=”singleValue”	حدد مرجع أيقونة العرض للصورة المطلوب استخدامها. يجب إدخال هذه السمة أو سمة الصورة لنوع زر يتضمن صورة. تتوقع هذه السمة قيمة واحدة تتبع الصياغة الموضحة في قسم القيمة الواحدة أعلاه.
	text="..."	تحديد عناصر النص المتنوعة المطلوبة بواسطة الزر. تتبع الصياغة المثال الموضح في معلومات السمات المركبة أعلاه. قيم أسماء عناصر النص الصالحة هي: label - نص التسمية المطلوب استخدامه للزر tooltip - نص التحويم المطلوب استخدامه للزر aria-label - تسمية ARIA للزر
	menu=”singleValue”	تحديد القائمة المطلوب استخدامها مع الزر. يجب إدخال هذه السمة لنوع زر يتضمن عنصر تحكم قائمة. تتوقع هذه السمة قيمة واحدة تتبع الصياغة الموضحة في قسم القيمة الواحدة أعلاه.
	disabled=”singleValue”	هذه سمة HTML قياسية. تؤدي القيمة "صواب" أو وجود النص "معطل" فقط إلى تعطيل زر مبدئيًا.
	security="..."	يمكنك اختياريًا تحديد إعدادات الحماية للزر. سيتم إخفاء الزر إذا لم يكن لدى المستخدم حق الوصول الآمن المناسب. تتبع الصياغة المثال الموضح في معلومات السمات المركبة أعلاه. قيم اسم عنصر الحماية الصالحة هي: service - خدمة التطبيق التي يتحكم وصول الحماية الخاص بها في الوصول إلى الزر accessMode - وضع الوصول المحدد للخدمة الذي يحدد مستوى أكثر دقة للوصول إلى الزر
	clickAction="..."	اختياريًا، حدد الإجراء المطلوب اتخاذه عندما يكون الزر "تم نقره". تتبع الصياغة المثال الموضح في معلومات السمات المركبة أعلاه. توجد قيم "اسم" محددة للسمة كما يلي: action - الإجراء المطلوب اتخاذه. القيم الصالحة هي "BPA" و"NAVIGATE" script - السكريبت المطلوب تنفيذه عندما يكون الإجراء هو "مساعد عمليات الأعمال" navopt - خيار التنقل المطلوب استخدامه عندما يكون الإجراء هو "تنقل" قد تتضمن السمة أيضًا أزواج أخرى من الاسم/القيمة تحدد المعلومات المطلوب تمريرها إلى السكريبت أو يتم استخدامها كحقول سياق تنقل. بالإضافة إلى إعدادات سمة التأمين، سيقوم النظام بالتحقق من وصول المستخدم إلى السكريبت أو مسار التنقل قبل تنفيذ الإجراء. من الممكن أن سمة HTML القياسية 'onClick' لا تزال مستخدمة. إذا كان HTML يحتوي على سمة 'onClick' بالإضافة إلى 'clickAction'، فستكون الأسبقية للسمة 'onClick'

فيما يلي مثال على زر بسيط مع نص.

<ou-button type="text" text="label:md[F1_BOOKMARK_LBL];"></ou-button>

فيما يلي مثال لزر الأيقونة باستخدام مرجع أيقونة العرض.

<ou-button type="image" imgRef="F1CMNT"></ou-button>

فيما يلي مثال لزر قائمة صورة.

<ou-button type="imageMenu" imgRef="F1STTGS" menu="CI_CONTEXTSCRIPT" text="tooltip:md[F1INSTY_VIS_LBL];></ou-button>

فيما يلي مثال لزر نص ينقل إلى صفحة أخرى.

<ou-button type="text" text="label:md[ALG_CD];tooltip:md[GOTO_ALG]" clickAction="action:NAVIGATE; navopt:f1algqTabMenu; ALG_CD:x[algorithm];></ou-button>

إظهار المخطط الافتراضي عند الإضافة

سيتم عرض القيم الافتراضية الموجودة في مخطط واجهة المستخدم في حقول إدخال خاصة بمخطط واجهة مستخدم إذا كانت عقدة <action مضمنة تحتوي على قيمة 'ADD' أو فارغة.


الصياغة
<action>ADD</action>

<action> </action>

سيتم عرض القيمة الافتراضية للمخطط الخاصة بعنصر <description>:

<schema>
    <action/>
    <boGroup type="group">
        <key/>
        <description default="enter description here"/>
    </boGroup>
</schema>

<html>
<body>
<table summary="" border="1" cellpadding="1" cellspacing="1">
    <tr>
        <td>Description   </td>
        <td><input oraField="boGroup/description"></td>
    </tr>
</table>
</body>
<xml>
<root>
    <action>ADD</action>
    <boGroup>
        <key/>
        <description/>
    </boGroup>
</root>
</xml>
</html>

HTML المعروض.

تكوين رسم بياني

بالإضافة إلى تكامل الرسوم البيانية مع المناطق، يدعم النظام استخدام نفس السمات في HTML لمخطط واجهة المستخدم لتكوين تمثيل رسومي لقائمة XML. يمكن أن يتحكم المصمم في نوع وحجم وموضع ومحتويات الرسم البياني باستخدام هذه السمات. للحصول على تفاصيل السمات والصياغة، ارجع إلى تكوين الرسم البياني لمستكشف البيانات.

أمثلة على الرسم البياني

عينة من تكوين المخطط الدائري:

<html>
<head>
<title>Pie Chart</title>
</head>
<body>
 
<div style="width:100%; height:290px;"
    oraChart="type:pie;"
    oraChartSeries1="list:set; labelPath:date; amount:amount; "
    oraChartBroadcast="BILL_ID:billId;">
</div>
 
</body>
 
<xml>
<root>
  <set>
<date>05-02-2003</date>
<amount>163.24</amount>
<billId>592211649441</billId>
  </set>
  <set>
<date>06-02-2003</date>
<amount>97.29</amount>
<billId>592211649442</billId>
  </set>
  <set>
<date>07-02-2003</date>
<amount>54.38</amount>
<billId>592211649443</billId>
  </set>
</root>
</xml>
</html>

أحد المخططات الدائرية المعروضة لسلسلة مفردة:

عينة من تكوين الرسم البياني الخطي أو المجمع أو المكدس - لكل منهم سلسلتين:

<html>
<head>
<title>Stacked Chart</title>
</head>
<body>
 
<div style="width:100%; height=300px;"
    oraChart="type:line;"
oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; "
oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; "
    oraChartBroadcast="BILL_ID:billId;">
</div>
 
<div style="width:100%; height=300px;"
oraChart="type:cluster;"
oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; "
oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; "
oraChartBroadcast="BILL_ID:billId;">
</div>
 
<div style="width:100%; height=300px;"
oraChart="type:stacked;"
oraChartSeries1="list:set; xaxis:date; label:Charge; amount:amount; "
oraChartSeries2="list:set; xaxis:date; label:Balance; amount:balance; "
oraChartBroadcast="BILL_ID:billId;">
</div>
 
</body>
 
<xml>
<root>
  <set>
<date>05-02-2003</date>
<amount>163.24</amount>
<balance>163.24</balance>
<billId>592211649441</billId>
  </set>
  <set>
<date>06-02-2003</date>
<amount>97.29</amount>
<balance>260.53</balance>
<billId>592211649442</billId>
  </set>
  <set>
<date>07-02-2003</date>
<amount>54.38</amount>
<balance>314.91</balance>
<billId>592211649443</billId>
  </set>
</root>
</xml>
</html>

ثلاثة أنواع من المخططات معروضة لكل واحد منهم سلسلتين: الخطي والمجمع والمكدس.

تحميل وتنزيل ملف القيمة المفصولة بفواصل

يمكن استخدام سمات HTML التالية لإدارة كل من التحميل والتنزيل بين إحدى القوائم التي تم تحديدها ضمن مخطط التخطيط وملف CSV (القيمة المفصولة بفاصلة). لاحظ أنه يوصى باستخدام هذه التقنية فقط للبيانات الصغيرة إلى متوسطة الحجم، على سبيل المثال ليس أكثر من آلاف عديدة من الصفوف. بالنسبة للبيانات الأكبر حجمًا، يوصى باستخدام تحميل مجموعة المعالجة/وظيفة التنزيل بدلاً من ذلك.

الصياغة هي oraUploadData="type:embed;path:list xpath;useLabels:true;showCount:true"

يتطلب تكوين التحميل منك تحديد اسم ملف القيمة المفصولة بفاصلة المطلوب تحميله وقائمة XML كهدف. سيقوم صف القيمة المفصولة بفاصلة عادةً بإنشاء مثيل قائمة منفصل. سيتم تحميل كل حقل مفصول بفاصلة موجود في الملف كعنصر منفصل في القائمة. لتضمين مربع حوار تحميل ضمن نطاق أحد المخططات، يجب ربط السمة oraUploadData بعنصر حاوية، مثل: div أو td أو span.

تشير القيمة الاختيارية useLabels:true إلى أنه أثناء تحليل بيانات ملف القيمة المفصولة بفاصلة للتحميل، من المتوقع أن تكون العناوين هي التسميات

ملاحظة: في حالة عدم تحديد القيمة useLabels:true وكان اسم عنصر XML الهدف هو "camelCase"، فيجب عندها أن يكون عنوان الجدول الإلكتروني المتوافق معهما بحالة أحرف العناوين مع وجود مسافة بين الكلمات، على سبيل المثال: "Camel Case". لا يتم اعتبار الأحرف والأحرف الخاصة كلمة مختلفة،على سبيل المثال: يجب تحميل "العنوان 1" إلى عنوان عنصر XML الهدف 1.

سيؤدي تحديد القيمة الاختيارية showCount:true إلى عرض عدد السجلات التي تم تحميلها.

تحذير: إذا كنت تستخدم إحدى الشبكات جنبًا إلى جنب مع الدالة oraUploadData، فيجب عندها أن تقوم بتعديل بيانات قائمة الشبكة باستخدام إجراء كائن العمل "استبدال". لمزيد من المعلومات، ارجع إلى إجراء كائن العمل استبدال.

عينة من oraUploadData="embed" ضمن نطاق عنصر div.

<html>
<head>
    <title>File Upload</title>
</head>
<body>
   
    <div oraUploadData="type:embed;path:myList"> </div>
 
</body>
 
<xml>
<root>
    <myList>
<id>838383930</id>
        <name>Janice Smith</name>
    </myList>
    <myList>
<id>737773730</id>
        <name>Bill McCollum</name>
    </myList>
</root>
</xml>
</html>

سيتم تضمين مربع حوار تحميل الملف هذا في نص الصفحة حيث يتم تحديد oraUploadData.

oraUploadData="type:popup;path:list xpath;useLabels:true;showOk:true;showCount:true"

يتطلب تكوين التحميل منك تحديد اسم ملف القيمة المفصولة بفاصلة المطلوب تحميله وقائمة XML كهدف. سيقوم صف القيمة المفصولة بفاصلة عادةً بإنشاء مثيل قائمة منفصل. سيتم تحميل كل حقل مفصول بفاصلة موجود في الملف كعنصر منفصل في القائمة. لتحميل ملف القيمة المفصولة بفاصلة باستخدام مربع الحوار المنبثق، يجب ربط السمة oraUploadData بعنصر مدخلات، مثل: زر أو ارتباط نص أو صورة.

يتم استخدام القيمة الاختيارية "The optional useLabels:true" للإشارة إلى أنه أثناء تحليل بيانات ملف القيمة المفصولة بفاصلة للتحميل، فمن المتوقع أن تكون العناوين هي التسميات

ملاحظة: في حالة عدم تحديد القيمة useLabels:true واسم عنصر XML الهدف على أنه "الأحرف الأولى الكبيرة" باللغة الإنجليزية، فيجب عندها أن يكون عنوان الجدول الإلكتروني المتوافق معهما بحالة أحرف العناوين مع وجود مسافة بين الكلمات، على سبيل المثال: "الأحرف الأولى الكبيرة" باللغة الإنجليزية. لا يتم اعتبار الأحرف والأحرف الخاصة كلمة مختلفة،على سبيل المثال: يجب تحميل "العنوان 1" إلى عنوان عنصر XML الهدف 1.

سيؤدي تحديد القيمة الاختيارية showOk:true إلى عرض زر "موافق" بمجرد انتهاء التحميل. سيظل الإطار المنبثق مفتوحًا إلى أن يتم الضغط على الزر. بالإضافة إلى ذلك، سيؤدي تحديد القيمة showCount:true إلى عرض عدد السجلات التي تم تحميلها.

عينة من oraUploadData="popup" مرتبطة بأحد الأزرار:

<html>
<head>
    <title>File Upload</title>
</head>
<body>
   <input type="button" name="submitButton" oraUploadData="type:popup;path:myList;" value='Get Data'>
   <table oraList="myList">
      <tr/>
      <tr>
         <td><span oraField="id"/></td>
         <td><span oraField="name"/></td>
      </tr>
   </table>
</body>
<xml>
<root>
   <myList>
      <id>838383930</id>
      <name>Janice Smith</name>
   </myList>
   <myList>
      <id>737773730</id>
      <name>Bill McCollum</name>
   </myList>
</root>
</xml>
</html>

HTML المعروض:

السمة oraUploadData مرفقة بزر "الحصول على البيانات"

سيؤدي الضغط على زر "الحصول على البيانات" إلى بدء تشغيل مربع حوار تحميل الملف القياسي (الذي تم إدخاله بواسطة إطار العمل) كما هو موضح أدناه.

oraDownloadData="list xpath"

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

ملاحظة: يعتمد تنسيق الرقم على إعداد ملف بيانات المستخدم. بالنسبة للمواقع التي يكون فيها الرمز العشري عبارة عن فاصلة، يمكن للنسخة المعدلة تكوين إعداد خاصية (spl.csv.delimiter.useFromDisplayProfile=true) مما يؤدي إلي استخدام النظام للفاصلة المنقوطة على أنها المحدد الذي يفصل العناصر بدلاً من الفاصلة.

عينة من oraDownloadData.

<html>
<head>
<title>File Download</title></head>
<body>
<input type="button" name="downloadButton" oraDownloadData="myList" value="Download"/>
</body>
<xml>
<root>
   <myList>
      <id>881-990987</id>
      <name>John Mayweather</name>
   </myList>
   <myList>
      <id>229-765467</id>
      <name>Anna Mayweather</name>
   </myList>
   <myList>
      <id>943-890432</id>
      <name>Andrew Brewster</name>
   </myList>
</root>
</xml>
</html>

HTML المعروض:

سيؤدي الضغط على زر "تنزيل" إلى بدء تشغيل مربع حوار تنزيل الملف القياسي (الذي تم إدخاله بواسطة إطار العمل) كما هو موضح أدناه.

سيؤدي التحميل الناجح إلى وجود ملف CSV:

لتنزيل البيانات من قائمة فرعية، استخدم السمة oraDownloadDataInList بدلاً من oraDownloadData. ستحتوي السمة oraDownloadDataInList على اسم القائمة الفرعية. يتم استخدام المسار X للقائمة الفرعية لاختيار بيانات الصف المحدد من القائمة الرئيسية. ولذلك يتم تنزيل القائمة الفرعية المحددة.

oraDownloadDataUseLabels="true"

يمكن استخدام السمة oraDownloadDataUseLabels جنبًا إلى جنب مع السمة oraDownloadData الموضحة أعلاه. حدد السمة oraDownloadDataUseLabels إذا كنت تريد من ملف القيمة المفصولة بفاصل الذي تم تكوينه استخدام تسميات العناصر الخاصة بعناوين الأعمدة بدلاً من أسماء العناصر.

إنشاء مقاطع مخطط منطقة البوابة

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


المتغير	منطق الاستبدال
[$ZONEDESCRIPTION]	نص وصف المنطقة.
[$SEQUENCEID]	معرف تسلسل المنطقة.
[$ZONENAME]	اسم المنطقة.
[$HELPTEXT]	نص تعليمات المنطقة.
[$ZONEPARAMNAME]	قيمة معلمة المنطقة (أو تركها فارغة إذا لم يتم تحديدها).

تحذير:

ارجع إلى أحد المخططات التالية باعتبارها أمثلة: F1-UIMapHeader وF1-ExplorerHeader.
تستخدم هذه المخططات علامة oraInclude لدمج مقاطع HTML الخاصة بقائمة العناوين وإجراءات إطار العمل. ارجع إلى معلمات نوع المنطقة الخاصة بمقاطع مخطط واجهة المستخدم الواجب تضمينها في HTML الخاص بك.
إذا كنت تريد ظهور أيقونة "نص التعليمات" بجوار وصف المنطقة الخاص بك، يجب أن يكون لديك id="title_[$SEQUENCEID]" في <td> الذي يحتوي على الوصف.
إذا كان من الضروري تضمين جافا سكريبت داخل مقطع مخطط واجهة المستخدم، سيلزم وضع جافا سكريبت داخل علامة ![CDATA[ ]] لضمان وجود مستند XML صالح. لاحظ أنه يمكن أن يتطلب الأمر تعطيل العلامات نفسها لتحسين التوافق مع المستعرضات الأقدم. على سبيل المثال:
```
<script type="text/javascript">

/*<![CDATA[ */

//
//javascript
//
/*]]> */
</script>
```

ملاحظة: إذا كنت تريد الحفاظ على وجود حقل مدخلات الترشيح، داخل مقطع مخطط الترشيح، لإطار العمل الخاص بوظيفتي "للخلف" و"للأمام"، يجب ربط حقل المدخلات (مربع النص، تحديد، إلى آخره) بمعرف HTML فريد. سيتم تسجيل قيم حقل الإدخال المرتبطة بمعرف فريد في "التذكير" الخاص بإطار العمل. يتم استخدام "التذكير" لإعادة إنشاء مخطط المدخلات عندما يتم الانتقال إلى منطقة البوابة باستخدام وظيفتي "للخلف" أو " للأمام".

ملاحظة: توجد دالات متعددة للتحكم في سلوك المنطقة، على سبيل المثال:

oraGetZoneSequence(zoneName). استخدام رمز المنطقة لاسترجاع رقم التسلسل الخاص به.
oraIsZoneCollapsed(sequenceId). استخدام تسلسل المنطقة لتحديد ما إذا كان تم طيها.
oraHandleCollapse(seq). طي المنطقة.
oraHandleExpand(seq,refresh). توسيع و/أو تحديث المنطقة.

كل هذه الدالات وغيرها موجودة بمكتبة JavaScriptuserMapSupport.js الموضحة أدناه.

تحذير: عند تنفيذ oraLoad في مخطط واجهة المستخدم لأحد المقاطع وكان من الضروري أن تقوم بتنفيذ دالة JavaScript أثناء تحميل الصفحة، (حيث تقوم الدالة باستدعاء كائن عمل أو خدمة أعمال أو سكريبت خدمة)، يمكنك استخدام الصياغة الخاصة "oraLoad[$SEQUENCEID]". لمزيد من المعلومات، ارجع إلى قسم إجراء تحميل الصفحة.

عينة oraLoad[$SEQUENCEID] المستخدمة بإحدى الدالات:

<script type="text/javascript">
function oraLoad[$SEQUENCEID]() {
checkRebateClaimStatus();
}
 
function checkRebateClaimStatus() {
    var work = id(''analyticsFilterText[$SEQUENCEID]'',
document).cells[0].innerText.split('' '');
    var rebateClaimId = work[work.length - 3];
    id(''rebateClaimId'', document).value = rebateClaimId;
oraInvokeSS(''C1-CheckRCSt'',''checkRebateClaimStatus'', false);
    var statusIndicator = id(''statusInd'', document).value;
    if (statusIndicator == ''C1PE'' || statusIndicator == ''C1ID'') {
       id(''addRebateClaimLine'', document).style.display = '''';
    } else {
id(''addRebateClaimLine'', document).style.display = ''none'';
    }
}
</script>

F1-ExplorerHeader المعروض:

استدعاء كائن عمل

يمكن استخدام دالة oraInvokeBO بعنوان منطقة البوابة أو مخطط ترشيح المنطقة. يشبه الأمر الموضح في دالة استدعاء كائن عمل التي تتيح إمكانية استدعاء أحد كائنات العمل في HTML الخاص بمخطط واجهة المستخدم. للتعرف على وصف أول ثلاث معلمات، ارجع إلى هذا القسم.


الصياغة	المعلمات	تعليقات
oraInvokeBO( )	'BO Name'
	'XPath' أو فارغ
	'action'
	فارغ	يجب تحديد تلك المعلمة على أنها الوسيطة الرابعة.
	[$SEQUENCEID]	يجب تحديد تلك المعلمة على أنها الوسيطة الخامسة.
	صواب \| خطأ	حدد القيمة صواب في حالة استخدام المقطع بعنوان منطقة البوابة. حدد القيمة خطأ في حالة استخدام المقطع بمخطط ترشيح المنطقة.

مثال بعنوان منطقة البوابة:

oraInvokeBO('CM-User','xmlGroup','read', null, [$SEQUENCEID], true)

استدعاء خدمة أعمال

يمكن استخدام دالة oraInvokeBS بعنوان منطقة البوابة أو مخطط ترشيح المنطقة. يشبه الأمر الموضح في دالة استدعاء خدمة أعمال التي تتيح إمكانية استدعاء إحدى خدمات الأعمال في HTML الخاص بمخطط واجهة المستخدم. للتعرف على وصف أول معلمتين، ارجع إلى هذا القسم.


الصياغة	المعلمات	تعليقات
oraInvokeBS( )	'BO Name'
	'XPath' أو فارغ
	فارغ	يجب تحديد تلك المعلمة على أنها الوسيطة الرابعة.
	[$SEQUENCEID]	يجب تحديد تلك المعلمة على أنها الوسيطة الخامسة.
	صواب \| خطأ	حدد القيمة صواب في حالة استخدام المقطع بعنوان منطقة البوابة. حدد القيمة خطأ في حالة استخدام المقطع بمخطط ترشيح المنطقة.

مثال بعنوان منطقة البوابة:

oraInvokeBS('CM-UserSearch','xmlGroup', null, [$SEQUENCEID], true)

استدعاء سكريبت خدمة

يمكن استخدام دالة oraInvokeSS بعنوان منطقة البوابة أو مخطط ترشيح المنطقة. يشبه الأمر الموضح في دالة استدعاء سكريبت خدمة التي تتيح إمكانية استدعاء سكريبت خدمة في HTML الخاص بمخطط واجهة المستخدم. للتعرف على وصف أول معلمتين، ارجع إلى هذا القسم.


الصياغة	المعلمات	تعليقات
oraInvokeSS( )	"اسم سكريبت الخدمة"
	'XPath' أو فارغ
	فارغ	يجب تحديد تلك المعلمة على أنها الوسيطة الرابعة.
	[$SEQUENCEID]	يجب تحديد تلك المعلمة على أنها الوسيطة الخامسة.
	صواب \| خطأ	حدد القيمة صواب في حالة استخدام المقطع بعنوان منطقة البوابة. حدد القيمة خطأ في حالة استخدام المقطع بمخطط ترشيح المنطقة.

مثال بعنوان منطقة البوابة:

oraInvokeSS('UserSearch','xmlGroup', null, [$SEQUENCEID], true)

اكتشاف التغييرات التي لم يتم حفظها

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

function hasUnsavedChanges(){
       return isDirtyFlag;
   }

إخفاء علامات تبويب البوابة

يوفر المنتج إمكانية استخدام JavaScript لإخفاء علامة تبويب في البوابة الحالية على أساس أحد الشروط باستخدام واجهة برمجة تطبيقات (API) JavaScript التي تخص oraAuthorizeTab. تقبل واجهة برمجة التطبيقات هذه استخدام الدالة على أنها معلمة وتقوم بإيقاف فهرس علامات التبويب المشار إليه.

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

function overrideTabIndex(index){
    if (index == 2) return false;
    if (index == 3) return false;
  }

تتم الإشارة إلى JavaScript على أنه "عند التحميل":

<body class="oraZoneMap"
onLoad="oraAuthorizeTabs(overrideTabIndex);">

مكتبات JavaScript المطلوبة

تعتمد كل الوظائف الموضحة في هذا المستند على زوج من مكتبات JavaScript. إذا كنت تكتب وتنفذ المخططات الخاصة بك بالكامل في إطار عمل عرض مخطط واجهة المستخدم - فلن تكون بحاجة إلى إدراج المكتبات التالية - سيقوم إطار العمل بإدراجها عند عرض مخطط واجهة المستخدم.

تحذير: عند تنفيذ HTML خارج إطار العمل يجب تضمين المراجع التالية بوضوح في HTML الخاص بك. بالإضافة إلى ذلك، يجب أن يكون للأداة التي تستخدمها لعرضHTML صلاحية الوصول إلى نسخة فعلية من privateUserMapSupport.js. لدعم الربط.

src="privateUserMapSupport.js"

يجب أن يشير مستند HTML الخاص بك إلى هذه المكتبة لتنفيذ الربط في بيئة مستقلة.

تحذير: الإشارة إلى الدالات بمكتبة JavaScript هذه أمر خطير - لأن هذه الدالات يملكها إطار العمل ويمكن تغييرها أثناء تحديث الإصدار أو عن طريق عملية مجموعة المعالجة العادية.

<script type="text/javascript" src="privateUserMapSupport.js"></script>

src="userMapSupport.js"

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

ملاحظة: يمكنك الإشارة إلى الدالات بمكتبة JavaScript هذه لكتابة دالات مخصصة ضمن نطاق مخطط واجهة المستخدم.

<script type="text/javascript" src="userMapSupport.js"></script>

onload="oraInitializeUserMap();"

لتنفيذ الربط ببيئة مستقلة، يجب تضمين الدالة التالية الجاري تحميلها في عقدة <body>.

<body onload="oraInitializeUserMap();">