feeder

Version 0.1.0 (7 mars 2025)

Introduction

Ce dépôt fournit des fonctions pour gérer facilement l'impression de rapports sur IBM i. Elle permet de manipuler des spools d'impression avec une API RPG moderne et facile à utiliser.

Principales fonctionnalités

Gestion des spools

• Initialisation des spools : Configuration facile d'un nouveau spool d'impression avec des paramètres personnalisables
• Ouverture et fermeture : Méthodes simplifiées pour ouvrir et fermer les spools d'impression
• Écriture : Fonction optimisée pour écrire des messages formatés dans les spools

Fonctions principales

• `setUpSpool` : Configure un spool avec un nom personnalisé
• `OpenSpool` : Ouvre le spool pour l'écriture
• `WRITESPOOL` : Écrit un message dans le spool ouvert
• `CloseSpool` : Ferme proprement le spool d'impression

Configuration requise

• IBM i version 7.3 ou ultérieure
• RPGLE Free Format (ILE)
• Binding directory 'SERVICES'

Installation

1. Installer Python et les extensions Python dans Vscode2.

2. Pour l'ajouter à votre projet, clôner le dépot ibmi-dependencies:

   git clone https://github.com/IBMiservices/ibmi-dependencies.git
   

3. Ajouter le fichier dependencies.json

       {
           "dependencies": {
               "print": {
               "url": "https://github.com/IBMiservices/print.git",
            "ref": "0.1.0"
        }
      }
   }

4. Si vous avez déjà un fichier dependencies, y ajouter les lignes:

   "print": {
        "url": "https://github.com/IBMiservices/print.git",
        "ref": "0.1.0"
      }

5. Exécuter l'action Tâches: Exécuter la tâche, Install dependencies :
   ctrl+shift+p
   

8. Le source du binding directory SERVICES sera ajouter à votre projet, ou si vous l'avez déjà, ajoutera le programme de service print.

Utilisation

**FREE
Ctl-Opt BndDir('SERVICES');
...
/include 'PRINT.RPGLEINC'
...
Dcl-DS mySpoolInfo likeds(Spool);
mySpoolInfo.spoolName = 'MONRAPPORT';
...
// Initialiser le spool
setUpSpool(mySpoolInfo);
...
// Écrire dans le spool
WRITESPOOL('Bonjour, ceci est un message de test');
WRITESPOOL('Ligne 2 du rapport');
...
// Fermer le spool
CloseSpool();

Caractéristiques techniques

• Utilisation du fichier `QSYSPRT` avec une largeur de 132 caractères
• Gestion des erreurs avec des moniteurs (`MONITOR`)
• Option `NoMain` pour utilisation en tant que module de service
• Utilisation des fonctions d'override pour la personnalisation des spools

Problèmes connus

• Les messages de plus de 132 caractères sont tronqués
• L'intégration avec CCSID non-ASCII peut nécessiter des ajustements supplémentaires

Licence

Cette bibliothèque est distribuée sous licence MIT. Voir le fichier LICENSE pour plus de détails." > RELEASE_NOTES.md