مكتبة لعمل تقارير بـ MS Word 2007

التقارير Reports هي المخرج الاساسي والاهم في تطبيقات قواعد البيانات ، ومن هنا تأتي أهمية التقارير ، وعلى المبرمج او المطور الاهتمام بالتقرير شكلا ومضمونا بطريقة تجعل المستخدم النهائي للتقرير يجد البيانات في منتهى السهولة ويستطيع التعامل معها، ففي بعض الاحيان قد لا يكتفي زبونك بنسخه مطبوعة من التقرير وانما تحتاج الى نسخه الكترونية ، البعض يرى الافضلية ان تكون على هيئة PDF والبعض قد يرى تصديرها بصيغة MS Word,MS Excel افضل خصوصا ان Microsoft Excel يوفر لك امكانيات احصائية وحسابية كبيرة تساعدك في احيان عديدة جداً. وقد يرى البعض ان جعل الصورة النهائية للتقرير بهيئة Word سيكون افضل من الناحية الشكلية خصوصا ، كما ان تصميم تقرير على هيئة Microsoft Word سيكون اسهل من استخدام برامج مخصصة للتقارير في بعض الاحيان كـ Crystal Reports او اداة التقارير الموجودة في Visual Studio نظرا لسهولة عملية التصميم وإمكانيات التنسيق والتنظيم الكبيرة الموجودة في برنامج كـ Microsoft Word 2007 .

وجدت مكتبة صغيرة  وهي تسهل عملية كتابة التقارير بصيغة Word2007 ( docx) وذلك انها تغنيك عن التعامل مع أي مكتبة من مكتبات برنامج Word بل لا تحتاج اصلا إلى وجوده لتقوم بتوليد تقرير بهيئة Word ، والسر في ذلك ان هيئة ملفات Word2007 ما هي الا عبارة عن ملف مضغوط بصيغة zip يحتوي على عدة ملفات xml وبالتالي فالعملية لا تعدو انشاء قالب ببرنامج Word2007 ثم استخدام هذا القالب في كل مره ووضع البيانات عليه !

لتحميل المكتبة من هنا:
http://www.zshare.net/download/54213236ceabcdfb/

المصدر :

http://www.codeproject.com/KB/printing/embedword.aspx

عمل تقرير MasterDetails بواسطة أداة تقارير Visual Studio

كثيرا ما نحتاج الى عمل تقرير من نوع Master Details حيث يكون لدينا جدولان مرتبطان بعلاقة One to Many . في هذا المقال اتناول كيفية عمل تقارير بهذا الشكل .

المرحلة الاولى : تهيئة الإتصال بقاعدة البيانات وكائن الـ Dataset :

سأستخدم في هذا المثال قاعدة البيانات Northwind كالعادة ، والجدولان Orders,OrderDetails تحديدا ( لا شيء مختلف حتى هنا ) وسم الـ Dataset الجديد كما يحلو لك فلن احتاجه في شرحي ( عجيبه اليس كذلك !! ) . الآن توجه الى الـ Datset لنقوم هناك ببعض التعديلات ونبدأ ” العربدة ” !

ما سنقوم به هو اضافة TableAdapter وهو ما يشبه الجدول الافتراضي Virtual Table نضيف للـ Dataset بأنفسنا وننفذ عليه جمله استعلام SQL كما يحلو لنا ، فهو مثل الـ View في SQL Server او Query في Access ، نقوم فيها بتحديد كافة الحقول المطلوب عرضها في التقرير من الجدولين الاب والإبن معا ، وبدون هذا لن تفلح في الشروع بالعمل واحفظ ساعات من التجارب قضيتها بلا جدوى !

الآن للعمل ، ولنضف كائن Table Adapter جديد :

من المعالج الظاهر انقر على زر Next مرتين ، ثم في المرحلة الثالثة منه ضع جملة SQL التالية :

SELECT Orders.[Order ID], Orders.[Customer ID], Orders.[Order Date], Orders.[Shipped Date], [Order Details].[Order ID] AS Expr1, [Order Details].ID,
[Order Details].[Product ID], [Order Details].Quantity, [Order Details].[Unit Price]
FROM (Orders INNER JOIN
[Order Details] ON Orders.[Order ID] = [Order Details].[Order ID])

