لكي تقوم باضافة تقرير جديد الى ReportDefintions.xml، يجب تكوين قالب تقرير في Crystal Reports Designer.
لاضافة تقرير جديد الى ReportDefinitions.xml:
- قم باستخدام برنامج تحرير XML لفتح ملف ReportDefinitions.xml، الموجود على <ier_install_path>\Config.
- قم بايجاد المصفوفة الخاصة بنموذج البيانات الذي يتم استخدامه في (FPOS) الخاص بك. ويتضمن ملف xml مصفوفة لتقارير DoD، وتقارير DoD المصنفة، وتقارير PRO، وتقارير BASE.
- قم باضافة شارة قيمة جديدة (على سبيل المثال، <value>42</value>).
هذه القيمة هي عبارة عن رقم صحيح يقوم بتعريف التقرير الذي تقوم بتكوينه في Crystal Reports Designer، ويعتبر متفرد لكل من التقارير. هذه القيمة تساوي عدد التقارير الموجودة زائد 1.
- في <List key="ReportDefinitions">، قم باضافة <object
key="reportDefinition">، للتقرير الجديد الخاص بك. اذا كانت هناك تقارير موجودة تشبه التقرير الذي تقوم بتكوينه:
- قم بفتح مفتاح العنصر reportDefinition بالكامل للتقرير الموجود في الملف XML.
- قم بلصق مفتاح العنصر الذي تم نسخه في مكان آخر من الملف XML.
- قم بتعديل مفتاح العنصر reportDefinition للتقرير الجديد الخاص بك من خلال تغيير أو اضافة قيم الى الشارات التالية كما يلزم.
n هو العدد الذي قمت بادخاله في الخطوة 3 السابقة.
<setting
key="id">n</setting>.
<setting key="title"
localizationKey="server.report_title.n">report
name</setting>، حيث report name هو عنوان التقرير الذي يقوم IBM® Enterprise Records بعرضه.
<setting
key="desc" localizationKey="server.report_desc.n">description</setting>، حيث
description هو النص الذي يقوم بقوم IBM Enterprise
Records بعرضه، والذي يقدم وصف مختصر لأغراض التقرير. على سبيل المثال، "يقوم هذا التقرير بعرض وحدات التخزين التي تم فتحها/اغلاقها خلال فترة محددة."
<setting
key="reportName" localizationKey="server.report_name.n">filename.rpt</setting>،
حيث filename هو اسم قالب التقرير الذي تم تكوينه في Crystal Reports Designer.
<setting key="img">relative
path to image file</setting> وهذه تعتبر قيمة اختيارية لادراج الرسم البياني. على سبيل المثال، images/action/report.gif.
- لاستبعاد التقرير الخاص بك من (FPOS) محدد، قم بادخال الشارات التالية:
<array key="excludedObjectStores">
<value>fpos</value> </array>
حيث fpos هو اسم FPOS الذي سيتم استبعاد التقرير الجديد منه. يمكنك اضافة شارات قيمة اضافية لاستبعاد التقرير من أكثر من واحد من FPOS.
- قم باضافة معيار التقرير، مثل أماكن FPOS، والتصرفات، والأحداث، والجداول الزمنية، والتواريخ.
- تحت <object key="reportDefinition">، قم باضافة <list
key="properties">، اذا لزم الأمر. اذا كان قد تم نسخ مفتاح العنصر reportDefinition
من التقرير الموجود، فان <list key="properties:> موجود بالفعل.
- تحت مفتاح كشف الخصائص، قم باضافة أو تعديل مفتاح محددات الاسم الرمزي، كما يتطلب الأمر لكل من معايير التقرير. اذا كنت قد قمت بتكوين أي من المعايير الجديدة، قم باضافة مفاتيح تحديد الاسم الرمزي للمعيار الجديد هنا أيضا.
اتبع كل من مفاتيح محددات الاسم الرمزي بهذه الشارة: <setting key="required"> 0 أو 1 </setting>، لتوضيح ما اذا كانت القيمة مطلوبة أم لا. 0 تشير الى أنه لا يستلزم أن يقوم المستخدم بتعليم أحد الاختيارات أو ادخال قيمة، بينما 1 تشير الى أن المستخدم مطالب بالقيام بذلك.
قم بتضمين كل من أزواج الأسماء الرمزية ومفاتيح التحديد المطلوبة بهذه الشارة: <object key="property"> </object>.
على سبيل المثال:
<object key="property"> <setting
key="symbolicname">symbolic name</setting>
<setting key="required">1</setting> </object>
حيث symbolic name هو المعيار الجديد الذي تقوم بتكوينه، أو أي من مفاتيح التحديد التالية:
- fileplan_browse - توجه IBM Enterprise
Records للسماح للمستخدم بالانتقال الى مكان ما بتخزين عنصر مخطط الحفظ.
- ros_browse - توجه IBM Enterprise
Records للسماح للمستخدم بالانتقال الى مكان ما بتخزين عنصر السجلات.
- start_date - تاريخ البدء لمعيار التقرير.
- end_date - تاريخ الانتهاء لمعيار التقرير.
- application_type - نوع السجل الذي سيتم استخدامه كمعيار، مثل PDF و DOC و XLS وأخرى.
- security_category - تتوقف محددات السرية، مثل مصنف، سري، سري للغاية، أخرى، على نمط البيانات.
- review_decision - قرار المراجعة، بما يتضمن الاعتماد أو الرفض.
- action - التصرف طبقا للعنصر، مثل فتح أو اغلاق.
- disposal_schedule - الجدول الزمني للتخلص الخاص بالعنصر.
- disposal_action - تصرف التخلص بناء على العنصر، مثل نقل أو مراجعة أو نقل مؤقت أو اتلاف.
- disposal_action_export - تصرف التخلص على أحد العناصر بعد عملية التصدير.
- report_type - لتوجيه IBM Enterprise
Records لعرض الاختيارات الدائرية ملخص أو تفصيلي.
- disposal_trigger - الحدث الذي يقوم ببدء تخلص العنصر مثل، تاريخ أو اغلاق أحد الحاويات أو حدث خارجيا
بالنسبة الى ros_browse و security_category و disposal_action و disposal_action_export و
review_decision واطلاق حدث التخلص، يقوم IBM Enterprise
Records باسترجاع القيم المفترضة من Content Engine عند التشغيل ويقوم بعرضهم في القائمة والتي يمكن للمستخدم تحديد قيمة منها.
- اذا كان التقرير الخاص بك يقوم باستخدام أنواع العنصر كمعيار:
- تحت مفتاح كشف الخصائص، قم باضافة الاسم الرمزي entity_type، متبوع بالعبارة "required" وتحدد المفتاح (1=required، 0=not required).
على سبيل المثال:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
- قم باضافة <list key="values"> حيث يتم ادخال أنواع العنصر التي يمكن للمستخدم تحديدها للتضمين في التقرير. على سبيل المثال:
<list key="values">
<object key="value">
<setting key="id">EntityType</setting>
<setting key="value" localizationKey=serve.report_n.EntityType">Entity</setting>
</object>
حيث
- EntityType هو RecordCategory أو RecordFolder أو السجل.
يمكنك تضمين كل أنواع العناصر الثلاثة، ولكن يجب أن يتم تضمين كل منهم في شارات <object key="value"> منفصلة.
- n هو الرقم الذي تم تعريفه في الخطوة 3 السابقة.
- Entity تصنيف السجل أو حافظة السجل أو السجل.
بيئات التشغيل المترجمة تتطلب "localizationKey."
على سبيل المثال، اذا كان التقرير الخاص بك يتضمن احصائيات عن تصنيفات التقرير وحافظات التقرير، فان هذا القسم من ملف XML سيكون مماثل لما يلي:
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">Record Category</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
</object>
</list>
</object>
- اذا كان التقرير الخاص بك يقوم باستخدام تصرفات التصنيف:
تحت مفتاح كشف الخصائص، قم باضافة الاسم الرمزي classification_action، متبوع بالعبارة "required" وتحدد المفتاح(1=required، 0=not required).
على سبيل المثال:
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
قم باضافة <list key="values"> حيث يتم ادخال تصرفات التصنيف التي يمكن للمستخدم تحديدها للتضمين في التقرير. على سبيل المثال:
<list key="values">
<object key="value">
<setting key="id">ClassificationAction</setting>
<setting key="value" localizationKey=serve.report_n.ClassificationAction">ClassificationAction</setting>
</object>
حيث:
- ClassificationAction هو تطوير النسخة أو تقليل النسخة أو تقليل فئة التصنيف. يمكنك تضمين كل تصرفات التصنيف الثلاثة، ولكن يجب أن يتم تضمين كل منهم في شارات <object key="value"> منفصلة.
- n هو قيمة "كود التعريف" الخاصة بهذا التقرير في المصفوفة الخاصة بنمط البيانات.
بيئات التشغيل المترجمة تتطلب "localizationKey."
على سبيل المثال، اذا كان التقرير الخاص بك يتضمن احصائيات عن تصرفات تقليل النسخة والغاء التصنيف، فان هذا القسم من ملف XML سيكون مماثل لما يلي:
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">Declassification</setting>
</object>
</list>
</object>
- بعد أن تقوم بادخال كل معايير التقرير:
- قم باغلاق <list key="properties"> باستخدام </list>.
- قم باغلاق <object key="reportDefinition"> باستخدام </object>
- قم بحفظ ملف XML.
- أعد بدء وحدة خدمة تطبيق الانترنت حيث يتم تشغيل IBM Enterprise
Records لكي يظهر تأثير التغييرات.
عند الانتهاء من التعديلات، فيجب أن يكون قسم مفتاح العنصر reportDefinition مماثل لما يلي:
<object key="reportDefinition">
<setting key="id">22</setting>
<setting key="title" localizationKey="server.report_title.42">Records
Manager Classification Update Report</setting>
<setting key="desc" localizationKey="server.report_desc.42"> يقوم هذا التقرير بعرض العناصر
التي تم تغيير تصنيفاتها في فترة محددة.</setting>
<setting key="url">RMViewReport.jsp</setting>
<setting key="img">images/action/report.gif</setting>
<setting key="reportName" localizationKey="server.report_name.42">Classification Update.rpt</setting>
<list key="properties">
<object key="property">
<setting key="symbolicName">fileplan_browse</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicName">start_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">end_date</setting>
<setting key="required">1</setting>
</object>
<object key="property">
<setting key="symbolicName">report_type</setting>
<setting key="required">0</setting>
</object>
<object key="property">
<setting key="symbolicname">entity_type</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">RecordCategory</setting>
<setting key="value" localizationKey=serve.report_42.RecordCategory">Record
Category</setting>
</object>
<object key="value">
<setting key="id">RecordFolder</setting>
<setting key="value" localizationKey=serve.report_42.RecordFolder">Record Folder</setting>
</object>
<object key="property">
<setting key="symbolicname">classification_action</setting>
<setting key="required">1</setting>
<list key="values">
<object key="value">
<setting key="id">Downgrading</setting>
<setting key="value" localizationKey=serve.report_42.Downgrading">Downgrading</setting>
</object>
<object key="value">
<setting key="id">Declassification</setting>
<setting key="value" localizationKey=serve.report_42.Declassification">Declassification</setting>
</object>
</list>
</object>
</list>
</object>
</list>
</object>