سمات وعُقد المخطط

المحتويات

أنواع العناصر الأربعة

نوع بيانات عنصر الحقل

الإشارة إلى العناصر الأخرى

اعتبارات التوقيت القياسي

سمات التعيين

السمات الوصفية

ثوابت المخطط

الإعداد الافتراضي ومتغيرات النظام

سمات وعُقد الفصل

منطقة البحث

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

إجراء التجاوز لخدمة الأعمال

تحديد "searchBy" لخدمة البحث

تضمين المخططات الأخرى

سمات التوافق

أنواع العناصر الأربعة

يمكن أن يكون عنصر المخطط واحدًا من أنواع البنية الأربعة المختلفة. لاحظ أنه توجد فئتان من أنواع العناصر: قائمة ومجموعة عُقد البنية والبيانات التي تحتوي على عُقد الحقل والقيم الأولية.

<schema>
  <input type="group"
    <userId/>
  </input>
  <output type="group">
    <firstName/>
    <lastName/>
  </output>
</schema>

<parameters type="group" 
mapXML="BO_DATA_AREA" mdField=
"F1_TODOSUMEMAIL_PARM_LBL"/>
  <numberOfDays 
  mdField="F1_NBR_DAYS" 
  required="true"/>
  <frequency 
   mdField="F1_FREQUENCY"/>

<schema>
  <statesList type="list">
    <state isPrimeKey="true"/>
    <description/>
  </statesList>
</schema>

<xml>
  <statesList>
    <state>AK</state>
    <description>Alaska</description>
  </statesList>
  <statesList>
    <state>AL</state>
    <description>Alabama</description>
  </statesList>
...
</xml>

<sendDetail type="raw" />

<sendDetail>
  <messageInfo>
    <senderAddress>123 W. Main St,    Ontario, CA
    </senderAddress>
    <corpZone>3A</corpZone>
  </messageInfo>
</sendDetail>

نوع بيانات عنصر الحقل

لا يمكن أن يوجد نوع بيانات إلا للحقل، من أنواع العناصر الأربعة المختلفة.

<schema>
  <custName dataType="string"/>
</schema>

<schema>
  <count dataType="number"/>
</schema>

<schema>
  <taxRate dataType="number" 
   currencyRef="currency"/>
</schema>

<schema>
  <currency default="USD" 
    suppress="true"/>
  <balance dataType="money" 
   currencyRef="currency"/>
</schema>

<schema>
  <status dataType="lookup" 
   lookup="STATUS_FLG"/>
</schema>

<schema>
  <category dataType="lookupBO" 
   lookupBO="CM-BusinessCategory"/>
</schema>

<schema>
  <allowsEdit dataType="boolean"/>
</schema>

<schema>
  <startDate dataType="date"/>
</schema>

<schema>
  <startDateTime 
  dataType="dateTime"/>
</schema>

<schema>
  <startTime dataType="time"/>
</schema>

<schema>
  <exportDirectory dataType="uri"/>
</schema>

الإشارة إلى العناصر الأخرى

توجد سمات مختلفة تتيح إمكانية الإشارة إلى عنصر آخر في نفس المخطط. الصياغة المدعومة لمرجع المسار X هي نفس الصياغة في كل حالة. يعرض هذا القسم أمثلة باستخدام سمة المرجع الافتراضي (defaultRef).

الإشارة إلى عنصر فرعي:

<schema>
   <id mapField="ACCT_ID" required="true"/>
   <altId defaultRef="id" required="true"/>
</schema>

الإشارة إلى عنصر في مجموعة أعلى:

<schema>
   <id mapField="ACCT_ID" required="true"/>
   <msgInfo type="group" mapXML="XML_FIELD">
     <altId defaultRef="../id" required="true"/>
   </msgInfo>
</schema>

الإشارة إلى عنصر في مجموعة أقل:

<schema>
   <id mapField="ACCT_ID" defaultRef="msgInfo/altId" required="true"/>
   <msgInfo type="group" mapXML="XML_FIELD">
     <altId required="true"/>
   </msgInfo>
</schema>