بعدها تنهي المعالج مباشرة بالضغط على زر Finish ، وتأكد من ان اسم الجدول الجديد هو Order_Details_Report وبهذا تنتهي هذه المرحلة وننتقل الى المرحلة التالية :

المرحلة الثانية : تصميم التقرير :

الآن نقوم بتصميم التقرير وهي مرحلة تحتوي العديد من الخطوات الصغيرة والسهله ، نقوم اولا بتحديد مصدر البيانات report Data Source ليكون الجدول الإفتراضي الذي انشاناه في المرحلة السابقة ونسبه الكامل OrdersDataSet_Order_Details_Report .

ثم نقوم بإضافة أداة List جديدة الى جسم التقرير ، ثم نقوم بتعديل الخاصيه DatasetName لتكون OrdersDataSet_Order_Details_Report ثم نعدل الخاصيه Grouping ونضع الحقل OrderID كمفتاح تجميع كما بالصورة التالية :

بعدها نضيف الحقول OrderId,CustomerId,OrderDate,ShippedDate الى داخل الـ List ، ثم نقوم بإضافة اداة Table لعرض البيانات الفرعيه وهي الحقول ProductID,Quantity,UnitPrice وذلك بسحب هذه الحقول من نافذة الـ Datasources ( الظاهره في الزاوية اليمنى العلوية من الصورة السابقة )الى الجدول مباشرة . بعدها ننتقل الى الزاوية العلوية اليسرى من اداة الجدول ونضغط بالزر الايمن عليه ونختار Properties من القائمة التي تظهر ، ثم انتقل الى التبويب Groups بعدها انقر على رز Edit Details Group واجعل الحقل ProductID ليكون مفتاح تجميع القيم في اداة الجدول .

الصورة التالية توضح الخطوتين السابقتين :

الخطوة التالية : لا لا يوجد أي خطوات فقد انتهى كل شيء كل ما عليك هو وضع اداة Report Viewer على احد النوافذة windows Forms وعرض التقرير عليها لترى النتيجة شامخة :

واذا كنت مستوعبا لما ذكرناه هنا ، وما ذكرناه حول عمل تقرير لسجل معين ، فيمكنك ان تقوم بعمل تقرير MasterDetails لأي سجل مراد بكل سهوله واترك هذا لكم لتكتشفوه في المرفق .

تحياتي

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

الطريقة الأخرى اسهل اذا اردنا مجرد عرض سجل واحد فقط ، وهي عمل Filter للبيانات في مصدر التقرير قبل ان تصل التقرير، طبعا بمجرد قيامك بإضافة اداة ReportViewer وتحديد تقرير معين موجود في المشروع سيتم اضافة عدة ادوات تلقائيا الى النافذة منها Dataset,TableAdapter,bindingSource ، فعملية الوصول الى مصدر البيانات من خلال الكود سهله جدا .

الفكرة هنا اننا سنقوم بعمل كائن DataView نستخدمه في فلترة البيانات حسب الحقل المميز للمصدر والذي يكون في العادة ID ، بعد ذلك نقوم بحذف كائن الـ ReportDataSource الخاص بالكائن ReportViewer.LocalReport ، ونضيف كائن جديد نعمله بانفسنا .

في حالتي استخدم الجدول Employees من قاعدة البيانات Northwind ولدي Dataset بالإسم EmployeesDataset وفي التقرير مصدر البيانات DataSource اسمه EmployeesDataset_Employees ،وقد اضفت الى النافذة المطلوبة شريط ادوات ToolStrip به أداة Label,TextBox,Button ليقوم المستخدم بإدخال الـ ID ،

بالنسبه للكود ، فقد قمت بحذف السطر التالي من الحدث Load للنافذة :

ثم قمت بإستيراد فضاء الأسماء :

وفي حدث النقر Click للزر المدعو tsbtnshowReport :

وقد وضعت تعليقات توضح الكود جيدا ، الفكرة في الكود اننا قمنا بعمل Replace لكائن الـ ReportDataSource بآخر جديد تم اعطاؤه سجل واحد فقط One Row Only لذلك سيتم عرض سجل واحد فقط على التقرير

في الرابط التالي المثال كاملا

تحياتي

عمل تقرير لعرض سجل معين

