الإعدادات
استخدم إعدادات الامتداد لتكوين سلوك أدوات IBM i.
يتضمن IBM Bob Premium Package for i إعدادات امتداد تتحكم في سلوك أدوات معينة. يمكنك إيجاد هذه الإعدادات وتعديلها بالانتقال إلى لوحة الأوامر، واستخدام أمر Preferences: Open Settings (UI)، والانتقال إلى إعدادات الامتداد باستخدام الفلاتر على الجانب الأيسر: Extensions > IBM Bob Premium Package for i.
الإعدادات العامة
الإعدادات العامة تتحكم في سلوك استرجاع البيانات الشامل للامتداد.
الحد الأقصى للصفوف المُجلَبة
| الخاصية | القيمة |
|---|---|
| معرف الإعداد | vscode-ibmi-bob.general.maxRowsToFetch |
| الافتراضي | 100 |
| الحد الأدنى | 1 |
يتحكم في الحد الأقصى لعدد الصفوف التي ستجلبها أداة execute_sql_statement من مجموعات نتائج استعلام Db2 for i. عندما يكون للاستعلام مزيد من الصفوف لإعادتها، سيُقيِّد Bob نفسه بهذا الحد لتجنب إثقال نافذة السياق. سيجلب Bob المزيد من الصفوف لاحقاً إذا لزم الأمر.
زِد هذه القيمة إذا كنت تعمل بانتظام مع مجموعات نتائج أكبر وتريد من Bob الوصول إلى بيانات أكثر في وقت واحد. كن على دراية بأن القيم الأكبر قد تزيد وقت الاستجابة وتتسبب في تسمم السياق نتيجة توفير بيانات كثيرة جداً لـ Bob.
إعدادات الحواجز
إعدادات الحواجز تُضيف ضوابط أمان لمنع العمليات غير المقصودة أو المدمرة على IBM i.
تطبيق أوامر CL المُؤهَّلة
| الخاصية | القيمة |
|---|---|
| معرف الإعداد | vscode-ibmi-bob.guardrails.enforceQualifiedCLCommands |
| الافتراضي | true |
عند التمكين، يتطلب Bob أن تكون أوامر CL المُمرَّرة إلى أداة execute_cl_command مُؤهَّلة بالمكتبة (مثلاً QSYS/...). إذا تم توفير أمر غير مُؤهَّل، يُعيد Bob خطأً مع البدائل المُؤهَّلة بشكل صحيح الموجودة باستخدام QSYS2.COMMAND_INFO وسيُعيد محاولة استدعاء الأداة بشكل صحيح.
تطبيق الأوامر المُؤهَّلة يُقلِّل مخاطر دقة الأوامر المعتمدة على قائمة المكتبات ويُوصى به كممارسة أمان مثلى. حتى إذا تم تعيين هذا الإعداد على false للسماح بالأوامر غير المُؤهَّلة، سيقترح Bob البدائل المُؤهَّلة كنصيحة.
أنواع عبارات SQL المحظورة
| الخاصية | القيمة |
|---|---|
| معرف الإعداد | vscode-ibmi-bob.guardrails.deniedSQLStatementTypes |
| الافتراضي | ["ALLOCATE", "CALL", "COMMIT", "CONNECT", "DISCONNECT", "DROP", "EXECUTE", "GRANT", "LOCK", "MERGE", "PREPARE", "RENAME", "REVOKE", "ROLLBACK", "SAVEPOINT", "TRUNCATE", "UPDATE"] |
قائمة بأنواع عبارات SQL التي تتطلب دائماً موافقة صريحة من المستخدم قبل أن تُنفِّذها أداة execute_sql_statement. عندما يحاول Bob تشغيل عبارة يطابق نوعها مدخلاً في هذه القائمة، يُطالَب المستخدم بالموافقة أو الرفض حتى لو منح صلاحية الموافقة التلقائية على التنفيذ للمهمة.
عدّل هذه القائمة لتتوافق مع مستوى المخاطر المقبول في مؤسستك. على سبيل المثال، إذا كانت سير عملك تتطلب بانتظام من Bob تشغيل الإجراءات المُخزَّنة أو إدارة المعاملات، يمكنك اختيار إزالة CALL أو COMMIT من قائمة الأوامر المحظورة.
إعدادات Understand
تتحكم إعدادات Understand في سلوك وتكوين قدرات ذكاء الكود في Understand.
مكتبة التثبيت
| الخاصية | القيمة |
|---|---|
| معرف الإعداد | vscode-ibmi-bob.understand.installLibrary |
| الافتراضي | (بدون قيمة — مطلوب) |
مكتبة IBM i التي تم تثبيت Understand فيها. هذا الإعداد مطلوب وليس له قيمة افتراضية. يجب تحديد اسم مكتبة صالح قبل تثبيت Understand.
يجب أن يتبع اسم المكتبة هذه القواعد:
- من 1 إلى 10 أحرف في الطول.
- يجب أن يبدأ بحرف (A–Z)، أو
$، أو@. - يمكن أن يحتوي فقط على حروف وأرقام و
#و$و@أو_. - لا يمكن أن يبدأ بـ
QأوSYSأو#، لأن هذه البوادئ محجوزة للمكتبات التي توفرها IBM. - لا يمكن أن يحتوي على نقاط (
.)، لأن المكتبة تُستخدم كمخطط SQL بواسطة Understand.
اختر مكتبة مخصصة غير مستخدمة مسبقاً، وقيّد الوصول إليها للمستخدمين المُخوَّلين الذين يحتاجونها.