learn crystal reports

Learn Crystal Reports [email protected]

1

com.yahoo@2005net_Solo _net.link@naserFared

ARAB TEAM 2000

PDF created with pdfFactory trial version www.pdffactory.com

mailto:[email protected]

http://www.pdffactory.com


2

المقدمة

وتمكنن ا Visual Studio.NET ف ي الرئی سیة للتق اریر األداة ھ ي CRYSTAL REPORTSتعتب ر م دویق . ال ی ستطیع تنفی ذھا غی ر المحت رفین أش كال ف ي ك وین تق اریر معق دة تع رض البیان ات م ن ت األداةھ ذه

Crystal Reports داخ ل بیئ ة متكامل ة للمب رمجین وس ائل Visual Studio.NET تق وم ھ ذه عرض مشاركة التقاریر والمعلومات على شبكة الوب ویتمیز , رؤیة وتحلیل البیانات إمكانیات بتوفیر األدوات

بالتفاع ل الق وى م ع الم ستخدمین ع ن طری ق ت وفیر HTML باستخدام أوالتقاریر سواء باستخدام الویندوز التقریر والبحث عن النصوصفيوسائل مثل التنقیب عن البیانات باستخدام الرسوم البیانیة التجول

ریبورت بتقدیم واجھ ات لت صمیم كریستالفي تكوین التقاریر یقوم مولد التقاریر فيوبدال من استخدام الكود ب سھولة وس رعة یطل ق عل ى ھ ذه الواجھ ات م صطلح خب راء إلیھ ا نحت اج الت يوص یاغة التق اریر

