Les scripts Python pour BankPerfect
(MAJ par Fabrice le 12/12/2009)
Introduction
Les scripts Python sont interprétés par BankPerfect. A son lancement, BankPerfect parcourt le dossier "\BankPerfect\Scripts\" et ajoute à son menu tous les scripts "*.py" accompagnés d'un fichier "*.ini".
Structure du fichier INI
Ce fichier ini contient les paramètres du script :
- Name=Nom du plugin
- nom du plugin
- Path=monplugin.py
- le script (le nom du fichier .py)
- Menu=outils
- (valeurs possibles : fichier, importer, édition, affichage, comptes, operations, outils, plugins, internet, context ou toolbar) : cette clé indique le ou les menus où le script apparaîtra (pour spécifier plusieurs menus, les séparer par une virgule : Menu=outils,context).
context correspond au menu contextuel (clic droit) et toolbar correspond à la barre d'outils.
- Index=6
- cette clé permet de définir à quelle position du menu le plugin apparaitra. La première position étant 0
- ExecuteWithFile=(0 ou 1)
- si égal à 1, le script s'exécutera à chaque ouverture de fichier .bp (cette fonction est utilisée par exemple par le script scheduler_auto.py pour savoir si il y a des lignes de l'échéancier à ajouter au chargement du fichier).
- ExecuteWithNewLine=(0 ou 1)
- indique à BankPerfect d'exécuter le plugin à chaque nouvelle ligne de compte
- ExecuteWithModifiedLine=(0 ou 1)
- indique à BankPerfect d'exécuter le plugin à chaque modification d'une ligne de compte
- Icon=Nom de l'iconne.ico
- icône du script (le nom du fichier .ico) ou l'index d'une icône interne à BP :
- Shortcut=Ctrl+F
- définit le raccourci clavier pour accéder lancer le plugin (Ex. Ctrl+B, F).
Note : Les raccourcis des plugins sont prioritaires sur les raccourcis déjà définis dans BP (F4, etc...)
- NeedsFile=(0 ou 1)
- si égal à 1, le script ne sera actif que si un fichier BankPerfect est ouvert.
- ReadOnly=(0 ou 1)
- cette clé permet d'indiquer à BankPerfect si ce plugin va modifier les données du fichier ouvert (ReadOnly=0) ou non (ReadOnly=1)
- DropDown=(0 ou 1)
- ??? précisé dans "setfilters.ini"
Outils nécessaires au développement des scripts
L'éditeur Python For BankPerfect
Pour développer votre script, il vous faut utiliser le plugin Python For BankPerfect téléchargeable à cette adresse.
Il s'agit d'un éditeur capable de vous permettre d'afficher, modifier et exécuter les scripts PythonBP.
Les scripts Python pour BankPerfect vous permettent aussi de créer des fenêtres avec tous les composants nécessaires pour communiquer avec l'utilisateur : l'éditeur Python for BankPerfect intègre un outil pour créer visuellement ces fenêtres et les objets qu'elles contiennent.