Arabic Knowledge blog مدونة المعرفة العربية : Crystal Reports lessons دروس تقارير الكريستال

‏إظهار الرسائل ذات التسميات Crystal Reports lessons دروس تقارير الكريستال. إظهار كافة الرسائل

Crystal Reports - Parameters المعلمات المتغيرات الممررة في تقارير كريستال

تُستخدم المعلمات لأخذ مدخلات المستخدم قبل إنشاء التقرير. يجب على المستخدم الرد على الموجه قبل إنشاء التقرير وتعتمد مخرجات التقرير على استجابة المستخدم لقيمة المعلمة.

باستخدام المعلمات مع الصيغ وفي التقرير ، يمكنك إنشاء تقرير واحد يتغير وفقًا لمتطلبات المستخدمين المختلفين.

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

ملاحظة - يمكن استخدام المعلمات في تقارير Crystal في المرشحات بعد استرجاعها من قاعدة البيانات.

معلمات متتالية

يتم تجميع المعلمات ذات التبعية معًا وتُعرف باسم المعلمات المتتالية. تتيح لك المعلمات المتتالية تجميع معلمتين أو أكثر في مجموعة واحدة.

المعلمات الموروثة

يمكن أيضًا إنشاء المعلمات على مستوى الكون أو في لوحة الاستعلام ويمكن توريثها لاحقًا في تقارير Crystal. يطلق عليهم المعلمات الموروثة. يمكن إسقاط هذه المعلمات على مستوى التقرير ولكن لا يمكن تحريرها في تقرير. لا يمكن تحرير هذه المعلمات إلا عند إنشائها.

أنواع بيانات المعلمات باراميتر

تدعم المعلمات في Crystal Report أنواع البيانات أدناه -

رقم
نص
تاريخ
زمن
التاريخ والوقت
عملة
قيمة منطقية
عضو

نقاط مهمة يجب تذكرها أثناء استخدام المعلمات -

لاستخدام معلمة في صيغة ، ليس من الضروري أن يتم وضعها في التقرير. يمكن استخدام المعلمات في صيغة مثل الكائنات الأخرى ويمكن إنشاؤها في ورشة Formula.
يمكن استخدام المعلمات مع قوائم القيم الثابتة أو الديناميكية.
يمكنك أيضًا إنشاء قائمة بالقيم يمكن للمستخدم من خلالها اختيار قيمة المعلمة بدلاً من إدخالها يدويًا.

قائمة أنواع القيم

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

كيف تصنع معلمة؟

في عرض Data Explorer ، انقر بزر الماوس الأيمن داخل منطقة Parameters → حدد New → New Parameter

يظهر مربع الحوار Create Parameter ← أدخل اسمًا للمعلمة (حتى 255 حرفًا أبجديًا رقميًا). في مربع الحوار ، يمكنك تغيير اسم ونوع المعلمة بالإضافة إلى الخصائص الأخرى.

حدد نوع البيانات المناسب من القائمة → مثل سلسلة أو رقم أو تاريخ ، من بين أمور أخرى.

في مربع نص المطالبة ، أدخل نص المطالبة المطلوب (حتى 255 حرفًا أبجديًا رقميًا).

على سبيل المثال - "حدد اسمًا"

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

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

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

Crystal Reports - Creating Arrays إنشاء المصفوفات في تقارير كريستال

يمكن تعريف متغير Array في Crystal Report باستخدام الكلمة الأساسية "Array".

Global NumberVar Array Z := [1, 2, 3];

يمكنك أيضًا تعيين قيم لعناصر Array ويمكن استخدام هذه القيم للحسابات في الصيغ. على سبيل المثال -

StringVar Array Z := [“Hello”,”World”];
Z[2] :=[“Bye”];
UpperCase (Z [2] )

هذه الصيغة ستعيد السلسلة "وداعا".

يمكنك أيضًا تغيير حجم المصفوفة باستخدام الكلمات الأساسية Redim و Redim Preserve. يتم استخدام Redim لإزالة الإدخالات السابقة للصفيف أثناء تغيير حجمه ، ويتم استخدام Redim Preserve لاحتواء قيم Array السابقة. على سبيل المثال -