لاحظت كثرة الأسئلة حول كيفية عمل تقرير لسجل واحد فقط ، وللأسف فإن اغلب السائلين لا يحددون نوع التقارير المستخدم ، وايضا هذا السؤال يتكرر بكثرة ، فقمت بعمل مثال مبسط حول حل هذا السؤال بواسطة اداة التقارير الخاصة بفيجوال ستوديو Microsoft Reporting Tool بواسطة الاصدار 2008 وهي لا تختلف كثيرا عن 2005 لكن لايوجد لدي الاصدار 2005 ، مع ذلك سأقوم بشرح الطريقة فلا تقلقوا

فكرة الحل :

يكمن الحل في عمل filter لبيانات التقرير بإستخدام حقل مميز للسجلات – في مثالي استخدمت قاعدة البيانات الشهيرة Northwind والجدول Customers تحديدا ، في ذلك الجدول ، الحقل Id هو المميز والذي لا يتكرر في كل الظروف – لذلك سنقوم بعمل Parameter ونضعه في الـ filter الخاص بالتقرير ، ثم نمرر قيمته بواسطة الكود قبل عرض التقرير على النافذة .

الحل :
نقوم بعمل مشروع جديد ونضيف له مصدر بيانات جديد New Data Source ثم نحدد قاعدة البيانات Northwind بعدها نختار الجدول customers فقط ونقوم بتسمية الـ Dataset بأي إسم نرغبه ، وليكن CustomersDataset ثم ننهي المعالج بالطبع .

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

بداية نذهب الى القائمة Report ونختار الأمر Data Sources ومن هناك نقوم بإضافة الـ Dataset الذي قمنا بإضافته توا للمشروع ثم نغلق مربع الحوار .

بعدها تأتي الخطوة الاهم على الإطلاق ،نذهب الى القائمة Report مجددا ونختار Report Parameters لتظهر لنا النافذة التالية :

نقوم بإضافة Parameter جديد ونحدد نوع ليكون Integer ثم نكتب إسمه وليكن CustomerID ثم نضغط على زر OK .

الآن نقوم بإضافة اداة Table وعليها الحقول المطلوبة ( لا اشرح هذه العملية هنا !! ) ثم نقوم بالضغط بالزر الأيمن على ال table في الزاوية العلوية اليسرى بعدها نختار Properties ، ومن النافذة الظاهره نختار Filter ثم هناك بإضافة filter جديد للـ grid ونختار الـ Operator الخاص بالمساواة ، ومن العمود Value نختار من القائمة المنسدلة Expression ومن نافذة ال Expression Editor نختار Parameters وسنرى هناك الباراميتر الذي قمنا بإضافته سابقا ، سنقوم الآن بالضغط على نقرا مزدوجا ثم نضغط على زر OK ونغلق النافذة .

الآن نذهب الى النافذة التي ستعرض التقرير ونضيف في البداية شريط ادوات ToolStrip وبه ثلاث أدوات بالترتيب :
- Label : نكتب عليه نص توجيهي للمستخدم وليكن filter Customer ID ،
- TextBox : اسمه tstxtCustomerID
- Button : اسمه tsbtnshowReport وليكن بالنص فقط ونصه Show Report .

الآن نقوم بوضع اداة Microsoft Report Viewer على النافذة ومن Choose Reports نختار التقرير الذي اضفناه سابقا .

ثم نذهب الى محرر الاكواد الخاص بالنافذة ونضيف فضاء الأسماء التالي :

ثم نقوم بحذف السطر :

من الحدث Load الخاص بالنافذة form .

بعدها نقوم بكتابة كود للزر tsbbtnShowReport في حدث النقر Click ونكتب الكود التالي :

شرح الكود :
في السطر الاول قمنا بإنشاء مصفوفة من النوع ReportParameter ونختار العنصر الأول فيها ( رقم صفر ) ليكون كائنا جديدا من النوع ReportParameter، وبإستخدام المشيد Constuctor نعطه الوسائط Arguments المطلوبة كما يلي :
- ParameterName : وهنا نكتب اسم الباراميتر الذي اضفناه في التقرير سابقا .
- Value : وهنا قيمة التقرير ، وهي قيمة الشرط في الـ filter ،

ثم نقوم بإضافة الباراميترات الى التقرير من خلال السطر :

بعدها نقوم بإظهار محتويات التقرير بالسطر:

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