وھ ى تمث ل ب رامج یمك ن ع ن طریقھ ا االختی ار ب ین مجموع ة متنوع ة م ن ) Report Experts(التق اریر ض الرسوم البیانیة التى تمكن المستخدم من الخطابات عرإعداد تبداء من التقاریر القیاسیة الى التيالتقاریر

ت م المئوی ة ولق د الفرعی ة والن سب واإلجمالی ات اإلجمالی اتتتب ع البیان ات و الوص ول ال ى التف صیالت ح ساب . بیئة التطویرأجزاء باقي یصبح جزءا متكامال مع لكيتصمیم مولد التقاریر

ادوات تكوين التقارير

اع مختلفة من االدوات المطلوبة لتكوين التقارير يشمل ذلك ادوات تصميم يحتوى كريستال ريبورت على انو التقارير ادوات مشاهدة التقارير وادوات الوصول الى مصادر البيانات

ادوات تصميم التقارير

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

كما يشمل واجهات المساعدة فى تصميم التقرير والتى يطلق .االداة الرئسية المستخدمة فى صناعة التقارير عليها خبراء التقارير

crystal reportsمصم تقارير :ت الى االقسام التاليةوينفسم مصمم تقارير كريستال ريبور

report designerمصمم التقرير • crystal reports toolbar شريط االدوات • field explorer مستكشف الحقول •

مصمم التقرير

ينقسم التقرير فى نافذة مصمم التقرير الى خمسة اقسام رئيسية ويمكن اخفاء بعض هذه االقسام او اضافة مـؤخرة ,موخرة التقريـر ,فسم التفصيالت ,مقدمة الصفحة ,مقدمة التقرير : اقسام اخرى تشمل هذه االقسام

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

مقدمة التقرير

ويحتوى قسم مقدمة ,دمة التقرير مرة واحدة فى بداية التقريريجرى طباعة الكائنات الموضوعة فى قسم مق التقرير بصفة عامة على عنوان التقرير والمعلومات االخرى التى نريد اظهارها فقط فـى بدايـة التقريـر وتحتوى الرسوم البيانية والجداول المتقاطعة التى توضع فى هذا القسم على بيانات تخص كامل التقرير كما

.لموضوع يتم تقييمها مرة واحدة فقط فى بداية التقريران الصيغ ا

مقدمة الصفحة

الكائنات التى توضع فى مقدمة الصفحة يتم طباعتها فى بداية كل صفحة ويحتوى قسم مقدمـة الـصفحة بصفة عامة على المعلومات التى نريد طباعتها فى قمة كل صفحة يمكن ان يشمل ذلك حقول النصوص مثل





3

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

قسم التفصيالتذى تظهر به معظم بيانـات التقريـر يحتوى هذا القسم على البيانات التى تكون جسم التقرير وهو القسم ال

ويجرى طباعة الكائنات التى توضع فى هذا القسم بالنسبة لكل سجل من سجالت البيانات على سبيل المثال سجل سوف يقوم التقرير بطباعة مائة قسم 100اذا اضفنا كائن قاعدة بيانات الى هذا القسم ويحتوى على

الـصيغ الموجـودة يـتم لرسوم البيانية والجداول المتقاطعة تفصيالت فى وقت التشغيل وال يمكن وضع ا تقييمها مرة بالنسبة لكل سجل

مؤخرة التقرير

الكائنات الموضوعة فى مؤخرة التقرير تطبع مرة واحدة فى نهاية التقرير ويستخدم هذا القسم لكى يحتوى االجماليات النهائية وتحتـوى علـى على المعلومات التى نريد اظهارها مرة واحدة فى نهاية التقرير مثل

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

مؤخرة الصفحة

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

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

جديدة

مقدمة المجموعة سم عن اضافة مجموعة الى التقرير قبل قسم التفصيالت مباشـرة ويـتم طباعـة الكائنـات يظهر هذا الق

الموضوعة فى هذا القسم فى بداية كل مجموعة جديدة ويحتفظ هذا القسم فى االساس بحقل اسم المجموعة قيـيم كما ايضا يمكن استخدامه لعرض الرسوم البياناية التى تشتمل على بيانات خاصة بالمجموعة ويتم ت

الصيغ الموضوعة فى هذه القسم فى بداية المجموعة

قسم ذيل المجموعةيظهر هذا القسم عند اضافة مجموعة الى التقرير بعد قسم التفصيالت مباشرة ويتم طباعة الكائنات التـى تحتوى علىها فى نهاية كل مجموعة ويحتوى هذا القسم بصفة عامة على قيم االجماليات الفرعية ويمكن

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

وتتوقف البيانات التى تظهر فى التقرير التام على خيارات التصميم التى يحددها المبـرمج وعلـى وجـه تارها الدراج كائنات التقرير المختلفـة علـى الخصوص تتنوع بيانات التقرير على اساس االقسام التى نخ

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

رسم بيانى منفصل سوف يظهر فى بداية كل مجموعة بيانات شامال البيانات المتعلقة مقدمة مجموعة فان بالمجموعة فقط





4

Field Explorerنافذة تعديل او حذف حقول تقرير يعرض هذه النافذة شجرة تتكون من حقول قاعدة البيانـات , وتستخدم الدراج

ايضا الـصيغة المعامـل اسـم Field Explorer وحقول خاصة يمكن اضافتها الى التقرير ويبين مربعالمجموعة االجمالى المتحرك والحقول غير المرتبطة بادوات التحكم التى سبق تعريفهـا لالسـتخدام فـى

التى تم اضـافتها الـى التقريـر وبجانـب الحقـول التقرير ويعرض ايضا عالمات اختيار بجانب الحقول المجموعـات , عمليات حسابية مثل حقـول الـصيغ المستخدمة بواسطة حقول اخرى او المستخدمة فى :االجماليات المتحركة والملخصاتولمشاهدة هذا المربع

document outline ثم نختارview فى قائمة other windowsنشير الى -1 ننقر بزر الماوس االيمن على اى حقل لمشاهدة القائمة المختصرة الخاصة باختياراته-2

Report Expertsخبراء التقاريريمكن استخدام مصمم كريستال ريبورت لتكوين تقرير بدون استخدام ادوات صـناعة التقـارير المتـوفرة بالنظام كما يمكن استخدام ادوات خبراء التقارير للمساعدة فى عملية التصميم فيما يلـى قائمـة بخبـراء

:التقرير التى يحتوى عليها كريستال ريبورت standerdتقرير قياسى -1 form letterنموذج الخطابات -2 formنموذج -3 cross-tabجداول متقاطعة -4 subreportتقرير فرعى -5 mail labelعنوان بريدى -6 drill downتتبع التفصيالت -7

كل اداة من هذه االدوات تقودنا خالل عملية تكوين التقرير عن طريق تزويدنا بسلسلة من الجداول ويحتوى

ول مساعدة خاصة بانواع معينة من التقاريرالكثير من هذه االدوات على جدا

خبير التقرير القياسىتعتبر هذه االداة االكثر استخداما بين جميع ادوات خبراء تقارير كريستال ريبورت وتحتوى علـى ثمانيـة

االخرى ويقوم خبير التقرير القياسى بقيادتنـا expertجداول الكثير منها شائع االستخدام بواسطة ادوات عملية اختيار مصدر البيانات والربط مع جداول البيانات كما يساعدنا فى اضـافة الحقـول وتحديـد خالل

وفى النهاية يقودنا الـى تكـوين المجموعات وتموين االجماليات تحديد معيار الفرز الذى نريد استخدامه تلفة تـرتبط بـصفحات الرسوم البياناية واختيار السجالت وترتبط هذه االداة بمربع حوار به ملصقات مخ

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

خبير اعداد الخطابات

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

خدام جدول الخطابات الستيراد نص سبق تكوينه من تطبيق اخرالخطاب ويمكن ايضا است

خبير اعداد النماذج

كـشوف ,قواتير الـشركة (يتيح لنا خبير النموذج تكوين التقارير يمكن طباعتها على نماذج سابقة التجهيز باالنماذج ومع انه يماثل خبير التقارير العادية الى حد كبير اال انه يحتوى على جدول خاص ) الخ,حسابات

كةرالسابق تجهيزها تتيح لنا اختيار اشكال تتناسب مع شعار الش





5

اول المتقاطعةدخبير الجتقودنا هذه االداة خالل عملية تكوين تقرير يتم فيه عرض البيانات فى صورة متقاطعة ومن بين الملصقات

التى تـساعدنا علـى customize styleوملصقcroos-table ملصقstyleالتى يحتوى عليها ملصق ذاتهاتكوين وصياغة البيانات المتقاطعة

خبير التقارير الفرعية

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

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

خبير ملصقات عناوين البريد

ين البريد من اى حجم وللقيام بـذلك يتيح لنا هذا الخبير تكوين تقرير خاص بالطباعة على ملصقات عناو الختيار نوع الملصق التجارى كما يمكنننا تعرف مخططاتنا من الصفوف واالعمدة ال labelنستخدم صفحة

نمط من التقارير متعددة االعمدة

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

ويقدم لنا هذا الخبير كل وظائف خبير التقارير القياسية ومن اهـم الملـصقات التـى drilldownالتنقيب الذى يعرض قائمة بالقسام التى يمكن اخفاؤهـا وال drillيحتوى عليها مربع حوار خبير التقارير ملصق

ويمكـن اسـتخدام البيانـات المخفيـة فـى ناسبتظهر االقسام المختفية الى ان يتم النقر على الحقل الم الملخصات والمجاميع

ادوات الوصول الى التقارير ومصادر البيانات

يحتاج المستخدم الوصول الى التقرير لقراءته كما يحتاج التقرير للوصول الى مصدر البيانات للحصول على لتقرير هـى اداة مـشاهدة التقـارير بنمـاذج البيانات االداة االرئيسية التى توفر للمستخدم الوصول الى ا

الويندوزمن ناحية اخرى يستطيع التقرير الوصول الى مصادر البيانات باستخدام محرك قواعد البيانات التى يحنوى

عليها كريستال ريبورت

اداة مشاهدة التقاريرام المستخدمين على الشاشة تستخدم اداة مشاهدة التقارير نماذج الويندوز لعرض تقاريركريستال ريبورت ام

ويجب ربط هذه االداة مع التقرير لكى يمكـن اسـتخدامهاوتوجد هـذه االداة فـى شـريط االوات باسـم crystalreportviewerوتحتوى على عدة خصائص للتحكم فى شكل وسلوك التقرير

تصدير التقارير

:لصيغ االمتاحة فى كريستال للتصدير هىويقصد بالتصدير تحولية الى انواع اخرى من الملفات والتقارير وا1-adobe acrobat (.pdf) 2- crystal reports for vs.net(.rpt)





6

3- HTML 3,2 an 4.0 (.html) 4- Microsoft excel (.xls) 5- Microsoft rich text(.rtf) 6 – microsft word (.doc)

بـشريط االدوات exportخالل اسـتخدام زر تصدير التقارير من crystalreportviewer وتدعم االداة crystal reports for vs.net(.rpt) وHTMLالخاص به الى كل صيغ التصدير المذكورة مـا عـدا ويمكن استخدام الكود لتعديل خيارات تصدير التقارير

طباعة التقارير

التقرير يمكن تزويد المستخدمين بخيارات الطباعة من خالل شريط ادوات اداة مشاهدة

محركات البياناتتستخدم محركات البيانات فى وقت التصميم للتعرف على مخططات البيانات ولكى يتم تحديد هذه المخططات

ومحركات , ODBCمحرك , OLEDB استخدام محرك يجب اجراء اتصال مع قواعد البيانات من خالل EXEL/ACCESS كزنة كما يتم االتصال مـع محـر للحصول على الجداول والمشاهد واالجراءات المخ

ADO.NET للحصول على مخطط بيانات فى صورة ملف XML وفى وقت التشغيل تـستخدم التقـارير نفس محركات البيانات المستخدمة فى اعداد التقارير واذا تم دفع البيانات الى كريستال ريبـورت سـوف

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

محرك قاعدة البيانات

قاعدة البيانات المستخدم معها

OLEDB اى قاعدة بيانات تدعمOLEDB

ODBC اى قاعدة بيانات بها محركODBC

Access\Excel برنامج اكسس واكسل

ADO.NET اعد البيانات التى تدعم هذه التقنيةقو

Field Definition اليستخدم مع قواعد االبيانات

CDO اليستخدم مع قواعد البيانات

تصميم تطبيقات التقارير

:بدء التقرير وتحديد مصدر البيانات

توى عليها التقرير اول مهام تصميم التقرير هى تحديد مصادر البيانات المستخدمة لتوريد البيانات التى يح وهناك العديد من مصادر البيانات التى يمكن استخدامها اال ان اهم هـذه المـصادر هـو فئـات البيانـات

DataSets





7

:تكوين تقرير جديد ننقر بزر الماوس االيمن على المشروع لعرض قائمة مختصرةsolution explorerفى نافذة .1 add new item وننقر على addنشير الى .2 وننقر فتح crystal reportهر مرع حوار نختار منه يظ .3 وبه ثالث خياراتcrystal reports galleryيظهر مربع حوار .4يقودنا خالل عملية تكوين التقرير واضافة اختياراتنا الـى مـصمم -االول استخدام خبير التقارير .5

التقارير -الثانى يفتح تقرير خالى .6 يؤدى الى تكوين تقرير جديد بنفس تصميم تقرير اخر-الخيار االخير استخدام تقرير موجود .7 okننقر .8

عند اختيار خبير التقارير يظهر مربع حوار خبير التقارير نختار البيانات المطلوبة لكل مجلد وبعدها ننقـر finish للوصول الى مصمم التقرير الخاص بينا

:اختيار مصدر بيانات التقرير





8

ع مصادر البيانات كما يمكن تغيير مصدر البيانات الذى يستخدمة التقرير بعـد يمكن ربط كائنات التقارير م اجراء االتصال بين كائن التقرير وبين مصدر البيانات وفى حالة استخدام التقرير الكثر من جدول يمكن ربط

الجداول معا

اختيار مصادر البيانات وربطها بالتقريرثم نختـار بنـد database fieldوس االيمن على بند ننقر بزر الماfield explorerفى مربع -1

add/remove database فى حالة عدم وجود اتصال مع مصدر بيانات يجب تكوين اتصال بالنقر على احد مصادر البيانات -2

ثم اختيار مورد البيانات المطلوب من مربع حوار مورد البياناتى ان نجـد جـداول مـصدر البيانـات نتصفح المجلدات الdatabase expertفى مربع حوار -3

المستخدم >> اعداد تقرير منها ثم ننقر على الزر الخاصنختار الجداول التى تحتوى على البيانات التى نريد -4 ok فى مربع االحوار ثم ننقر selected tablesباضافتها الى جانب -5

:sqlاستعالم \تكوين جداول افتراضية بناء على امر الخاصة بنا عن sql يمكن كتابة اوامر sql البيانات التى نستخدمها تدعم اوامر لغة االستعالماذا كانت قاعدة

فى مربع حوار خبير التقارير ويترتب على ذلك تكوين جول افتراضى يمثـل add commandطريق زر عالجة البيانات االوامر يمنح ذلك مستخدمى قواعد البيانات المتمرسين القدرة على احكام الرقابة على م هذه

:خاص بالمستخدم sqlلتكوبن كائن امر . التى تدفع الى الخادم ثـم ننفـر field explorerننقر بزر الماوس االيمن على يشفشالشسث بهثمس فـى مربـع -1

add/remove database





9

نتصفح المجلدات الى ان نصل الى مصدر البيانات الخـاص database expertفى مربع حوار -2 بنا

add commandمصدر البيانات ننقر نقرا مزدوجا على عقدة اسفل -3 ندخل االمر او االستعالم المناسب لمصدر البيانات add command to reportفى مربع حوار -4 field يترتب على ذلك العودة الى مصمم التقرير وظهور الجدول االفتراضى فى مربـع okننقر -5

explorer

:تغيير موقع مصدر البيانات لالشارة الى االسم او الموقع الجديد للجداول النشطة فى التقرير ويعتبر ذلـك set locationخدم امر نست

مفيدا عند استقبال تقرير يستخدم قاعدة بيانات توجد بموقع مختلف على النظام او عنـد تغييـر الـدليل ا تيكيا بتحويل محرك البيانات اتو مset locationباالضافة الى ذلك يقوم امر . الخاص بقاعدة البيانات

الذى نستخدمه الى مصدر البيانات الذى نقوم باختياره :لتغيير مصدر موقع بيانات

يؤدى set location ثم ننقر databaseننقر بزر الماوس االيمن فى مصمم التقرير نشير الى -1 ذلك الى عرض مربع حوار

صدر البيانات الذى نرد تغييره نختار جدول م current data source listمن قائمة -2 نتصفح الى ان نصل الى مصدر البياناتreplace withفى قائمة -3 نختار الجدول المراد التغيير اليه -4 replaceننقر -5 بعد االنتهاء من تغيير كل الجدداول التى نريد تغييرهاcloseننقر -6

:ربط جداول البيانات

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





10

الحد العمالء فـى orders لكى يتم تخصيص كل امر فى جدول customers وجدول ordersبين جدول customersجدول

للربط بين جداول قاعـدة database expert من مربع حوار link لية الربط نستخدم ملصق وللقيام بعم حيث تقوم اتوماتيكيا باختيار الروابط بين auto-linkالبيانات واسهل طريقة للربط بين الجداول هو اختيار

اليـدوى بـين الجاول على اسا الحقول المشتركة فى هذه الجداول او حقول مفهرسة ويمكن ايضا الربط لترتيب هذه الروابطorder linksجداول قاعدة البيانات واذا كان لدينا العجيج من الروابط يمكننا استخدام

ادراج حقول قاعدة البيانات فى التقرير

والدراج احـد field explorerيقوم كريستال ريبورت بعرض كل حقول قاعدة البيانات المتاحة فى مربع :الحقول بالتقرير

لكى نتمكن من مشاهدة جـداول database field نوسع عقدة field explorerفى مربع حوار -1 قاعدة البيانات

نوسع جدول قاعدة البيانات ونختار حقل البيانات المستهدف ويمكن مشاهدة قيمة الحقل الذى يتم -2 من القائمة browse dataوس االيمن ثم اختيار اختياره وكذلك نوع وحجم الحقل بالنقر بزر الما

المختصرة يعرض مربع الحوار الناتج فئة فرعية من قيم الحقل مع اسم الحقل نوعه وطوله او اى قسم اخر بالتقريرdetailsنسحب الحقل الذى تم اختياره الى قسم -3

:استخدام فئات البيانات فى اعداد التقرير

يجب تكوين كائن فئة بيانات ثم االتصال مع ذلـك datasetsخدم فئات البيانات قبل اعداد التقاير التى تست الكائن وبالنظر الى ان كائن فئة البيانات ال يحتوى على البيانات اثناء التصميم لذلك ال يمكن تصفح بيانات

اوال دفع الحقول فى مصمم التقارير وولتمكين التقرير من عرض البيانات الحقيقية فى وقت التشغيل يجب ع كائن تقريرمالبيانات الى كائن فئة البيانات ثم ربط فئة البيانات

اضافة التقارير الى التطبيقات

:االضافة المباشرة للتقرير

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

الموجودة فى النظام ويبين ملف تصنيف التقرير االقسام التى يتكون منها هذا ReportClassالتصنيف التقرير وال يجب ان يقوم المبرمجين بتغيير هذه االقسام

:اضافة التقارير من خالل مكونات التقارير الغير نوعية

Untyped)ن اختيار ادراج احد التقارير فى نموذج ويندوز عن طريق اضافة مكون تقارير غير نوعىيمكReport Component) الى النموذج اوال ثم تحميل المكون بملف التقرير بعد ذلك .

