الإعدادات
استخدم إعدادات الامتداد لتكوين سلوك أدوات 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 تشغيل عبارة يطابق نوعها مدخلاً في هذه القائمة، يُطالَب المستخدم بالموافقة أو الرفض حتى لو منح صلاحية الموافقة التلقائية على التنفيذ للمهمة.
عدّل هذه القائمة لتتوافق مع مستوى المخاطر المقبول لفريقك. على سبيل المثال، قد ترغب في إزالة CALL أو COMMIT من القائمة المحظورة إذا كانت مهامك تتطلب بانتظام استدعاء Bob للإجراءات المُخزَّنة أو إدارة المعاملات.