اخيرا الفكرة المستخدمه هنا بالباراميترات يمكن استخدامها لعرض البيانات بين مجالين او تجميع او اي شيء تحتاجه تضع مكانه اسم الباراميتر بإستخدام الـ Expression Editor وتجعل تقاريرك ديناميكية اكثر .

لتحميل المثال المذكور يرجى النقر هنا

عرض التقرير على نافذة WindowsForm :
لنفترض أنه يوجد لديك نافذة في مشروعك اسمها Form1 وتود عرض التقرير عليها ، فكل ما عليك القيام به هو ما يلي :
1. أضف الاداة Reportviewer على النافذة من المجموعة Data في صندوق الأدوات ToolBox .
2. سيظهر لك الجزء ReportViewer Tasks اختر منه اسم ملف التقرير المطلوب والذي سيكون في حالتنا Report1 من الخيار Choose Report .

سيتم عمل اللازم بشكل تلقائي ، قم بتشغيل تطبيقك لترى النافذة وقد ظهرت بالشكل التالي :

مبروك لقد قمت بعمل أول تقرير لك ! ما رأيك الآن بهذا النوع من التقارير وسهوله التعامل معه وتصميمه وما إلى هناك ؟ طبعا لاحظ انك لن تحصل على نفس الشكل وذلك لانني قمت ببعض التنسيقات البسيطه على التقرير حتى يظهر بشكل اوضح ، وبالنسبه لك تستطيع تقليدها بأسرع من البرق !

ألم تقتنع بعد بأنه أسهل من CrystalReports بعد ؟ حسنا تابع الأجزاء التالية .

تجميع البيانات الظاهرة على أداة Table :
في اغلب تقاريرنا نحتاج إلى اظهار البيانات على شكل مجموعات حسب قيمه حقل معين ، كإظهار موظفي جامعة أهلا عرب لوحدهم ( لا يوجد لدينا موظفين ! ) وموظفي VB4ARAB لوحدهم ( ولا اعتقد لديهم موظفين ! ) ، أدوات تقارير visual studio توفر لك اغلبها إمكانية التجميع Grouping ومن يرفض منها فسنفعل ذلك رغما عنها ( كما سنذكر لاحقا ) ، ولعمل group أساسية ( حيث يمكن عمل الكثير من الـ Groups بأنواع أخرى ) نتبع الخطوات التالية :

1. ( يا عيني على المبرمجين ! ) من نافذة خصائص الأداة Table1 نختار لسان التبويب Groups ثم Details Grouping وستظهر لنا نافذة جديدة ( ستعتاد قريبا على كثره النوافذ المتوالدة في هذا النوع من التقارير ) .
2. من النافذة الظاهرة ومن لسان التبويب General وأسفل كلمة Group On نقوم بإضافة الحقل / الحقول / الصيغة !! المطلوبة لعمل المجموعة حسبها .
3. اضغط على OK مرتين وشغل التطبيق ، مبروك تم عمل التجميع بسهولة كبيرة .

دعني أخبرك بوجود طريقة أخرى لإضافة مجموعة وهي بالنقر على رمز صف التفاصيل Details بالزر الأيمن واختيار Edit Group ، هذا سيقودنا إلى أن كل التفاصيل الظاهرة على هيئة صفوف rows ما هي إلا عبارة عن مجموعات ! فقط جرب أن تعيد الحركة السابقة وتضغط الامر Insert Group وأنشئ مجموعة جديده بنفسك واضغط على OK وشاهد النتيجه بنفسك والتي تتمثل في إضافة صفين واحد فوق المجموعة Details وآخر أسفلها ( لا تشغل بالك فهذا مجرد مثال فقط )
هناك امر اود ذكره هنا ، وهو ان المجموعة الواحدة قد تحتوي على أكثر من حقل واحد وكذلك يمكنك اضافه صيغ Expressions مثلا في احد برامجي استخدمت الصيغة التالية للتجميع :

=Format(Fields!Date.Value,"MMMM yyyy")

وفكر في الصيغة السابقة قليلا فهي ستفتح لك أفكار جديدة . أمر آخر يزيد روعة المجموعات هنا، وهو إمكانية عمل فرز تصاعدي أو تنازلي ولأي حقل تريده ( أو حتى صيغه ! ) في كل مجموعة على حده وذلك بتحرير المجموعة واختيار لسان التبويب Sort كما بالشكل التالي :

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