الإشارة إلى عنصر في مجموعة أخرى:

<schema>
  <acctInfo type="group">
    <id mapField="ACCT_ID" required="true"/>
  </acctInfo>
   <msgInfo type="group" mapXML="XML_FIELD">
     <altId defaultRef="../acctInfo/altId" required="true"/>
   </msgInfo>
</schema>

اعتبارات التوقيت القياسي

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

عند تحديد عنصر بالقيمة dataType="dateTime"، يمكنك اختياريًا تكوين stdTime="true" للإشارة إلى أن البيانات المسجلة في العنصر تمثل التوقيت القياسي دائمًا في المنطقة الزمنية "الأساسية". يتم تحديد المنطقة الزمنية "الأساسية" في خيارات التثبيت.

مثال:

<schema>
  <startTime dataType="Time" stdTime="true"/>
</schema>

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

مثال:

<schema>
  <alternateTimeZone fkRef="F1-TZONE" suppress="true"/>
  <startDateTime dataType="dateTime" stdTimeRef="alternateTimeZone"/>
</schema>

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

<schema>
  <displayTimeZone fkRef="F1-TZONE" suppress="true"/>
  <startDateTime dataType="dateTime" stdTime="true" displayRef="displayTimeZone"/>
</schema>

سمات التعيين

عند إنشاء المخطط الخاص بك، يمكنك الاختيار من إحدى سمات التعيين التالية.

<schema>
  <factId 
   mapField="FACT_ID"/>
</schema>

<persons type="list" 
   mapChild="CI_ACCT_PER"
  <personId mapField="PER_ID"/>
</persons>

<selectList type="list" 
  mapList="DE" 
  <value mapField="COL_VALUE"> 
    <row mapList="DE_VAL"> 
      <SEQNO is="2"/> 
    </row> 
  </value>  
</selectList>

<enrollmentRequest type="group" 
mapXML="CASE_CLOB">
  <messageID/>
  <sender/>
</enrollmentRequest>
<enrollmentKey 
mapXML="CASE_CLOB"/>
<enrollmentInfo type="list" 
mapChild="CI_CASE_CHILD">
  <sequence 
  mapField="CHILD_SEQ"/>
  <name 
  mapXML="CASE_CHILD_CLOB"/>
  <value 
  mapXML="CASE_CHILD_CLOB"/>
</enrollmentInfo>

<questionnaire 
type="list" mapXML="CASE_CLOB">
  <question 
  isPrimeKey="true"/>
  <answer/>
</questionnaire>

<questionnaire type="list" 
  orderBy="page/section, 
page/sequence" 
mapXML="CASE_CLOB">
<question isPrimeKey="true"/>
<answer/>
<page type="group">
  <section/>
  <sequence/>
</page>
</questionnaire>

السمات الوصفية

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

<schema>
  <!-- This schema is used to 
capture business information 
only, please refer to the 
'HUMAN' BO for person 
information -->
</schema>

<schema>
  <active type="boolean" 
description="active account" 
label="Active"/>
</schema>

<schema>
  <active type="boolean" 
description="active account" 
label="Active"/>
</schema>

<schema>
  <logDate mapField="LOG_DT" 
default="%CurrentDate" 
required="true" 
private="true"
</schema>

<schema>
  <active 
mdField="CM_ACTIVE_SW"/>
</schema>

<schema>
  <person fkRef="PER" 
mapField="CHAR_VAL_FK1">
   <row mapChild="CI_SA_CHAR">
      <CHAR_TYPE_CD is="PER"/>
    </row>
  </person>
</schema>

<schema>
  <type mdField="SA_TYPE_CD" 
default="E1" private="true"/>
</schema>

<schema>
    <ls mdField="LIFE_SUPPORT_FLG" 
default="N" suppress="true"/<
</schema>

<schema>
  <email mdField="EMAIL" 
suppress="blank"/>
</schema>

<schema>
  <email mdField="EMAIL" 
suppress="input"/>
</schema>

<schema>
  ...
  <version mapField="VERSION_NBR"
 noAudit="true"/>
  ...
  <workFields type="group"
 noAudit="true"
    <lastProcessedId/>
    <lastProcessedTime/>
  </workFields>