Local NumberVar Array Z;
Redim Z [2]; //Now Z is [0, 0]
Z [2] := 10; //Now Z is [0, 10]
Redim Z [3]; //Now Z is [0, 0, 0], Redim has erased previous Array values.
Z [3] := 20; //Now Z is [0, 0, 20]
Redim Preserve Z [4]; 
//Now Z is [0, 0, 20, 0], Redim Preserve has contained previous Array values.
"finished"

مصفوفة مع حلقات

تُستخدم المصفوفات أيضًا مع Loops: مثل حلقة For.

Local NumberVar Array Z;
Redim Z[10];
Local NumberVar x;
For x := 1 To 10 Do
(Z[x] := 10 * x);
Z [5] //The formula returns the Num

Crystal Reports - Creating Variables إنشاء المتغيرات تقارير كريستال

ية

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

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

تحديد متغير

Local Stringvar Customer_Lastname
Local numbervar Sales_percentage

الكلمة الأساسية للإعلان عن المتغير لها "var" في النهاية وهي صحيحة لجميع أنواع المتغيرات. يمكنك أيضًا إسناد قيمة أولية إلى متغير مع إعلان أو بناء جملة منفصل.

Local NumberVar Z; //Declare Z to be a Number variable
Z := 30;           //Assign the value of 30 to Z

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

محلي
عالمي
مشترك

يحدد هذا أنه يمكن استخدام متغير في صيغة واحدة في صيغة أخرى.

المتغيرات المحلية

يتم الإعلان عن المتغيرات المحلية باستخدام الكلمة الأساسية المحلية متبوعة بالنوع ويتبعها اسم المتغير كما في الأمثلة أعلاه.

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

//Formula 1
Local NumberVar Z;
Z := 30;

//Formula 2
EvaluateAfter ({@Formula A})
Local NumberVar Z;
Z := z + 5;

في المثال أعلاه ، ستُرجع الصيغة 2 القيمة 5 حيث تم التصريح عن Z كمتغير رقم محلي في الصيغة 1 ، لذا ستأخذ القيمة الافتراضية للمتغير Z في الصيغة 2.

المتغيرات العالمية

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

Global StringVar Z;

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

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

المتغيرات المشتركة

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

لاستخدام متغير مشترك ، قم بتعريفه في صيغة في التقرير الرئيسي -

Shared NumberVar Z := 10;

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

Crystal Reports - Conditional Formatting عمل تنسيقات مشروطة في تقارير كريستال

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

اكتب الصيغة في جزء نص الصيغة ، واحفظها وأغلقها.

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

في هذا المثال ، يتم استخدام crGreen ، crRed ، crBlack. يمكنك أيضًا استخدام القيمة الرقمية الفعلية لثوابت الألوان.

هناك ثلاث وظائف شائعة للتنسيق الشرطي -

CurrentObjectValue
DefaultAttribute
GridRowColumnValue

يمكن استخدام DefaultAttribute مع أي صيغة تنسيق ، CurrentObjectValue لأي صيغة تنسيق تقوم فيها بتنسيق قيمة كائن ، ويمكن استخدام GridRowColumnValue لأي صيغة تنسيق حيث تقوم بتنسيق قيمة كائن في علامة تبويب متقاطعة.

Crystal Reports - Applying Calculations تطبيق العمليات الحسابية في تقارير كريستال

تُستخدم الصيغ المحسوبة لإجراء العمليات الحسابية في تقارير Crystal ويمكن تصميمها في ورشة عمل المعادلات.

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

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

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

قائمة العمليات الحسابية من أعلى إلى أدنى أسبقية هي -

الأس
النفي
الضرب والقسمة والنسب المئوية
تقسيم صحيح
باقي القسمة
جمع وطرح

Crystal Reports - If Then Else الجمل الشرطية في تقارير كريستال

عبارة if-then-Else هي أبسط عبارات تدفق التحكم. يخبر البرنامج الخاص بك بتنفيذ قسم معين من التعليمات البرمجية فقط إذا تحقق شرط معين صحيح.

إذا رأيت عبارة If-Then-Else التالية مع عوامل تشغيل منطقية ، فقد سمحت لك بتمرير شروط متعددة في الصيغة وإرجاع القيمة ، إذا كان الشرط صحيحًا.

If({PROJECT.Customer\Customer Name} [1 to 2] = "An" and
ToText({PROJECT.Time\Year}) [1] = "2") or
({Project.Customer\CUSTOMER NAME} [1 to 2] = "Ja" and
ToText({PROJECT.Time\Year}) [1] = "2") Then
"Five star rating CUSTOMER"
Else
"1 star rating CUSTOMER"

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