التجميع بأداة List :
ان التجميع بهذه الاداة يتيح لك مرونه فائقه جدا ، فكما ذكرنا سابقا الأداة List تحضن مجموعة أدوات بداخلها وتزودها بمصدر البيانات الخاص بها ، أي ان الأدوات التي توجد بداخلها تأخذ منها البيانات ، وتعد هذه الاداة الطريقة المثلى لعرض البيانات على مجموعة ادوات مختلفه تتشارك جميعها في نفس المجموعة Group من البيانات أو الفرز أو الفلترة . بصيغه أخرى ، من إسم الأداة نعرف بانها قائمة تحتوي على عناصر ، هذه العناصر هي عباره عن ادوات اخرى كـ textbox,Table,Matrix وغيرها ولها نفس مصدر البيانات .

وقبل أن نبدأ معها ، سأفترض وجود جدول معك يحمل الاسم Contacts وبه الحقول Name,City,MobilePhone . والعمل الفعلي سيكون من خلال عدة مراحل نذكرها :
1. اختيار الـ dataset للاداة List .
2. تحرير الـ Details Group للاداة List .
3. ( إختياري حسب نوع الاداة ) إسناد الـ dataset للاداة ليكون نفس الخاص بـ List .
4. وضع الحقول على الاداوت المناسبة .

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

من استخدام List تجني فوائد كثيرة فيمكنك عمل Grouping وعرض البيانات على ادوات لا تدعم المجموعات بشكل مباشر مثل الـ TextBoxes ، عمل بطاقات وغيرها .
ومن أبرز فوائد استخدام الـ List التي تعجبني هو عمل تقارير بطريقة Master/Details الرائعة ! كيف ؟ سنوضحها كما يلي :

اضف إلى مصادر بيانات التقرير Report Data Sources جدولين مرتبطين وفي المثال لدي قمت بإضافه الجدولين Orders/OrderDetails من قاعدة بيانات Northwind ، ثم نضيف اداة List إلى الـ Body الخاص بالتقرير ، ومن خصائصها نختار الجدول الرئيسي Orders كمصدر لبيانات الاداة ، ثم نضع عليها مجموعة من الـ Textboxes واحد منها نكتب عليه ” Order ID ” وبجانبه اداة اخرى مثلها نضع عليها محتوى الحقل OrderID أي ان صيغتها تكون ” =Fields!OrderID.Value ” ونقوم بنفس العمليه للحصول على عنوان ومحتوى للحقل OrderDate ، ثم نضع اسفلها اداة اخرى ونكتب عليها Order Details ونضيف اسفلها اداة جدول Table نضغط عليها بالزر الايمن على احد حدودها أو على الخليه العلوية اليسرى ، ونظهر نافذه الخصائص التابعه لها ، ويكون مصدر البيانات الخاص بها هو الجدول OrdersDetail ونضع عليها الحقول UnitPrice,Quantitiy,Price بسحبها من نافذه الـ dataSource إلى الصف الثاني من الأداة الواحد تلو الآخر .
مختصر الفقرة الماضية سيكون شكل التقرير كالتالي :

أرأيت روعة التقرير الذي عملته ؟ قمنا بعمل تقرير Master/Details يظهر الـ details الخاصه بكل Order على شكل جدول اسفل العناوين .

محرر الصيغ Expression Editor :


بالنسبة لي ولك كمصممي تقارير، فأن هذا هو الجزء الأهم والنافذة ذات الأهمية الاستثنائية تحت كل الظروف داخل التقرير ! فبدونها لن تستطيع عمل تقرير محترم ( أتحداك ! ) هذه النافذة نقوم فيها بكاتبة الصيغ البرمجية البسيطة الخاصة بهذا النوع من التقارير ، ولك أن تعتبر أنه مشابه لمحرر الأكواد الخاص بلغات البرمجة الكاملة داخل Visual Studio كـمحرر Visual Basic .Net و C# لكنه بإمكانات مخفضة جدا بالمقارنة مع محررات لغات البرمجة .