</schema>

<schema>
  <message type="group" storeEmptyNodes="true">
  ...
  </message>
</schema>

<schema emitEmptyGroups="true">
  <message type="group">
  ...
  </message>
</schema>

<schema>
  <messageNumber type="field" emitEmptyElements="true">
  ...
  </message>
</schema>

<schema>
  <messageNumber type="group" adheresToDA="DataAreaName">
  ...
  </message>
</schema>

ثوابت المخطط

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

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

• يتم تحديد قيمة بحث لنوع الخيار للبحث F1CN_​OPT_​TYP_​FLG. على سبيل المثال، M202 - نوع الرسالة الصادرة لإتمام النشاط باسم قيمة Java outmsgCompletion

• المخطط الأساسي المستخدَم في إنشاء الرسالة الصادرة التي تخص "إتمام النشاط"، والتي تشير إلى ثابت المخطط باستخدام اسم قيمة Java لقيمة البحث لنوع الخيار

  ...
  <outboundMessageType mapField="OUTMSG_TYPE_CD" default="%Constant(outmsgCompletion)"/>
  ...

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

يمكن أيضًا استخدام ثوابت المخطط في صياغة الفصل لتحديد عناصر الصف المطلوبة للفصل.

الإعداد الافتراضي ومتغيرات النظام

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

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

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

<schema>
  <perType mapField="PER_OR_BUS_FLG" 
default="P" required="true"/>
</schema>

<schema>
  <frequency dataType="number" 
default="1" required="true"/>
</schema>

<schema>
  <logDate mapField="LOG_DT" 
default="%CurrentDate" required="true"/>
</schema>

<schema>
  <logDateTime mapField="LOG_DTTM" 
default="%CurrentDateTime" 
required="true"/>
</schema>

<schema>
  <startDateTime mapField="START_DTTM" 
default="%StandardDateTime" 
required="true"/>
</schema>

<schema>
  <billDate mapField="BILL_DT" 
default="%ProcessDate" 
required="true"/>
</schema>

<schema>
  <calcDateTime mapField="CALC_DTTM" 
default="%ProcessDateTime" 
required="true"/>
</schema>

<schema>
  <logUser mapField="LOG_USER" 
default="%CurrentUser" 
required="true"/>
</schema>

<schema>
  <timeZone 
default="%CurrentUserTimeZone" 
required="true"/>
</schema>

<schema>
  <custLanguage mapField="CUST_LANG" 
default="%CurrentUserLanguage" 
required="true"/>
</schema>

<schema>
  <currency mapField="CURRENCY_CODE" 
default="%InstallationCurrency" 
required="true"/>
</schema>

<schema>
  <country mapField="COUNTRY" 
default="%InstallationCountry" 
required="true"/>
</schema>

<schema>
  <language mapField="LANGUAGE" 
default="%InstallationLanguage" 
required="true"/>
</schema>

<language mapField="CUSTOMER_LANG" 
default="%Constant(customerLanguage)" 
required="true"/>

<source mapField="PER_ID" 
default="%Context(source)" 
required="true"/>

سمات وعُقد الفصل

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

تحديد القائمة أو الجدول الفرعي

عند فصل الجدول الفرعي، يجب إدخال عقدة الصف لتحديد القائمة/الجدول الفرعي الذي يحتوي على العنصر. في عقدة الصف، يجب تحديد عنصر واحد على الأقل بتعريف is= الذي يضمن أن العنصر صف فريد في قاعدة البيانات. يمكن لعقدة الصف أيضًا تحديد العناصر أو الحقول بالصف، التي تم إيقافها وملؤها باستخدام تكوين القيمة الافتراضية.