وال يتم تكوين تصنيف خاص به فى وقت reportdocumentيتبع مكون التقارير الغير نوعية تصنيف سبب ربطه مع التقرير فى وقت التشغيلالتصميم ب

:الضافة مكون تقرير غير نوعى الى النموذج نتبع االتى فى صندوق االدوات الى النموذجcomponent من صفحة report documentنسحب مكون -1 untyped reportdocument نختار تصنيف choose a reportdocumentفى مربع حوار -2

تقرير غير نوعىلى ذلك اضافة مكونيترتب ع

الخاصة بتصنيف loadولتحميل مكون تقرير غير نوعى باحد التقارير نستدعى الطريقة reportdocument على سبيل المثال لتحميل مكون التقرير غير النوعى المسمى reportsdoc1

Reportdoc1.Load("c:\my Rreport.rpt") كن ربط هذا المكون مع اداة عد تحميل ملف طباعة فى مكون تقرير غير نوعى يمب

crystalReportViewer





11

:اضافة التقارير من خالل مكونات التقارير النوعية

يسمح (typed report document)يمكن اضافة تقرير نزعى الى النموذج من خالل مكون تقرير نوعى تضافة التقرير عن لنا ذلك بضبط خيارات الطباعة الخاصة بالمكون فى نافذة الخصائص ويمكن ايضا اس