بداية أخبرك بأن الكود الذي يكتب داخل هذه النافذة ما هو إلا عبارة عن دالة ، أي يجب ان تبدأ بعامل المساواة = ، وكأنك تعتبر أن هذا الكود هو جزء من كود آخر مخفي يبدأ بشيء مثل Textbox1.Value .

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

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

المجموعتان الباقيتان وهما Operators و Common Functions اترك لك استكشافهما وهما سهلتان جدا – رغم غناهما – ، الأولى توفر مجموعة من عوامل التشغيل والمقارنة Operators التي يمكنك استخدامها في كتابه الأكواد كـالمعامل = و < وغيرها ، اما الثانية فهي تعرض لك مجموعات من الدوال الجاهزة والتي اعتدنا استخدامها منذ VB6 وهي موجودة ايضا في Crystal Reports لمن استخدمه .

ربط التقرير بالبيانات :
لربط تقرير بالبيانات ، علينا أولا التأكد من وجود مصدر بيانات DataSource بالتقرير وعلامته وجود كائن من النوع Dataset عام على مستوى المشروع ويظهر مع باقي ملفات المشروع Classes,Modules وغيرها . سأفترض انه لا يوجد لديك مصدر بيانات ، سنقوم بإضافته من القائمة Data | Add New Datasource … ثم تكمل باقي الإعدادات بنفسك فأنت مبرمج وان لم تكن هكذا فاعذرني فهذا الحديث مخصص للمبرمجين فقط .

بعد وجود مصدر للبيانات يأتي دور العملية التالية وهي اختيار DataSource التقرير والذي يمثل أحد كائنات قاعدة البيانات الموجودة في DataSet معين ، ما يهمنا من هذا الأمر هو ان نذهب إلى القائمة Report | Data Sources لتظهر لك نافذة كالتالية :

في هذه النافذة اختر من الـ Combobox الظاهر لك مصدر البيانات والذي سيكون اسمه مبدوءا باسم الـ Dataset متبوعا باسم الكائن ( جدول ، استعلام ، اجراء مخزن .. الخ ) ثم تضغط على الزر Add لإضافته . مما يعجبني هو إمكانية إعادة التسمية لأي من مصادر بيانات التقرير DataSources المضافة إليه ، وهذا الأمر مهم في عدة أمور أولها هو تسهيل الوصول إلى اسم الكائن المطلوب عند اختياره لأي أداة على التقرير ، وثانيهما هو عند استخدام الأكواد مع اداة ReportViewer في أي من نوافذ المشروع WindowsForms ( وحتى مع WebForms) وهذا امر نتركه لاحقا .

بقي ان انوه بأنه يمكن للتقرير الواحد ان يحتوي على عدة DataSources .

عرض البيانات على أدوات التقرير :

الآن وصلنا إلى عرض البيانات على احد ادوات التقارير ، والطريقة سهلة جدا ، ولكن الاهم هو ان تعرف أي اداة ستستخدم ؟ سنبدأ اولا بعرض البيانات بطريقة الجدول وبشكل بدائي مباشر كما بجدول قاعدة البيانات ، لنقوم بهذا ، فإننا نقوم بسحب أداة Table إلى الجزء Body من التقرير ونضعه في المكان المناسب ، وهنا اذا كنت قد تعاملت مع Crystal Reports فإنك سترى الفرق الشاسع في سهولة وضع اداة ومحاذاتها على جسم التقرير بعكس Crystal Reports .
نعود إلى موضوعنا ، الخطوة التالية هي النقر على الخلية Cell الموجودة في الزاوية العلوية اليسرى للأداة بالزر الأيمن واختيار Properties وستظهر لك النافذة التالية :

من لسان التبويب General نختار من القائمة DatasetName اسم الـ Dataset ( كائن البيانات ) الذي تود جعله مصدر لبيانات هذا الكائن والذي هو Table1 ، سأفترض أنه يحمل الإسم Dataset_Contacts ثم نضغط على OK .

الآن ننتقل إلى الصف الثاني الظاهر على الجدول والذي ترى به كلمه Details واضغط بالزر الأيمن على أول خلية Cell واختر Expression وسيظهر لك محرر الصيغ ، من هناك توجه مباشره إلى المجموعة Fields(Dataset_Contacts) ومن اقصى يمين تلك النافذة ستجد قائمة بالحقول الموجودة بذلك الكائن ( في حالتنا هذه جدول ) اضغط بشكل مزدوج DoubleClick على أي الحقل المراد ( سأفترض أنه Name ) وستجد ان في محرر الصيغ قد اصبح يحتوي على صيغه مثل التالية :