• بالنسبة لكائن العمل، تحدد عقدة الصف الجدول الفرعي الذي ينتمي إليه الحقل المنفصل.

  الصياغة هي <row mapChild="table name">. هذا المثال للحصول على قائمة بالأشخاص لحساب في منتج خدمة العملاء والفوترة. يمكن تحديد أحد الأشخاص كشخص "رئيسي". ويوضح هذا كيفية تحديد عنصر واضح لمعرف الشخص الرئيسي لتبسيط المراجع إلى هذا الحقل. وهو جزء من الجدول الفرعي CI_​ACCT_​PER. وما يجعله فريدًا هو أن قيمة MAIN_​CUST_​SW هي true (ولا يمكن أن توجد هذه القيمة إلا لصف واحد)

  <custId mapField="PER_ID" mdField="CM-MainCust">
    <row mapChild="CI_ACCT_PER">
      <MAIN_CUST_SW is="true" />
      <ACCT_REL_TYPE_CD default="MAIN" />
    </row>
  </custId>

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

• بالنسبة لخدمة الأعمال، تحدد عقدة الصف اسم القائمة التي ينتمي إليها الحقل المنفصل.

  الصياغة هي <row mapList="list name">. يعرض هذا المثال إدخالين من القائمة التي يتم فصلها إلى قيمة حقل ووصف.

  <selectList type="list" mapList="DE"> 
      <value mapField="COL_VALUE"> 
  <row mapList="DE_VAL"> 
            <SEQNO is="2"/> 
  </row> 
      </value>  
    <description mapField="COL_VALUE"> 
  <row mapList="DE_VAL"> 
          <SEQNO is="3"/> 
  </row> 
    </description> 
  </selectList>

تحديد القائمة أو الحقل المنفصل بشكل فريد

يتم استخدام الصياغة is= في الصف أو عنصر rowFilter لتحديد الصف بشكل فريد.

<tdTypeCd 
  mapField="CHAR_VAL_FK1">
  <row 
    mapChild="F1_EXT_LOOKUP_VAL_CHAR">
    <CHAR_TYPE_CD 
   is="CM-TD-TYPE"/>
  </row>
</tdTypeCd>

<unitRate mapField="CHAR_VAL" 
  dataType="number">
  <row mapChild=
   "F1_EXT_LOOKUP_VAL_CHAR">
    <CHAR_TYPE is
   ="%Constant(cmRate)"/>
  </row>
</unitRate>

<schema>
  <mainPhone mapField="PHONE">
    <row mapChild="CI_PER_PHONE">
      <PHONE_TYPE_CD 
      is="%Constant(mainPhoneType)"/>
      <SEQ_NUMis="%1"/>
    </row>
  </mainPhone>
</schema>

فصل نوع الخاصية المحددة مسبقًا

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

<usage mdField="STATUS_RSN_USAGE" mapField="CHAR_VAL">
  <row mapChild="F1_BUS_OBJ_STATUS_RSN_CHAR">
      <CHAR_TYPE_CD is="F1-SRUSG"/>
      <SEQ_NUM is="1"/>
  </row>
</usage>

تحديد عناصر متعددة من القائمة

عند محاولة تضمين أعمدة متعددة من نفس القائمة، يوفر النظام مجموعة رموز مختصرة لنسخ قواعد الفصل المحددة في عنصر آخر لكي لا يتطلب تكرار قواعد الفصل. وللقيام بهذا، تحتوي عقدة الصف على السمة rowRef وتشير إلى اسم العنصر الآخر الذي يحدد معلومات التعيين. يوضح المثال التالي طريقة فصل الحقلين "معرف العميل" و"استلام نسخة من الفاتورة" من نفس قائمة الأشخاص للحساب (حيث تكون قيمة MAIN_​CUST_​SW هي true).

<custId mapField="PER_ID">
  <row mapChild="CI_ACCT_PER">
      <MAIN_CUST_SW is="true" />
      <ACCT_REL_TYPE_CD default="MAIN" />
  </row>
</custId>
<copyBill mapField="RECEIVE_COPY_SW" rowRef="custId"/>

لاحظ أن مجموعة الرموز أعلاه توضح أيضًا أنه يمكن تحديد rowRef مباشرةً في تعريف السمة للعنصر.

الفصل على عمق طبقتين

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

<custId mapField="PER_ID">
  <row mapChild="CI_ACCT_PER">
    <MAIN_CUST_SW is="true" />
    <ACCT_REL_TYPE_CD default="MAIN" />
  </row>