تم حفظ هذه الصيغة ثم إضافتها إلى نص التقرير ضمن علامة تبويب الهيكل كما هو موضح في الصور التالية -

تمت إضافة عمود جديد في التقرير بتصنيف العملاء كما هو مذكور في صيغة الاختبار.

Crystal Reports - Apply Boolean Formulas تطبيق الصيغ المنطقة في تقارير كريستال

هناك عوامل تشغيل منطقية مختلفة يمكن استخدامها في الصيغة في تقارير Crystal. هم -

و and
أو or
ليس not
Eqv
Imp
XOR

يتم استخدام كل هذه العوامل لتمرير شروط متعددة في الصيغ -

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

استخدام عوامل التشغيل المنطقية "AND" -

If {CUSTOMER.CUSTOMER_NAME} [1 to 2] = "AN" and
ToText({CUSTOMER.CUSTOMER ID}) [2] = "4" then
"TRUE"
Else
"FALSE"

استخدام عوامل التشغيل المنطقية "AND" و "OR" -

If ({CUSTOMER.CUSTOMER_NAME} [1 to 2] = "AN" and
ToText({CUSTOMER.CUSTOMER ID}) [1] = "4") or
({CUSTOMER.CUSTOMER_NAME} [1 to 2] = "Ja" and
ToText({CUSTOMER.CUSTOMER ID}) [1] = "2") then
"Five star rating CUSTOMER"
Else
"1 star rating CUSTOMER"

Crystal Reports Creating & Modifying Formulas صيغ التعديل والانشاء في تقارير كريستال

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

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

يمكنك أيضًا إنشاء صيغة جديدة عن طريق فتح ورشة عمل Formula من علامة تبويب Formula ضمن Data → New → New Formula كما هو موضح في الصورة التالية.

لكتابة صيغة في نافذة نص الصيغة ، يمكنك استخدام الكائنات قيد الاستخدام ضمن علامة التبويب "عامل التشغيل" وعوامل تشغيل مختلفة لتمرير شرط في الصيغة.

يمكن حفظ الصيغة باستخدام خيار الحفظ في أسفل الصفحة. بمجرد حفظ الصيغة ، تندرج ضمن قائمة الصيغ في علامة التبويب Data Explorer.

يمكنك سحب هذه الصيغة إلى أي قسم من التقرير.

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

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

لحذف الصيغة من تقرير ، انقر بزر الماوس الأيمن فوق اسم الصيغة وانقر فوق حذف.

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

Crystal Reports - Formula Workshop ورشة الصيغ تقارير كريستال

تُستخدم ورشة عمل الصيغة لإنشاء أنواع مختلفة من الصيغ. يمكنك فتح ورشة عمل الصيغة بالانتقال إلى البيانات ← انقر فوق الصيغ أو بالنقر فوق علامة تبويب الصيغة في شريط أدوات البيانات.

يوجد في ورشة عمل الصيغة لوحتان - لوحة التنقل ولوحة الكائنات.

تحتوي لوحة التنقل على مجلد لكل نوع من الصيغ في Crystal Reports.

تحتوي لوحات الكائنات على 4 حقول -

مستكشف البيانات Data Explorer - يحتوي على كائنات وصيغ ومعلمات وإجماليات قيد الاستخدام موجودة في تقرير Crystal.

كائنات النتائج Result Objects - تحتوي على جميع كائنات النتائج المتاحة للاستخدام في التقرير.

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

عوامل التشغيل Operators - يتم استخدامها لتمرير الشروط بين القيم. وهي تشمل: العمليات الحسابية ، والمصفوفات ، والعوامل المنطقية ، إلخ.

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

Crystal Reports - Defining Formulas تعريف او تحديد صيغة تقارير كريستال

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

مثال - (Emp_details.sal) * 0.15

الصيغ الشائعة هي - العمليات الحسابية ووظائف السلسلة مثل الأحرف الكبيرة ووظائف التاريخ وما إلى ذلك.

تحتوي الصيغة على جزأين في التقرير -

بناء الجملة
مكونات

على مكونات يتم استخدامها لإنشاء الصيغ.

تحتوي تقارير Crystal على الأنواع التالية من الصيغ - تقارير الصيغ وصيغ التنسيق الشرطي.

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