طريق ربطه مع اداة مشاهدة التقارير

:ربط التقارير مع ادوات مشاهدة التقارير يجب ربط كائن التقرير (crystalreportviewer)قبل ان نستطيع عرض تقرير فى اداة مشاهدة التقارير

و وقت التشغيل ويمكن الربط فى وقت التصميم اreport sourceمع االداة يتم ذلك عن طريق خاصية سواء

:ربط التقارير غير المضافة الى التطبيق

عندما توجد التقارير فى صورة ملفات على الكمبيوتر غير المضافة الى المشروع محل التصميم توجد ثالث : طرق للربط

:ربط التقرير باستخدام اسم ملف التقرير

على اسم ملف report source نضبط خاصية viewerالجراء الربط فى الخصائص الداة • التقرير

الجراء الربط عن طريق الكود نقوم بتحديد مسار واسم الملف للتقرير •

Crystalreportviewer1.reportsource="c:\\reports\\my report.rpt"

:ربط التقرير غير المضاف باستخدام كائن تقرير نفتح محرر الكود بالنقر المزدوج على النموذج االساسى -1 : باضافة مجاالت االسماء التاليةنقوم -2

3- Imports CrystalDecisiions.CrystalReports.Engine 4- نعرف متغير عام على مستوى النموذج -5