كود:
=Fields!Name.Value

الآن قد بالضغط على الزر OK ، كرر نفس العملية لحقول أخرى . لكن مهلا ، يوجد طريقة اسهل من هذا بكثير، وسنتبعها مع كل الأدوات لعرض الحقول ، وهي بعمل Drag & Drop لاسم الحقل من نافذة مصدر البيانات Data Sources إلى الاداة المطلوبة أو الخلية المطلوبة .

أدوات التقرير :
من المؤكد انك ستعرض البيانات على أدوات معينه ، وكذلك ستستخدم بعضها لتمنح التقرير شكلا جماليا ، وفي أدوات تقارير Visual Studio ستجد أدوات مشابهه لأدوات Windows Controls كما بالصورة التالية :

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

أداة صندوق النص Textbox :
واضح من اسم الأداة وعنوانها أنها شبيهه بتلك الموجودة في Windows Forms مع ملاحظة كونها اقل مزايا. تتمتع بقدر جيد من الخصائص المفيدة اترك لك عزيزي المبرمج فرصة استكشافها ، ولك من عندي أن الخاصية الأهم هي Value وهي التي تمثل البيانات المعروضة على الأداة .أداة الخط Line:
لا تعليق ! استخدام هذه الأداة محصور في الجماليات وهو عرض خط بطرفين .

أداة الجداول المتداخلة Matrix :
ما فائدة هذه الأداة ؟ ما الفرق بينها وبين الأداة السابقة ؟ أجيبك بكل بساطة أن هذه الأداة هي أداة عظيمة جدا وتمكنك من تجميع البيانات بشروط كثيرة جدا بدون الحاجة إلى كتابة استعلامات مخصصة ومعقدة جدا في قاعدة البيانات والتي غالبا ما تكون شبه مستحيلة !
من المعروف أن أداة الجدول Table تقوم بعرض البيانات على شكل جدول يحتوي على أعمدة محددة وعددها ثابت بينما الصفوف يكون عددها متغيرا حسب حجم البيانات ، بينما أداة الـ Matrix تقوم بعرض البيانات على شكل جدول بأعمدة غير محدودة العدد أثناء تصميم الأداة والتقرير وإنما في وقت التنفيذ على حسب حجم البيانات والمجموعات التي كونتها في الأداة يتم إنشاء صفوف وأعمدة ! هنا قوة هذه الأداة الرائعة بحق ( إن لم تصدق ، فأخبرك أنني قبل أن اعرف هذه الأداة استغرقت شهرا كاملا باحثا عن حل لعمل تقرير فيه مجاميع كثيرة ومتداخله ومشروطة أيضا وكانت عملية معقدة جدا باءت بالفشل لولا اكتشافي لكيفية عمل هذه الأداة )
وسنتحدث عن هذه الأداة وكيفية استخدامها لاحقا.

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

الأداة List:
هذه الأداة إحدى أهم الأدوات على الإطلاق، فهي تعرض البيانات على شكل مجموعات يتم تكرارها كل صف Row من الجدول أو الاستعلام المحدد، لم تفهم صحيح ؟ إليك مثال صغير، يمكن أن تكون هذه الأداة أداة حاضنة لمجموعة من أداوت أخرى ، مثلا تستطيع أن تضع عليها Textbox و Table بحيث يظهر في أداة النص اسم الشخص مثلا ، وفي الجدول تظهر بياناته المختلفة ، ويتم تكرار هذه المجموعة دوما ، الجدير بالذكر انه يجب أن تقوم بعمل Group تجمع عليها البيانات المجلوبة من الـ DataTable لكي تستطيع استخدامها وهذا ما سنراه لاحقا .

أداة الصور Image :
هذه الأداة واضح من عنوانها واسمها أنها خاصة بعرض الصور على التقرير ، هذه الصور قد يكون مصدرها ملف تحدده أنت ، صورة مدمجة في التقرير ، أو صورة من قاعدة البيانات ( ياللروعة ! )

أداة التقرير الفرعي Sub Report :
أداه تستخدم لعرض تقرير داخل آخر ، ولا يوجد لدي الكثير لأخبرك عنه لأنني لم أجربها حتى اللحظة .