</custId>
<legalContact mapField="CHAR_VAL_FK1">
  <row rowRef="custId">
    <row mapChild="CI_ACCT_PER_CHAR" >
       <CHAR_TYPE_CD is="LEGAL" />
    </row>
  </row>
</legalContact>

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

تحديد القائمة المنفصلة

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

بدلاً من عقدة الصف، يتم تكوين القائمة المنفصلة بالعنصر rowFilter. يعرض المخطط التالي المثال الموضح. تحدد عقدة القائمة الجدول الفرعي. ويتضمن rowFilter المعايير التي تحدد الصفوف في الجدول، المطلوب تضمينها. ويتم تحديد عناصر القائمة في عقدة القائمة خارج العنصر rowFilter.

<custId mapField="PER_ID">
  <row mapChild="CI_ACCT_PER">
    <MAIN_CUST_SW is="true" />
    <ACCT_REL_TYPE_CD default="MAIN" />
  </row>
</custId>
<miscPersons type="list" mapChild="CI_ACCT_PER">
  <rowFilter>
    <MAIN_CUST_SW is="false" />
  </rowFilter>
  <relType mapField="ACCT_REL_TYPE_CD"/>
  <personId mapField="PER_ID"/>
</custId>

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

فصل قائمة بتاريخ تفعيل

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

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

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

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

العناصر المنفصلة حيث لا يتم تتبع التغييرات

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

<schema>
  <externalReference mapField="ADHOC_CHAR_VAL" mdField="CM_EXT_REF" dataType="string">
    <row mapChild="CI_SA_CHAR">
      <CHAR_TYPE is="CM_EXT_REF"/>
      <EFFDT is="2000-01-01"/>
    </row>
  </externalReference>
</schema>

العناصر المنفصلة التي لها تواريخ فعالية للتغييرات

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

<schema>
  <price mapField="CHAR_VAL" 
   dataType="number" required="true">
    <row mapChild="CI_SA_CHAR">
      <CHAR_TYPE is="PRICE"/>
      <EFFDT 
   is="%effectiveDate(priceEdate)" />
    </row>
  </price>
<priceEdate mapField="EFFDT" 
  rowRef="price"/>
</schema>

<schema>
  <price mapField="CHAR_VAL" 
  dataType="number">
    <row mapChild="RATE_CHAR">
      <CHAR_TYPE is="PRICE"/>
      <EFFDTTM 
  is="%effectiveDateTime(priceEdatetime)"/>
    </row>
  </price>
  <priceEdatetime mapField="EFFDTTM" 
  rowRef="price"/>
</schema>

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

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

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

<schema>
  <price mapField="CHAR_VAL" 
  dataType="number">
    <row 
  mapChild="CI_SA_CHAR">
      <CHAR_TYPE is="PRICE"/>
      <EFFDT
   is="%effectiveDate"/>
    </row>
  </price>
</schema>

<schema>
  <price mapField="CHAR_VAL" 
   dataType="number">
    <row mapChild="RATE_CHAR">
      <CHAR_TYPE is="PRICE"/>
      <EFFDT 
    is="%effectiveDateTime" />
    </row>
  </price>
</schema>

منطقة البحث

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

search="search zone"

يمكن استخدام سمة البحث في مخطط واجهة المستخدم، ويتم استخدامها لإنشاء سمة مخطط واجهة المستخدم oraSearch آليًا. وتعتبر منطقة البحث منطقة مستكشف تم تكوينها كبحث.

<person fkRef="PER" search="C1_PSRCH"/>

searchField="search field:element|'literal';"

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

حقل البحث: element|'literal'. يمثل حقل البحث مرشح منطقة البحث المطلوب ملؤه عند بدء التشغيل. ويكون العنصر هو عنصر المخطط المستخدَم لملء المرشح. ويعتبر العنصر اختياريًا، في حالة تركه فارغًا، سيتم تعيينه افتراضيًا للعنصر الذي تم تحديد هذه السمة عليه. وتصبح أيضًا قيمة searchField هي literal كقيمة إدخال.

