Understand
قم بتعيين كائنات تطبيقات IBM i وتبعياتها باستخدام لوحة Understand Dashboard، واستخدم Bob للإجابة على الأسئلة الهيكلية مباشرةً من بيانات الفحص.
Understand هو مكوّن ذكاء كود مدرج مع IBM Bob Premium Package for i. يفحص مكتبات تطبيقات IBM i التي تحددها ويبني نموذجاً شاملاً للتطبيق من خلال فهرسة جميع الكائنات المكتشفة، بما في ذلك البرامج وبرامج الخدمة والوحدات والملفات والأوامر ومناطق البيانات وطوابير البيانات. يرسم Understand أيضاً العلاقات بين هذه الكائنات، مُلتقطاً التبعيات مثل استدعاءات البرامج وأنماط وصول الملفات وربط برامج الخدمة ومراجع SQL والمشغلات وعلاقات المفاتيح الخارجية وتكوينات السجلات وقيود قاعدة البيانات.
بعد الفحص، يستطيع Bob الإجابة على الأسئلة الهيكلية مباشرةً من بيانات الفحص دون قراءة كل عضو مصدر، وتوفر لوحة Understand Dashboard واجهة مرئية لاستكشاف الكائنات والتبعيات والرؤى.
جميع بيانات الفحص مُستخرَجة من الكائنات نفسها. لا يقرأ Understand كود المصدر ولا يُحلِّله. إذا كانت أعضاء المصدر غير متزامنة مع الكائنات المُجمَّعة على النظام، يعكس الفحص الكائنات وليس المصدر.
المتطلبات الأساسية
- اتصال نشط بـ IBM i عبر Code for IBM i.
- يجب تكوين إعداد
vscode-ibmi-bob.understand.installLibraryقبل تثبيت Understand. اختر مكتبة مخصصة غير موجودة في مكتبات المستخدم الحالية. قيّد الوصول إلى المكتبة للمستخدمين المُخوَّلين فقط.
تُخزَّن بيانات التطبيق الممسوحة في مكتبة خاصة. إذا منحت مستخدمين آخرين وصولاً إلى هذه المكتبة، فقد يتمكنون من الاطلاع على بيانات من كائنات لا يمتلكون صلاحية مباشرة عليها.
جولة البدء السريع
الجولة الإرشادية المُدمَّجة لـ Understand هي أسرع طريقة للبدء. افتحها من لوحة الأوامر بتشغيل الأمر Get Started with Understand، أو افتح تبويب Get Started في VS Code واختر جولة Understand your IBM i applications.
تُرشدك الجولة خلال الخطوات التالية:
- الاتصال بـ IBM i
- تثبيت مكوّن Understand
- إنشاء أول تطبيق لك
- فحصه
- استكشاف النتائج مع Bob
لوحة Understand Dashboard
لوحة Understand Dashboard هي الواجهة المركزية لإدارة التطبيقات واستكشاف نتائج الفحص. افتحها بأمر Open Understand Dashboard من لوحة الأوامر، أو بالنقر على أيقونة لوحة Understand Dashboard في شريط عنوان عرض دردشة Bob.
تتكون اللوحة من التبويبات التالية:
| التبويب | الغرض |
|---|---|
| Overview | تثبيت مكوّن Understand وتحديثه ومراقبة حالته. |
| Applications | إنشاء تطبيقات IBM i وفحصها وإدارتها. |
| Libraries | إضافة مكتبات أو إزالتها من التطبيق المحدد. |
| Objects | البحث وتصفية كل كائن ممسوح؛ حدّد كائناً لرؤية ما يستخدمه وما يستخدمه. |
| Insights | أعداد الكائنات والتبعيات والكائنات الأكثر مرجعيةً ومخاطر SQL الديناميكي والمشغلات والمفاتيح الخارجية والكائنات المسجلة. |
| Messages | التشخيصات ومعلومات الحالة لكل خطوة فحص. |
| Settings | وصول سريع لإعداد مكتبة التثبيت. |
تثبيت مكوّن Understand
قبل فحص أي تطبيق، يجب تثبيت مكوّن Understand على IBM i.
افتح لوحة Understand Dashboard وانتقل إلى تبويب Overview.
إذا لم تكن هناك مكتبة تثبيت محددة، اختر Set install library على بطاقة المكوّن وأدخل اسم المكتبة في محرر الإعدادات.
عد إلى اللوحة واختر Install Understand.
عند شحن إصدار أحدث مع تحديث الامتداد، تعرض نفس البطاقة على تبويب Overview إجراء Update Understand.
إنشاء تطبيق
يتكون التطبيق من قائمة مرتبة من المكتبات ذات الصلة التي تمثل تطبيق IBM i واحد، مثل PAYLIB وPAYDTA لنظام الرواتب.
في تبويب Applications، اختر New application:
- أدخل اسماً للعرض ووصفاً اختيارياً.
- ابدأ بكتابة اسم مكتبة. تعرض القائمة مكتبات المستخدم المتاحة على النظام المتصل وتستثني مكتبات النظام (
Q*وSYS*و#*). - اختر مكتبة مقترحة، أو اضغط Enter لإضافة اسم مكتبة. تُفحص المكتبات بالترتيب الذي تُضاف به.
يمكنك إضافة مكتبات أو إزالتها في أي وقت من تبويب Libraries.
فحص تطبيق
يحلل الفحص كل كائن في مكتبات التطبيق ويسجل التبعيات بينها. اختر Scan بجانب تطبيق في تبويب Applications لبدء الفحص.
- يُعرض تقدم الفحص في القسم السفلي من اللوحة. تعمل الفحوصات في وظيفة SQL مخصصة، مما يتيح لك الاستمرار في استخدام تبويبات اللوحة الأخرى أثناء الفحص.
- عند اكتمال الفحص، قد يُحدِّد مكتبات إضافية مشار إليها بواسطة كائنات التطبيق غير المدرجة بعد في التطبيق. راجع هذه التوصيات في تبويب Libraries.
- تحقق من تبويب Messages للاطلاع على أي كائنات أو تبعيات أو مراجع لم يتمكن الماسح من حلها.
يقرأ Understand الكائنات المُجمَّعة على النظام، وليس أعضاء المصدر. علاقات التبعيات مثل الاستدعاءات الديناميكية (حيث يُخزَّن اسم البرنامج في متغير) ومراجع جداول SQL الديناميكية لا تكون مرئية لفحص الكائنات ولا تُسجَّل. تُبرز اللوحة وردود Bob الكائنات المُحدَّدة بـ SQL الديناميكي كمناطق تتطلب مراجعة يدوية.
عند إجراء تغييرات على مكتبة معينة، لا تحتاج إلى إعادة فحص التطبيق بالكامل. يمكنك فحص مكتبات فردية من تبويب Libraries للحفاظ على تحديث الفهرس بسرعة.
استكشاف الكائنات والرؤى
بعد اكتمال الفحص، يمكنك استكشاف النتائج بطريقتين.
في اللوحة، استخدم تبويب Objects للبحث وتصفية كل كائن مُفهرَس. اختر كائناً لرؤية ما يستخدمه (التبعيات الصادرة) وما يستخدمه (التبعيات الواردة)، إلى جانب أعمدة للملفات والرموز المُصدَّرة. يمنحك تبويب Insights إحصاءات مجمعة: أعداد الكائنات والتبعيات والكائنات الأكثر مرجعيةً ومخاطر SQL الديناميكي والمشغلات والمفاتيح الخارجية والكائنات المسجلة.
مع Bob، اختر زر Explore the Application with Bob في تبويب Insights لفتح مهمة في وضع IBM i Developer تبدأ بملخص للتطبيق الممسوح. ومن هناك، يمكنك الاستمرار في طرح الأسئلة بلغة عادية — ما يستخدمه البرنامج، وما الذي سينكسر إذا تغيّر ملف، وأين يُستخدم SQL الديناميكي، وأي البرامج OPM، وغيرها الكثير. راجع استخدام Bob مع Understand للتفاصيل.
استخدام Bob مع Understand
عند تثبيت Understand وفحص تطبيق، يحصل Bob تلقائياً على وصول إلى ست أدوات Understand وثلاث مهارات Understand في وضعَي IBM i Developer وIBM i Database.
يستخدم Bob أدوات Understand تلقائياً كمصدره الأول للمعلومات كلما تعلّق سؤال ببنية التطبيق أو علاقات الكائنات أو تحليل التبعيات. يشمل ذلك مهاماً مثل:
- ما الذي يستدعي البرنامج
ORDPROC؟ على ماذا يعتمد؟ - هل من الآمن حذف الملف
CUSTMST؟ ما الذي سينكسر؟ - أي البرامج OPM؟ أيها يستخدم SQL الديناميكي؟
- أعطني نظرة عامة على تطبيق
PAYLIBواستعداده للتحديث. - ما الذي يُصدِّره برنامج الخدمة
DBSRV، ومن يستخدم تلك الإجراءات؟
يُجيب Bob على هذه الأسئلة من بيانات فحص الكائنات. لا يقرأ أعضاء المصدر للتحليل الهيكلي إلا إذا طلبت منه صراحةً فتح ملف مصدر محدد.
للتحكم في ما إذا كان بإمكان Bob استخدام أدوات Understand لمهمة معينة، قم بتكوين مجموعة صلاحيات Understand عند بدء مهمة أو تعديلها.
أدوات Understand مُفعَّلة فقط عند تثبيت المكوّن. إذا كانت هذه الأدوات غير مرئية أو لا يمكن استخدامها، فهذا يعني أن Understand لم يُثبَّت بعد. لتفعيلها، أكمل عملية التثبيت الموضحة في تثبيت مكوّن Understand.
الحفاظ على تحديث البيانات
تمثل بيانات Understand حالة تطبيقك وقت أحدث فحص. إذا أُضيفت كائنات أو عُدِّلت أو أُزيلت بعد الفحص، شغِّل فحصاً جديداً لتحديث البيانات والحفاظ على حداثتها. يُشير Bob ولوحة Understand Dashboard تلقائياً عند احتمال قِدَم نتائج الفحص، مما يساعدك في تحديد وقت الحاجة إلى إعادة الفحص.