أداة المخططات Charts :
أداة مهمة للكثيرين وهي تستخدم في رسم مخطط بيانات للبيانات Chart كما تشاء وبأشكال مختلفة وهو يفي بالغرض ويزيد أيضا ! فهي أكثر الأدوات خصائصا وتخصيصا على الإطلاق . الحديث عن هذه الأداة بشكل مفصل بحاجة إلى 20 صفحة !
الآن استطيع الجزم بأنه أصبحت لديكم صورة ولو بسيطة عن تقارير Visual Studio ، وقبل أن ننتقل إلى المرحلة التطبيقية ، ينبغي لنا أن نتحدث عن الـ Expression Editor الخاص بهذا النوع من التقارير وهو موضوع الدرس القادم !

أدوات تقارير Visual Studio
في مختلف التطبيقات التي تعتمد على قواعد البيانات ، نحتاج إلى استخلاص البيانات على شكل تقارير وغالبا ما يكون مصيرها الطباعة ، بالتالي يجب عليك كمبرمج أن تعرف كيفية التعامل مع التقارير وإنشائها والقيام – بحد أدنى – بالعمليات الأساسية عليها من ابتداءا من عمل تقرير جدولي بسيط ، مرورا بتجميع البيانات ، وانتهاءا بعمل تقارير الـ CrossTable أو ما يعرف بالـ Matrix.

ولا اعلم ما سبب نهم مستخدمي لغات البرمجة وحتى المبرمجين – من مايكروسوفت بـتقارير Crystal Reports الذي اعتبره ” مرض ” ظهر مع Visual Basic6 واستمر مع ظهور Visual Studio.Net حتى آخر إصداره معتمده حاليا وهي 2005 . لا يشكو كريستال ريبورت من عيب غير انه اكبر من اللازم ، ويحتاج إلى عمل أكثر ومشاكله أكثر وحتى طريقة رسم الأدوات على التقرير تعتبر متعبة – على الأقل بالنسبة لي . ومن هذا المنطلق قررت الحديث عن أداة التقارير الرائعة جدا والتي تصاحب Visual Studio 2005 وهي Visual Studio Reporting Controls السهلة في التعامل والتصميم والمتكاملة منذ البداية مع أي تطبيق تبنيه بأي لغة تابعة لـ .net

أين هي أداة تقارير Visual Studio ؟
يمكنك الوصول إلى هذه الأداة من القائمة Project ثم Add New Item ومنها تختار Report كما بالصورة التالية :

مكونات التقرير:
يتكون هذا النوع من التقرير من صفحة التصميم، وكل صفحة تتكون من ثلاثة أجزاء رئيسية:
• Page Header : وهو رأس الصفحة .
• Body : وهو جسم التقرير والمكان الذي تظهر عليه البيانات ( يتم التكرار داخل كل أداة أو مجموعة على حدة وليس المقطع بأكمله مثل Crystal Reports )
• Page Footer : وهو ذيل التقرير .

بمجرد إنشاء أي تقرير فإن الـ Page Header والـ Page Footer لا تظهر وبالتالي فعليك إظهارها من خلال الضغط بالزر الأيمن لتحصل على القائمة التالية :

أو من خلال القائمة Report :

ولكل من الأجزاء الثلاثة السابقة خصائص أهمها PrintOnFirstPage و PrintOnLastPage بالنسبة للجزأين Page Header و Page Footer، ولكن سنبقي التفاصيل حول هذه الأجزاء الثلاثة لاحقا، والآن سنتحدث عن خصائص التقرير:

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

وهي تتكون من عدة ألسنة تبويب، سنترك الآن اللسان General لنتوجه إلى Layout الخاص بتنظيم صفحة التقرير:

نبدأ بالخاصيتين Page Width و Page Height اللتان تمكناننا من تحديد أبعاد صفحة التقرير علما بان الوحدة المستخدمة هنا هي الإنش Inches . بالنسبة لخصائص الـ Margin فهي التي تمكننا من التحكم بهوامش صفحة التقرير عند الطباعة وهي أيضا بوحدة الإنش .

هذه هي نهاية الجزء الأول … ومن لديه اي سؤال او تعقيب فلا يتردد بطرحه على الرابط التالي : هنا