Public WithEvents oRpt As ReportDocument

رثم بعد ذلك نربطه مع اداة مشاهدة التقاري للنموذج نستخدم كائن التقرير فى تحميل التقريرnewفى وسيلة

Public Sub New() MyBase.New() oRpt= new ReportDocument oRpt.load(c:\\reports\\my report.rpt) Crystalreportviewer1.reportsource=oRpt End Sub

:الربط باستخدام مكون تقرير غير نوعى كون بالملف الى النموذج ثم تحميل المreportdocument1نفترض اضافة مكون تقرير غير نوعى باسم

c:\\reports\\my report.rpt يمكننا ربط مكون التقرير غير النوعى مع اداة viewer عن طريق report sourceخاصية

:ربط التقارير المضافة الى التطبيق

عن طريق استخدام مكون تقرير نوعى او اعن viewerيمكن ربط التقارير المضافة الى التطبيق مع اداة ثيل من تصنيف التقريرطريق انشاء م

:الربط باستخدام كائن تقرير





12

الى rpt.عند اضافة احد التقارير الى مشروع تطبيق ويندوز يتم تلقائيا اضافة ملف تصنيف امتداده المشروع خاص بهذا التقرير ويمكن تكوين كائن من هذا التصنيف وربطه مع اداة مشاهدة التقارير هكذا

