Paramètres
Utilise les paramètres de l'extension pour configurer le comportement des outils IBM i.
IBM Bob Premium Package for i inclut des paramètres d'extension qui contrôlent certains comportements des outils. Tu peux trouver et modifier ces paramètres en accédant à la palette de commandes, en utilisant la commande Preferences: Open Settings (UI) et en naviguant vers les paramètres de l'extension via les filtres sur le côté gauche : Extensions > IBM Bob Premium Package for i.
Paramètres généraux
Les paramètres généraux contrôlent le comportement global de récupération des données de l'extension.
Nombre maximum de lignes à récupérer
| Propriété | Valeur |
|---|---|
| ID du paramètre | vscode-ibmi-bob.general.maxRowsToFetch |
| Valeur par défaut | 100 |
| Minimum | 1 |
Contrôle le nombre maximum de lignes que l'outil execute_sql_statement récupérera depuis les ensembles de résultats de requête Db2 for i. Lorsqu'une requête a plus de lignes à retourner, Bob se limitera à cette valeur pour éviter de surcharger la fenêtre de contexte. Bob récupérera davantage de lignes plus tard si nécessaire.
Augmente cette valeur si tu travailles régulièrement avec de grands ensembles de résultats et que tu veux que Bob accède à plus de données à la fois. Sache que des valeurs plus élevées peuvent augmenter le temps de réponse et provoquer un empoisonnement du contexte en fournissant trop de données à Bob.
Paramètres des garde-fous
Les paramètres des garde-fous ajoutent des contrôles de sécurité pour prévenir les opérations non intentionnelles ou destructrices sur IBM i.
Imposer des commandes CL qualifiées
| Propriété | Valeur |
|---|---|
| ID du paramètre | vscode-ibmi-bob.guardrails.enforceQualifiedCLCommands |
| Valeur par défaut | true |
Lorsqu'activé, Bob exige que les commandes CL passées à l'outil execute_cl_command soient qualifiées par une bibliothèque (par ex., QSYS/...). Si une commande non qualifiée est fournie, Bob retourne une erreur avec les alternatives correctement qualifiées trouvées via QSYS2.COMMAND_INFO et re-tentera d'appeler l'outil correctement.
Imposer des commandes qualifiées réduit le risque de résolution de commandes dépendante de la liste de bibliothèques et est recommandé comme bonne pratique de sécurité. Même si ce paramètre est défini à false pour autoriser les commandes non qualifiées, Bob suggérera quand même des alternatives qualifiées à titre de conseil.
Types d'instructions SQL refusées
| Propriété | Valeur |
|---|---|
| ID du paramètre | vscode-ibmi-bob.guardrails.deniedSQLStatementTypes |
| Valeur par défaut | ["ALLOCATE", "CALL", "COMMIT", "CONNECT", "DISCONNECT", "DROP", "EXECUTE", "GRANT", "LOCK", "MERGE", "PREPARE", "RENAME", "REVOKE", "ROLLBACK", "SAVEPOINT", "TRUNCATE", "UPDATE"] |
Une liste de types d'instructions SQL qui nécessitent toujours une approbation explicite de l'utilisateur avant que l'outil execute_sql_statement les exécute. Lorsque Bob tente d'exécuter une instruction dont le type correspond à une entrée de cette liste, l'utilisateur est invité à approuver ou refuser l'exécution, même s'il a accordé la permission d'auto-approbation execute pour la tâche.
Ajuste cette liste pour l'aligner sur la tolérance au risque de ton organisation. Par exemple, si tes workflows nécessitent fréquemment que Bob exécute des procédures stockées ou gère des transactions, tu peux choisir de retirer CALL ou COMMIT de la liste des commandes refusées.
Paramètres Understand
Les paramètres Understand contrôlent le comportement et la configuration des capacités d'intelligence de code Understand.
Bibliothèque d'installation
| Propriété | Valeur |
|---|---|
| ID du paramètre | vscode-ibmi-bob.understand.installLibrary |
| Valeur par défaut | (aucune — obligatoire) |
La bibliothèque IBM i où Understand est installé. Ce paramètre est obligatoire et n'a pas de valeur par défaut. Tu dois spécifier un nom de bibliothèque valide avant d'installer Understand.
Le nom de bibliothèque doit respecter ces règles :
- Entre 1 et 10 caractères de longueur.
- Doit commencer par une lettre (A–Z),
$ou@. - Ne peut contenir que des lettres, des chiffres,
#,$,@ou_. - Ne peut pas commencer par
Q,SYSou#, car ces préfixes sont réservés aux bibliothèques fournies par IBM. - Ne peut pas contenir de points (
.), car la bibliothèque est utilisée comme schéma SQL par Understand.
Sélectionne une bibliothèque dédiée qui n'est pas déjà utilisée, et limite l'accès aux utilisateurs autorisés qui en ont besoin.