<person fkRef="PER" search="C1_PSRCH" searchField="PERSON; PER_TYPE:personType;"/>

searchOut="search field:element;"

لا يمكن استخدام السمة searchOut إلا بالتزامن مع سمة البحث. ويتم استخدام السمة searchOut لإنشاء سمة مخطط واجهة المستخدم oraSearchOut. ويتم استخدام القيمة searchOut لتسجيل القيمة المحددة من منطقة البحث ونقلها إلى عنصر مخطط واجهة المستخدم. يجب أن تتطابق القيمة searchOut المحددة مع رمز اختصار ELEMENT_​NAME في معلمة منطقة نتائج البحث.

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

<person fkRef="PER" search="C1_PSRCH" searchField="PER_ID" 
searchOut="PER_ID;PRIMARY_PHONE:personPhone;"/>

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

سيتم فرض حماية خدمة التطبيق عند استدعاء كائن العمل أو سكريبت الخدمة من سكريبت مساعد عمليات الأعمال (BPA) أو مخطط واجهة المستخدم، ولكن ليس من سكريبت الخدمة. في حالة ما إذا كنت تريد فرض الحماية عند استدعاء كائن العمل أو سكريبت الخدمة من سكريبت الخدمة، يجب إضافة السمة التالية إلى مخطط سكريبت الخدمة.

appSecurity="true"

السمة appSecurity غير متاحة إلا لمخططات سكريبت الخدمة. وفي حالة تحديدها، سيتم تقييم خدمة التطبيق، الخاصة بأي كائن عمل أو سكريبت خدمة تم استدعاؤه مباشرةً بواسطة سكريبت الخدمة، للوصول.

<schema appSecurity="true">
  ...
</schema>

إجراء التجاوز لخدمة الأعمال

في حالة ما إذا كنت تريد استدعاء خدمة الأعمال بإجراء آخر غير "قراءة"، يجب تحديد سمة الإجراء في العقدة الأساسية بمخطط خدمة الأعمال.

pageAction="add, change, delete"

يتم استخدام سمة الإجراء لتجاوز الإجراء الافتراضي "قراءة" في مخطط خدمة الأعمال. القيم الصالحة هي:

• إضافة

• تحديث (غير مسموح به إلا لخدمة كائن الصيانة)

• تغيير (غير مسموح به لخدمة كائن الصيانة)

• حذف

• قراءة (وهو الإجراء الافتراضي في حالة عدم تحديد pageAction)

مثال:

<schema pageAction="change">
  <parm type="group">
    <ele1/>
    <ele2/>
  </parm>
</schema>

تحديد السمة searchBy لخدمة البحث

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

searchBy="MAIN"

يمكن العثور على قيم السمة searchBy عن طريق عرض مخطط XML المرتبط بخدمة الأعمال، استخدم "عرض عنوان URL لمخطط XML". والقيم النموذجية هي:

• MAIN

• ALT

• ALT2

• ALT3

• إلخ

<schema searchBy="MAIN">
  <AccountID mapField="ACCT_ID"/>
  <Results type="list">
    <AccountID mapField="ACCT_ID"/>
  </Results>
</schema>

تضمين المخططات الأخرى

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

يتطلب تضمين المخطط جزأين:

1. عقدة التضمين
2. سمة الاسم

يوضح الجدول التالي عبارات التضمين المدعومة.

<schema>
  <cust type="group">
<includeBO name="C1-Person"/>
</cust>
  <spouse type="group">
<includeBO name="C1-Person"/>
</spouse>
</schema>

<schema>
<includeBS name="F1-ReadMOLog"/>
</schema>

<schema>
<includeDA 
   name="F1CommonSchemaFieldData"/>
</schema>

<schema>
<includeMP 
   name="F1-DisplayRecordActions"/>
</schema>

<schema>
<includeSS name="F1-ActShowZn"/>
</schema>

سمات التوافق

تمت إضافة هذه السمات كجزء من الترقيات من الإصدارات السابقة لتطبيق "إطار العمل".

fwRel="2"

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

<schema fwRel="2"
    ...
</schema>