CrystalReportViewer1.ReportSource=New My_Report()

:ربط التقرير باستخدام مكون تقرير نوعىباستخدام نافذة من خالل مكون تقرير نوعى viewerيمكن ربط التقرير المضاف الى المشروع مع متحكم

الخصائص او باستخدام الكود :كائنات التقرير

)Database Field(حقول قاعدة البيانات • )Formula Fields(حقول صياغة • )Parameter Fields(حقول معامالت • )Group name Fields(حقول مجموعاات • (SQL Expression Fields)حقول تعبيرات لغة االستعالم المركبة • (Running Total Fields)حقول االجمالى المتحرك • (Summary fields))الملخصات(الحقول االجمالية • (Charts)الرسوم البيانيه •

:الحقولدوران كائنات

text rotation يمكننـا اسـتخدام خيـارات format editor فى مربع حوار commonتحت ملصق درجة270, 90لتصفيف كائنات الحقول والنصوص راسيا على التقرير ويمكننا تحريك النص

:منع بتر النصوصتفاع هذا االطار علـى عند وضع كائن نص على التقرير يتم تمثيله باطار على وجه مصم التقارير يعتمدار

ارتفاع بنط الحروف المستخدم بينما يتحدد العرض على اساس الكائن الذى نتعامل معه وبغض النظر عـن عرض الكائن سواء كان العرض االفتراضى او عرض تم تغييره بواسطة المستخدم يمكن ان نواجه مشكلة

بتر النص عند الطاعـة وقـد يبـدو زيادة طول النص المطبوع على عرض كائن النص مما يترتب عليه التقرير فى صورة جيدة على الجهاز المستخدم فى تصميمه اال انه عند الطباعة باستخدام محـرك طابعـة

مختلف يتمدد طول النص ويبقى اطار الكائن ثابتا مما يؤدى الى بتر النص اساس عرض الحقل فى يتقرر العرض على memoبة لحقول قاعدة البيانات غير الحقول من نوع بالنس

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

ويختلف العرض االفتراضى لحقـول االرقـام علـى اسـاس نـوع البيانـات الرقميـة التـى تحتـوى (byte,integer,double….etc)عليه

:لمنع بتر نص داخل كائن formatننقر بزر الفارة االيمن على الكائن المراد صياغته ثم ننقر .1 can grow ونختار مربع commonفى مربع الحوار ننقر على ملصق .2

للحفظ ويترتب على ذلك صياغة الكائن للطباعة على سطور متعددة فاذا كانت طباعة النص اكبـر okننقر -عرض الكائن فان النص يجرى استكماله فى سطور اضافيةمن

:منع تداخل النصوص

يجب تجنب تصميم التقارير حيث تكون المسافة بين الكائنات ضيقة جدا بل يجب ترك مسافة للنمو الناتج تقريبا واذا لم يكن ذلك ميسرا يجب انقاص حجم الخط%5عن توسيع عرض الكائن بنسبة

:منع بتر االرقام

اذا كانت قيمة رقمية او قيمة عملة اكبر من الحقل الذى يحتوى عليها فان الوضع الطبيعى هو بتر او قص يمكن ان يـؤدى 1000 يمكن ان تظهر ف التقرير 100000000هذه القيمة على سبيل المثال قيمة مثل





13

سوف يتم تمثيـل Allow Field Clippingذلك الى حدوث ارتباك عمد قراءة التقرير وعند ازالة خيار لالشارة الـى ان الحقـل (#########)القيم الرقمية والنقدية التى تتجاوز حجم الحقل بالعالمات الرقمية

.صغير بالنسبة للرقم

:التحكم فى بيانات التقريريتناول هذا القسم عمليات التحكم فى البيانات التى يحتوى عليها التقرير وطريقة عرضـها تـشمل هـذه

لعملياتاتكوين االجماليات الفرعيـة ,فرز البيانات ,تكوين المجموعات وتلخيصها ,ضبط المعامالت ,ترشيح البيانات

. البياناتوتنسيقاستخدام الصيغ ,والمتحركة

:ترشيح البيانات يبين لنا هذا القسمم كيفية ترشيح البيانات التى نريد وضعها فى التقرير ويتم ترشيح البيانـات باسـتخدام

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

:اختيار السجالت

سجالت بالجدول المستخدم يجرى طباعتهـا عند اختيار سجل لعرضه على تقرير فأن قيم الحقول فى كل ال افتراضيا غير انه فى حاالت كثيرة قد ال نريد وضع جميع هذه القيم فى التقرير ولكن فقط طباعة فئة فرعية

لتوفير هذه االمكانية يحتوى كريستال ريبورت على لغة صياغة معقدة يمكن استخدامها .من هذه القيم لتوفير select(كمـا يحتـوى علـى اداة خبيـر االختيـار . انواع اختيار السجالتافتراضيا لتحديد اى نوع من

expert( على هـذا االسـاس يمكـن . التى تقوم بقيادة المستخدمين فى عملية تكوين االختيارات المختلفة التفريق بين طريقتين الختيار السجالت فى كريستال ريبورت

سجالت لمعالجة اساسيات اختيار الselect expertاستخدام -1 اختيار السجالت باستخدام الصيغ -2

: السجالتتحديد الحقول التى نستخدمها فى اختيار

عند اختيار سجالت فان ذلك يعنى بناء التقرير على سجالت تتوافق مع الشروط التى قمت بتحديدها وتعتمد ا نريد تكوين تقرير هذه الشروط على نوع البيانات التى نريد عرضها بالتقرير نفترض على سبيل المثال انن

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

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

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

المنطقةعلىنطاق الرموز البريدية التى تتبع هذه اذا كان الجدول يحتوى على حقل خاص بكود المنطقة يمكن اختيار المنطقة بناء عغلى قيمة هذا *

الحقل

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

البيانات وعند تحديد صيغة الختيار السجالت فى تقرير يعتمد بدفع معايير اختيار السجالت الى خادم sqlعلى مصدر بيانات اس كيو ال يقوم كريستال ريبورت بتحليل هذه الصيغة وتكوين استعالم على

:اساسها وتمرير االستعالم الى خادم اس كيو ال يتم بعد ذلك تنفيذ االستعالم على مرحلتين





14

السجالت يقوم خادم قاعدة البيانات بمعالجة االستعالم واعاددة فئة من فى المرحلة االولى من اختيار* السجالت الى كريستال ريبورت

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

:الية من معايير اختيار السجالت يمكن دفعها الى خادم اس كيو الاالنواع الت االختيار باستخدام الحقول المفهرسة وغير المفهرسة* and,or مع عبارات sql االختيار باستخدام استعالامات * التى تنفذ صيغة العمليات الحسابية الخاصة باختيار السجلsqlحقول تعبيرات *

ك صيغ ال يمكن تنفيذها على الخادم يوضح المثال التالى مزايا كتابة صـيغ اختيـار ويجب مالحظة ان هنا فـى قاعـدة بيانـات orders ان جـدول نفترض. السجالت التى يمكن تنفيذها على خادم قاعدة البيانات

xtreme ونفترض اننا نريد اعداد تقرير عن 1998 سجل يقع فى تاريخ سنه 169 سجل منها 2001 به :سجالت فقط يمكننا استخدام صيغة االختيار التاليةتلك ال

Year({Orders.Order Date})<1998 الـى كريـستال 2001 الناتج عن هذه الصيغة سوف يقوم بارسال كل السجالت البالغ عددها sqlاستعالم

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

where الن الدالة yearاليمكن تنفيذها على خادم البيانات من ناحية اخرى يمكن استخدام صيغة االختيار التالية

{Orders.Order Date}<#jan 1,1997# على الخادم وبالتالى ينتج االستعالم الذى تكونه هذه الصيغة يحتوى فقط علىيمكن تنفيذ الصيغة الثانية

169سجل تعاد الى كريستال ريبورت

فى تكوين معايير الترشيحselect expertاستخدام يجعل خبير االختيار من السهل اختيار السجالت التى نريد استخدامها فى تقاريرناوعند العمل مع هذه االداة

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

select expert ثم ننقر علـى reportننقر بزر الماوس االيمن على مصمم التقرير نشير الى • chose fieldيترتب على ذلك عرض مربع حوار

لى الحقل الذى نريد استخدامه فى عملية االختيار ثم ننقر علـى فى مربع الحوار نركز الضوء ع • ثم اختيار الحقل التالىnewويمكننااختيار اكثر من حقل بالنقر على ملصق . موافق

نستخدم القوئم المنسدلة الدخال معيار االختيار بالنـسبة للحقـل select expertفى مربع حوار • السابق اختياره فى الخطوة السابقة

عند االنتهاءokقر نن •





15

اعداد صيغ االختيار بواسطة المستخدم Edit Selection نختـار reportننقر بزر الماوس االيمن على مصمم التقارير نـشير الـى •

Formula يترتب عى ذلك عرض مربع حوار record selectuion formula editor نافذة او االختيار من اشجار المكونـات فى مربع الحوار ندخل الصيغة فى مربع االدخال باسفل ال •

(field tree,function tree,operator tree) للتعرف على اى اخطاء فى الصيغةcheckننقر زر • نصحح اخطاء الصيغة ان وجدت • بعد التحقق من صحة الصيغةsave and closeننقر •





16

:قوالب صيغ اختيار السجالت

قوالب للمساعدة فى تكوين الصيغ الخاصة بنا باستخدام مربـع حـوار يمكن استخدام امثلة الصيغ التالية selection formula editor

"c"بالحرف (file.field)اختيار السجالت التى تبداء فيها قيمة الحقل

{file.field} startswith "c"

c"" بالحرف (file.field)اختيار السجالت التى ال تبداء فيها قيمة الحقل

Not ({file.field}startswith "c")

"999" تساوى (file.field) فى حقل 5 الى 3اختيار السجالت التى تكون المفردات من

"999" in {file.field} [3 to 5]

"cycle"اختيار السجالت التى تكون فيها قيمة الحقل تحتوى على السلسلة

"cycle" in {file.field}

99999 فيها قمة الحقل اكبر من اختيار السجالت التى تكون

{file.field} >99999

99999اختيار السجالت التى تكون فيها قيمة الحقل اقل من

{file.field}<99999

99999 واقل من 11111اختيار السجالت التى تكون فيها قيمة الحقل اكبر من

{file.field} > 11111 and {file.field} <99999

1999الت التى تكون فيها قيمة التاريخ اقل من سنة اختيار السج

Year {{file.field})<1999

:ضبط المعامالت بحث مستخدم التقرير على ادخال معلومات ويمكن النظر الـى المعامـل (parameters)تقوم المعامالت

ـ ات التـى يـدخلها على انه سؤال يجب على المستخدم االجابة عليه قبل انتاج التقرير وتقـرر المعلوم المستخدم او الطريقة التى يجيب بيها ما سوف يظهر على التقرير

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

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

:تصميم حقول المعامالت





17

ثم ننقـر علـى parameter fields االيمن على ننقر بزر الماوسfield explorerفى مربع -1new

name ندخل اسم للمعامل فى مربع حقل creat parameter fieldفى مربع حوار -2 وهو النص الذى يظهر فى مربـع حـوار prompting textندخل نص الحث المناسب فى حقل -3

enter parameter value عند تجديد بيانات التقرير(refreshing) ع القيمةندخل نو -4 نحدد الجول والحقل بالنسبة لقيمة المعاملset default valuesننقر -5 لتحريك اى قيمة الى منطقة القيم االفتراضية يؤدى ذلك الى تمكين المستخدم مـن >>ننقر على -6

اختيار اى قيمة فى منطقة القيم االفتراضية ok ثم ننثر creat parameter field يترتب على ذلك ظهور مربع حوار okننقر -7 نسحب المعامل ونضعه فى التقرير -8

تحديد نوع وصيغة االدخال فى المعامالت

فى حقل (edit mask) يمكننا اختيار قناع ادخال stringعند تحديد القيم االفتراضية لحقل معامل من نوع edit maskلرموز المستخدمة بدال من تحديد نطاق للقيم ويممكن ان يكون قناع االدخال اى مجموعة من ا

لتقييد القيم التى يمكن ادخالها فى حقول المعامالت وفيما يلى بيان بالحروف المستخدمة فى تكـوين اقنـة :االدخال• "A"يسمح بادخال الحروف واالرقام ويفرض ادخال رمز فى قيمة المعامل • "a"يسمح بادخال الحروف واالرقام وال يفرض ادخال رمز فى قيمة المعامل يسمح بادخال االرقام من صفر الى تسعة و يفرض ادخال رمز فى قيمة المعامل" 0" • يسمح بادخال االرقام او المسافات وال يفرض ادخال رمز" 9" • يسمحبادخال رقم،مسافة،او عالمة زائد وناقص وال يفرض ادخال رمز" #" •• "L" يسمح بادخال حرف [A TO Z]ويفرض ادخال رمز





18

يفرض ادخال رمز فى قيمة المعامليسمح بادخال حرف وال "؟" •• "C"يسمح بادخال اى مسافه او رمز وال يفرض ادخال رمز رموز فاصلة تستخدم للفصل فى قناع االدخال",;:-"/ • (LOWERCASE)يسبب تحويل الرموز التالية له الى الحجم الصغير " <" • (UPPER CASE)يسبب تحويل الرموز التالية له الى الحجم الكبير " >" • يسبب عرض الحرف التالى له بدون تغيير فى قيمة المعامل"\" •• "PASSWORD "يسمح لنا باستخدام القناع الدخال كلمات المرور الى اقسام التقرير المختلفة

انتهى الجزء االول




learn crystal reports

Documents